最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。
readtable
ファイルからのテーブルの作成
構文
T = readtable(filename)T = readtable(filename,Name,Value)T = readtable(filename,opts)T = readtable(filename,opts,Name,Value)説明
T = readtable(filename)
readtable は、ファイル拡張子からファイル形式を判定します。
区切りテキスト ファイルの場合、
.txt、.datまたは.csvスプレッドシート ファイルの場合、
.xls、.xlsb、.xlsm、.xlsx、.xltm,.xltxまたは.ods
readtable は、ファイルの列ごとに 1 つの変数を T に作成し、ファイルの最初の行から変数名を読み取ります。既定では、作成される変数は、列全体が数値の場合は double、列に数値以外の要素がある場合は文字ベクトルの cell 配列になります。
T = readtable(filename,Name,Value)
たとえば、readtable でファイルの最初の行を変数名として読み取るかデータとして読み取るかを指定することができます。
T = readtable(filename,opts,Name,Value)ReadVariableNames、ReadRowNames、DateLocale、Encoding、Sheet および Basic の名前と値のペア引数の 1 つ以上によって指定された追加のオプションを使用して table を作成します。
例
テキスト ファイルからのテーブルの作成
myCsvTable.dat ファイルをテキスト エディターに読み込み、その内容をプレビューします。スクリーン ショットを以下に示します。このファイルにはコンマ区切り列データが含まれています。
filename = fullfile(matlabroot,'examples','matlab','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
テキスト ファイルからの列見出しのないテーブルの作成
mySpaceDelimTable.txt ファイルをテキスト エディターに読み込み、その内容をプレビューします。スクリーン ショットを以下に示します。このファイルにはスペース区切り列データが含まれています。
filename = fullfile(matlabroot,'examples','matlab','mySpaceDelimTable.txt');
スペース区切りのテキスト ファイルから列見出しとしての変数名を含まないテーブルを作成します。
T = readtable(filename,... 'Delimiter',' ','ReadVariableNames',false)
T=3×5 table
Var1 Var2 Var3 Var4 Var5
____ ____ ____ ____ _______
'M' 45 45 'NY' 'true'
'F' 41 32 'CA' 'false'
'M' 40 34 'MA' 'false'
T には、既定の変数名が含まれます。
テキスト ファイルからのテーブルの作成と形式の設定
myCsvTable.dat ファイルをテキスト エディターに読み込み、その内容をプレビューします。スクリーン ショットを以下に示します。このファイルにはコンマ区切り列データが含まれています。
filename = fullfile(matlabroot,'examples','matlab','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 番目の列は数値となっています。
filename = fullfile(matlabroot,'examples','matlab','german_dates.txt');
readtable を使用してサンプル ファイルを読み取ります。変換指定子は日付では %D、浮動小数点値では %f です。ファイルのエンコードは、名前と値のペアの引数 FileEncoding で指定します。日付の書式とロケールは、名前と値のペアの引数 DateLocale で指定します。
T = readtable(filename,'ReadVariableNames',false,... '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 array
{'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: 'UTF-8'
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
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:
WhitespaceRule
Type
FillValue
Name
QuoteRule
TreatAsMissing
Prefixes
Suffixes
EmptyFieldRule
変数 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
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
入力引数
出力引数
ヒント
XLSX 形式の大きなファイルは読み取りに時間がかかることがあります。インポートとエクスポートのパフォーマンスを向上させるためには、XLSB 形式を使用することが Microsoft によって推奨されています。
参考
detectImportOptions | preview | table | textscan | writetable | インポート ツール
