readtimetable
从文件创建时间表
描述
通过从文件中读取面向列的数据来创建时间表。TT
= readtimetable (文件名
)
readtimetable
从文件扩展名确定文件格式:
. txt
,.dat
,或. csv
对于带分隔符的文本文件xls
,.xlsb
,.xlsm
,.xlsx
,.xltm
,.xltx
,或。ods
电子表格文件. xml
用于可扩展标记语言(XML)文件。
对于文本和电子表格文件,readtimetable
创建一个变量TT
并从文件的第一行读取变量名。对于XML文件,readtimetable
创建一个变量T
对于作为时间表变量检测的每个元素或属性节点。变量名对应于元素和属性名。
readtimetable
设置type的第一列datetime
或持续时间
在表格数据中为行时间的时间表。其余的列成为时间表的变量。
例子
从文本文件创建时间表
从逗号分隔的文本文件创建一个表。
TT =阅读时间表(“outages.csv”);
显示表的摘要。创建时间表时,如果未为行时间指定任何参数,则readtimetable
函数检测并指定数据中的第一个日期时间或持续时间变量,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 cell array of character vector 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 2002-02-07 16:50 Median 2010-03-31 10:54 Max 204209-18 23:31 NumMissing 29原因:1468x1 cell array of character vector
使用导入选项从文件创建时间表
检测文本文件的导入选项,指定变量类型,然后根据数据创建时间表。
从文件创建一个导入选项对象,并检查变量选项。
opts = detectImportOptions(“outages.csv”);选择。VariableOptions
ans = 1x6异构VariableImportOptions (TextVariableImportOptions, DatetimeVariableImportOptions, NumericVariableImportOptions)数组,属性:Name Type FillValue TreatAsMissing QuoteRule Prefixes suffix EmptyFieldRule
修改options对象,为数据中的变量指定所需的数据类型。更改变量的数据类型地区
而且导致
分类。
选项= setvartype(选项,{“地区”,“原因”}, {“分类”,“分类”});
使用readtimetable
与选项对象一起导入时间表。然后显示时间表摘要。
TT =阅读时间表(“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 NorthEast 557 SouthEast 389 SouthWest 26 West 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值:最小时间中位数2010-03-31最大时间最大204209-18 23:31数字失踪29原因:1468x1分类值:攻击294地震2能源紧急188设备故障156火灾25强风暴338雷暴201未知24风95冬季风暴145
从文件创建时间表并指定行时间
从逗号分隔的文本文件中读取一个表,并使用您选择的行时间变量创建一个时间表。
创建一个导入选项对象并预览表格数据。
opts = 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 =阅读时间表(“outages.csv”,“RowTimes”,“RestorationTime”);总结(TT)
RowTimes: RestorationTime: 1468x1 datetime值:Min 2002-02-07 16:50 Median 2010-03-31 10:54 Max 204209-18 23:31 NumMissing 29变量:Region: 1468x1 cell array of character vectors OutageTime: 1468x1 datetime值: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 vectors
创建时间表从电子表格文件和格式输入数据
从电子表格文件创建时间表,并格式化输入数据。例如,从该文件创建一个时间表quarterlyFinances1999To2019.csv
,指定时间戳的开始日期和每个时间戳之间的时间,并从数据中删除“$”符号。
读取文件中的数据quarterlyFinances1999To2019.csv
作为一个时间表。指定连续行时间之间的时间长度为一个日历季度,从日期1999年1月1日开始。集“VariableNamingRule”
来保存
以保留变量名中的空白,并设置“TrimNonNumeric”
来真正的
删除数据中数值之前的“$”符号。
TT =阅读时间表(“quarterlyFinances1999To2019.csv”,“步伐”calquarters (1)“开始时间”, datetime(1999,1,1),...“VariableNamingRule”,“保存”,“TrimNonNumeric”,真正的);
显示数据摘要。
总结(TT)
行次数:时间:80x1 datetime值:Min 01- 01- 1999年1月-2008年11月- 16- 2018年10月变量:净销售额:80x1 double值:Min 35066中位数1.0407e+05最大1.7684e+05销售成本:80x1 double值:Min 18106中位数48624最大77742毛利率:80x1 double值:Min 14563中位数56719最大99097研发费用:80x1 double值:Min 4904.9中位数24637最大45234管理费用:80x1 double值:Min最小1047.4中位数2015.3最大2811.5总营业费用:80x1倍值:最小5992.5中位数26518最大48045净收入:80x1倍值:最小7634.3中位数28586最大51051总股份:80x1倍值:最小822中位数1820.5最大2710每股收益:80x1倍值:最小6.52中位数15.515最大24.62
输入参数
文件名
- - - - - -要读取的文件名称
特征向量|字符串标量
要读取的文件的名称,指定为字符向量或字符串标量。
根据文件的位置,文件名
可以变成这些形式之一。
位置 |
形式 |
||||||||
---|---|---|---|---|---|---|---|---|---|
MATLAB中的当前文件夹或文件夹®路径 | 中指定文件的名称 例子: |
||||||||
文件夹中的文件 |
如果文件不在当前文件夹或MATLAB路径上的文件夹中,则在中指定完整或相对路径名 例子: 例子: |
||||||||
互联网网址 | 如果文件指定为internet统一资源定位符(URL),则 例子: |
||||||||
远程位置 |
如果文件存储在远程位置,则
根据位置的远近
有关更多信息,请参见使用远程数据. 例子: |
如果
文件名
包含文件扩展名,然后导入函数从扩展名确定文件格式。否则,必须指定“文件类型”
名称-值对参数来指示文件类型。在Windows上®微软系统®Excel®软件,导入功能读取任何Excel电子表格文件格式认可的Excel版本。
如果你的系统没有Excel for Windows或者你正在使用MATLAB在线™时,导入函数与
UseExcel
属性设置为假
,只读.xls, .xlsx, .xlsm, .xltx和.xltm
文件。对于带分隔符的文本文件,导入函数将文件中的空字段转换为任意一个
南
(对于数值变量)或空字符向量(对于文本变量)。文本文件中的所有行必须具有相同数量的分隔符。导入函数忽略文件中不重要的空白。
数据类型:字符
|字符串
选择
- - - - - -文件导入选项
SpreadsheetImportOptions
|DelimitedtextImportOptions
|FixedWidthImportOptions
|XMLImportOptions
文件导入选项,指定为SpreadsheetImportOptions
,DelimitedTextImportOptions
,FixedWidthImportOptions
,或XMLImportOptions
对象创建的detectImportOptions
函数。的选择
对象包含控制数据导入过程的属性。有关每个对象属性的更多信息,请参阅相应的对象页面。
文件类型 | 输出 |
---|---|
电子表格文件 | SpreadsheetImportOptions 对象(仅对表 ,DataRange ,VariableNames 属性) |
文本文件 | DelimitedTextImportOptions 对象 |
固定宽度的文本文件 | FixedWidthImportOptions 对象 |
XML文件 | XMLImportOptions 对象 |
名称-值参数
指定可选参数对为Name1 = Value1,…,以=家
,在那里的名字
参数名称和价值
对应的值。名称-值参数必须出现在其他参数之后,但对的顺序无关紧要。
在R2021a之前,使用逗号分隔每个名称和值,并将其括起来的名字
在报价。
例子:“NumHeaderLines”,5
指示表数据前面的前五行是标题行。
WebOptions
- - - - - -HTTP
或HTTPS
请求的选项
weboptions
对象
HTTP
或HTTPS
请求选项,作为weboptions
对象。的weboptions
对象确定在指定时如何导入数据文件名
internet URL是否包含该协议类型“http://”
或“https://”
.
文件类型
- - - - - -文件类型
“文本”
|“表格”
文件类型,指定为逗号分隔的对,由“文件类型”
而且“文本”
或“表格”
.
指定“文件类型”
参数时,名称-值对参数文件名
不包括文件扩展名,或者扩展名不是以下其中之一:
. txt
,.dat
,或. csv
对于带分隔符的文本文件xls
,.xlsb
,.xlsm
,.xlsx
,.xltm
,.xltx
,或。ods
电子表格文件
例子:“文件类型”、“文本”
数据类型:字符
|字符串
NumHeaderLines
- - - - - -标题行数
正整数
文件中的标题行数,由逗号分隔的对组成“NumHeaderLines”
一个正整数。如果未指定,导入函数将自动检测文件中的标题行数。
例子:“NumHeaderLines”7
数据类型:单
|双
ExpectedNumVariables
- - - - - -期望变量数
正整数
变量的预期数目,指定为由逗号分隔的对组成“ExpectedNumVariables”
一个正整数。如果未指定,导入函数将自动检测变量的数量。
数据类型:单
|双
范围
- - - - - -要读取的部分数据
特征向量|字符串标量|数值向量
要从文本或电子表格文件中读取的数据的一部分,指定为由逗号分隔的对组成“范围”
以及这些形式之一的字符向量、字符串标量或数字向量。
指定方法范围 |
描述 |
---|---|
从细胞
|
将数据的起始单元格指定为字符向量或字符串标量或两个元素数值向量。
使用起始单元格,导入函数通过从起始单元格开始导入并在最后一个空行或页脚范围结束来自动检测数据的范围。 例子: |
矩形范围
|
使用其中一种形式的矩形范围指定要读取的确切范围。
导入函数只读取包含在指定范围内的数据。指定范围内的任何空字段都将作为缺失的单元格导入。 |
行范围或列范围
|
通过使用Excel行号标识开始行和结束行来指定范围。 使用指定的行范围,导入函数通过从第一个非空列读取数据的末尾来自动检测列的范围,并为每列创建一个变量。 例子: 或者,通过使用Excel列字母或数字标识开始列和结束列来指定范围。 使用指定的列范围,import函数通过从第一个非空行读取到数据末尾或页脚范围来自动检测行范围。 属性中指定的列数必须匹配 例子: |
起始行号
|
使用正标量行索引指定包含数据的第一行。 使用指定的行索引,导入函数通过从指定的第一行读入到数据的末尾或页脚范围来自动检测数据的范围。 例子: |
Excel的命名范围
|
在Excel中,可以创建名称来标识电子表格中的范围。例如,您可以选择电子表格的一个矩形部分并调用它 例子: |
未指定或为空
|
如果未指定,导入功能将自动检测使用范围。 例子: 注意:使用范围指电子表格中实际包含数据的矩形部分。导入函数通过修改不包含数据的任何开头和结尾行和列来自动检测所使用的范围。仅为空白的文本被认为是数据,并在使用的范围内捕获。 |
数据类型:字符
|字符串
|双
TextType
- - - - - -导入文本数据的类型
“字符”
|“字符串”
类型,指定为逗号分隔的对,由“TextType”
,要么“字符”
或“字符串”
.
“字符”
-将文本数据作为字符向量导入MATLAB。“字符串”
-将文本数据导入MATLAB作为字符串数组。
例子:“TextType”、“生物炭”
DatetimeType
- - - - - -类型用于导入日期和时间数据
“datetime”
(默认)|“文本”
|“exceldatenum”
(只适用于电子表格文件)
类型导入的日期和时间数据,指定为逗号分隔的对,由“DatetimeType”
其中一个价值观是:“datetime”
,“文本”
,或“exceldatenum”
.的值“exceldatenum”
仅适用于电子表格文件,对文本文件无效。
价值 | 导入日期和时间数据的类型 |
---|---|
“datetime” |
MATLAB 有关更多信息,请参见 |
“文本” |
如果
|
“exceldatenum” |
Excel序列号 连续日期编号是与给定参考日期之后的天数相等的单个数字。Excel序列号与MATLAB序列号使用不同的参考日期。有关Excel日期的详细信息,请参见 |
数据类型:字符
|字符串
TreatAsMissing
- - - - - -要解释为缺失数据的文本
特征向量|字符串标量|字符向量的单元格数组|字符串数组
要解释为缺失数据的文本,指定为字符向量、字符串标量、字符向量的单元格数组或字符串数组。
例子:TreatAsMissing,{“NA”,“TBD”}
指示导入函数处理的任何事件NA
或TBD
作为一个缺失的领域。
数据类型:字符
|字符串
|细胞
ReadVariableNames
- - - - - -将第一行读为变量名
真正的
|假
将第一行读取为变量名,由逗号分隔的对组成“ReadVariableNames”
,要么真正的
或假
.如果未指定,导入函数将自动检测变量名的存在。
指示器 |
描述 |
---|---|
|
当要读取的区域的第一行包含表的变量名时使用。导入函数为中的每一列创建一个变量,并使用检测到的变量名 |
|
当要读取的区域的第一行包含表中的数据时使用。导入函数创建表单的默认变量名 |
未指明的 | 如果不指定,导入函数将自动检测真正的 或假 并相应地进行。 |
当你指定ReadVariableNames
除了名值对选择
,则导入函数执行如下操作。
如果
ReadVariableNames
设置为真正的
,然后导入函数从指定文件中读取变量名VariableNamesRange
或者是VariableNamesLine
导入选项对象的属性。如果
ReadVariableNames
设置为假
,然后导入函数从VariableNames
导入选项对象的属性。
数据类型:逻辑
RowTimes
- - - - - -行乘以变量
变量名|时间向量
行乘以变量,指定为逗号分隔的对,由“RowTimes”
还有一个变量名或者时间向量。
变量名称必须是字符向量或字符串标量,包含输入表中包含的任何变量的名称
datetime
或持续时间
值。由变量名指定的变量为行提供行时间标签。输入表的其余变量成为时间表的变量。时间向量必须是a
datetime
向量还是a持续时间
向量。时间向量的元素数必须等于输入表的行数。时间向量中的时间值不需要是唯一的、排序的或规则的。输入表的所有变量都成为时间表的变量。
数据类型:字符
|字符串
|datetime
|持续时间
SampleRate
- - - - - -行次数的采样率
正数值标量
行次数的采样率,指定为逗号分隔的对,由“SampleRate”
和一个正的标量。采样率是输出时间表时间向量的每秒采样数(Hz)。
当你使用“SampleRate”
若要指定时间表的行时间向量,默认的第一行时间(开始时间)为0秒。要设置开始时间而不是0,请指定“开始时间”
名称-值对。
数据类型:双
步伐
- - - - - -行时间之间的时间步长
时间常数|calendarDuration标量
行时间之间的时间步长,指定为逗号分隔的对,由“步伐”
和duration标量或calendarDuration标量。的值“步伐”
参数指定连续行次数之间的时间长度。导入函数使用时间步长值来计算有规律间隔的行时间。
当你使用“步伐”
若要指定时间表的行时间向量,默认的第一行时间(开始时间)为0秒。要设置开始时间而不是0,请指定“开始时间”
名称-值对。
如果“步伐”
是日历持续时间值,则“开始时间”
必须为datetime值。
数据类型:持续时间
|calendarDuration
开始时间
- - - - - -行次数的开始时间
datetime标量|时间常数
行时间的开始时间,指定为逗号分隔的对,由开始时间
和datetime标量或duration标量。
若要为时间表定义时间向量,请使用“开始时间”
用任何一个“SampleRate”
或者是“步伐”
名称-值对参数。
开始时间的数据类型决定了行时间向量的数据类型。
如果开始时间为datetime值,则时间表的行时间为datetime值。
如果开始时间是一个持续时间值,那么行时间就是持续时间。
数据类型:datetime
|持续时间
VariableNamingRule
- - - - - -标记以保留变量名
“修改”
(默认)|“保存”
标记以保留变量名,指定为任意一种“修改”
或“保存”
.
“修改”
-转换无效的变量名(由isvarname
函数)到有效的MATLAB标识符。“保存”
-保留不是有效MATLAB标识符的变量名,例如包含空格和非ascii字符的变量名。
从R2019b开始,变量名和行名可以包含任何字符,包括空格和非ascii字符。此外,他们可以从任何字符开始,而不仅仅是字母。变量名和行名不必是有效的MATLAB标识符(由isvarname
功能)。若要保留这些变量名和行名,请设置值VariableNamingRule
来“保存”
.的值时,变量名不会刷新VariableNamingRule
从“修改”
来“保存”
.
数据类型:字符
|字符串
分隔符
- - - - - -字段分隔符字符
特征向量|字符串标量|字符向量的单元格数组|字符串数组
分隔文本文件中的字段分隔符字符,指定为字符向量、字符串标量、字符向量的单元格数组或字符串数组。
例子:“分隔符”,“|”
例子:“分隔符 ',{';','*'}
数据类型:字符
|字符串
|细胞
空格
- - - - - -将字符视为空白
特征向量|字符串标量
要作为空白处理的字符,指定为包含一个或多个字符的字符向量或字符串标量。
例子:“空白”、“_”
例子:“空白”、“? !”
LineEnding
- - - - - -行尾字符
{' \ n ', ' \ r ', ' \ r \ n '}
(默认)|特征向量|字符串标量|字符向量的单元格数组|字符串数组
行尾字符,指定为字符向量、字符串标量、字符向量的单元格数组或字符串数组。
例子:' LineEnding ', ' \ n '
例子:“LineEnding”、“\ r \ n”
例子:LineEnding,{‘\ b’,‘:’}
数据类型:字符
|字符串
|细胞
CommentStyle
- - - - - -评论风格
特征向量|字符串标量|字符向量的单元格数组|字符串数组
注释的样式,指定为字符向量、字符串标量、字符向量的单元格数组或字符串数组。
例如,要忽略同一行上百分号后面的文本,请指定CommentStyle
作为“%”
.
例子:CommentStyle,{“/ *”}
数据类型:字符
|字符串
|细胞
编码
- - - - - -字符编码方案
“utf - 8”
|“iso - 8859 - 1”
|“windows - 1251”
|“windows - 1252”
|……
与文件关联的字符编码方案,指定为逗号分隔的对,由“编码”
而且“系统”
或标准字符编码方案名称。如果不指定任何编码,则readtimetable
函数在读取文件时使用自动字符集检测来确定编码。
如果您指定“编码”
参数之外的导入选项,则readtimetable
函数使用指定的值“编码”
,覆盖导入选项中定义的编码。
例子:“编码”,“utf - 8”
使用UTF-8作为编码。
例子:“编码”、“系统”
使用系统默认编码。
数据类型:字符
|字符串
DurationType
- - - - - -持续时间数据的输出数据类型
“持续时间”
(默认)|“文本”
文本文件中持续时间数据的输出数据类型,指定为由逗号分隔的对组成“DurationType”
,要么“持续时间”
或“文本”
.
价值 | 导入时长数据的类型 |
---|---|
“持续时间” |
MATLAB 有关更多信息,请参见 |
“文本” |
如果
|
数据类型:字符
|字符串
DateLocale
- - - - - -阅读日期的地点
特征向量|字符串标量
用于读取日期的区域设置,指定为逗号分隔的对,由“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
名称-值对用于区分数字的整数部分和小数部分。
当转换为整数数据类型时,具有小数部分的数字将四舍五入到最接近的整数。
例子:如果名称-值对指定为“DecimalSeparator”、“,”
,然后导入函数导入文本“14159”
作为数字3.14159
.
数据类型:字符
|字符串
ThousandsSeparator
- - - - - -表示千位分组的字符
特征向量|字符串标量
表示数值变量中千位分组的字符,指定为字符向量或字符串标量。数千个分组字符充当视觉分隔符,在每三个位置值处对数字分组。方法中指定的字符ThousandsSeparator
名称-值对来解释导入的数字。
例子:如果名称-值对指定为“ThousandsSeparator”、“,”
,然后导入函数导入文本“1234000”
作为1234000
.
数据类型:字符
|字符串
TrimNonNumeric
- - - - - -删除非数字字符
假
(默认)|真正的
从指定为逻辑变量的数值变量中移除非数值字符真正的
或假
.
例子:如果名称-值对指定为“TrimNonNumeric”,真的
,则导入函数读取“500美元/ -”
作为500
.
数据类型:逻辑
ConsecutiveDelimitersRule
- - - - - -过程来处理连续的分隔符
“分裂”
|“加入”
|“错误”
过程处理分隔文本文件中的连续分隔符,该分隔符指定为本表中的值之一。
连续分隔符规则 | 行为 |
---|---|
“分裂” |
将连续的分隔符拆分为多个字段。 |
“加入” |
将分隔符合并为一个分隔符。 |
“错误” |
返回错误并中止导入操作。 |
数据类型:字符
|字符串
LeadingDelimitersRule
- - - - - -过程来管理前导分隔符
“保持”
|“忽略”
|“错误”
过程来管理分隔文本文件中的前导分隔符,该分隔符作为本表中的值之一指定。
前导分隔符规则 | 行为 |
---|---|
“保持” |
保留分隔符。 |
“忽略” |
忽略分隔符。 |
“错误” |
返回错误并中止导入操作。 |
TrailingDelimitersRule
- - - - - -过程来管理尾随分隔符
“保持”
|“忽略”
|“错误”
过程来管理带分隔符的文本文件中的尾随分隔符,该分隔符作为本表中的值之一指定。
前导分隔符规则 | 行为 |
---|---|
“保持” |
保留分隔符。 |
“忽略” |
忽略分隔符。 |
“错误” |
返回错误并中止导入操作。 |
表
- - - - - -读取的表
”
空字符数组(默认)|特征向量|字符串标量|正标量整数
要从中读取的工作表,指定为空字符数组、字符向量或包含工作表名称的字符串标量,或表示工作表索引的正标量整数。属性指定的值表
属性时,导入函数的行为如表中所述。
规范 | 行为 |
---|---|
” (默认) |
从第一个工作表导入数据。 |
的名字 | 从匹配的工作表名称导入数据,而不管工作表在电子表格文件中的顺序如何。 |
整数 | 从表中导入由整数表示的位置的数据,而不管电子表格文件中的表名如何。 |
数据类型:字符
|字符串
|单
|双
UseExcel
- - - - - -标记启动Microsoft Excel for Windows实例
假
(默认)|真正的
的实例开始的标志Microsoft Excel当读取电子表格数据时,指定为逗号分隔的对,由“UseExcel”
,要么真正的
,或假
.
您可以设置“UseExcel”
参数设置为以下值之一:
真正的
—导入函数在读取文件时启动Microsoft Excel实例。假
—导入函数在读取文件时,不会启动Excel实例。在此模式下操作时,导入函数功能在支持文件格式和交互特性(如公式和宏)方面有所不同。金宝app
UseExcel |
|
|
---|---|---|
金宝app支持的文件格式 |
|
|
金宝app支持交互式特性,如公式和宏 |
是的 |
没有 |
从Windows平台上的电子表格文件读取时,如果要启动的实例Microsoft Excel,然后设置“UseExcel”
参数真正的
.
AttributeSuffix
- - - - - -属性后缀
“属性”
(默认)|特征向量|字符串标量
属性后缀,指定为逗号分隔的对,由“AttributeSuffix”
或字符向量或字符串标量。此参数指定读取函数附加到与输入XML文件中的属性对应的所有表变量的后缀。如果您没有指定“AttributeSuffix”
,则读取函数默认为追加后缀“属性”
到与输入XML文件中的属性对应的所有变量名。
例子:“AttributeSuffix”、“_att”
ImportAttributes
- - - - - -导入属性
逻辑1
或真正的
(默认)|逻辑0
或假
导入属性,指定为逗号分隔的对,由“ImportAttributes”
,要么1
(真正的
)或0
(假
).如果你指定假
,则读取函数不会将输入文件中的XML属性作为输出表中的变量导入。
例子:“ImportAttributes”,假的
RowNodeName
- - - - - -表行XML节点名称
特征向量|字符串数组
表行XML节点名,指定为由逗号分隔的对组成“RowNodeName”
或字符向量或字符串标量。此参数指定描述输出表行的XML节点名。
例子:“RowNodeName”、“XMLNodeName”
RowSelector
- - - - - -表行XPath表达式
特征向量|字符串标量
表行XPath表达式,指定为字符向量或字符串标量,读取函数使用它来选择输出表中的各个行。您必须指定RowSelector
作为有效的XPath 1.0版表达式。
例子:“RowSelector”、“RootNode / ChildNode”
VariableNodeNames
- - - - - -表变量XML节点名
字符向量的单元格数组|字符串数组
表变量XML节点名,指定为由逗号分隔的对组成“VariableNodeNames”
或者是字符向量的单元格数组,或者是字符串数组。此参数指定XML节点名,读取函数使用该名称标识要作为输出表中的变量读取的XML节点。
例子:VariableNodeNames,{‘XMLNodeName1’,‘XMLNodeName2}
例子:“VariableNodeNames”、“XMLNodeName”
例子:“VariableNodeNames”,(“XMLNodeName1”、“XMLNodeName2”)
VariableSelectors
- - - - - -表变量XPath表达式
字符向量的单元格数组|字符串数组
表变量XPath表达式,指定为字符向量的单元格数组或读取函数用来选择表变量的字符串数组。您必须指定VariableSelectors
作为有效的XPath 1.0版表达式。
例子:VariableSelectors, {' / RootNode / ChildNode '}
例子:‘VariableSelectors’,”/ RootNode / ChildNode”
例子:“VariableSelectors”,(“/ RootNode / ChildNode1”,“/ RootNode / ChildNode2”)
TableNodeName
- - - - - -表XML节点名
特征向量|字符串标量
表XML节点名,指定为逗号分隔的对,由“TableNodeName”
或字符向量或字符串标量。该参数指定了读取函数应该读取到表中的输入结构中的节点。
例子:“TableNodeName”、“节点名的
TableSelector
- - - - - -表数据XPath表达式
特征向量|字符串标量
表数据XPath表达式,指定为字符向量或字符串标量,读取函数使用它来选择输出表数据。您必须指定TableSelector
作为有效的XPath 1.0版表达式。
例子:“TableSelector”、“RootNode / ChildNode”
VariableUnitsSelector
- - - - - -变量单位XPath表达式
特征向量|字符串标量
变量单位XPath,指定为字符向量或字符串标量,读取函数使用它来选择表变量单位。您必须指定VariableUnitsSelector
作为有效的XPath 1.0版表达式。
例子:“VariableUnitsSelector”、“RootNode / ChildNode”
VariableDescriptionsSelector
- - - - - -变量描述XPath表达式
特征向量|字符串标量
变量描述XPath表达式,指定为字符向量或字符串标量,读取函数使用它来选择表变量描述。您必须指定VariableDescriptionsSelector
作为有效的XPath 1.0版表达式。
例子:“VariableDescriptionsSelector”、“RootNode / ChildNode”
RepeatedNodeRule
- - - - - -过程来处理重复的XML节点
“addcol”
(默认)|“忽略”
|“错误”
过程来处理表的给定行中重复的XML节点,指定为“addcol”
,“忽略”
,或“错误”
.
重复节点规则 |
行为 |
---|---|
“addcol” |
为表中变量标题下的重复节点添加列。指定的值 |
“忽略” |
跳过导入重复的节点。 |
“错误” |
显示错误消息并中止导入操作。 |
例子:“RepeatedNodeRule”、“忽略”
RegisteredNamespaces
- - - - - -已注册的XML名称空间前缀集
字符串数组
一组已注册的XML名称空间前缀,指定为逗号分隔的对,由RegisteredNamespaces
和一个前缀数组。读取函数在计算XML文件上的XPath表达式时使用这些前缀。将命名空间前缀及其关联的url指定为Nx2字符串数组。RegisteredNamespaces
也可以在计算由选择器名称-值参数指定的XPath表达式时使用,例如StructSelector
为readstruct
,或VariableSelectors
为readtable
而且readtimetable
.
默认情况下,读取函数自动检测要注册的名称空间前缀,以便在XPath求值中使用,但是您也可以使用RegisteredNamespaces
名称-值参数。当XML节点有名称空间URL,但在XML文件中没有声明名称空间前缀时,可以注册一个新的名称空间前缀。
例如,计算XML文件上的XPath表达式example.xml
不包含名称空间前缀的。指定“RegisteredNamespaces”
作为[" myprefix ", " //www.tatmou.com ")
要分配前缀myprefix
到URL//www.tatmou.com
.
T = readtable("example.xml", "VariableSelector", "/myprefix:Data",…"RegisteredNamespaces", ["myprefix", "//www.tatmou.com/es/"])
例子:“RegisteredNamespaces”,(“myprefix”、“//www.tatmou.com”)
提示
使用XPath选择器指定要导入XML输入文档的哪些元素。例如,假设您想导入XML文件
myFile.xml
,其结构如下:<数据> <表类别= "的" > < var > 1 < / var > < var > 2 < / var > < /表> <表类别= "十" > < var > 10 < / var > < var > 20 < / var > < /表> > < /数据
VariableSelectors
或TableSelector
.选择操作 语法 例子 结果 选择名称与要选择的节点匹配的每个节点,而不管其在文档中的位置。 在名称前加上两个斜杠( //
).数据=可读数据(“myFile.xml”,“VariableSelectors”,' / / var ')
数据= 4×1表var ___ 1 2 10 20
读取属于元素节点的属性的值。 在属性前加上@号( @
).数据=可读数据(“myFile.xml”,“VariableSelectors”,' / /表/ @category ')
数据表categoryAttribute = 2×1 _________________ " 的”“十”
在节点集中选择一个特定的节点。 在方括号中提供要选择的节点的索引( []
).数据=可读数据(“myFile.xml”,“TableSelector”,/ /表[1]”)
数据= 2×1表var ___ 1 2
指定操作的优先级。 在要首先求值的表达式周围添加圆括号。 数据=可读数据(“myFile.xml”,“VariableSelectors”,/ /表/ var[1]”)
10 . Data = 2×1 table var ___ 1
数据=可读数据(“myFile.xml”,“VariableSelectors”,”(/ /表/ var)[1]”)
数据=表var ___
版本历史
在R2019a中引入
Abrir比如
Tiene una versión modificada de este ejemplo。¿Desea abrir este ejemplo con sus modificaciones?
MATLAB突击队
Ha hecho clic en unenlace que对应一个este commando de MATLAB:
弹射突击队introduciéndolo en la ventana de commandos de MATLAB。Los navegadores web no permission comandos de MATLAB。
您也可以从以下列表中选择一个网站:
如何获得最佳的网站性能
选择中国站点(中文或英文)以获得最佳站点性能。其他MathWorks国家站点没有针对您所在位置的访问进行优化。