readtable
ファイルからのテーブルの作成
構文
説明
T = readtable(filename,Name,Value)ReadVariableNames を使用して、ファイルの最初の行を変数名またはデータとして読み取ることができます。
T = readtable(filename,opts,Name,Value)readtable はテキスト ファイルでは名前と値の引数 ReadVariableNames、ReadRowNames、DateLocale、および Encoding のみ、スプレッドシート ファイルでは名前と値の引数 ReadVariableNames、ReadRowNames、Sheet、および UseExcel のみをサポートします。
例
テキスト ファイルの table としての読み取り
テキスト ファイルの内容を 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' } {0x0 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: [1-by-29 matlab.io.VariableImportOptions]
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);
行名を含む table としてのスプレッドシート ファイルの読み取り
スプレッドシートから、最初の行に変数名、最初の列に行名が含まれるテーブルを作成します。テーブルの最初の 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'
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: [1-by-10 matlab.io.VariableImportOptions]
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 としての読み取り
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 としての読み取り
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"
HTML Web ページの table としての読み取り
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"
入力引数
出力引数
拡張機能
バージョン履歴
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)