readtable
ファイルからのテーブルの作成
説明
T = readtable(filename)
readtable は、ファイル拡張子からファイル形式を判定します。
区切りテキスト ファイルの場合、
.txt、.datまたは.csvスプレッドシート ファイルの場合、
.xls、.xlsb、.xlsm、.xlsx、.xltm,.xltxまたは.ods拡張マークアップ言語 (XML) の場合、
.xmlMicrosoft® Word ドキュメント ファイルの場合、
.docxハイパーテキスト マークアップ言語 (HTML) ファイルの場合、
.html、.xhtmlまたは.htm
テキスト ファイルおよびスプレッドシート ファイルの場合、readtable は、ファイルの列ごとに 1 つの変数を T に作成し、ファイルの最初の行から変数名を読み取ります。XML ファイルの場合、readtable は、table 変数として検出された要素ノードまたは属性ノードごとに 1 つの変数を T に作成します。変数の名前は要素および属性の名前に対応します。Microsoft Word ドキュメント ファイルの場合、readtable は、既定ではドキュメントの最初のテーブルからデータをインポートして、ファイルの列ごとに 1 つの変数を T に作成し、テーブルの最初の行から変数名を読み取ります。HTML ファイルの場合、readtable は、既定では最初の <TABLE> 要素からデータをインポートして、ファイルの列ごとに 1 つの変数を T に作成し、テーブルの最初の行から変数名を読み取ります。
既定では、readtable は、入力ファイルの各列で検出されたデータ値に適したデータ型をもつ変数を作成します。
T = readtable(___,Name,Value)readtable でファイルの最初の行を変数名として読み取るかデータとして読み取るかを指定することができます。
データ特有のインポート オプションを設定するには、opts オブジェクトを使用するか、名前と値のペアを指定できます。opts に加えて名前と値のペアを指定する場合、readtable がサポートするのは次の名前と値のペアのみです。
テキストおよびスプレッドシートのパラメーター —
ReadVariableNames、ReadRowNamesテキストのみのパラメーター —
DateLocale、Encodingスプレッドシートのみのパラメーター —
Sheet、UseExcel
例
テキスト ファイルからのテーブルの作成
myCsvTable.dat ファイルをテキスト エディターに読み込み、その内容をプレビューします。スクリーン ショットを以下に示します。このファイルにはコンマ区切り列データが含まれています。
filename = 'myCsvTable.dat';
コンマ区切りのテキスト ファイルからテーブルを作成します。作成された table T にはファイルの列ごとに 1 つの変数が含まれ、readtable はファイルの最初の行のエントリを変数名として扱います。
T = readtable(filename)
T=5×6 table
LastName Gender Age Height Weight Smoker
____________ ______ ___ ______ ______ ______
{'Smith' } {'M'} 38 71 176 1
{'Johnson' } {'M'} 43 69 163 0
{'Williams'} {'F'} 38 64 131 0
{'Jones' } {'F'} 40 67 133 0
{'Brown' } {'F'} 49 64 119 0
ヘッダーを無視して欠損値を埋める
R2020a 以降、関数 readtable は、関数 detectImportOptions をファイルで自動的に呼び出すかのように入力ファイルを読み取ります。これはデータ型を検出し、余分なヘッダー行を破棄し、欠損値を埋めることができます。
たとえば、ファイル headersAndMissing.txt をテキスト エディターでプレビューします。このファイルには列名が含まれる行があり、別の行にはヘッダーが含まれます。前の行にはデータ値がありますが、最後の 2 行にはギャップがあります。
このファイルから table を作成します。関数 readtable は、ヘッダーを破棄します。また、適切な欠損値 (数値変数には NaN の値、テキストには空の文字ベクトル) をギャップに埋めます。
T = readtable('headersAndMissing.txt')T=5×6 table
LastName Gender Age Height Weight Smoker
___________ __________ ___ ______ ______ ______
{'Wu' } {'M' } 38 71 176 1
{'Johnson'} {'M' } 43 69 163 0
{'Sanchez'} {'F' } 38 64 131 0
{'Brown' } {'F' } NaN 67 133 0
{'Picard' } {0x0 char} NaN 64 119 0
以前のリリースでの既定の動作に戻すには、名前と値のペアの引数 'Format','auto' を指定します。readtable は、ヘッダーをデータとして読み取り、結果として、すべての table 変数をテキストに変換します。
T = readtable('headersAndMissing.txt','Format','auto')
T=6×6 table
LastName Gender Age Height Weight Smoker
___________ __________ __________ _______ _______ ___________
{'string' } {'string'} {'int' } {'int'} {'int'} {'boolean'}
{'Wu' } {'M' } {'38' } {'71' } {'176'} {'1' }
{'Johnson'} {'M' } {'43' } {'69' } {'163'} {'0' }
{'Sanchez'} {'F' } {'38' } {'64' } {'131'} {'0' }
{'Brown' } {'F' } {0x0 char} {'67' } {'133'} {'0' }
{'Picard' } {0x0 char} {0x0 char} {'64' } {'119'} {'0' }
詳細については、このページの「互換性についての考慮事項」節を参照してください。
テキスト ファイルからの列見出しのないテーブルの作成
ファイル mySpaceDelimTable.txt をテキスト エディターでプレビューします。スクリーン ショットを以下に示します。このファイルにはスペース区切り列データが含まれています。
スペースで区切られたテキスト ファイルから table を作成します。ファイルの最初の行に検出可能な列名が含まれていないため、関数 readtable は、既定の変数名 Var1 から Var5 を割り当てます。
T = readtable('mySpaceDelimTable.txt')T=3×5 table
Var1 Var2 Var3 Var4 Var5
_____ ____ ____ ______ _________
{'M'} 45 45 {'NY'} {'true' }
{'F'} 41 32 {'CA'} {'false'}
{'M'} 40 34 {'MA'} {'false'}
テキスト ファイルからのテーブルの作成と形式の設定
myCsvTable.dat ファイルをテキスト エディターに読み込み、その内容をプレビューします。スクリーン ショットを以下に示します。このファイルにはコンマ区切り列データが含まれています。
filename = 'myCsvTable.dat';
コンマ区切りのテキスト ファイルからテーブルを作成します。最初の 2 つの列を文字ベクトル、3 番目の列を uint32、その次の 2 つの列を倍精度浮動小数点数としてインポートします。最後の列のエントリを文字ベクトルとしてインポートします。
T = readtable(filename,'Format','%s%s%u%f%f%s')
T=5×6 table
LastName Gender Age Height Weight Smoker
____________ ______ ___ ______ ______ ______
{'Smith' } {'M'} 38 71 176 {'1'}
{'Johnson' } {'M'} 43 69 163 {'0'}
{'Williams'} {'F'} 38 64 131 {'0'}
{'Jones' } {'F'} 40 67 133 {'0'}
{'Brown' } {'F'} 49 64 119 {'0'}
変換指定子は、文字ベクトルの cell 配列の場合は %s、double の場合は %f、uint32 の場合は %u です。
テキスト ファイルからの外国語の日付の読み取り
ファイルからドイツ語の日付を読み取り、英語の日付としてテーブルに追加します。
ファイル german_dates.txt をテキスト エディターでプレビューします。スクリーン ショットを以下に示します。値の最初の列にはドイツ語の日付が含まれ、2 番目と 3 番目の列は数値となっています。
readtable を使用してサンプル ファイルを読み取ります。変換指定子は日付では %D、浮動小数点値では %f です。ファイルのエンコードは、名前と値のペアの引数 FileEncoding で指定します。日付の書式とロケールは、名前と値のペアの引数 DateLocale で指定します。
T = readtable('german_dates.txt',... 'Format','%{dd MMMM yyyy}D %f %f',... 'FileEncoding','ISO-8859-15',... 'DateLocale','de_DE')
T=3×3 table
Var1 Var2 Var3
________________ ____ _____
01 January 2014 20.2 100.5
01 February 2014 21.6 102.7
01 March 2014 20.7 99.8
スプレッドシートからの行名を含むテーブルの作成
スプレッドシートから、最初の行に変数名、最初の列に行名が含まれるテーブルを作成します。
T = readtable('patients.xls','ReadRowNames',true);
テーブルの最初の 5 行と最初の 4 つの変数を表示します。
T(1:5,1:4)
ans=5×4 table
Gender Age Location Height
__________ ___ _____________________________ ______
Smith {'Male' } 38 {'County General Hospital' } 71
Johnson {'Male' } 43 {'VA Hospital' } 69
Williams {'Female'} 38 {'St. Mary's Medical Center'} 64
Jones {'Female'} 40 {'VA Hospital' } 67
Brown {'Female'} 49 {'County General Hospital' } 64
テーブルの DimensionNames プロパティを表示します。
T.Properties.DimensionNames
ans = 1x2 cell
{'LastName'} {'Variables'}
'LastName' は、スプレッドシートの最初の行の最初の列にある名前です。
スプレッドシートからの特定範囲のデータの読み取り
スプレッドシート patients.xls の指定した領域のデータを使用して table を作成します。角 C2 と E6 の間にある 5 行 3 列の四角形領域のデータを使用します。この領域の最初の行は変数名として使用しないでください。
T = readtable('patients.xls',... 'Range','C2:E6',... 'ReadVariableNames',false)
T =
Var1 Var2 Var3
____ ___________________________ ____
38 'County General Hospital' 71
43 'VA Hospital' 69
38 'St. Mary's Medical Center' 64
40 'VA Hospital' 67
49 'County General Hospital' 64
T には、既定の変数名が含まれます。
テキスト ファイルのインポート オプションの検出と使用
インポート オプションを作成し、複数の変数に対しデータ型を適用してから、データを読み取ります。
テキスト ファイルからインポート オプション オブジェクトを作成します。
opts = detectImportOptions('airlinesmall.csv')opts =
DelimitedTextImportOptions with properties:
Format Properties:
Delimiter: {','}
Whitespace: '\b\t '
LineEnding: {'\n' '\r' '\r\n'}
CommentStyle: {}
ConsecutiveDelimitersRule: 'split'
LeadingDelimitersRule: 'keep'
TrailingDelimitersRule: 'ignore'
EmptyLineRule: 'skip'
Encoding: 'ISO-8859-1'
Replacement Properties:
MissingRule: 'fill'
ImportErrorRule: 'fill'
ExtraColumnsRule: 'addvars'
Variable Import Properties: Set types by name using setvartype
VariableNames: {'Year', 'Month', 'DayofMonth' ... and 26 more}
VariableTypes: {'double', 'double', 'double' ... and 26 more}
SelectedVariableNames: {'Year', 'Month', 'DayofMonth' ... and 26 more}
VariableOptions: Show all 29 VariableOptions
Access VariableOptions sub-properties using setvaropts/getvaropts
VariableNamingRule: 'modify'
Location Properties:
DataLines: [2 Inf]
VariableNamesLine: 1
RowNamesColumn: 0
VariableUnitsLine: 0
VariableDescriptionsLine: 0
To display a preview of the table, use preview
変数 TaxiIn と変数 TaxiOut の Type プロパティを確認します。
getvaropts(opts,{'TaxiIn','TaxiOut'})ans =
1x2 TextVariableImportOptions array with properties:
Name
Type
FillValue
TreatAsMissing
QuoteRule
Prefixes
Suffixes
EmptyFieldRule
WhitespaceRule
変数 TaxiIn と TaxiOut の型を double に変更します。
opts = setvartype(opts,{'TaxiIn','TaxiOut'},'double');インポートして確認する変数のサブセットを指定します。
opts.SelectedVariableNames = {'TaxiIn','TaxiOut'};関数 readtable をオプション オブジェクトと共に使用して、選択した変数をインポートします。テーブルの概要を表示します。
T = readtable('airlinesmall.csv',opts);
summary(T)Variables:
TaxiIn: 123523x1 double
Values:
Min 0
Median 5
Max 1451
NumMissing 37383
TaxiOut: 123523x1 double
Values:
Min 0
Median 13
Max 755
NumMissing 37364
スプレッドシート ファイルのインポート オプションの検出と使用
スプレッドシート ファイルのインポート オプションを検出し、インポートする変数を指定してから、データを読み取ります。
ファイルからインポート オプション オブジェクトを作成します。
opts = detectImportOptions('patients.xls')opts =
SpreadsheetImportOptions with properties:
Sheet Properties:
Sheet: ''
Replacement Properties:
MissingRule: 'fill'
ImportErrorRule: 'fill'
Variable Import Properties: Set types by name using setvartype
VariableNames: {'LastName', 'Gender', 'Age' ... and 7 more}
VariableTypes: {'char', 'char', 'double' ... and 7 more}
SelectedVariableNames: {'LastName', 'Gender', 'Age' ... and 7 more}
VariableOptions: Show all 10 VariableOptions
Access VariableOptions sub-properties using setvaropts/getvaropts
VariableNamingRule: 'modify'
Range Properties:
DataRange: 'A2' (Start Cell)
VariableNamesRange: 'A1'
RowNamesRange: ''
VariableUnitsRange: ''
VariableDescriptionsRange: ''
To display a preview of the table, use preview
オプション オブジェクトを変更してインポートする変数を指定します。
opts.SelectedVariableNames = {'Systolic','Diastolic'};readtable をオプション オブジェクトと共に使用して、指定した変数をインポートします。
T = readtable('patients.xls',opts);
summary(T)Variables:
Systolic: 100x1 double
Values:
Min 109
Median 122
Max 138
Diastolic: 100x1 double
Values:
Min 68
Median 81.5
Max 99
任意の変数名を含む表形式データの読み取り
スペース、非 ASCII 文字などの任意の文字を含む変数名を保持しながら、表形式データを読み取ることができます。まず、任意の変数名を含む table を作成し、その table をテキスト ファイルに書き込みます。次に、元の変数名を保持しながら表形式データを読み戻します。
任意の変数名を含む table を作成し、その表形式データをファイル 'sampletable.txt' に書き込みます。
LastName = {'Sanchez';'Johnson';'Li';'Diaz';'Brown'};
Age = [38;43;38;40;49];
Smoker = logical([1;0;1;0;1]);
varNames = {'Last Name','Age','Smoker (1 or 0)'};
T = table(LastName,Age,Smoker,'VariableNames',varNames)T=5×3 table
Last Name Age Smoker (1 or 0)
___________ ___ _______________
{'Sanchez'} 38 true
{'Johnson'} 43 false
{'Li' } 38 true
{'Diaz' } 40 false
{'Brown' } 49 true
writetable(T,'sampletable.txt')readtable を使用して、表形式データを読み戻します。既定で、MATLAB® はスペースおよび非 ASCII 文字が含まれる変数名を、有効な MATLAB® 識別子に変換します。たとえば、MATLAB® は変数名 'Last Name' を 'LastName'、'Smoker (1 or 0)' を 'Smoker_1or0_' に変換します。変数名を保持しながら表形式データを読み取るには、'VariableNamingRule' パラメーターを preserve に設定します。
T_preserve = readtable('sampletable.txt',"VariableNamingRule","preserve")
T_preserve=5×3 table
Last Name Age Smoker (1 or 0)
___________ ___ _______________
{'Sanchez'} 38 1
{'Johnson'} 43 0
{'Li' } 38 1
{'Diaz' } 40 0
{'Brown' } 49 1
ファイルから 16 進数と 2 進数を読み取る
16 進数と 2 進数をファイルから読み取り、それらを数値変数として table に格納できます。関数 readtable は、16 進数と 2 進数にそれぞれ 0x と 0b の接頭辞が含まれている場合、16 進数と 2 進数を自動的に読み取ります。数値は整数データ型を使用して格納されます。また、このような数値に接頭辞がない場合、インポート オプションを使用して読み取ることもできます。
hexAndBinary.txt のファイルをテキスト エディターでプレビューします。このファイルには 16 進数と 2 進数に接頭辞が含まれている列がありますが、含まれていない列が 1 つあります。
readtable を使用してファイルを読み取ります。この関数は、0x と 0b の接頭辞を含む数値を検出し、それらを整数として格納します。3 番目の列には接頭辞がないため、その値はテキストとして扱われます。
T = readtable('hexAndBinary.txt')T=3×4 table
Var1 Var2 Var3 Var4
_____ ____ ________ ___________
255 255 {'C7F9'} {'Device1'}
256 4 {'05BF'} {'Device2'}
43981 129 {'F00F'} {'Device3'}
T.Var1 には 8 ビットより大きいストレージを必要とする値があるため、関数 readtable は、数値を異なる整数クラス (uint16 と uint8) に格納します。
class(T.Var1)
ans = 'uint16'
class(T.Var2)
ans = 'uint8'
16 進数と 2 進数からインポートされた数値を格納するためのデータ型を指定するには、名前と値のペアの引数 'HexType' および 'BinaryType' を使用します。値を符号付き 32 ビット整数として格納します。
T = readtable('hexAndBinary.txt','HexType','int32','BinaryType','int32'); class(T.Var1)
ans = 'int32'
class(T.Var2)
ans = 'int32'
インポート オプションを使用して接頭辞のない 16 進数と 2 進数を検出し、それらのためのストレージを指定します。hexAndBinary.txt のインポート オプション オブジェクトを作成します。
opts = detectImportOptions('hexAndBinary.txt')opts =
DelimitedTextImportOptions with properties:
Format Properties:
Delimiter: {','}
Whitespace: '\b\t '
LineEnding: {'\n' '\r' '\r\n'}
CommentStyle: {}
ConsecutiveDelimitersRule: 'split'
LeadingDelimitersRule: 'keep'
TrailingDelimitersRule: 'ignore'
EmptyLineRule: 'skip'
Encoding: 'UTF-8'
Replacement Properties:
MissingRule: 'fill'
ImportErrorRule: 'fill'
ExtraColumnsRule: 'addvars'
Variable Import Properties: Set types by name using setvartype
VariableNames: {'Var1', 'Var2', 'Var3' ... and 1 more}
VariableTypes: {'auto', 'auto', 'char' ... and 1 more}
SelectedVariableNames: {'Var1', 'Var2', 'Var3' ... and 1 more}
VariableOptions: Show all 4 VariableOptions
Access VariableOptions sub-properties using setvaropts/getvaropts
VariableNamingRule: 'modify'
Location Properties:
DataLines: [1 Inf]
VariableNamesLine: 0
RowNamesColumn: 0
VariableUnitsLine: 0
VariableDescriptionsLine: 0
To display a preview of the table, use preview
接頭辞がない場合でも 3 番目の列を 16 進数値としてインポートする必要があることを指定するには、関数 setvaropts を使用して、table の 3 番目の変数の型を変更します。変数の型を int32 に設定します。
opts = setvaropts(opts,3,'NumberSystem','hex','Type','int32')
opts =
DelimitedTextImportOptions with properties:
Format Properties:
Delimiter: {','}
Whitespace: '\b\t '
LineEnding: {'\n' '\r' '\r\n'}
CommentStyle: {}
ConsecutiveDelimitersRule: 'split'
LeadingDelimitersRule: 'keep'
TrailingDelimitersRule: 'ignore'
EmptyLineRule: 'skip'
Encoding: 'UTF-8'
Replacement Properties:
MissingRule: 'fill'
ImportErrorRule: 'fill'
ExtraColumnsRule: 'addvars'
Variable Import Properties: Set types by name using setvartype
VariableNames: {'Var1', 'Var2', 'Var3' ... and 1 more}
VariableTypes: {'auto', 'auto', 'int32' ... and 1 more}
SelectedVariableNames: {'Var1', 'Var2', 'Var3' ... and 1 more}
VariableOptions: Show all 4 VariableOptions
Access VariableOptions sub-properties using setvaropts/getvaropts
VariableNamingRule: 'modify'
Location Properties:
DataLines: [1 Inf]
VariableNamesLine: 0
RowNamesColumn: 0
VariableUnitsLine: 0
VariableDescriptionsLine: 0
To display a preview of the table, use preview
ファイルを読み取り、3 番目の列をテキストではなく数値としてインポートします。
T = readtable('hexAndBinary.txt',opts)T=3×4 table
Var1 Var2 Var3 Var4
_____ ____ _____ ___________
255 255 51193 {'Device1'}
256 4 1471 {'Device2'}
43981 129 61455 {'Device3'}
XML ファイル用の XML インポート オプションの作成
XML ファイル用の XML インポート オプションを作成し、インポートする変数を指定してから、データを読み取ります。
XML ファイル students.xml には、Student という名前の 4 つの兄弟ノードがあり、それぞれに同じ子ノードと属性が含まれています。
type students.xml<?xml version="1.0" encoding="utf-8"?>
<Students>
<Student ID="S11305">
<Name FirstName="Priya" LastName="Thompson" />
<Age>18</Age>
<Year>Freshman</Year>
<Address>
<Street xmlns="https://www.mathworks.com">591 Spring Lane</Street>
<City>Natick</City>
<State>MA</State>
</Address>
<Major>Computer Science</Major>
<Minor>English Literature</Minor>
</Student>
<Student ID="S23451">
<Name FirstName="Conor" LastName="Cole" />
<Age>18</Age>
<Year>Freshman</Year>
<Address>
<Street xmlns="https://www.mathworks.com">4641 Pearl Street</Street>
<City>San Francisco</City>
<State>CA</State>
</Address>
<Major>Microbiology</Major>
<Minor>Public Health</Minor>
</Student>
<Student ID="S119323">
<Name FirstName="Morgan" LastName="Yang" />
<Age>21</Age>
<Year>Senior</Year>
<Address>
<Street xmlns="https://www.mathworks.com">30 Highland Road</Street>
<City>Detriot</City>
<State>MI</State>
</Address>
<Major>Political Science</Major>
</Student>
<Student ID="S201351">
<Name FirstName="Salim" LastName="Copeland" />
<Age>19</Age>
<Year>Sophomore</Year>
<Address>
<Street xmlns="https://www.mathworks.com">3388 Moore Avenue</Street>
<City>Fort Worth</City>
<State>TX</State>
</Address>
<Major>Business</Major>
<Minor>Japanese Language</Minor>
</Student>
<Student ID="S201351">
<Name FirstName="Salim" LastName="Copeland" />
<Age>20</Age>
<Year>Sophomore</Year>
<Address>
<Street xmlns="https://www.mathworks.com">3388 Moore Avenue</Street>
<City>Fort Worth</City>
<State>TX</State>
</Address>
<Major>Business</Major>
<Minor>Japanese Language</Minor>
</Student>
<Student ID="54600">
<Name FirstName="Dania" LastName="Burt" />
<Age>22</Age>
<Year>Senior</Year>
<Address>
<Street xmlns="https://www.mathworks.com">22 Angie Drive</Street>
<City>Los Angeles</City>
<State>CA</State>
</Address>
<Major>Mechanical Engineering</Major>
<Minor>Architecture</Minor>
</Student>
<Student ID="453197">
<Name FirstName="Rikki" LastName="Gunn" />
<Age>21</Age>
<Year>Junior</Year>
<Address>
<Street xmlns="https://www.mathworks.com">65 Decatur Lane</Street>
<City>Trenton</City>
<State>ME</State>
</Address>
<Major>Economics</Major>
<Minor>Art History</Minor>
</Student>
</Students>
ファイルから XMLImportOptions オブジェクトを作成します。VariableSelectors の値を //@FirstName と指定して、FirstName 要素ノードを table 変数としてインポートするように選択します。
opts = xmlImportOptions("VariableSelectors","//@FirstName")
opts =
XMLImportOptions with properties:
Replacement Properties:
MissingRule: "fill"
ImportErrorRule: "fill"
RepeatedNodeRule: "addcol"
Variable Import Properties: Set types by name using setvartype
VariableNames: "Var1"
VariableTypes: "char"
SelectedVariableNames: "Var1"
VariableOptions: Show all 1 VariableOptions
Access VariableOptions sub-properties using setvaropts/getvaropts
VariableNamingRule: "preserve"
Location Properties:
TableSelector: <missing>
RowSelector: <missing>
VariableSelectors: "//@FirstName"
VariableUnitsSelector: <missing>
VariableDescriptionsSelector: <missing>
RowNamesSelector: <missing>
RegisteredNamespaces: [0x2 string]
readtable をオプション オブジェクトと共に使用して、指定した変数をインポートします。
T = readtable("students.xml",opts)T=7×1 table
Var1
__________
{'Priya' }
{'Conor' }
{'Morgan'}
{'Salim' }
{'Salim' }
{'Dania' }
{'Rikki' }
カスタムの XML 名前空間接頭辞の登録
名前と値の引数 RegisteredNamespaces を使用して、入力ファイルの既存の名前空間 URL にカスタムの XML 名前空間接頭辞を登録します。
XML ファイルから XMLImportOptions オブジェクトを作成します。'VariableSelectors' の値として Street 要素ノードの XPath 式を指定し、接頭辞 myPrefix を Street ノードに属する URL に登録します。
opts = detectImportOptions("students.xml","RegisteredNamespaces", ["myPrefix","https://www.mathworks.com"],... "VariableSelectors","//myPrefix:Street")
opts =
XMLImportOptions with properties:
Replacement Properties:
MissingRule: "fill"
ImportErrorRule: "fill"
RepeatedNodeRule: "addcol"
Variable Import Properties: Set types by name using setvartype
VariableNames: "Street"
VariableTypes: "string"
SelectedVariableNames: "Street"
VariableOptions: Show all 1 VariableOptions
Access VariableOptions sub-properties using setvaropts/getvaropts
VariableNamingRule: "preserve"
Location Properties:
TableSelector: <missing>
RowSelector: <missing>
VariableSelectors: "//myPrefix:Street"
VariableUnitsSelector: <missing>
VariableDescriptionsSelector: <missing>
RowNamesSelector: <missing>
RegisteredNamespaces: ["myPrefix" "https://www.mathworks.com"]
関数 readtable をオプション オブジェクトと共に使用して、選択した変数をインポートします。
T2 = readtable("students.xml",opts)T2=7×1 table
Street
___________________
"591 Spring Lane"
"4641 Pearl Street"
"30 Highland Road"
"3388 Moore Avenue"
"3388 Moore Avenue"
"22 Angie Drive"
"65 Decatur Lane"
Microsoft Word ドキュメントからの特定のテーブルの読み取り
関数 readtable は、既定では、Microsoft Word ドキュメント ファイルから最初のテーブルを読み取ります。ファイル MaintenanceReport.docx にはテーブルが 2 つ含まれています。2 つ目のテーブルの最後の行に、テーブルの変数と一致しない、列がマージされたセルがあります。
TableIndex オプションを 2 に設定して 2 つ目のテーブルを読み取ります。列がマージされたセルがある行をスキップするために、MergedCellColumnRule オプションを 'omitrow' に設定します。
filename = "MaintenanceReport.docx"; T = readtable(filename,'TableIndex',2,'MergedCellColumnRule','omitrow')
T=3×5 table
Description Category Urgency Resolution Cost
_____________________________________________________________________ ____________________ ________ __________________ ________
"Items are occasionally getting stuck in the scanner spools." "Mechanical Failure" "Medium" "Readjust Machine" "$45"
"Loud rattling and banging sounds are coming from assembler pistons." "Mechanical Failure" "Medium" "Readjust Machine" "$35"
"There are cuts to the power when starting the plant." "Electronic Failure" "High" "Full Replacement" "$16200"
あるいは、TableSelector オプションを使用して XPath セレクターでテーブルを選択することもできます。Microsoft Word ドキュメントの "Description" というテキストを含むテーブルを選択するには、XPath セレクター "//w:tbl[contains(.,'Description')]" を使用します。
T = readtable(filename, ... 'TableSelector',"//w:tbl[contains(.,'Description')]", ... 'MergedCellColumnRule','omitrow')
T=3×5 table
Description Category Urgency Resolution Cost
_____________________________________________________________________ ____________________ ________ __________________ ________
"Items are occasionally getting stuck in the scanner spools." "Mechanical Failure" "Medium" "Readjust Machine" "$45"
"Loud rattling and banging sounds are coming from assembler pistons." "Mechanical Failure" "Medium" "Readjust Machine" "$35"
"There are cuts to the power when starting the plant." "Electronic Failure" "High" "Full Replacement" "$16200"
HTML Web ページからのテーブルの読み取り
URL https://www.mathworks.com/help/matlab/text-files.html から、XPath セレクター "//TABLE[contains(.,'readtable')]" を使用して、"readtable" というテキストを含む最初のテーブルを読み取ります。このテーブルにはヘッダー行がないため、ReadVariableNames オプションを false に設定します。
url = "https://www.mathworks.com/help/matlab/text-files.html"; T = readtable(url,'TableSelector',"//TABLE[contains(.,'readtable')]", ... 'ReadVariableNames',false)
T=4×2 table
Var1 Var2
________________ ____________________________
"readtable" "Create table from file"
"writetable" "Write table to file"
"readtimetable" "Create timetable from file"
"writetimetable" "Write timetable to file"
入力引数
出力引数
ヒント
XLSX 形式の大きなファイルは読み取りに時間がかかることがあります。インポートとエクスポートのパフォーマンスを向上させるためには、XLSB 形式を使用することが Microsoft によって推奨されています。
インポートする XML 入力文書の要素を指定するには、XPath セレクターを使用します。たとえば、次の構造の XML ファイル
myFile.xmlをインポートするとします。次の表に、<data> <table category="ones"> <var>1</var> <var>2</var> </table> <table category="tens"> <var>10</var> <var>20</var> </table> </data>VariableSelectorsやTableSelectorなどの XPath セレクターの名前と値の引数でサポートされる XPath 構文を示します。選択操作 構文 例 結果 文書内の場所に関係なく、選択するノードに名前が一致するすべてのノードを選択する。 名前の前にスラッシュを 2 つ ( //) 付ける。data = readtable('myFile.xml', 'VariableSelectors', '//var')
data = 4×1 table var ___ 1 2 10 20要素ノードに属する属性の値を読み取る。 属性の前にアット マーク ( @) を付ける。data = readtable('myFile.xml', 'VariableSelectors', '//table/@category')
data = 2×1 table categoryAttribute _________________ "ones" "tens"一連のノードから特定のノードを選択する。 選択するノードのインデックスを大かっこ ( []) で囲んで指定する。data = readtable('myFile.xml', 'TableSelector', '//table[1]')
data = 2×1 table var ___ 1 2演算の優先順位を指定する。 最初に評価する式を小かっこで囲む。 data = readtable('myFile.xml', 'VariableSelectors', '//table/var[1]')
data = 2×1 table var ___ 1 10data = readtable('myFile.xml', 'VariableSelectors', '(//table/var)[1]')
data = table var ___ 1
バージョン履歴
R2013b で導入
You can also select a web site from the following list:
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)