主要内容

readtimetable

从文件创建时间表

描述

例子

TT= readtimetable (文件名)创建一个时间表通过阅读用于数据从一个文件中。

readtimetable确定文件扩展名的文件格式:

  • . txt,.dat,或. csv分隔的文本文件

  • xls,.xlsb,.xlsm,.xlsx,.xltm,.xltx,或。ods电子表格文件

  • . xml可扩展标记语言(XML)文件。

用于文本和电子表格文件,readtimetable创建一个变量TT每一列的文件和读取文件的第一行的变量名。XML文件,readtimetable创建一个变量T为每个元素或属性节点检测到一个时间表变量。变量名称对应于元素和属性名称。

readtimetable集的第一列类型datetime持续时间在表格数据的行乘以时间表。其余列变量的时间表。

例子

TT= readtimetable (文件名,选择)另外采用进口选项选择

例子

TT= readtimetable (___,名称,值)从一个文件中创建一个时间表与附加选项指定的一个或多个参数名称-值对。使用任何输入参数的前面的语法指定名称-值对。

设置特定的导入选项为您的数据,您可以使用选择对象或您可以指定名称-值对。当你除了指定名称-值对选择,然后readtimetable金宝app只支持这些名称-值对:

  • ——文本和表格参数ReadVariableNames,RowTimes,SampleRate,步伐,开始时间

  • 文本只有参数-DateLocale,编码

  • 电子表格只有参数-,UseExcel

例子

全部折叠

创建一个表的以逗号分隔的文本文件。

TT = readtimetable (“outages.csv”);

显示表的一个总结。创建时间表时,如果没有指定行乘以任何参数,那么readtimetable功能检测和指定第一个datetime或持续时间变量的数据,OutageTime行乘以变量。其余变量的变量的时间表。

总结(TT)
RowTimes: OutageTime: x1 datetime值:1468分钟2002-02-01 12:18值2002-02-01 21:05 Max 2002-02-01 02:41变量:地区:1468 x1单元阵列特征向量的损失:1468 x1双重价值:最小0值180.26最大23418 NumMissing 604客户:x1双重价值:1468分钟0 75765 Max中位数5.9689 e + 328年06 NumMissing RestorationTime: x1 datetime值:1468分钟2002-02-07 16:50值2002-02-07 10:54 Max 2002-02-07二三31 NumMissing 29原因:1468 x1单元阵列的特征向量

检测导入文本文件的选项,指定变量类型,然后创建一个时间表从数据。

从一个文件中创建一个导入选项对象并检查变量的选择。

选择= detectImportOptions (“outages.csv”);opts.VariableOptions
ans = 1 x6异构VariableImportOptions (TextVariableImportOptions, DatetimeVariableImportOptions NumericVariableImportOptions)数组属性:名称类型FillValue TreatAsMissing QuoteRule前缀后缀EmptyFieldRule

修改对象的选项来指定所需的数据类型的变量数据。改变变量的数据类型地区导致分类。

选择= setvartype(选择,{“地区”,“原因”},{“分类”,“分类”});

使用readtimetable随着选择对象导入时间表。然后显示摘要的时间表。

TT = readtimetable (“outages.csv”、选择);总结(TT)
RowTimes: OutageTime: x1 datetime值:1468分钟2002-02-01 12:18值2002-02-01 21:05 Max 2002-02-01 02:41变量:地区:1468 x1分类值:中西部142东北557年东南389西南26西方亏损354:1468 x1双重价值:最小0值180.26最大23418 NumMissing 604客户:x1双重价值:1468分钟0 75765 Max中位数5.9689 e + 328年06 NumMissing RestorationTime: x1 datetime值:1468分钟2002-02-07 16:50值2002-02-07 10:54 Max 2002-02-07二三31 NumMissing 29原因:1468 x1分类值:攻击294地震188能源应急设备故障156火25 95年201年338年暴风雷雨未知24日风145年冬季风暴

从以逗号分隔的文本文件中读取一个表并创建一个与您选择的行乘以变量的时间表。

