readtable
파일에서 테이블 만들기
구문
설명
T = readtable(filename,Name,Value)ReadVariableNames 이름-값 인수를 사용하여 파일의 첫 번째 행을 변수 이름 또는 데이터로 읽어 올 수 있습니다.
T = readtable(filename,opts,Name,Value)readtable은 텍스트 파일에는 ReadVariableNames, ReadRowNames, DateLocale, Encoding 이름-값 인수만 지원하고 스프레드시트 파일에는 ReadVariableNames, ReadRowNames, Sheet, UseExcel 이름-값 인수만 지원합니다.
예제
텍스트 파일을 테이블로 읽어 들이기
텍스트 파일의 내용을 테이블로 가져옵니다. 생성되는 테이블은 파일의 각 열별로 변수를 하나씩 포함하고 파일의 첫 번째 라인에 있는 항목을 변수 이름으로 사용합니다.
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
누락된 데이터가 있는 텍스트 파일 읽기
데이터 누락이 있는 텍스트 파일에서 테이블을 만듭니다. 기본적으로 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
가져오기 옵션을 사용하여 텍스트 파일의 일부 읽어 들이기
import options 객체를 사용하여 readtable이 파일을 해석하는 방법을 구성합니다. 예를 들어 import options 객체를 사용하여 텍스트 파일의 일부만 읽어옵니다.
먼저, 변수 이름 및 유형, 구분자, 공백 문자를 포함한 텍스트 파일의 특징을 검출하기 위해 detectImportOptions를 사용해서 import options 객체를 만듭니다. 이 경우 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
import options 객체를 수정하여 가져올 변수의 서브셋을 지정합니다. 그런 다음 import options 객체와 함께 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
특정 범위를 사용하여 스프레드시트 파일 읽어 들이기
스프레드시트의 지정된 영역에 있는 데이터를 사용하여 테이블을 만듭니다. 끝 지점 C2와 E6 사이에 있는 5×3의 사각형 영역의 데이터를 사용합니다. 이 영역의 첫 번째 행을 변수 이름으로 사용하지 않습니다. 결과로 생성되는 테이블은 대신 디폴트 변수 이름을 사용합니다.
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
가져오기 옵션을 사용하여 스프레드시트 파일 읽어 들이기
import options 객체를 사용하여 readtable이 파일을 해석하는 방법을 구성합니다. 예를 들어, import options 객체를 사용하여 스프레드시트 파일에서 지정된 변수만 읽어옵니다.
먼저, 변수 이름 및 유형을 포함한 스프레드시트 파일의 특징을 검출하기 위해 detectImportOptions를 사용해서 파일에서 import options 객체를 만듭니다. 이 경우 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
import options 객체를 수정하여 가져올 변수를 지정합니다. 그런 다음 import options 객체와 함께 readtable을 사용하여 지정된 변수를 가져옵니다. 테이블의 처음 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 파일을 테이블로 읽어 들이기
XML 파일의 내용을 테이블로 가져옵니다.
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>
먼저, XML 파일의 특징을 검출하기 위해 detectImportOptions를 사용해서 XMLImportOptions 객체를 만듭니다. VariableSelectors 이름-값 인수를 Street 요소 노드의 XPath 표현식으로 지정하여 도로 이름만 테이블로 읽어옵니다. RegisteredNamespaces 이름-값 인수를 설정하여 사용자 지정 네임스페이스 접두사를 기존 네임스페이스 URL에 등록합니다.
opts = detectImportOptions("students.xml",RegisteredNamespaces=["myPrefix","https://www.mathworks.com"], ... VariableSelectors="//myPrefix:Street");
그런 다음 import options 객체와 함께 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 문서를 테이블로 읽어 들이기
Microsoft Word 문서의 테이블을 MATLAB의 테이블로 가져옵니다. 이 사례에서는 문서에 두 개의 테이블이 있고, 두 번째 테이블은 병합된 셀을 포함합니다. TableIndex 이름-값 인수를 설정하여 두 번째 테이블을 읽어 들입니다. 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 선택자를 사용하여 테이블을 선택할 수도 있습니다. "Description" 텍스트를 포함하는 Microsoft Word 문서 테이블을 선택하려면 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 웹페이지를 테이블로 읽어 들이기
XPath 선택자 "//TABLE[contains(.,'readtable')]"을 사용하여 URL https://www.mathworks.com/help/matlab/text-files.html에서 텍스트 "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"
입력 인수
출력 인수
확장 기능
버전 내역
R2013b에 개발됨참고 항목
함수
writetable|table|textscan|detectImportOptions|preview|readtimetable|readcell|readmatrix|readvars|setvaropts
라이브 편집기 작업
앱
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)