主要内容

SpreadSheetimportOptions.

为电子表格导入选项对象

描述

一个SpreadSheetimportOptions.对象使您可以指定MATLAB的方式®从电子表格文件导入表格数据。该对象包含控制数据导入过程的属性,包括处理错误和缺少数据。

创建

你可以创建一个SpreadSheetimportOptions.通过使用任何一个侦探功能或者SpreadSheetimportOptions.功能(此处描述):

  • 侦探根据指定的电子表格的内容来检测和填充导入属性文件名

    opts = detectimportoptions(文件名);

  • SpreadSheetimportOptions.根据您的导入需求定义导入属性。

描述

例子

选择= spreadsheetImportOptions创造一个SpreadSheetimportOptions.具有一个变量的对象。

例子

opts = SpreadSheetimportOptions('numvariables',numvars.)中指定的变量个数创建对象numvars.

例子

opts = SpreadSheTimportOptions(___,名称,值)指定附加的特性SpreadSheetimportOptions.对象使用一个或多个名称值对参数。

输入参数

展开全部

变量数,指定为正标量整数。

特性

展开全部

变量属性

变量名称,指定为字符向量或字符串数​​组的单元格数组。的VariableNames属性包含导入变量时要使用的名称。

如果数据包含N变量,但没有指定变量名称,那么VariableNames属性包含{‘Var1’,‘Var2’,……,“VarN”}

要支持万博1manbetx无效的MATLAB标识符作为变量名称,例如包含空格和非ASCII字符的变量名称,请设置值variablenamingrule.'保存'

例子:opts.variablenames.返回当前(检测到的)变量名称。

例子:opts.variablenames(3)= {'height'}将第三个变量的名称更改为高度

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

标志以保留变量名称,指定为逗号分隔的配对组成variablenamingrule.和任何一种“修改”或者'保存'

  • “修改”- 转换无效的变量名称(由此确定)isvarname.功能)到有效的MATLAB标识符。

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

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

数据类型:char|细绳

变量的数据类型,指定为字符向量的单元格数组,或包含一组有效数据类型名称的字符串数组。的VariableTypes属性指定导入变量时使用的数据类型。

更新VariableTypes属性,使用setvartype函数。

例子:选择。VariableTypes返回当前变量数据类型。

例子:选择= setvartype(选择“高度”,{“双重”})更改变量的数据类型高度双倍的

要导入的变量子集,指定为字符向量、字符串标量、字符向量的单元数组、字符串数组或数字索引数组。

SelectedVariableNames必须是包含在内的名称子集VariableNames财产。默认,SelectedVariableNames控件中的所有变量名VariableNames属性,这意味着导入所有变量。

使用SelectedVariableNames属性只导入感兴趣的变量。属性指定变量的子集SelectedVariableNames属性和使用readtable仅导入该子集。

要支持万博1manbetx无效的MATLAB标识符作为变量名称,例如包含空格和非ASCII字符的变量名称,请设置值variablenamingrule.'保存'

例子:opts.selectedvariablenames = {'height','lastname'}只选择两个变量,高度,用于进口操作。

例子:opts.selectedvariablenames = [1 5]仅选择两个变量,第一个变量和第五变量,用于导入操作。

例子:t = readtable(文件名,opts)对象中指定的变量返回一个表SelectedVariableNames财产的财产选择目的。

数据类型:uint16|UINT32|UINT64|char|细绳|细胞

键入特定的变量导入选项,作为变量导入选项对象数组返回。数组包含对应于指定的每个变量的对象VariableNames财产。数组中的每个对象都包含支持使用特定数据类型导入数据的属性。万博1manbetx

变量选项支持这些数据类型:数字,文万博1manbetx本,逻辑,约会时间, 或者分类

要查询变量的当前(或检测到)选项,请使用getVaropts.函数。

要为变量设置和自定义选项,请使用setvaropts函数。

例子:选择。VariableOptions的集合。可变端口选项对象,对应于数据中的每个变量的对象。

例子:GetVaropts(选择,'高度')返回可变端口选项对象高度多变的。

例子:选择= setvaropts(选择、“高度”、“FillValue”,0)设置fillvalue.变量的属性高度0

位置属性

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