创建对象和预览表格数据导入选项。

选择= detectImportOptions (“outages.csv”);预览(“outages.csv”选择)
ans =8×6表地区OutageTime损失客户RestorationTime引起_________________ ___________ ______ __________ ___________ ___________________{“西南”}2002-02-01 12:18 458.98 - 1.8202 e + 06 2002-02-01 16:50{“暴风雪”}{“东南”}2003-01-23 00:49 530.14 - 2.1204 e + 05 NaT{“暴风雪”}{“东南”}2003-02-07)21:15 289.4 - 1.4294 e + 05 2003-02-07 08:14{“暴风雪”}{‘西方’}2004-04-06 05:44 434.81 - 3.4037 e + 05 2004-04-06 06:10{“设备故障”}{“中西部”}2002-03-16 06:18 186.44 - 2.1275 e + 05 2002-03-16 23:23{“暴风”}{‘西方’}2003-06-18 02:49 0 0 2003-06-18 10:54{‘攻击’}{‘西方’}2004-06-20 39 231.29南2004-06-20 19:16{“设备故障”}{‘西方’}2002-06-06 19:28 311.86南2002-06-06 00:51{“设备故障”}

创建一个指定的时间表RestorationTime变量是行乘以变量的时间表。然后,显示一个时间表的摘要。

TT = readtimetable (“outages.csv”,“RowTimes”,“RestorationTime”);总结(TT)
RowTimes: RestorationTime: x1 datetime值:1468分钟2002-02-07 16:50值2002-02-07 10:54 Max 2002-02-07二三31 NumMissing 29变量:地区:1468 x1单元阵列的特征向量OutageTime: x1 datetime值:1468分钟2002-02-01 12:18 2010-03-18 21:05 Max 2014-01-15 02:41损失中位数:1468 x1双重价值:最小0值180.26最大23418 NumMissing 604客户:x1双重价值:1468分钟0 75765 Max中位数5.9689 e + 328年06 NumMissing原因:1468 x1单元阵列的特征向量

从电子表格文件创建一个时间表和格式输入数据。例如,创建一个时间表的文件quarterlyFinances1999To2019.csv的开始日期,指定时间戳和每个人之间的时间、和删除数据的“$”符号。

quarterlyFinances.png

文件中读取数据quarterlyFinances1999To2019.csv作为一个时间表。指定的时间长度之间的连续行乘以一个日历季度开始日期1999年1月1日。集“VariableNamingRule”保存为了保存变量名的空白,并设置“TrimNonNumeric”真正的删除之前的“$”符号的数值数据。

TT = readtimetable (“quarterlyFinances1999To2019.csv”,“步伐”calquarters (1)“开始时间”datetime (1999, 1, 1),“VariableNamingRule”,“保存”,“TrimNonNumeric”,真正的);

显示数据的总结。

总结(TT)
x1 datetime值:RowTimes:时间:80分钟01 - 2008年1月- 1999年11月16 -中值- Max 01 - 10月- 2018变量:净销售额:80 x1双重价值:最小35066中位数1.0407 e + 05年最大1.7684 e + 05年销售成本:80 x1双重价值:18106分钟48624 Max 77742毛利率中位数:80 x1双重价值:14563分钟56719 Max 99097研究和开发费用中位数:80 x1双重价值:4904.9分钟24637 Max 45234管理费用中位数:80 x1双重价值:最小1047.4中位数2015.3最大2811.5总营业费用:80 x1双重价值:5992.5分钟26518 Max 48045净利润中位数:80 x1双重价值:7634.3分钟28586 Max 51051股中位数:80 x1双重价值:最小822中位数1820.5最大2710年每股收益:80 x1双重价值:24.62最小6.52中位数15.515最大

输入参数

全部折叠

指定名称的文件阅读,作为特征向量或一个字符串标量。

根据你的文件的位置,文件名可以承担其中的一个形式。

位置

形式

在MATLAB当前文件夹或文件夹®路径

指定文件的名称文件名

例子:“myFile.txt”

文件在一个文件夹

