主要内容

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只支持这些名值对:

  • 文本和电子表格参数-ReadVariableNamesRowTimesSampleRate步伐开始时间

  • -纯文本参数DateLocale编码

  • 电子表格参数-UseExcel

例子

全部折叠

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

TT = readtimetable (“outages.csv”);

显示表的摘要。在创建时间表时,如果没有为行时间指定任何参数,则readtimetable函数检测并指定数据中的第一个datetime或duration变量,OutageTime,作为行乘以变量。其余的变量成为时间表的变量。

总结(TT)
RowTimes: OutageTime: 1468x1 datetime值:Min 2002-02-01 12:18 Median 2010-03-18 21:05 Max 2014-01-15 02:41变量:Region: 1468x1 double值:Min 0 Median 180.26 Max 23418 NumMissing 604 Customers: 1468x1 double值:Min 0 Median 75765 Max 5.9689e+06 NumMissing 328 RestorationTime: 1468x1 datetime值:Min 2002-02-07 16:50 Median 2010-03-31 10:54 Max 2042-09-18 23:31 NumMissing 29原因:1468x1 cell array of character vector

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

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

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

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

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

使用readtimetable与options对象一起导入时间表。然后显示时间表的摘要。

TT = readtimetable (“outages.csv”、选择);总结(TT)
RowTimes: OutageTime: 1468x1 datetime值:Min 2002-02-01 12:18 Median 2010-03-18 21:05 Max 2014-01-15 02:41变量:Region: 1468x1 categorical值:MidWest 142东北557东南389西南26西部354 Loss: 1468x1 double值:Min 0 Median 180.26 Max 23418 NumMissing 604 Customers: 1468x1 double值:Min 0 Median 75765 Max 5.9689e+06 NumMissing 328 RestorationTime: 1468x1 datetime值:Min 2011-02-07 16:50中位数2010-03-31 23:31 NumMissing 29原因:1468x1分类值:攻击294地震2能源紧急情况188设备故障156火灾25强风暴338雷暴201未知24风95冬季风暴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.442.1275e+05 2002-03-18 23:23{'严重风暴'}{'西部'}2003-06-18 02:49 00 2003-06-18 10:54{'攻击'}{'西部'}2004-06-20 14:39 231.29 NaN 2004-06-20 19:16{'设备故障'}{'西部'}2002-06-06 19:28 311.86 NaN 2002-06-07 00:51{'设备故障'}

创建时间表RestorationTime变量为时间表的行时间变量。然后,显示时间表的摘要。

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

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

quarterlyFinances.png

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

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

显示数据的摘要。

总结(TT)
行时间:时间:80x1 datetime值:Min 01- 01- 1999年1月-中位数16- 11月-2008年11月- 10月最大值2018年01- 10月变量:净销售额:80x1 double值:Min 35066中位数1.0407e+05 Max 1.7684e+05销售成本:80x1 double值:Min 18106中位数48624 Max 77742毛利率:80x1 double值:Min 14563中位数56719 Max 99097研发费用:80x1 double值:Min 4904.9中位数24637 Max 45234行政费用:80x1 double值:Min 35066中位数1.0407e+05Min 1047.4中位数2015.3 Max 2811.5总运营费用:80x1 double Values: Min 5992.5中位数26518 Max 48045净收入:80x1 double Values: Min 7634.3中位数28586 Max 51051总股份:80x1 double Values: Min 822中位数1820.5 Max 2710每股收益:80x1 double Values: Min 6.52中位数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存储 wasbwasbs
HDFS™ hdfs

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

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

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

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

  • 如果您的系统没有Windows Excel,或者您正在使用MATLAB在线™,导入函数与UseExcel属性设置为,并只阅读.xls、.xlsx、.xlsm、.xltx和.xltm文件。

  • 对于带分隔符的文本文件,导入函数将文件中的空字段转换为两者之一(对于数值变量)或空字符向量(对于文本变量)。文本文件中的所有行必须具有相同数量的分隔符。导入函数忽略文件中不重要的空白。

数据类型:字符|字符串

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

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

名称-值参数

指定可选参数对为Name1 = Value1,…,以=家,在那里的名字参数名称和价值对应的值。名-值参数必须出现在其他参数之后,但对的顺序并不重要。

在R2021a之前,名称和值之间用逗号隔开,并括起来的名字在报价。

例子:“NumHeaderLines”,5指示表数据前面的前五行是标题行。

所有支持的文件类型

全部折叠

HTTPHTTPS请求选项,指定为weboptions对象。的weboptions对象确定在指定时如何导入数据文件名是否包含该协议类型的internet 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”—使用Corner1而且Corner2哪两个相对的角定义了Excel中要读取的区域A1符号。例如,“C2: N15”

  • [r1 c1 r2 c2]—使用包含开始行、开始列、结束行和结束列的四元素数字向量指定范围。例如,[2 3 15 13]

导入函数只读取包含在指定范围内的数据。在指定范围内的任何空字段都被导入为缺失的单元格。

行范围或列范围

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

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

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

例子:“5:500”

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

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

字段中指定的列数必须与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://support.microsoft.com/kb/214330

数据类型:字符|字符串

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

