主要内容

ReadTimetable.

从文件创建时间表

描述

例子

TT.= READTIMETABLE(文件名通过从文件读取面向列的数据来创建时间表。

ReadTimetable.从文件扩展名确定文件格式:

  • 。文本文件.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.采样率时间戳开始时间

  • 文本只参数 -DateLocale编码

  • 电子表格只有参数-meftexcel.

例子

全部收缩

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

TT = readtimetable ('outages.csv');

显示表的摘要。创建时间表时,如果您未指定行时间的任何参数,那么ReadTimetable.函数检测和指定数据中的第一个DATETIME或持续时间变量,OutageTime,作为行时间变量。剩余变量成为时间表的变量。

总结(TT)
Rowtims:OutageTime:1468x1 DateTime值:Min 2002-02-01 12:18中位数2010-03-18 21:05 Max 2014-01-15 02:41变量:区域:1468x1 Cell are字符矢量丢失:1468x1双值:Min 0中位数180.26 Max 23418 Nummissing 604客户:1468x1双倍值:Min 0中位数75765 Max 5.9689E + 06 Nummissing 328 Restiontime:1468x1 DateTime值:Min 2002-02-07 16:50中位数2010-03-31 10:54MAX 2042-09-18 23:31 NUMMISING 29原因:1468x1字符向量阵列

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

从文件创建导入选项对象并检查变量选项。

选择= detectImportOptions ('outages.csv');选择
ans = 1x6异构可变导入选项(TextVarifeimportOptions,DateTimeVareifeImportOptions,NumericVareaseImportOptions)数组与属性:名称类型FirpValue injamissing QuoteRule Prefixes Seftixes extentFieldRule

修改options对象以指定数据中变量所需的数据类型。更改变量的数据类型地区导致分类。

opts = setvartype(opts,{'地区''原因'},{'分类''分类'});

ReadTimetable.以及选项对象以导入时间表。然后显示时间表的摘要。

TT = readtimetable ('outages.csv',选择);总结(TT)
RowTimes: OutageTime: 1468x1 datetime Values: Min 2002-02-01 12:18 Median 2010-03-18 21:05 Max 2014-01-15 02:41 Variables: Region: 1468x1 categorical Values: MidWest 142 NorthEast 557 SouthEast 389 SouthWest 26 West 354 Loss: 1468x1 double Values: Min 0 Median 180.26 Max 23418 NumMissing 604 Customers: 1468x1 double Values:最小0值75765最大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损失客户恢复时间___________________________________________________________________________________________________________________________________________________________________02-07 16:50 {'冬季风暴'} {'southeast'} 2003-01-23 00:49 530.14 2.1204E + 05 Nat {'冬季风暴'} {'Southeast'} 2003-02-07 21:15 289.4 1.4294E + 05 2003-02-17 08:14 {冬季风暴'} {'west'} 2004-04-06 05:44 434.81 3.4037E + 05 2004-04-06 06:10 {'midwest'} {'midwest'} 2002-03-16 06:18 186.44 2.1275E +05 2002-03-18 23:23 {'secort Storm'} {'West'} 2003-06-18 02:49 0 0 2003-06-18 10:54 {'攻击'} {'West'} 2004-06-20 14:39 231.29 NaN 2004-06-20 19:16 {'equipment fault'} {'West' } 2002-06-06 19:28 311.86 NaN 2002-06-07 00:51 {'equipment fault'}

属性创建时间表恢复时间变量是时间表的行时间变量。然后,显示时间表的摘要。

TT = readtimetable ('outages.csv''rowtimes'“RestorationTime”);总结(TT)
RowTimes: RestorationTime: 1468x1 datetime Values: Min 2002-02-07 16:50 Median 2010-03-31 10:54 Max 2042-09-18 23:31 NumMissing 29 Variables: Region: 1468x1 cell array of character vectors OutageTime: 1468x1 datetime Values: Min 2002-02-01 12:18 Median 2010-03-18 21:05 Max 2014-01-15 02:41 Loss: 1468x1 double Values:min0 Median 180.26 Max 23418 NumMissing 604 Customers: 1468x1 double Values: min0 Median 75765 Max 5.9689e+06 NumMissing 328原因:1468x1 cell array of character vectors

从电子表格文件创建时间表并格式化输入数据。例如,从文件中创建时间表季度融资1999to2019.csv.,指定时间戳的开始日期以及它们之间的每个时间,并从数据中删除“$”符号。

读取文件中的数据季度融资1999to2019.csv.作为一个时间表。指定连续行次之间的时间长度为一个日历季度,从1999年1月1日开始。集“PreserveVariableNames”真的保留变量名中的空格,并设置'trimnonnumeric'真的在数据中的数值之前删除“$”符号。

TT = readtimetable (“quarterlyFinances1999To2019.csv”“timestep”calquarters (1)“开始时间”,DateTime(1999,1,1,1),......“preservevariablenames”, 真的,“TrimNonNumeric”, 真的);

显示数据的摘要。

总结(TT)
RowTimes: Time: 80x1 datetime Values: Min 01- 1- 1999 Median 16- 11 -2008 Max 01-10 -2018 Variables: Net Sales: 80x1 double Values: Min 35066 Median 1.0407e+05 Max 1.7684e+05 Cost of Sales: 80x1 double Values: Min 18106 Median 48624 Max 77742毛利率:80x1 double Values: Min 14563 Median 56719 Max 99097 Research and Development Expenses:80x1 double Values: Min 7634.3 Median 28586 Max 51051 Total Shares: 80x1 double Values: Min 7904.9 Median 24637 Max 45234 Administrative Expenses: 80x1 double Values: Min 1047.4 Median 2015.3 Max 2811.5 Total Operating Expenses: 80x1 double Values: Min 5992.5 Median 26518 Max 48045 Net Income: 80x1 double Values: Min 7634.3 Median 28586 Max 51051 Total Shares: 80x1 double Values:Min 822 Median 1820.5 Max 2710每股收益:80x1 double Values:最小6.52 Median 15.515 Max 24.62

输入参数

全部收缩

要读取的文件名称,指定为字符向量或字符串标量。

根据您的文件的位置,文件名可以采取其中一种形式。

位置

形式

当前文件夹或MATLAB上的文件夹®小路

中指定文件的名称文件名

例子:'myfile.txt'

文件夹中的文件

如果文件不在当前文件夹中或MATLAB路径上的文件夹中,则指定完整或相对路径名称文件名

例子:'c:\ myfolder \ myfile.xlsx'

例子:“dataDir \ myFile.txt”

互联网网址

如果文件被指定为internet统一资源定位符(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 Storage. 黄金草原
HDFS™ HDFS.

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

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

  • 如果文件名包括文件扩展名,然后导入函数从扩展名确定文件格式。否则,您必须指定'文件类型'名称 - 值对参数指示文件类型。

  • 在Windows上®与微软系统®excel.®软件,导入功能读取您版本的Excel识别的任何Excel电子表格文件格式。

  • 如果您的系统没有Windows的Excel,或者您正在使用Matlab Online™,导入功能与该功能一起运行meftexcel.物业设为错误的,只读.xls, .xlsx, .xlsm, .xltx和.xltm文件。

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

数据类型:char|细绳

文件导入选项,指定为SpreadsheetImportOptionsdelimitedtextimportoptions.多个沃特莫特选项, 或者xmlimportoptions.由此创建的对象侦探函数。的选择对象包含控制数据导入过程的属性。有关每个对象属性的更多信息,请参阅相应的对象页面。

文件类型 输出
电子表格文件 SpreadsheetImportOptions对象(仅对数据范围, 和variablenames.属性)
文本文件 delimitedtextimportoptions.对象
宽度固定的文本文件 多个沃特莫特选项对象
XML文件 xmlimportoptions.对象

名称-值对的观点

指定可选的逗号分隔对名称,值参数。名称是参数名称和价值是相应的价值。名称必须出现在引号内。您可以以任何顺序指定多个名称和值对参数name1,value1,...,namen,valuen

例子:“NumHeaderLines”,5指示表格数据前面的前五行是标题行。
文本和电子表格文件

全部收缩

文件类型,指定为逗号分隔的对,由'文件类型'“文本”或者'电子表格'

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

  • 。文本文件.DAT., 或者.csv.用于分隔的文本文件

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

例子:'filetype','text'

数据类型:char|细绳

文件中的标题线数,指定为逗号分隔对组成'numheaderlines'一个正整数。如果未指定,导入函数会自动检测文件中的标题行数。

例子:“NumHeaderLines”7

数据类型:单身的|双倍的

期望的变量数,指定为逗号分隔的对,由'预期的内瓦里亚布尔'一个正整数。如果未指定,导入函数将自动检测变量的个数。

数据类型:单身的|双倍的

从文本或电子表格文件中读取的部分数据,指定为逗号分隔对“范围”字符向量,字符串标量,或数字向量。

指定的方法范围 描述

起始牢房

'细胞'或者(行坳)

将数据的起始小区指定为字符向量或字符串标量或两个元素数字向量。

  • 使用Excel包含列字母和行号的字符向量或字符串标量A1符号。例如,A5单元格的标识符是否在列的交点一个和行5

  • 表格的两个元素数字矢量(行坳)指示起始行和列。

使用起始单元格,导入函数通过从起始单元格开始导入,到最后一个空行或页脚范围结束,自动检测数据的范围。

例子:'a5'或者[5 1]

矩形范围

“Corner1: Corner2”或者[R1 C1 R2 C2]

指定在其中一种形式中使用矩形范围读取的精确范围。

  • “Corner1: Corner2”-指定使用的范围角落1.角落2.这是两个相对的角落,用于定义Excel中读取的区域A1符号。例如,“C2: N15”

  • [R1 C1 R2 C2]- 使用包含Start-Row,Start-Column,End-Row和终端列的四个元素数字向量的范围。例如,[2 3 15 13]

导入功能仅读取指定范围内包含的数据。指定范围内的任何空字段都将导入丢失的单元格。

行范围或列范围

“第一行:Row2”或者'第1列:column2'

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

使用指定的行范围,导入函数通过从第一个非空列读取到数据的末尾来自动检测列的范围,并为每个列创建一个变量。

例子:“5:500”

或者,通过使用Excel列字母或数字标识开始和结束列来指定范围。

使用指定的列范围,导入函数通过从第一个NONEMPTY行读取到数据的末尾或页脚范围来自动检测行范围。

指定范围中的列数必须与指定的数字匹配预示.财产。

例子:“答:K”

起始行号

n

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

使用指定的行索引,导入函数通过从指定的第一行读取到数据的末尾或页脚范围来自动检测数据的范围。

例子:5

Excel的命名范围

'namedrange'

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

例子:'范围','mytable'

不明或空

''

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

例子:'范围',''

注意:使用范围指实际包含数据的电子表格的矩形部分。导入功能通过修剪不包含数据的任何前导和尾随行和列自动检测使用的范围。只有空白空间的文本被视为数据,并在使用的范围内捕获。

数据类型:char|细绳|双倍的

输入导入的文本数据,指定为逗号分隔的配对组成'texttype',要么'char'或者'细绳'

  • 'char'-导入文本数据到MATLAB作为字符向量。

  • '细绳'-导入文本数据到MATLAB作为字符串数组。

例子:'texttype','char'

用于导入日期和时间数据的类型,指定为逗号分隔的对,由“DatetimeType”和其中一个值:'约会时间'“文本”, 或者“exceldatenum”.的值“exceldatenum”只适用于电子表格文件,对文本文件无效。

价值 输入导入日期和时间数据
'约会时间'

马铃薯datetime数据类型

有关更多信息,请参阅datetime

“文本”

如果“DatetimeType”被指定为“文本”,然后输入日期和时间数据的类型取决于所指定的值'texttype'范围:

  • 如果'texttype'被设置为'char',然后导入函数将日期返回为字符向量的单元格数组。

  • 如果'texttype'被设置为'细绳',然后导入函数将日期返回为字符串数组。

“exceldatenum”

Excel序列日期号码

序列日序是单个数字等于给定参考日期的天数。Excel序列日序号使用与Matlab序列日期号不同的其他参考日期。有关Excel日期的更多信息,请参阅https://金宝appsupport.microsoft.com/en-us/kb/214330

数据类型:char|细绳

要解释为缺失数据的文本,指定为字符向量、字符串标量、字符向量的单元数组或字符串数组。

例子:TreatAsMissing,{“NA”,“TBD”}指示导入函数处理任何NA或者TBD.作为缺少的领域。

数据类型:char|细绳|细胞

将第一行读为变量名称,指定为分隔的配对组成'readvariablenames',要么真的或者错误的.如果未指定,导入函数会自动检测变量名称的存在。

指示器

描述

真的

当要读取的区域的第一行包含表的变量名时使用。导入函数使用检测到的变量名为中每一列创建一个变量T

错误的

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

未指明的 左侧未指定后,导入功能会自动检测真的或者错误的并相应地进行。

当您指定时readvariablenames.名值对除选择,然后导入函数进行如下所示。

  • 如果readvariablenames.被设置为真的,然后使用的导入函数通过使用指定文件从指定文件中读取变量名称VariableNamesRange或者variablenamesline.导入选项对象的属性。

  • 如果readvariablenames.被设置为错误的,然后导入函数从中读取变量名称variablenames.导入选项对象的属性。

数据类型:逻辑

行时间变量,指定为逗号分隔对'rowtimes'和变量名称或时间向量。

  • 变量名必须是字符向量或字符串标量,其中包含输入表中包含的任何变量的名称datetime或者期间价值观。变量名称指定的变量为行提供行时间标签。输入表的剩余变量成为时间表的变量。

  • 时间向量一定是adatetime向量或一个期间向量。时间向量的元素数必须等于输入表的行数。时间向量中的时间值不需要是唯一的、有序的或规则的。输入表中的所有变量都变成了时间表的变量。

数据类型:char|细绳|datetime|期间

行时间的采样率,指定为逗号分隔的对组成'采样率'和一个正数标量。采样率是输出时间表的时间向量的每秒样本数(Hz)。

当你使用'采样率'要指定时间表的行时间向量,默认的第一行时间(开始时间)为零秒为零。要设置零以外的开始时间,请指定“开始时间”名称值对。

数据类型:双倍的

行时间之间的时间步长,指定为逗号分隔对组成'timestep'以及一个持续时间标量或calendarDuration标量。的价值'timestep'参数指定连续行次之间的时间长度。导入函数使用时间步长值来计算有规律间隔的行时间。

当你使用'timestep'要指定时间表的行时间向量,默认的第一行时间(开始时间)为零秒为零。要设置零以外的开始时间,请指定“开始时间”名称值对。

如果是'timestep'是日历持续时间值,然后是“开始时间”必须是DateTime值。

数据类型:期间|日历

行时间的开始时间,指定为逗号分隔的对组成开始时间和DateTime标量或持续时间标量。

要定义时间表的时间向量,请使用“开始时间”与之无论'采样率'或者'timestep'名称-值对参数。

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

  • 如果开始时间是DateTime值,则时间表的行次数为DateTime值。

  • 如果开始时间是一个持续时间值,那么行时间就是持续时间。

数据类型:datetime|期间

标志以保留变量名称,指定为逗号分隔的配对组成variablenamingrule.,要么“修改”或者“保存”

  • “修改”-转换无效的变量名(由isvarname.函数)到有效的MATLAB标识符。

  • “保存”- 保留不具有有效MATLAB标识符的变量名称,例如包含空格和非ASCII字符的变量名称。

从R2019b开始,变量名和行名可以包含任何字符,包括空格和非ascii字符。此外,它们可以以任何字符开头,而不仅仅是字母。变量和行名不必是有效的MATLAB标识符(如由isvarname.功能)。要保留这些变量名和行名,请将值设置为variablenamingrule.“保存”

数据类型:char|细绳

文本文件只

全部收缩

字段分隔符字符在分隔的文本文件中,指定为字符向量,字符串标量,字符向量的单元格数组或字符串数​​组。

例子:'delimiter','|'

例子:'delimiter',{';','*'}

数据类型:char|细绳|细胞

以白色空间对待的字符,指定为包含一个或多个字符的字符向量或字符串标量。

例子:“空白”、“_”

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

线端字符,指定为字符向量,字符串标量,字符向量的单元格数组或字符串数​​组。

例子:'排队','\ n'

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

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

数据类型:char|细绳|细胞

注释的样式,指定为字符向量、字符串标量、字符向量的单元数组或字符串数组。

例如,要在同一行上挂牌略有百分之符号,请指定CommentStyle.作为“%”

例子:'CommentStyle',{'/ *'}

数据类型:char|细绳|细胞

与文件相关联的字符编码方案,指定为包含的逗号分隔对“编码”'系统'或标准字符编码方案名称。如果不指定任何编码,则ReadTimetable.函数在读取文件时使用自动字符集检测来确定编码。

如果您指定“编码”参数除了导入选项,那么ReadTimetable.函数使用指定的值“编码”,重写在导入选项中定义的编码。

例子:'编码','utf-8'使用UTF-8作为编码。

例子:'编码','system'使用系统默认编码。

数据类型:char|细绳

从文本文件输出数据类型的持续时间数据,指定为逗号分隔对'durationtype',要么'期间'或者“文本”

价值 导入持续时间数据的类型
'期间'

马铃薯期间数据类型

有关更多信息,请参阅期间

“文本”

如果'durationtype'被指定为“文本”,然后导入持续时间数据的类型取决于指定的值'texttype'范围:

  • 如果'texttype'被设置为'char',然后导入函数将持续时间数据作为字符向量的单元格数组返回。

  • 如果'texttype'被设置为'细绳',然后导入函数将持续时间数据返回为字符串数组。

数据类型:char|细绳

用于阅读日期的区域设置,指定为逗号分隔的配对'datelocale'以及表单的字符矢量或字符串标量xx_yy.,地点:

  • yy.是一个大写的ISO 3166-1 alpha-2代码,表示一个国家。

  • xx是指示语言的小写ISO 639-1双字母代码。

有关区域设置的常用值的列表,请参见地区名称值对参数datetime函数。

使用时%D.读取文本的格式说明符datetime值,使用DateLocale指定导入函数应该在其中解释月和周的名称和缩写的区域设置。

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

例子:'datelocale','ja_jp'

在数字变量中指示小数分隔符的字符,指定为字符向量或字符串标量。控件中指定的字符将被导入函数使用DecimalSeparator名称 - 值对以将数字的整数部分与十进制部分区分开来。

在转换为整数数据类型时,具有小数部分的数字将四舍五入到最接近的整数。

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

数据类型:char|细绳

表示在数字变量中分组的数千个字符,指定为字符向量或字符串标量。数千个分组字符充当视觉分离器,在每三个位置计算数字。控件中指定的字符将被导入函数使用数千律师名称-值对来解释被导入的数字。

例子:如果将名称值对指定为'数千律师',',',然后导入函数导入文本“1,234,000”作为1234000.

数据类型:char|细绳

从数字变量中删除非数字字符,指定为逻辑真的或者错误的

例子:如果将名称值对指定为'trimnonnumeric',true,然后导入函数读取'500美元/ - '作为500.

数据类型:逻辑

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

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

数据类型:char|细绳

过程来管理带分隔符的文本文件中的开头分隔符,该文件指定为该表中的一个值。

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

过程来管理带分隔符的文本文件中的尾随分隔符,将其指定为该表中的一个值。

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

全部收缩

要从中读取的工作表,指定为空字符数组、包含工作表名称的字符向量或字符串标量,或表示工作表索引的正标量整数。对象指定的值属性,则导入函数的行为如表中所述。

规格 行为
''(默认) 从第一个表导入数据。
名称 无论电子表格文件中的纸张订单如何导入匹配的工作表名称。
整数 无论电子表格文件中的工作表名称是什么,都可以将数据从工作表中按整数表示的位置导入。

数据类型:char|细绳|单身的|双倍的

旗帜开始一个实例微软Excel.读取电子表格数据时的Windows,指定为包括的逗号分隔对“UseExcel”,要么真的, 或者错误的

你可以设置“UseExcel”参数到其中一个值:

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

  • 错误的- 读取文件时,导入功能不会启动Microsoft Excel的实例。在此模式下运行时,导入功能功能在文件格式和交互功能的支持下不同,例如公式和宏。金宝app

meftexcel.

真的

错误的

金宝app支持文件格式

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

.xls,.xlsx,.xlsm,.xltx,.xltm

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

是的

没有

从Windows平台上的电子表格文件读取时,如果要启动一个实例微软Excel.,然后设置“UseExcel”参数真的

XML文件只

全部收缩

属性后缀,指定为逗号分隔对'attributesuffix'并且是字符向量或字符串标量。此参数指定读取函数附加到对应于输入XML文件中的属性的所有表变量的后缀。如果您未指定'attributesuffix',然后读取功能默认为追加后缀'属性'与输入XML文件中属性对应的所有变量名。

例子:'attributesuffix','_ att'

导入属性,指定为逗号分隔对组成'进一步进一步',要么1真的)或0错误的).如果您指定错误的,然后读取功能不会将输入文件中的XML属性导入输出表中的变量。

例子:“ImportAttributes”,假的

表行XML节点名,由逗号分隔的对组成'rownodename'并且是字符向量或字符串标量。此参数指定描绘输出表的行的XML节点名称。

例子:“RowNodeName”、“XMLNodeName”

表行XPath表达式,指定为读取功能用于选择输出表的单个行的字符向量或字符串标量。您必须指定Rowselector.作为有效的XPath版本1.0表达式。

例子:'rowselector','/ rootnode / shordnode'

表变量XML节点名称,指定为逗号分隔对组成'variablenodenames'或者是字符向量的单元格数组或者是字符串数组。此参数指定读取函数用于标识要作为输出表中的变量读取的XML节点的XML节点名。

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

例子:“VariableNodeNames”、“XMLNodeName”

例子:'variablenodenames',[“xmlnodename1”,“xmlnodename2”]

表变量XPath表达式,指定为读取函数用于选择表变量的字符向量或字符串数​​组的单元格数组。您必须指定变形electors.作为有效的XPath版本1.0表达式。

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

例子:'VariableElectors',“/ rootnode / shardnode”

例子:'VariaBliceElectors',[“/ rootnode / shildnode1”,“/ rootnode / shildnode2”]

表XML节点名,由逗号分隔的对组成'tablenodename'并且是字符向量或字符串标量。此参数指定读取函数应该读取表的输入结构中的节点。

例子:'tablenodename','nodename'

表数据XPath表达式指定为读取功能用于选择输出表数据的字符向量或字符串标量。您必须指定TableSelector作为有效的XPath版本1.0表达式。

例子:'tableselector','/ rootnode / shordnode'

可变单元XPath,指定为读取函数用于选择表变量单元的字符向量或字符串标量。您必须指定VariableUnitsSelector作为有效的XPath版本1.0表达式。

例子:'“变量单独选择”,“/ rootnode / shildnode”

可变描述XPath表达式,指定为读取功能读取用于选择变量描述的字符向量或字符串标量。您必须指定variabledescriptions选择器作为有效的XPath版本1.0表达式。

例子:'variabledescriptions selector','/ rootnode / shildnode'

过程在表的给定行中处理重复的XML节点,指定为“addcol”“忽略”, 或者'错误'

重复节点规则

行为

“addcol”

在表格中的变量标题下添加列的列。指定值'重复诺德鲁莱恩'作为“addcol”不为重复节点在表中创建单独的变量。

“忽略”

跳过重复节点的导入。

'错误' 显示错误消息并中止导入操作。

例子:'repedednoderule','忽略'

一组注册的XML名称空间前缀,指定为逗号分隔的对,由注册NameSpaces.还有一个前缀数组。读取函数在对XML文件上的XPath表达式求值时使用这些前缀。将名称空间前缀及其关联的url指定为一个Nx2字符串数组。注册NameSpaces.也可以在计算由选择器名称-值参数指定的XPath表达式时使用,例如StructSelector为了阅读, 或者变形electors.为了readtableReadTimetable.

默认情况下,读取功能会自动检测命名空间前缀以注册用于XPath评估,但您也可以使用该注册新的命名空间前缀注册NameSpaces.名称-值参数。当XML节点具有名称空间URL,但XML文件中没有声明的名称空间前缀时,可以注册一个新的名称空间前缀。

例如,评估名为XML文件的XPath表达式example.xml不包含命名空间前缀。指定'注册NameSpaces'作为[" myprefix ", " //www.tatmou.com ")分配前缀MyPrefix.到网址//www.tatmou.com.

t = readtable(“example.xml”,“VariableelElector”,“/ MyPrefix:Data”,...“注册NameSpace”,[“MyPrefix”,“//www.tatmou.com”))

例子:“注册namespaces”,[“myprefix”,“//www.tatmou.com”]

输出参数

全部收缩

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

提示

  • XPath选择器名称-值参数支持以下XPath语法,例如金宝appRowselector.或者variablingelector

    • 要选择名称与要选择的节点匹配的每个节点,无论文档中的位置如何,请使用" / / myNode”语法。您可以使用" / / myNode”要省略前面要选择的节点之前的XPath表达式。

    • 要在文件中的一个父节点下读取几个兄弟节点之一,可以指定儿童编码[n, 在哪里n对应于要索引的兄弟节点。例如,路径“/ RootNode / ChildNode[2]”选择第二个ChildNode元素的父元素是RootNode

    • 要在输入XML文件中读取属于元素节点的属性的值,请指定在属性名之前。例如,“/ rootnode / shordnode [2] / @ attributename”选择属性AttributeName属于第二个ChildNode元素的父元素是RootNode

介绍了R2019a