如果文件不在当前文件夹或在MATLAB上一个文件夹路径,然后指定完整的或相对路径名文件名

例子:“C: \ myFolder \ myFile.xlsx”

例子:“dataDir \ myFile.txt”

互联网网址

如果文件被指定为一个互联网统一资源定位符(URL)文件名必须包含的协议类型“http://”“https://”

例子:“http://hostname/path_to_file/my_data.csv”

远程位置

如果文件存储在一个偏远的位置,然后文件名必须包含指定的文件的完整路径和形式:

scheme_name:/ /path_to_file/my_file.ext

基于远程位置,scheme_name这个表中的值之一。

远程位置 scheme_name
Amazon S3™ s3
Windows Azure®Blob存储 wasb,wasbs
HDFS™ hdfs

有关更多信息,请参见使用远程数据

例子:s3: / / bucketname / path_to_file / my_file.csv '

  • 如果文件名包括文件扩展名,然后导入函数决定的文件格式扩展。否则,你必须指定“文件类型”名称-值对参数来表示文件的类型。

  • 在Windows上®与微软系统®Excel®任何Excel电子表格软件,导入函数读取Excel文件格式被你的版本。

  • 如果您的系统没有Excel为Windows或如果您正在使用MATLAB在线™、导入功能的运行UseExcel属性设置为,只读取xls, .xlsx .xlsm、.xltx .xltm文件。

  • 分隔的文本文件,导入函数转换文件中的空字段(对于一个数值型变量)或一个空字符向量(一个文本变量)。文本文件中的所有行必须有相同数量的分隔符。导入函数忽略了无关紧要的文件中的空白。

数据类型:字符|字符串

文件导入选项,指定为一个SpreadsheetImportOptions,DelimitedTextImportOptions,FixedWidthImportOptions,或XMLImportOptions创建的对象detectImportOptions函数。的选择对象包含的属性控制数据导入过程。对每个对象的属性的更多信息,参见相应的页面对象。

类型的文件 输出
电子表格文件 SpreadsheetImportOptions对象(仅供,DataRange,VariableNames属性)
文本文件 DelimitedTextImportOptions对象
宽度固定的文本文件 FixedWidthImportOptions对象
XML文件 XMLImportOptions对象

名称-值参数

指定可选的双参数作为Name1 = Value1,…,以=家,在那里的名字参数名称和吗价值相应的价值。名称-值参数必须出现在其他参数,但对的顺序无关紧要。

R2021a之前,用逗号来分隔每一个名称和值,并附上的名字在报价。

例子:“NumHeaderLines”, 5表明第一个五行之前的表格数据是头线。

所有支持金宝app的文件类型

全部折叠

HTTPHTTPS请求选项,指定为一个weboptions对象。的weboptions当指定的对象决定了如何导入数据文件名互联网是一个URL包含协议类型“http://”“https://”

文本和电子表格文件

全部折叠

类型的文件,指定为逗号分隔组成的“文件类型”“文本”“表格”

指定“文件类型”名称-值对参数时文件名不包括文件扩展名或者以外的扩展是下列之一:

  • . txt,.dat,或. csv分隔的文本文件

  • xls,.xlsb,.xlsm,.xlsx,.xltm,.xltx,或。ods电子表格文件

例子:“文件类型”、“文本”

数据类型:字符|字符串

的标题行数在这个文件中,指定为逗号分隔组成的“NumHeaderLines”和一个正整数。如果未指定的,导入函数自动检测文件的标题行数。

例子:“NumHeaderLines”7

数据类型:|

预期变量的数量,指定为逗号分隔组成的“ExpectedNumVariables”和一个正整数。如果未指定的,导入函数自动检测变量的数量。

数据类型:|

部分的数据读取文本或电子表格文件,指定为逗号分隔组成的“范围”和一个特征向量,字符串标量或数值向量这些形式之一。

指定的方法范围 描述

从细胞

“细胞”(行坳)

指定的起始单元格数据作为特征向量或字符串标量或两个元素数值向量。

  • 特征向量或字符串标量包含一个列和行号使用Excel信A1符号。例如,A5的标识符是细胞在列的交集一个和行5

  • 两个元素数值向量的形式(行坳)表示开始的行和列。