例子:TreatAsMissing,{“NA”,“TBD”}的任何发生指示导入函数处理NATBD如同一场思念。

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

将第一行读取为变量名,指定为逗号分隔的对,由“ReadVariableNames”,要么真正的.如果未指定,导入函数将自动检测变量名的存在。

指示器

描述

真正的

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

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

未指明的 如果未指定,导入函数将自动检测真正的并相应收益。

当你指定ReadVariableNames名称-值对选择,则导入函数进行如下操作。

  • 如果ReadVariableNames被设置为真正的方法从指定的文件中读取变量名VariableNamesRange或者是VariableNamesLine属性的导入选项对象。

  • 如果ReadVariableNames被设置为,然后导入函数从VariableNames属性的导入选项对象。

数据类型:逻辑

行时间变量,指定为逗号分隔的对,由“RowTimes”还有一个变量名或者时间向量。

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

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

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

行次数的采样率,指定为逗号分隔的对,由“SampleRate”和一个正的数值标量。采样率是输出时间表的时间矢量的每秒采样数(Hz)。

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

数据类型:

行次数之间的时间步长,指定为逗号分隔的对,由“步伐”和duration标量或calendarDuration标量。的值“步伐”参数指定连续行次数之间的时间间隔。导入函数使用时间步长值来计算规则间隔的行时间。

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

如果“步伐”是日历持续时间值,则“开始时间”必须是datetime值。

数据类型:持续时间|calendarDuration

行次数的开始时间,指定为逗号分隔的对,由开始时间和日期时间标量或持续时间标量。

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

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

  • 如果开始时间为datetime值,则时间表的行时间为datetime值。

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

数据类型:datetime|持续时间

标记以保留变量名,指定为任意“修改”“保存”

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

  • “保存”-保留不是有效的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 alpha-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 Excel当读取电子表格数据时,指定为逗号分隔的对,由“UseExcel”,要么真正的,或

您可以设置“UseExcel”参数设置为以下值之一:

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

  • —导入功能在读取文件时不启动Excel实例。在此模式下操作时,导入函数功能在支持文件格式和交互特性(如公式和宏)方面有所不同。

UseExcel

真正的

支持文件格式

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

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

支持交互特性,如公式和宏

是的

没有

在从Windows平台上的电子表格文件读取时,如果想启动的实例Microsoft Excel,然后设置“UseExcel”参数真正的

XML文件只

全部折叠

属性后缀,指定为逗号分隔的对,由“AttributeSuffix”或者是字符向量或字符串标量。此参数指定读取函数附加到与输入XML文件中的属性对应的所有表变量的后缀。如果不指定“AttributeSuffix”,则read函数默认为追加后缀“属性”到输入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和一个前缀数组。读取函数在计算XML文件上的XPath表达式时使用这些前缀。将命名空间前缀及其关联的url指定为一个Nx2字符串数组。RegisteredNamespaces可以在计算由选择器名称-值参数指定的XPath表达式时使用,例如StructSelectorreadstruct,或VariableSelectorsreadtable而且readtimetable

默认情况下,读取函数自动检测名称空间前缀,以便注册用于XPath求值,但是您也可以使用RegisteredNamespaces名称-值参数。如果XML节点有名称空间URL,但XML文件中没有声明名称空间前缀,则可以注册一个新的名称空间前缀。

例如,计算XML文件上的XPath表达式example.xml它不包含名称空间前缀。指定“RegisteredNamespaces”作为[" myprefix ", " //www.ru-cchi.com ")要分配前缀myprefix到URL//www.ru-cchi.com

T = readtable("example.xml", "VariableSelector", "/myprefix:Data",…“RegisteredNamespaces”,[" myprefix ", " //www.ru-cchi.com "])

例子:“RegisteredNamespaces”,(“myprefix”、“//www.ru-cchi.com”)

输出参数

全部折叠

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

提示

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

    <数据> <表类别= "的" > < var > 1 < / var > < var > 2 < / var > < /表> <表类别= "十" > < var > 10 < / var > < var > 20 < / var > < /表> > < /数据
    该表提供XPath选择器名称-值参数支持的XPath语法,例如VariableSelectorsTableSelector

    选择操作 语法 例子 结果
    选择名称与要选择的节点相匹配的每个节点,而不管其在文档中的位置。 名称前加上两个斜杠(//).
    数据= readtable (“myFile.xml”“VariableSelectors”' / / var '
    数据= 4×1 table var ___ 1 2 10 20
    读取属于元素节点的属性的值。 在属性前加上at符号(@).
    数据= readtable (“myFile.xml”“VariableSelectors”' / /表/ @category '
    数据表categoryAttribute = 2×1  _________________ " 的”“十”
    在节点集合中选择一个特定的节点。 用方括号提供要选择的节点的索引([]).
    数据= readtable (“myFile.xml”“TableSelector”/ /表[1]”
    数据= 2×1 table var ___ 1
    指定操作的优先级。 在要首先求值的表达式周围添加括号。
    数据= readtable (“myFile.xml”“VariableSelectors”/ /表/ var[1]”
    Data = 2×1 table var ___ 1
    数据= readtable (“myFile.xml”“VariableSelectors””(/ /表/ var)[1]”
    数据=表var ___

版本历史

介绍了R2019a

Baidu
map