最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。
readtable
ファイルからのテーブルの作成
説明
T = readtable(filename)
readtable は、ファイル拡張子からファイル形式を判定します。
区切りテキスト ファイルの場合、
.txt、.datまたは.csvスプレッドシート ファイルの場合、
.xls、.xlsb、.xlsm、.xlsx、.xltm,.xltxまたは.ods
readtable は、ファイルの列ごとに 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'
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
PreserveVariableNames: false
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
PreserveVariableNames: false
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_' に変換します。変数名を保持しながら表形式データを読み取るには、'PreserveVariableNames' パラメーターを true に設定します。
T_preserve = readtable('sampletable.txt','PreserveVariableNames',true)
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'
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
PreserveVariableNames: false
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'
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
PreserveVariableNames: false
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'}
入力引数
出力引数
ヒント
XLSX 形式の大きなファイルは読み取りに時間がかかることがあります。インポートとエクスポートのパフォーマンスを向上させるためには、XLSB 形式を使用することが Microsoft によって推奨されています。
互換性についての考慮事項
参考
detectImportOptions | preview | readcell | readmatrix | readtimetable | readvars | setvaropts | table | textscan | writetable | インポート ツール
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
Select web siteYou 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)