使用细胞开始,导入函数自动检测数据的程度开始导入细胞开始和结束在最后空行或页脚。

例子:的A5(5 - 1)

矩形范围

“Corner1: Corner2”(r1 c1 r2 c2)

指定矩形的确切范围阅读使用范围在这些形式之一。

  • “Corner1: Corner2”——指定范围内使用Corner1Corner2这是两个对立的角落,定义该地区在Excel中读A1符号。例如,“C2: N15”

  • (r1 c1 r2 c2)——使用四个元素指定范围数值向量包含起始行、起始列,结束行,结束列。例如,(2 3 15 13)

导入函数只读取数据包含在指定的范围内。任何空字段指定范围内进口失踪细胞。

行或列范围范围

“第一行:Row2”“Column1: Column2”

指定开始和结束行通过识别范围使用Excel行数。

使用指定的行范围,导入函数自动检测列程度通过阅读从第一个非空的列的数据,并创建一个变量,每列。

例子:“5:500”

另外,指定范围确定的开始和结束列使用Excel列字母或数字。

使用指定的列范围,导入函数自动检测行程度通过阅读从第一个非空的行或页脚的数据范围的结束。

指定范围的列数必须匹配指定的数量ExpectedNumVariables财产。

例子:“答:K”

起始行号

n

指定包含数据的第一行使用积极的标量行索引。

使用指定的行索引,导入函数自动检测数据通过阅读的程度从指定的第一行或页脚的数据范围的结束。

例子:5

Excel的命名范围

“NamedRange”

在Excel中,您可以创建电子表格中的名称识别范围。例如,您可以选择一个矩形部分的电子表格和调用它“myTable”。如果这样的命名范围存在于一个电子表格,然后导入函数可以读取范围使用它的名称。

例子:“范围”、“myTable”

不明或空

如果未指定的,使用的导入功能自动检测范围。

例子:“范围”,“

注意:使用范围指的矩形部分实际上包含数据的表格。导入函数自动检测应用范围通过削减任何前导和尾随不包含数据的行和列。文本只有白色的空间被认为是数据和捕获在使用范围内。

数据类型:字符|字符串|

对进口文本数据类型,指定为逗号分隔组成的“TextType”,要么“字符”“字符串”

  • “字符”——文本数据导入MATLAB作为特征向量。

  • “字符串”——文本数据导入MATLAB作为字符串数组。

例子:“TextType”、“生物炭”

对进口日期和时间数据类型,指定为逗号分隔组成的“DatetimeType”这些值之一:“datetime”,“文本”,或“exceldatenum”。的值“exceldatenum”只适用于电子表格文件,并为文本文件是无效的。

价值 进口日期和时间数据类型
“datetime”

MATLABdatetime数据类型

有关更多信息,请参见datetime

“文本”

如果“DatetimeType”被指定为“文本”,然后对进口日期和时间数据类型取决于中指定的值“TextType”参数:

  • 如果“TextType”被设置为“字符”,那么导入函数返回日期的单元阵列特征向量。

  • 如果“TextType”被设置为“字符串”,那么导入函数返回日期作为一个字符串数组。

“exceldatenum”

Excel串行日期数字

串行的日期数一个数字等于给定的参考日期的天数。Excel串行数据使用不同的参考日期比MATLAB数字串行日期。Excel日期的更多信息,请参阅https://金宝appsupport.microsoft.com/kb/214330

数据类型:字符|字符串

文本解释缺失的数据,指定为一个特征向量,字符串标量,单元阵列的特征向量,或字符串数组。

例子:TreatAsMissing, {“NA”,“TBD”}指导治疗任何发生的导入功能NATBD作为一个失踪的字段。

数据类型:字符|字符串|细胞

读第一行作为变量名,指定为逗号分隔组成的“ReadVariableNames”,要么真正的。如果未指定的,导入函数自动检测的变量名。

指示器

描述

真正的

