readtable
ファイルからのテーブルの作成
構文
説明
T = readtable(filename,Name=Value)ReadVariableNames を使用して、ファイルの最初の行を変数名またはデータとして読み取ることができます。
T = readtable(filename,opts,Name=Value)readtable はテキスト ファイルでは名前と値の引数 ReadVariableNames、ReadRowNames、DateLocale、および Encoding のみ、スプレッドシート ファイルでは名前と値の引数 ReadVariableNames、ReadRowNames、Sheet、および UseExcel のみをサポートします。
例
テキスト ファイルの内容を table にインポートします。作成された table にはファイルの列ごとに 1 つの変数が含まれ、ファイルの最初の行のエントリが変数名として使用されます。
T = readtable("myCsvTable.dat")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
データ ギャップが含まれているテキスト ファイルから table を作成します。既定では、readtable はギャップを適切な欠損値で埋めます。
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' } {0×0 char} NaN 64 119 0
データ ギャップのある行を省略するには、名前と値の引数 MissingRule を指定します。
T = readtable("headersAndMissing.txt",MissingRule="omitrow")
T=3×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
インポート オプション オブジェクトを使用して、readtable でファイルを解釈する方法を構成します。たとえば、インポート オプション オブジェクトを使用してテキスト ファイルのサブセットのみを読み取ります。
まず、変数の名前と型、区切り記号、空白文字など、テキスト ファイルの要素を検出するために detectImportOptions を使用してインポート オプション オブジェクトを作成します。この場合、detectImportOptions は DelimitedTextImportOptions オブジェクトを作成します。
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
インポート オプション オブジェクトを変更して、インポートする変数のサブセットを指定します。次に、インポート オプション オブジェクトを指定して readtable を使用し、データのサブセットをインポートします。
opts.SelectedVariableNames = ["TaxiIn","TaxiOut"]; T = readtable("airlinesmall.csv",opts);
スプレッドシートから、最初の行に変数名、最初の列に行名が含まれるテーブルを作成します。テーブルの最初の 5 行と最初の 4 つの変数を表示します。
T = readtable("patients.xls",ReadRowNames=true);
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
スプレッドシートの指定した領域のデータを使用して table を作成します。角 C2 と E6 の間にある 5 行 3 列の四角形領域のデータを使用します。この領域の最初の行は変数名として使用しないでください。作成された table では、代わりに既定の変数名が使用されます。
T = readtable("patients.xls",Range="C2:E6",ReadVariableNames=false)
T=5×3 table
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
インポート オプション オブジェクトを使用して、readtable でファイルを解釈する方法を構成します。たとえば、インポート オプション オブジェクトを使用して、スプレッドシート ファイルから指定した変数のみを読み取ります。
まず、変数の名前と型など、スプレッドシート ファイルの要素を検出するために detectImportOptions を使用してファイルからインポート オプション オブジェクトを作成します。この場合、detectImportOptions は SpreadsheetImportOptions オブジェクトを作成します。
opts = detectImportOptions("patients.xls")opts =
SpreadsheetImportOptions with properties:
Sheet Properties:
Sheet: ''
Replacement Properties:
MissingRule: 'fill'
ImportErrorRule: 'fill'
MergedCellColumnRule: 'placeleft'
MergedCellRowRule: 'placetop'
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
インポート オプション オブジェクトを変更して、インポートする変数を指定します。次に、インポート オプション オブジェクトを指定して readtable を使用し、指定した変数をインポートします。table の最初の 5 行を表示します。
opts.SelectedVariableNames = ["Systolic","Diastolic"]; T = readtable("patients.xls",opts); T(1:5,:)
ans=5×2 table
Systolic Diastolic
________ _________
124 93
109 77
125 83
117 75
122 80
XML ファイルの内容を table にインポートします。
students.xml ファイルには、Student という名前の 7 つの兄弟ノードがあり、それぞれに同じ子ノードと属性が含まれています。
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>
まず、detectImportOptions を使用して XMLImportOptions オブジェクトを作成し、XML ファイルの要素を検出します。Street 要素ノードの XPath 式として名前と値の引数 VariableSelectors を指定して、道路名だけを table に読み取ります。名前と値の引数 RegisteredNamespaces を設定して、既存の名前空間の URL にカスタムの名前空間接頭辞を登録します。
opts = detectImportOptions("students.xml",RegisteredNamespaces=["myPrefix","https://www.mathworks.com"], ... VariableSelectors="//myPrefix:Street");
次に、インポート オプション オブジェクトを指定して readtable を使用し、指定した変数をインポートします。
T = readtable("students.xml",opts)T=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 ドキュメントから table を MATLAB の table にインポートします。ここでは、ドキュメントに 2 つの table が含まれており、2 番目の table にマージされたセルが含まれています。名前と値の引数 TableIndex を設定して 2 番目の table を読み取ります。名前と値の引数 MergedCellColumnRule を設定して、列がマージされたセルがある行をスキップします。
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 セレクターで table を選択することもできます。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"
XPath セレクター "//TABLE[contains(.,'readtable')]" を使用して、URL https://www.mathworks.com/help/matlab/text-files.html から "readtable" というテキストを含む最初の table をインポートします。この table にはヘッダー行がないため、名前と値の引数 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"