规格 行为
(默认) 从第一张作为导入数据。
名称 无论电子表格文件中的纸张订单如何导入匹配的工作表名称。
整数 无论电子表格文件中的工作表名称如何导入由整数的位置的页面导入数据。

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

要导入数据的位置,指定为字符向量、字符串标量、字符向量的单元数组、字符串数组、正标量整数或N-经过-2正数标量整数。指定数据范围使用其中一种形式。

由此指定 行为

'细胞'或者n

起始牢房或起始行

使用Excel指定数据的起始小区®A1符号。例如,A5是列中的单元格的标识符一个和行5

使用启动单元格,导入函数通过在起始单元上的导入并在最后一个空行或页脚范围内开始导入来自动检测数据的范围。

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

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

例子:的A5或者5

角落1:Corner2.

矩形范围

使用矩形范围形式指定要读取的确切范围,其中Corner1Corner2是两个相对的角落,用于定义要读取的区域。

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

列数必须与指定的数字匹配numvarialbles.财产。

例子:'A5:K50'

row1:row2.或者第1列:Column2.

行范围或列范围

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

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

例子:“5:500”

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

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

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

例子:'A:K'

(n1 n2;n3陶瓷;……)

多行范围

指定多个行范围用一个读N-经过-2数组包含N不同的行范围。

有效的多行范围数组必须:

  • 在越来越多的顺序中指定行范围,即数组中指定的第一行范围在另一行范围之前将显示在文件中。

  • 仅包含非重叠行范围。

使用INF.仅支持指示数字数万博1manbetx组中的最后一个范围,指定多行范围。例如,[1 3;5 6;8款]

例子:[1 3;5 6;8款]

未指定或空的

不要获取任何数据。

例子:

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

行名称的位置,指定为字符向量,字符串标量,正标量整数或空字符数组。指定rownamerange.作为此表中的值之一。

由此指定 行为

'细胞'

使用Excel指定数据的起始小区A1符号。例如,A5是列中的单元格的标识符一个和行5

导入函数标识数据中每个变量的名称。

例子:的A5

角落1:Corner2.

矩形范围

使用矩形范围形式指定要读取的确切范围,其中Corner1Corner2是两个相对的角落,用于定义要读取的区域。

包含的行数rownamerange.必须匹配数据行数,并指示的范围rownamerange.必须仅跨越一列。

例子:“A5: A50”

row1:row2.

行范围

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

行名必须在单个列中。

例子:'5:50'

n

数字索引

使用正标量列索引指定包含行名称的列。

例子:5

未指定或空的

指示没有行名。

例子:

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

变量名称的位置,指定为字符向量,字符串标量,正标量整数或空字符数组。指定VariableNamesRange作为此表中的值之一。

由此指定 行为

'细胞'

使用Excel指定数据的起始小区A1符号。例如,A5是列中的单元格的标识符一个和行5

导入函数读取数据中每个变量的名称。

例子:的A5

角落1:Corner2.

矩形范围

使用矩形范围形式指定要读取的确切范围,其中Corner1Corner2是两个相对的角落,用于定义要读取的区域。

列数必须与指定的数字匹配numvarialbles.属性,且范围必须仅跨一行。

例子:'A5:K5'

row1:row2.

行范围

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

必须是单行。

例子:'5:5'

n

数字索引

使用正标量行索引指定包含变量名称的行。

例子:5

未指定或空的

表示没有变量名称。

例子:

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

可变描述的位置,指定为字符向量,字符串标量,正标量整数或空字符数组。指定variabledescrectionrange.作为此表中的值之一。

由此指定 行为

'细胞'

使用Excel指定数据的起始小区A1符号。例如,A5是列中的单元格的标识符一个和行5

导入函数读取数据中每个变量的描述。

例子:的A5

角落1:Corner2.

矩形范围

使用矩形范围形式指定要读取的确切范围,其中Corner1Corner2是两个相对的角落,用于定义要读取的区域。

列数必须与指定的数字匹配numvarialbles.属性,且范围必须仅跨一行。

例子:'A5:K5'

row1:row2.

行范围

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

必须是单行。

例子:'5:5'

n

数字索引

使用正标量行索引指定包含描述的行。

例子:5

未指定或空的

表示没有可变描述。

例子:

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

可变单元的位置,指定为字符向量,字符串标量,正标量整数或空字符数组。指定VariableUnitsRange作为此表中的值之一。