时使用的第一行地区阅读包含表的变量名。发现导入函数创建一个变量,变量名,为每一列T

时使用的第一行地区读表中包含的数据。导入函数创建默认表单的变量名“Var1”,…,“VarN”,在那里N是变量的数量。

未指明的 当离开不明,进口自动检测功能真正的并相应收益。

当你指定ReadVariableNames名称-值对除了选择,然后导入函数如下。

  • 如果ReadVariableNames被设置为真正的,然后导入函数从指定文件中读取变量名称使用VariableNamesRange或者是VariableNamesLine导入选择对象的属性。

  • 如果ReadVariableNames被设置为,然后导入函数读取的变量名VariableNames导入选择对象的属性。

数据类型:逻辑

行乘以变量指定为逗号分隔组成的“RowTimes”一次和一个变量名或向量。

  • 变量名必须是一个特征向量或字符串标量包含任何变量的名称包含在输入表datetime持续时间值。该变量指定的变量名称为行提供行时间标签。其余变量输入表成为变量的时间表。

  • 时间必须是一个向量datetime向量或一个持续时间向量。时间向量的元素数量必须等于输入表的行数。时间的时间值向量不需要是独一无二的,排序,或定期。输入表的所有变量的变量的时间表。

数据类型:字符|字符串|datetime|持续时间

行乘以采样率,指定为逗号分隔组成的“SampleRate”和积极的数字标量。样本的取样速率是每秒(赫兹)的时间向量输出的时间表。

当你使用“SampleRate”指定的行向量的时间表,默认第一行时间(开始时间)为零。设置开始时间比零,其他指定“开始时间”名称-值对。

数据类型:

行乘以之间的时间步,指定为逗号分隔组成的“步伐”和一个标量或持续时间calendarDuration标量。的值“步伐”参数指定的时间长度之间的连续行乘以。导入函数使用时间步长值计算定期间隔一行乘以。

当你使用“步伐”指定的行向量的时间表,默认第一行时间(开始时间)为零。设置开始时间比零,其他指定“开始时间”名称-值对。

如果“步伐”是一个日历时间值,那么“开始时间”必须是一个datetime值。

数据类型:持续时间|calendarDuration

行乘以的开始时间,指定为逗号分隔组成的开始时间和一个datetime标量或持续时间标量。

定义向量的时间时间表,使用“开始时间”用的“SampleRate”或者是“步伐”名称-值对参数。

的数据类型开始时间,决定行时间向量的数据类型。

  • 如果开始时间是一个datetime值,那么行乘以时间表的datetime值。

  • 如果开始时间是一个时间值,那么行乘以时间。

数据类型:datetime|持续时间

国旗保存变量名称,指定为“修改”“保存”

  • “修改”——转换无效变量名(如决定的isvarnameMATLAB函数)来有效的标识符。

  • “保存”——保存变量名是无效的MATLAB标识符,如变量名,包括空间和非ascii字符。

从R2019b,变量名和行名称可以包含任何字符,包括空格和非ascii字符。同时,他们不仅可以从任何字符,字母。变量和行名称不需要有效的MATLAB标识符(如决定的isvarname功能)。保存这些变量名和行名称,设置的值VariableNamingRule“保存”。变量名不刷新时的价值VariableNamingRule改变从“修改”“保存”

数据类型:字符|字符串

文本文件只

全部折叠

字段分隔符字符分隔的文本文件,指定为一个特征向量,字符串标量,单元阵列的特征向量,或字符串数组。

例子:“分隔符”,“|”

例子:“分隔符”,{‘;’,‘*’}

数据类型:字符|字符串|细胞

字符视为空白,指定为一个特征向量包含一个或多个字符或字符串标量。

例子:“空白”、“_”

例子:“空白”、“? !”

行尾字符,指定为一个特征向量,字符串标量,单元阵列的特征向量,或字符串数组。

例子:' LineEnding ', ' \ n '

例子:“LineEnding”、“\ r \ n”

例子:LineEnding, {‘\ b’,‘:’}

数据类型:字符|字符串|细胞

