이 페이지의 최신 내용은 아직 번역되지 않았습니다. 최신 내용은 영문으로 볼 수 있습니다.
readtable
파일에서 테이블 만들기
설명
T = readtable(filename)
readtable은 다음과 같은 파일 확장자에서 파일 형식을 결정합니다.
.txt,.dat,.csv- 기호로 구분된 텍스트 파일.xls,.xlsb,.xlsm,.xlsx,.xltm,.xltx,.ods- 스프레드시트 파일
readtable은 파일의 각 열별로 변수를 하나씩 T에 만들고, 그 변수 이름은 파일의 첫 번째 행에서 읽어 들입니다. 기본적으로 readtable은 입력 파일의 각 열에서 감지된 데이터 값에 적합한 데이터형의 변수를 생성합니다.
T = readtable(___,Name,Value)readtable이 파일의 첫 번째 행을 변수 이름으로 읽을지 또는 데이터로 읽을지 여부를 지정할 수 있습니다.
데이터에 대한 특정 가져오기 옵션을 설정하기 위해 opts 객체를 사용하거나 이름-값 쌍을 지정할 수 있습니다. opts에 더해 이름-값 쌍을 지정하는 경우, readtable은 다음과 같은 이름-값 쌍만 지원합니다.
텍스트 및 스프레드시트 파라미터 —
ReadVariableNames,ReadRowNames텍스트 전용 파라미터 —
DateLocale,Encoding스프레드시트 전용 파라미터 —
Sheet,UseExcel
예제
텍스트 파일에서 테이블 만들기
파일 myCsvTable.dat를 불러오고 텍스트 편집기에서 파일 내용을 미리 봅니다. 아래에 스크린샷이 나와 있습니다. 파일에 쉼표로 구분된 열 방향 데이터가 포함되어 있음을 알 수 있습니다.
filename = 'myCsvTable.dat';
쉼표로 구분된 텍스트 파일에서 테이블을 생성합니다. 생성되는 테이블 T에 파일의 각 열별로 변수가 하나씩 포함되고 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 파일을 미리 봅니다. 파일에는 열 이름이 있는 라인과 헤더가 있는 라인이 있습니다. 마지막 두 행에는 빈 곳이 있습니다. 앞에 있는 행들의 경우, 그곳에 데이터 값이 들어 있습니다.
파일에서 테이블을 생성합니다. 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은 헤더를 데이터로 읽어 들이고 결과적으로 모든 테이블 변수를 텍스트로 변환합니다.
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 파일을 미리 봅니다. 아래에 스크린샷이 나와 있습니다. 파일에 공백으로 구분된 열 방향 데이터가 포함되어 있음을 알 수 있습니다.
공백으로 구분된 텍스트 파일에서 테이블을 생성합니다. 파일의 첫 번째 행에 감지 가능한 열 이름이 없으므로 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';
쉼표로 구분된 텍스트 파일에서 테이블을 생성합니다. 처음 두 열을 문자형 벡터로 가져오고 세 번째 열을 uint32로, 그 다음의 두 열을 배정밀도 부동소수점 숫자로 가져옵니다. 마지막 열의 항목은 문자형 벡터로 가져옵니다.
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'}
변환 지정자는 문자형 벡터로 구성된 셀형 배열의 경우 %s이고, double형의 경우 %f이며, uint32형의 경우 %u입니다.
텍스트 파일에서 다른 언어 날짜 읽기
파일에서 독일식 날짜를 읽고 테이블에 영어권 국가의 날짜로 추가합니다.
텍스트 편집기에서 german_dates.txt 파일을 미리 봅니다. 아래에 스크린샷이 나와 있습니다. 값의 첫 번째 열에는 독일식 날짜가 포함되어 있고 두 번째 및 세 번째 열에는 숫자형 값이 들어 있습니다.
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의 지정된 영역의 데이터를 사용하여 테이블을 만듭니다. 끝 지점 C2와 E6 사이에 있는 5x3의 사각형 영역의 데이터를 사용합니다. 이 영역의 첫 번째 행을 변수 이름으로 사용하지 않습니다.
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에는 디폴트 변수 이름이 포함되어 있습니다.
텍스트 파일에 대한 가져오기 옵션을 감지하고 사용하기
가져오기 옵션을 만들고 여러 변수의 데이터형을 조정한 후 데이터를 읽어 들입니다.
텍스트 파일에서 import options 객체를 만듭니다.
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'};options 객체와 함께 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
스프레드시트 파일에 대한 가져오기 옵션을 감지하고 사용하기
스프레드시트 파일에 대한 가져오기 옵션을 감지하고, 가져올 변수를 지정한 다음 데이터를 읽어 들입니다.
파일에서 import options 객체를 만듭니다.
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
options 객체를 수정하여 가져올 변수를 지정합니다.
opts.SelectedVariableNames = {'Systolic','Diastolic'};options 객체와 함께 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 문자 등의 임의의 문자를 포함하는 변수 이름을 유지하면서 테이블 형식의 데이터를 읽을 수 있습니다. 먼저 임의의 변수 이름이 있는 테이블을 만들어 텍스트 파일에 씁니다. 그런 다음 원래 변수 이름을 그대로 유지한 채 테이블 형식 데이터를 다시 읽어 들입니다.
임의의 변수 이름이 있는 테이블을 만들어 테이블 형식 데이터를 파일 '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진수를 읽고 테이블에 숫자형 변수로 저장할 수 있습니다. readtable 함수는 0x 및 0b 접두사가 포함된 경우 자동으로 16진수 및 2진수를 각각 읽어 들입니다. 숫자형 값은 정수 데이터형을 사용하여 저장됩니다. 또한 접두사가 없는 경우 가져오기 옵션을 사용하여 이러한 숫자를 읽어 들일 수 있습니다.
텍스트 편집기에서 hexAndBinary.txt 파일을 미리 봅니다. 접두사가 있는 16진수 및 2진수 열과 함께 접두사가 없는 열이 하나 있습니다.
readtable을 사용하여 파일을 읽어 들입니다. 이 함수는 0x 및 0b 접두사가 있는 숫자를 감지하여 정수로 저장합니다. 세 번째 열에는 접두사가 없으므로 해당 값은 텍스트로 처리됩니다.
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에 대한 import options 객체를 생성합니다.
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
접두사가 없어도 세 번째 열을 16진수 값으로 가져오도록 지정하려면 setvaropts 함수를 사용하여 테이블의 세 번째 변수에 대한 변수 유형을 수정하십시오. 변수 유형을 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
파일을 읽고 세 번째 열을 텍스트가 아니라 숫자형 값으로 가져옵니다.
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 형식의 대용량 파일은 불러오는 속도가 느린 경우가 있습니다. 더 나은 가져오기 및 내보내기 성능을 위해 Microsoft는 XLSB 형식을 사용할 것을 권장합니다.
호환성 관련 고려 사항
참고 항목
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)
