主要内容

SpreadSheetimportOptions.

导入电子表格的选项对象

展开所有页面

描述

一种SpreadSheetimportOptions.对象使您能够指定如何使用MATLAB®从电子表格文件导入表格数据。该对象包含控制数据导入过程的属性，包括处理错误和缺少数据。

创建

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

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

    opts = detectimportoptions（文件名）;

  • 用SpreadSheetimportOptions.要根据导入要求定义导入属性。

句法

opts = SpreadSheetimportOptions.
opts = SpreadsheeTimportOptions（'numvariables'，numvars）
opts = SpreadSheTimportOptions（___、名称、值)

描述

例子

opts = SpreadSheetimportOptions.创建一个SpreadSheetimportOptions.具有一个变量的对象。

例子

opts = SpreadSheetimportOptions（'numvariables'，numvars.）使用指定的变量数创建对象numvars.。

例子

opts = SpreadSheTimportOptions（___那名称，价值）指定其他特性为了SpreadSheetimportOptions.对象，使用一个或多个名称-值对参数。

输入参数

全部展开

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

属性

全部展开

变量属性

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

如果数据包含N变量，但没有指定变量名称，那么variablenames.属性包含{'var1'，'var2'，...，'varn'}。

要支持金宝app无效的MATLAB标识符作为变量名，例如包含空格和非ascii字符的变量名，请设置variablenamingrule.至“保存”。

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

例子:opts.variablenames（3）= {'height'}将第三种变量的名称更改为高度。

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

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

  • '调整'-转换无效的变量名(由isvarname.函数)到有效的MATLAB标识符。

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

从R2019B开始，变量名称和行名可以包含任何字符，包括空格和非ASCII字符。此外，它们可以从任何角色开始，而不仅仅是字母。变量和行名不必是有效的matlab标识符（由此确定）isvarname.功能）。要保留这些变量名称和行名称，请设置值variablenamingrule.至“保存”。

数据类型:字符|字符串

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

更新variabletypes.财产，使用setVartype.功能。

例子:opts.variabletypes.返回当前变量数据类型。

例子:opts = setvartype（选择，'height'，{'double'}）更改变量的数据类型高度至双。

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

sedicentvariablenames.必须是包含在内的名称子集variablenames.财产。默认，sedicentvariablenames.包含来自的所有变量名称variablenames.属性，这意味着导入所有变量。

使用sedicentvariablenames.属性只进口感兴趣的变量。使用该变量的子集指定sedicentvariablenames.财产和使用可阅读只导入那个子集。

要支持金宝app无效的MATLAB标识符作为变量名，例如包含空格和非ascii字符的变量名，请设置variablenamingrule.至“保存”。

例子:opts.selectedvariablenames = {'height'，'lastname'}仅选择两个变量，高度和姓，用于导入操作。

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

例子:t = readtable（文件名，opts）返回仅包含在中指定的变量的表sedicentvariablenames.财产的财产选择目的。

数据类型:uint16|uint32|UINT64|字符|字符串|细胞

键入特定的变量导入选项，作为变量导入选项对象数组返回。数组包含对应于指定的每个变量的对象variablenames.财产。阵列中的每个对象都包含支持使用特定数据类型导入数据的属性。金宝app

变量选项支持这些数据类型：数字，文金宝app本，逻辑那约会时间， 或者分类。

要查询变量的当前（或检测到）选项，请使用getvaropts功能。

要设置和自定义变量的选项，请使用setvaropts.功能。

例子:opts.variableOptions.返回一系列可变端口选项对象，对应于数据中的每个变量的对象。

例子:GetVaropts（选择，'高度'）返回可变端口选项对象的高度多变的。

例子:opts = setvaropts（opts，'height'，'fillvalue'，0）设置fillvalue.属性。高度至0.。

位置属性

从读取的工作表，指定为空字符数组，包含纸张名称的字符向量或字符串标量，或表示表索引的正标量整数。基于指定的值床单属性，则导入函数的行为如表中所述。

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

数据类型:字符|字符串|单身的|双

要导入的数据的位置，指定为字符向量，字符串标量，字符向量单元阵列，字符串数组，正标量整数或一个N——- - - - - -2正标量整数数组。指定DataRange使用其中一种形式。

指定的 行为

'细胞'或者N.

起始牢房或起始行

使用Excel指定数据的起始小区®A1符号。例如，A5单元格的标识符是否在列的交点一种和排5.。

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

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

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

例子:'a5'或者5.

'角落1：Corner2.'

矩形范围

指定使用矩形范围形式读取的精确范围，其中角落1.和角落2.是两个对立的角落，定义了该地区的阅读。

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

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

例子:'A5：K50'

'第一行:Row2'或者'Column1: Column2'

行范围或列范围

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

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

例子:'5：500'

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

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

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

例子:'A：K'

[n1 n2;n3 n4; ...]

多个行范围

指定多行范围与…一起阅读N——- - - - - -2数组包含N不同的行范围。

一个包含多个行范围的有效数组必须:

  • 按递增顺序指定行范围，即在数组中指定的第一个行范围在其他行范围之前出现在文件中。

  • 仅包含非重叠行范围。

用于INF.仅支持指示数字数金宝app组中的最后一个范围，指定多行范围。例如，[1 3;5 6;8款]。

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

''

不明或空

不要获取任何数据。

例子:''

数据类型:字符|字符串|细胞|单身的|双

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

指定的 行为

'细胞'

使用Excel指定数据的起始小区A1符号。例如，A5单元格的标识符是否在列的交点一种和排5.。

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

例子:'a5'

'角落1：Corner2.'