风格的评论,指定为一个特征向量,字符串标量,单元阵列的特征向量,或字符串数组。

例如,忽略了文本上签字后百分之一,指定CommentStyle作为“%”

例子:CommentStyle, {“/ *”}

数据类型:字符|字符串|细胞

字符编码方案相关文件,指定为逗号分隔组成的“编码”“系统”或一个标准字符编码方案的名字。当你不指定任何编码,readtimetable函数使用自动字符集检测来确定当读取文件的编码。

如果你指定“编码”参数除了导入选项,那么readtimetable函数使用指定的值“编码”中定义的编码,覆盖导入选项。

例子:“编码”,“utf - 8”使用utf - 8编码。

例子:“编码”、“系统”使用系统默认的编码。

数据类型:字符|字符串

从文本文件输出数据类型的时间数据,指定为逗号分隔组成的“DurationType”,要么“持续时间”“文本”

价值 对进口持续时间数据的类型
“持续时间”

MATLAB持续时间数据类型

有关更多信息,请参见持续时间

“文本”

如果“DurationType”被指定为“文本”,然后对进口持续时间数据类型取决于中指定的值“TextType”参数:

  • 如果“TextType”被设置为“字符”,那么导入函数返回时间数据的单元阵列特征向量。

  • 如果“TextType”被设置为“字符串”,那么导入函数返回时间数据作为一个字符串数组。

数据类型:字符|字符串

语境对阅读日期,指定为逗号分隔组成的“DateLocale”和一个特征向量或一个字符串标量的形式xx_YY,地点:

  • YY是一个大写的ISO 3166 - 1α2代码表示一个国家。

  • xx是一个小写的ISO 639 - 1两个字母的代码显示语言。

此表列出了一些常见的区域设置的值。

语言环境 语言 国家
“de_DE” 德国 德国
“en_GB” 英语 联合王国
“en_US” 英语 美国
“es_ES” 西班牙语 西班牙
“fr_FR” 法国 法国
“it_IT” 意大利 意大利
“ja_JP” 日本 日本
“ko_KR” 韩国 韩国
“设置nl_NL” 荷兰 荷兰
“zh_CN” 中文(简体) 中国

当使用% D阅读文本格式说明符datetime值,使用DateLocale指定的地区进口函数应该解释,一周中的第几天名称和缩写。

如果你指定DateLocale参数除了选择导入选项,然后导入函数使用指定的值DateLocale论点,覆盖导入选项中定义的语言环境。

例子:“DateLocale”、“ja_JP”

字符表示的十进制分隔符数值变量指定为一个特征向量或字符串标量。导入函数使用中指定的字符DecimalSeparator名称-值对区分一个数的整数部分和小数部分。

当转换成整数数据类型、数量与小数部分四舍五入为最接近的整数。

例子:如果指定名称-值对“DecimalSeparator”、“,”,然后导入函数导入文本“14159”数量3.14159

数据类型:字符|字符串

字符显示数以千计在数值变量分组,指定为一个特征向量或字符串标量。数以千计的分组角色扮演视觉分隔符,分组数量在每三个地方的价值观。导入函数使用中指定的字符ThousandsSeparator名称-值对解释数据被导入。

例子:如果指定名称-值对“ThousandsSeparator”、“,”,然后导入函数导入文本“1234000”作为1234000

数据类型:字符|字符串

删除非数字字符的数字变量,指定为一个逻辑真正的

例子:如果指定名称-值对“TrimNonNumeric”,真的,然后导入函数读取“500美元/ -”作为500年

数据类型:逻辑

程序来处理连续分隔符分隔的文本文件,指定为这个表中的值之一。

连续分隔符规则 行为
“分裂” 将连续分隔符分割为多个字段。
“加入” 加入分隔符为一个分隔符。
“错误” 返回一个错误,中止导入操作。

数据类型:字符|字符串

过程管理主要分隔符分隔的文本文件,指定为这个表中的值之一。

领先的分隔符规则 行为
“保持” 分隔符。
“忽略” 忽略了分隔符。
“错误” 返回一个错误,中止导入操作。