由此指定 行为

'细胞'

使用Excel指定数据的起始小区A1符号。例如,A5是列中的单元格的标识符一个和行5

导入函数为数据中的每个变量读取一个单元。

例子:的A5

角落1:Corner2.

矩形范围

使用矩形范围形式指定要读取的确切范围,其中Corner1Corner2是两个相对的角落,用于定义要读取的区域。

列数必须与指定的数字匹配numvarialbles.属性,且范围必须仅跨一行。

例子:'A5:K5'

row1:row2.

行范围

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

必须是单行。

例子:'5:5'

n

数字索引

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

例子:5

未指定或空的

表示没有可变单位。

例子:

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

替换规则

过程来管理丢失的数据,指定为该表中的一个值。

失踪的规则 行为
'充满'

类的内容替换缺失的数据fillvalue.财产。

fillvalue.属性在可变端口选项正在导入变量的对象。有关访问的更多信息fillvalue.财产,参见getVaropts.

'错误' 停止导入并显示显示缺失的记录和字段的错误消息。
'奥马克' 省略包含缺失数据的行。
'omitvar' 省略包含缺失数据的变量。

例子:选择opts.missingrule ='欧洲';

数据类型:char|细绳

过程要处理导入错误,指定为此表中的值之一。

导入错误规则 行为
'充满'

类的内容替换发生错误的数据fillvalue.财产。

fillvalue.属性在可变端口选项正在导入变量的对象。有关访问的更多信息fillvalue.财产,参见getVaropts.

'错误' 停止导入并显示显示错误导致记录和字段的错误消息。
'奥马克' 省略发生错误的行。
'omitvar' 省略发生错误的变量。

例子:opts.importerrule ='omitvar';

数据类型:char|细绳

对象的功能

getVaropts. 获取变量导入选项
setvaropts 设置变量导入选项
setvartype 设置变量数据类型
预习 使用导入选项预览八行文件

例子

全部折叠

创建一个导入选项对象以从文件中读取一个变量patients.xls

初始化A.SpreadSheetimportOptions.对象,指定变量名称,变量类型和数据启动单元格。然后,使用预习使用导入选项对象来预览数据。

opts = SpreadsheetimportOptions;opts.variablenames =.“姓”;opts.variabletypes =.'分类';opts.datarange =.“A2”;预习(“patients.xls”,选择)
ans =.8×1表Lastname ________史密斯johnson威廉姆斯琼斯·棕色戴维斯米勒威尔逊

从文件导入变量。

Onevar = Readtable(“patients.xls”、选择);谁oneVar
Name Size Bytes Class Attributes oneVar 100x1 12709 table

创建导入选项对象以读取多个变量patients.xls

基于文件的内容,定义变量的数量,变量名称,变量类型和数据启动位置。

numvars = 7;varnames = {“姓”,'性别','年龄','地点','高度',“重量”,“吸烟者”};vartypes = {'char','分类','int32','char',“双”,“双”,“逻辑”};datastartloc =.“A2”;

初始化导入选项对象选择使用SpreadSheetimportOptions.函数和变量信息。

opts = SpreadSheTimportOptions(“NumVariables”,numvars,......'variablenames'varNames,......'variabletypes',vartypes,......'数据范围',datastartloc);

控件预览数据预习使用导入选项函数。

预习(“patients.xls”,选择)
ans =.8×7表Lastname性别年龄位置位置高度减肥____________ ________ ______________________________________________________________ _ _ _ _ _ _ _ johnson'}男性43 {'va医院'} 69 163 false {'威廉姆斯“女性38 {St.玛丽的医疗中心'} 64 131 false {'jones'}女性40 {'va医院'} 67 133 false {'brown'}女性49 {'县普通医院'} 64 119 false {'davis'}女性46 {'英石。Mary's Medical Center'} 68 142 False {'Miller'}女性33 {'Va Hospital'} 64 142 True {'Wilson'}男性40 {'VA Hospital'} 68 180 False

使用导入数据readtable

t = readtable(“patients.xls”、选择);谁T
名称大小字节类属性T 100x7 30563表

尖端

  • 介绍:

    • R2016b -SpreadSheetimportOptions.对象

    • R2018B -SpreadSheetimportOptions.功能

另请参阅

|