矩形范围

指定使用矩形范围形式读取的精确范围，其中角落1.和角落2.是两个对立的角落，定义了该地区的阅读。

包含的行数rownamerange.必须匹配数据行数，以及rownamerange.必须仅跨越一列。

例子:'A5：A50'

'第一行:Row2'

行范围

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

行名称必须位于单个列中。

例子:'5:50'

N.

数字索引

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

例子:5.

''

不明或空

表示没有行名称。

例子:''

数据类型:字符|单身的|双

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

指定的 行为

'细胞'

使用Excel指定数据的起始小区A1符号。例如，A5单元格的标识符是否在列的交点一种和排5.。

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

例子:'a5'

'角落1：Corner2.'

矩形范围

指定使用矩形范围形式读取的精确范围，其中角落1.和角落2.是两个对立的角落，定义了该地区的阅读。

列数必须与指定的数字匹配NumVariables属性，范围必须仅跨越一行。

例子:“A5: K5”

'第一行:Row2'

行范围

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

必须是单行。

例子:“5”

N.

数字索引

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

例子:5.

''

不明或空

表示没有变量名称。

例子:''

数据类型:字符|单身的|双

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

指定的 行为

'细胞'

使用Excel指定数据的起始小区A1符号。例如，A5单元格的标识符是否在列的交点一种和排5.。

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

例子:'a5'

'角落1：Corner2.'

矩形范围

指定使用矩形范围形式读取的精确范围，其中角落1.和角落2.是两个对立的角落，定义了该地区的阅读。

列数必须与指定的数字匹配NumVariables属性，范围必须仅跨越一行。

例子:“A5: K5”

'第一行:Row2'

行范围

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

必须是单行。

例子:“5”

N.

数字索引

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

例子:5.

''

不明或空

表示没有变量描述。

例子:''

数据类型:字符|字符串|单身的|双

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

指定的 行为

'细胞'

使用Excel指定数据的起始小区A1符号。例如，A5单元格的标识符是否在列的交点一种和排5.。

导入函数读取数据中每个变量的单位。

例子:'a5'

'角落1：Corner2.'

矩形范围

指定使用矩形范围形式读取的精确范围，其中角落1.和角落2.是两个对立的角落，定义了该地区的阅读。

列数必须与指定的数字匹配NumVariables属性，范围必须仅跨越一行。

例子:“A5: K5”

'第一行:Row2'

行范围

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

必须是单行。

例子:“5”

N.

数字索引

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

例子:5.

''

不明或空

表示没有可变单元。

例子:''

数据类型:字符|字符串|单身的|双

替换规则

程序管理缺失数据，指定为此表中的值之一。

缺少规则 行为
“填满”

用内容替换丢失的数据fillvalue.财产。

这fillvalue.属性在可变端口选项要导入的变量的。有关访问fillvalue.财产，参见getvaropts。
'错误' 停止导入并显示显示缺失的记录和字段的错误消息。
'奥马克' 省略包含缺失数据的行。
“omitvar” 省略包含缺失数据的变量。

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

数据类型:字符|字符串

过程来处理导入错误，指定为该表中的一个值。

导入错误的规则 行为
“填满”

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

这fillvalue.属性在可变端口选项要导入的变量的。有关访问fillvalue.财产，参见getvaropts。
'错误' 停止导入并显示显示错误导致记录和字段的错误消息。
'奥马克' 省略发生错误的行。
“omitvar” 省略发生错误的变量。

例子:选择。ImportErrorRule =“omitvar”;

数据类型:字符|字符串

对象功能

getvaropts 获取变量导入选项
setvaropts. 设置变量导入选项
setVartype. 设置变量数据类型
预览 使用导入选项从文件中预览8行

例子

全部收缩

打开直播脚本

创建一个导入选项对象，从文件中读取一个变量患者.XLS.。

初始化A.SpreadSheetimportOptions.对象，指定变量名称、变量类型和数据起始单元格。然后,使用预览使用导入选项对象进行预览数据。

opts = SpreadsheetimportOptions;opts.variablenames ='姓';opts.variabletypes =.“分类”;选择。DataRange ='A2';预习（'患者xls'，选择）
ans =8×1表Lastname ________史密斯johnson威廉姆斯琼斯·棕色戴维斯米勒威尔逊

从文件导入变量。

Onevar = Readtable（'患者xls'，选择）;谁是onevar.
名称大小字节类属性onevar 100x1 12709表
打开直播脚本

创建一个导入选项对象以从中读取多个变量患者.XLS.。

根据文件的内容，定义变量的数量、变量名称、变量类型和数据起始位置。

numVars = 7;varNames = {'姓'那“性别”那'年龄'那'地点'那'高度'那'重量'那“抽烟”};varTypes = {'char'那“分类”那“int32”那'char'那'双倍的'那'双倍的'那'逻辑'};dataStartLoc ='A2';

初始化导入选项对象选择使用SpreadSheetimportOptions.功能和您的变量信息。

opts = SpreadSheTimportOptions（'numvarialbles'，numvars，......'variablenames'，varnames，......'variabletypes'varTypes,......'数据范围', dataStartLoc);

使用该数据预览数据预览使用导入选项。

预习（'患者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

使用导入数据可阅读。

T = readtable ('患者xls'，选择）;谁是T.
名称大小字节类属性t 100x7 30563表

提示

  • 介绍：

    • R2016B -SpreadSheetimportOptions.目的

    • R2018B -SpreadSheetimportOptions.功能

也可以看看

|

MATLAB的文档

金宝app

介绍MATLAB深度学习

介绍MATLAB深度学习

下载电子书