过程管理落后于分隔符分隔的文本文件,指定为这个表中的值之一。

领先的分隔符规则 行为
“保持” 分隔符。
“忽略” 忽略了分隔符。
“错误” 返回一个错误,中止导入操作。
电子表格文件只

全部折叠

读取表,指定为一个空字符数组,一个特征向量或字符串标量包含表的名称,或积极的标量整数表示表索引。基于指定的值的属性,表中描述的导入功能的行为。

规范 行为
(默认) 从第一张工作表导入数据。
的名字 导入匹配的数据表名称,不管订单表的电子表格文件。
整数 导入数据表的位置用整数,无论表名称的电子表格文件。

数据类型:字符|字符串||

标志开始的一个实例Microsoft ExcelWindows时阅读的电子表格数据,指定为逗号分隔组成的“UseExcel”,要么真正的,或

你可以设置“UseExcel”参数的值:

  • 真正的——Microsoft Excel的导入功能启动一个实例时阅读该文件。

  • ——导入函数不开始Microsoft Excel当读取文件的一个实例。当操作在这种模式下,导入函数功能不同文件格式的支持和互动特性,如公式和宏。金宝app

UseExcel

真正的

金宝app支持文件格式

xls, .xlsx、.xlsm .xltx、.xltm .xlsb。ods

xls, .xlsx .xlsm、.xltx .xltm

金宝app支持交互式功能,如公式和宏

是的

没有

当阅读从电子表格文件在Windows平台上,如果你想开始的一个实例Microsoft Excel,然后设置“UseExcel”参数真正的

XML文件只

全部折叠

后缀属性,指定为逗号分隔组成的“AttributeSuffix”和一个特征向量或字符串标量。这个参数指定后缀阅读函数附加到所有表变量对应于输入XML文件中的属性。如果你不指定“AttributeSuffix”,然后阅读功能默认为附加后缀“属性”对所有变量名称对应于输入XML文件中的属性。

例子:“AttributeSuffix”、“_att”

导入属性,指定为逗号分隔组成的“ImportAttributes”,要么1(真正的)或0()。如果您指定阅读,那么函数将不导入XML输入文件中的属性变量输出表中。

例子:“ImportAttributes”,假的

表行XML节点名称,指定为逗号分隔组成的“RowNodeName”和一个特征向量或字符串标量。这个参数指定了XML节点名称,描绘了输出表的行。

例子:“RowNodeName”、“XMLNodeName”

矢量表行XPath表达式,指定为一个字符或字符串标量函数使用阅读选择个人输出表的行。您必须指定RowSelector作为一个有效的XPath 1.0表达式。

例子:“RowSelector”、“RootNode / ChildNode”

表变量XML节点名称,指定为逗号分隔组成的“VariableNodeNames”和特征向量的细胞数组或字符串数组。这个参数指定阅读函数使用的XML节点名称识别XML节点输出表中读取为变量。

例子:VariableNodeNames, {‘XMLNodeName1’,‘XMLNodeName2}

例子:“VariableNodeNames”、“XMLNodeName”

例子:“VariableNodeNames”, (“XMLNodeName1”、“XMLNodeName2”)

表变量XPath表达式,指定为一个单元阵列的特征向量数组或字符串读取函数使用选择表变量。您必须指定VariableSelectors作为有效的XPath表达式1.0版本。

例子:VariableSelectors, {' / RootNode / ChildNode '}

例子:‘VariableSelectors’,”/ RootNode / ChildNode”

例子:“VariableSelectors”, (“/ RootNode / ChildNode1”,“/ RootNode / ChildNode2”)

表的XML节点名称,指定为逗号分隔组成的“TableNodeName”和一个特征向量或字符串标量。这个参数指定节点的输入结构,阅读函数应该读表。

例子:“TableNodeName”、“节点名的

表数据XPath表达式,指定为一个特征向量或字符串标量,阅读函数使用选择输出表数据。您必须指定TableSelector作为一个有效的XPath 1.0表达式。

