主要内容

readmatrix.

从文件读取矩阵

描述

例子

a = readmatrix(文件名通过从文件中读取面向列的数据来创建一个数组。的readmatrix.功能执行自动检测导入参数为您的文件。

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

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

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

对于包含混合数字和文本数据的文件,readmatrix.默认情况下将数据作为数字阵列作为数字。

例子

a = readmatrix(文件名选择此外使用导入选项选择

例子

a = readmatrix(___名称,价值从文件中创建数组,其中包含一个或多个名称值对参数指定的其他选项。在指定名称值对之前,使用先前语法中的任何输入参数。

要为数据设置特定的导入选项,您可以使用选择对象或您可以指定名称值对。除了添加名称 - 值对时选择, 然后readmatrix.万博1manbetx仅支持这些名称值对:

  • 文本文件,datelocale.编码

  • 电子表格文件,床单meftexcel.

例子

全部收缩

显示basic_matrix.txt.然后将数据导入矩阵。

类型basic_matrix.txt.
6,8,3,15,4,7,3 1,6,7,10 4,2,8,2 2,7,5,9
m = readmatrix('basic_matrix.txt'
m =5×4.6 8 3 1 5 4 7 3 1 6 7 10 4 2 8 2 2 7 5 9

导入数字数据basic_matrix.xls.进入矩阵。

m = readmatrix('basic_matrix.xls'
m =5×4.6 8 3 1 5 4 7 3 1 6 7 10 4 2 8 2 2 7 5 9

预览来自电子表格文件的数据并从指定的表格和范围将数字数据导入矩阵。

电子表格文件airlinesmall_subset.xlsx.包含1996年至2008年之间多年的多个工作表中的数据。每个工作表都有一年的数据。预览文件中的数据airlinesmall_subset.xlsx.。的预览函数默认显示来自第一个工作表的数据。文件中的前八个变量包含数字数据。

opts = detectimportoptions(“airlinesmall_subset.xlsx”);预览(“airlinesmall_subset.xlsx”选择)
ans =.表8×29年月DAYOFMONTH DAYOFWEEK DepTime CRSDepTime ArrTime CRSArrTime UniqueCarrier FlightNum TailNum ActualElapsedTime CRSElapsedTime开播ArrDelay DepDelay产地目标距离TaxiIn TaxiOut取消CancellationCode改行CarrierDelay WeatherDelay SDELAY SecurityDelay LateAircraftDelay ____ _____ __________ _________ _______ __________ _______ __________ _____________ _________ __________ _________________ ______________ _______ ________ ________ _______ _______ ________ ______ ________________ ________________________________________________________________________________________________________0 {0x0 char} {0x0 char} {0x0 char} {0x0 char} 1996 1 12 5 1252 1245 1511 1500 {'n905aw'} 79 75 58 11 7 {'lax'{'phx'} 370 3 18 0 {0x0 char} 0 {0x0 char} {0x0 char} {0x0 char} {0x0 char} {0x0 char} 1996 1 16 2 1441 1445 1708 1721 {'HP'} 211 {'n165aw'} 87 96 74 -13-4 {'phx'} {'phx'} 601 4 9 0 {0x0 char} 0 {0x0 char} {0x0 char} {0x0 char} {0x0 char} {0x0 char} 1996 1 1 11 2 2258 2300 2336 2335 {'hp'} 1245 {'n183aw'} 38 35 20 1 -2 {'tus'} {'phx'} {'phx'} 110 6 12 0 {0x0 char} 0 {0x0 char} {0x0 char} {0x0 char} {0x0 char} {0x0 char} {0x0 char} {0x0 char} {0x0 char} {0x0 char} {0x0 char} {0x0 char} {0x0 char}} {0x0 char} 1996 1 4 4 1814 1814 1901 1910 {'美国'} 683 {'n963vj'} 47 56 34 -9 0 {'dtw'} {'pit'} 201 6 7 0 {0x0 char} 0 {0x0 char} {0x0 char} {0x0 char} {0x0 char} {0x0 char} 1996 1 31 3 1822 1820 1934 1925 {'nu912vj'} 72 65 52 9 2 {'phl'} {''pit'} 267 6 14 0 {0x0 char} 0 {0x0 char} {0x0 char} {0x0 char} {0x0 char} 1996 1 18 4 729 730 841 843 {'n941vj'{72 73 58 -2 -1 {'dca'} {'pvd'} 357 3 11 0 {0x0 char} 0 {0x0 char} {0x0 char} {0x0 char} {0x0 char} 1996 1 265 1704 1705 1829 1839 {'nw'} 1538 {'n960n'} 85 94 69 -10 -1 {'dtw'} {'ric'} 456 3 13 0 {0x0 char} 0 {0x0 char} {0x0 char}{0x0 char} {0x0 char} {0x0 char}

配置要导入的opts对象中的值10.从工作表命名的前五个变量的行'2007'

opts.sheet =.'2007';选择.SelectedVariaBlenames = [1:5];opts.datarange =.'2:11';m = readmatrix(“airlinesmall_subset.xlsx”选择)
m =10×52007 1 2 711 2007 1 3 3 652 2007 1 4 4 1116 2007 1 5 5 8200 2007 1 7 7 1411 2007 1 811 1935 2007 1 9 2 2005 2007 1 11 4 15200 2007 1 12 5 1133 2007 1 13 6 922

从指定的表格和范围预览电子表格文件和将数字数据作为矩阵导入数值数据。

电子表格文件airlinesmall_subset.xlsx.包含1996年至2008年之间多年的多个工作表中的数据。每个工作表都有一年的数据。预览文件中的数据airlinesmall_subset.xlsx.。的预览函数默认显示来自第一个工作表的数据。文件中的前八个变量包含数字数据。

opts = detectimportoptions(“airlinesmall_subset.xlsx”);预览(“airlinesmall_subset.xlsx”选择)
ans =.表8×29年月DAYOFMONTH DAYOFWEEK DepTime CRSDepTime ArrTime CRSArrTime UniqueCarrier FlightNum TailNum ActualElapsedTime CRSElapsedTime开播ArrDelay DepDelay产地目标距离TaxiIn TaxiOut取消CancellationCode改行CarrierDelay WeatherDelay SDELAY SecurityDelay LateAircraftDelay ____ _____ __________ _________ _______ __________ _______ __________ _____________ _________ __________ _________________ ______________ _______ ________ ________ _______ _______ ________ ______ ________________ ________________________________________________________________________________________________________0 {0x0 char} {0x0 char} {0x0 char} {0x0 char} 1996 1 12 5 1252 1245 1511 1500 {'n905aw'} 79 75 58 11 7 {'lax'{'phx'} 370 3 18 0 {0x0 char} 0 {0x0 char} {0x0 char} {0x0 char} {0x0 char} {0x0 char} 1996 1 16 2 1441 1445 1708 1721 {'HP'} 211 {'n165aw'} 87 96 74 -13-4 {'phx'} {'phx'} 601 4 9 0 {0x0 char} 0 {0x0 char} {0x0 char} {0x0 char} {0x0 char} {0x0 char} 1996 1 1 11 2 2258 2300 2336 2335 {'hp'} 1245 {'n183aw'} 38 35 20 1 -2 {'tus'} {'phx'} {'phx'} 110 6 12 0 {0x0 char} 0 {0x0 char} {0x0 char} {0x0 char} {0x0 char} {0x0 char} {0x0 char} {0x0 char} {0x0 char} {0x0 char} {0x0 char} {0x0 char} {0x0 char}} {0x0 char} 1996 1 4 4 1814 1814 1901 1910 {'美国'} 683 {'n963vj'} 47 56 34 -9 0 {'dtw'} {'pit'} 201 6 7 0 {0x0 char} 0 {0x0 char} {0x0 char} {0x0 char} {0x0 char} {0x0 char} 1996 1 31 3 1822 1820 1934 1925 {'nu912vj'} 72 65 52 9 2 {'phl'} {''pit'} 267 6 14 0 {0x0 char} 0 {0x0 char} {0x0 char} {0x0 char} {0x0 char} 1996 1 18 4 729 730 841 843 {'n941vj'{72 73 58 -2 -1 {'dca'} {'pvd'} 357 3 11 0 {0x0 char} 0 {0x0 char} {0x0 char} {0x0 char} {0x0 char} 1996 1 265 1704 1705 1829 1839 {'nw'} 1538 {'n960n'} 85 94 69 -10 -1 {'dtw'} {'ric'} 456 3 13 0 {0x0 char} 0 {0x0 char} {0x0 char}{0x0 char} {0x0 char} {0x0 char}

进口10.第一个的行5.来自工作表命名的变量'2007'

m = readmatrix(“airlinesmall_subset.xlsx”'床单''2007''范围''A2:E11'
m =10×52007 1 2 711 2007 1 3 3 652 2007 1 4 4 1116 2007 1 5 5 8200 2007 1 7 7 1411 2007 1 811 1935 2007 1 9 2 2005 2007 1 11 4 15200 2007 1 12 5 1133 2007 1 13 6 922

输入参数

全部收缩

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

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

地点

形式

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
亚马逊S3™ S3
Windows Azure.®Blob Storage. wasbwasbs
HDFS™ HDFS.

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

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

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

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

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

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

数据类型:char|字符串

文件导入选项,指定为一个SpreadSheetimportOptions.delimitedtextimportoptions.多个沃特莫特选项,或XMLImportOptions由此创建的对象detectImportOptions功能。的选择对象包含控制数据导入过程的属性。有关每个对象属性的更多信息,请参阅相应的对象页面。

文件类型 输出
电子表格文件 SpreadSheetimportOptions.对象(仅适用于床单DataRange, 和variablenames.特性)
文本文件 delimitedtextimportoptions.目的
固定宽度文本文件 多个沃特莫特选项目的
XML文件 XMLImportOptions目的

名称值对参数

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

例子:'numheaderlines',5表示在表格数据之前的前五条线是标题线。
文本和电子表格文件

全部收缩

文件类型,指定为逗号分隔对组成'文件类型''文本'或者'电子表格'

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

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

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

例子:“文件类型”、“文本”

数据类型:char|字符串

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

例子:'numheaderlines',7

数据类型:|双倍的

预期的变量数,指定为逗号分隔对组成“ExpectedNumVariables”和一个正整数。如果未指定,导入函数会自动检测变量的数量。

数据类型:|双倍的

从文本或电子表格文件中读取的部分数据,指定为逗号分隔对'范围'和其中一个表单中的字符向量,字符串标量或数字矢量。

指定的方法范围 描述

起始牢房

'细胞'或者[行col]

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

  • 字符向量或字符串标量,包含excel的列字母和行号A1符号。例如,A5是列中的单元格的标识符一种和排5.

  • 两元素数值矢量的形式[行col]表示起始行和列。

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

例子:'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]

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

行范围或列范围

'row1:row2'或者“Column1: Column2”

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

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

例子:'5:500'

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

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

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

例子:'A:K'

起始行号

N

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

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

例子:5.

Excel的命名范围

'namedrange'

在Excel中,您可以创建名称以识别电子表格中的范围。例如,您可以选择电子表格的矩形部分并调用它'MyTable'。如果在电子表格中存在此类命名范围,则导入功能可以使用其名称读取该范围。

例子:'范围','mytable'

未指定或空的

''

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

例子:'范围',''

笔记:使用范围指电子表格中实际包含数据的矩形部分。导入函数通过修剪不包含数据的任何开头和结尾行和列,自动检测使用的范围。仅为空白的文本被视为数据,并在使用范围内捕获。

数据类型:char|字符串|双倍的

文本以将指定为缺少数据的文本,指定为字符向量,字符串标量,字符向量单元数组或字符串数​​组。

例子:“尾声”,{'na','tbd'}指示导入功能治疗任何发生NA.或者TBD.作为缺少的领域。

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

输出数据类型,指定为逗号分隔对组成'OutputType'以及包含此表中任何数据类型的名称的字符向量或字符串标量。

数据类型 输出数据类型
数字 'uint8''int8''int16'“int32”'int64''uint16''uint32''uint64''单身的',或'双倍的'
文本 'char'或者'细绳'
其他类型 “datetime”“持续时间”,或'分类'

例子:“OutputType”、“uint8”

数据类型:char|字符串

仅文本文件

全部收缩

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

例子:“分隔符”,“|”

例子:“分隔符 ',{';','*'}

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

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

例子:'空白','_'

例子:'空白','!!。,'

行结束字符,指定为字符向量、字符串标量、字符向量的单元数组或字符串数组。

例子:' LineEnding ', ' \ n '

例子:'系列','\ r \ n'

例子:'排队',{'\ b',':'}

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

评论的风格,指定为字符向量,字符串标量,字符向量或字符串数​​组。

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

例子:CommentStyle,{“/ *”}

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

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

如果您指定了'编码'参数除了导入选项,那么readmatrix.函数使用指定的值'编码',覆盖导入选项中定义的编码。

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

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

数据类型:char|字符串

读取日期的区域设置,指定为逗号分隔的对,由'datelocale'以及表单的字符矢量或字符串标量XX._yy.,地点:

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

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

有关区域设置的常见值列表,请参阅地区的名称-值对参数约会时间功能。

使用时%D.格式化说明符以读取文本约会时间值,使用datelocale.指定导入函数应该解释月份和日常名称和缩写的语言环境。

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

例子:'datelocale','ja_jp'

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

转换为整数数据类型时,带有十进制部分的数字将舍入到最接近的整数。

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

数据类型:char|字符串

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

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

数据类型:char|字符串

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

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

数据类型:逻辑

过程在分隔的文本文件中处理连续分隔符,指定为此表中的值之一。

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

数据类型:char|字符串

在分隔的文本文件中管理前导分隔符的过程,指定为此表中的值之一。

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

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

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

全部收缩

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

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

数据类型:char|字符串||双倍的

旗帜开始一个实例微软Excel.在Windows中读取电子表格数据时,指定为逗号分隔的对,由'使用'和任何一种真的,或错误的

你可以设置'使用'参数到其中一个值:

  • 真的- 读取文件时,导入函数启动Microsoft Excel的实例。

  • 错误的—导入功能在读取文件时不会启动Microsoft Excel实例。在这种模式下操作时,导入函数的功能在支持文件格式和交互特性(如公式和宏)方面有所不同。万博1manbetx

meftexcel.

真的

错误的

万博1manbetx支持的文件格式

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

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

万博1manbetx支持交互式功能,例如公式和宏

是的

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

在R2019A介绍