例子:“TableSelector”、“RootNode / ChildNode”

XPath变量单位,指定为一个特征向量或字符串标量函数所使用的阅读选择表变量单位。您必须指定VariableUnitsSelector作为一个有效的XPath 1.0表达式。

例子:“VariableUnitsSelector”、“RootNode / ChildNode”

变量描述XPath表达式,指定为一个特征向量或字符串标量阅读函数读取使用选择表变量描述。您必须指定VariableDescriptionsSelector作为一个有效的XPath 1.0表达式。

例子:“VariableDescriptionsSelector”、“RootNode / ChildNode”

程序处理重复表的XML节点在一个给定的行,指定为“addcol”,“忽略”,或“错误”

重复节点规则

行为

“addcol”

添加列重复节点变量下表中的标题。指定的值“RepeatedNodeRule”作为“addcol”不创建一个单独的表中变量的重复节点。

“忽略”

跳过导入重复的节点。

“错误” 显示一个错误消息并中止导入操作。

例子:“RepeatedNodeRule”、“忽略”

组注册XML名称空间前缀指定为逗号分隔组成的RegisteredNamespaces和一个前缀数组。阅读函数使用这些前缀在评估XPath表达式在一个XML文件。指定名称空间前缀和它们相关的url作为Nx2字符串数组。RegisteredNamespaces还可以使用当你评估一个XPath表达式指定的选择器名称参数,如StructSelectorreadstruct,或VariableSelectorsreadtablereadtimetable

默认情况下,阅读功能自动检测名称空间前缀注册使用XPath的评价,但是你也可以注册新使用的名称空间前缀RegisteredNamespaces名称-值参数。你可以注册一个新的名称空间前缀当XML节点的名称空间URL,但没有在XML文件中声明的名称空间前缀。

例如,评估一个XPath表达式在一个XML文件example.xml这并不包含一个名称空间前缀。指定“RegisteredNamespaces”作为[" myprefix ", " //www.tatmou.com ")分配前缀myprefix到URL//www.tatmou.com

T = readtable(“的例子。xml”、“VariableSelector”、“/ myprefix:数据”,……“RegisteredNamespaces”, [" myprefix ", " //www.tatmou.com "])

例子:“RegisteredNamespaces”, (“myprefix”、“//www.tatmou.com”)

输出参数

全部折叠

输出的时间表。时间表可以存储元数据,比如描述变量单位,变量名和行乘以。有关更多信息,请参见属性的部分时间表

提示

  • 使用XPath选择器来指定哪些元素的XML输入文档导入。例如,假设您想要导入的XML文件myFile.xml,它具有以下结构:

    <数据> <表类别= " 1 " > < var > 1 < / var > < var > 2 < / var > < /表> <表类别= "十" > < var > 10 < / var > < var > 20 < / var > < /表> < /数据>
    这个表提供的XPath语法支持XPath选择器名称参数,如金宝appVariableSelectorsTableSelector

    选择操作 语法 例子 结果
    选择每个节点名称和节点相匹配的你想选择,无论其位置在文档中。 与两个斜杠(前缀的名称/ /)。
    数据= readtable (“myFile.xml”,“VariableSelectors”,' / / var ')
    数据表var = 4×1 1 2 10 20
    读一个属性的值属于一个元素节点。 前缀的属性与一个符号(@)。
    数据= readtable (“myFile.xml”,“VariableSelectors”,' / /表/ @category ')
    data = 2×1表categoryAttribute _________________“的”“十”
    在一组节点选择一个特定的节点。 提供的索引节点你想选择在方括号([])。
    数据= readtable (“myFile.xml”,“TableSelector”,/ /表[1]”)
    数据表var = 2×1 1 2
    指定操作的优先级。 加括号的表达式你想先评估。
    数据= readtable (“myFile.xml”,“VariableSelectors”,/ /表/ var [1]”)
    data = 2×1表var ___ 1 10
    数据= readtable (“myFile.xml”,“VariableSelectors”,”(/ /表/ var) [1]”)
    数据表var ___ = 1

版本历史

介绍了R2019a