이 번역 페이지는 최신 내용을 담고 있지 않습니다. 최신 내용을 영문으로 보려면 여기를 클릭하십시오.
delimitedTextImportOptions
구분된 텍스트에 대한 import options 객체
설명
DelimitedTextImportOptions
객체를 사용하면 MATLAB®이 구분된 텍스트 파일에서 테이블 형식 데이터를 가져오는 방법을 지정할 수 있습니다. 이 객체는 누락된 데이터나 오류를 처리하는 속성과 데이터 가져오기 프로세스를 제어하는 속성을 가집니다.
생성
DelimitedTextImportOptions
객체는 detectImportOptions
함수 또는 여기에서 설명하는 delimitedTextImportOptions
함수를 사용하여 만들 수 있습니다.
detectImportOptions
를 사용하면filename
에 지정된 구분된 텍스트 파일의 내용을 기반으로 가져오기 속성을 감지하고 채울 수 있습니다.opts = detectImportOptions(filename);
delimitedTextImportOptions
를 사용하면 가져오기 요구 사항을 기반으로 가져오기 속성을 정의할 수 있습니다.
구문
설명
opts = delimitedTextImportOptions
는 1개의 변수를 갖는 DelimitedTextImportOptions
객체를 만듭니다.
입력 인수
변수 개수로, 양의 정수 스칼라로 지정됩니다.
속성
변수 속성
변수 이름으로, 문자형 벡터로 구성된 셀형 배열 또는 string형 배열로 지정됩니다. VariableNames
속성은 변수를 가져올 때 사용할 이름을 포함합니다.
데이터에 N
개 변수가 포함되어 있지만 변수 이름이 지정되지 않은 경우 VariableNames
속성은 {'Var1','Var2',...,'VarN'}
을 포함합니다.
공백과 비ASCII 문자가 포함된 변수 이름과 같이 유효하지 않은 MATLAB 식별자를 변수 이름으로 사용할 수 있도록 하려면 VariableNamingRule
의 값을 'preserve'
로 설정하십시오.
예: opts.VariableNames
는 현재(감지된) 변수 이름을 반환합니다.
예: opts.VariableNames(3) = {'Height'}
는 세 번째 변수의 이름을 Height
로 변경합니다.
데이터형: char
| string
| cell
변수 이름을 유지할지 지정하는 플래그로, "modify"
또는 "preserve"
중 하나로 지정됩니다.
"modify"
— 유효하지 않은 변수 이름(유효 여부는isvarname
함수의 판정에 따름)을 유효한 MATLAB 식별자로 변환합니다."preserve"
— 공백과 비ASCII 문자가 포함된 변수 이름과 같이 MATLAB 식별자로 유효하지 않은 변수 이름을 그대로 유지합니다.
R2019b부터 변수 이름과 행 이름에 공백, 비ASCII 문자 등 모든 문자를 사용할 수 있습니다. 또한 영문자뿐만 아니라 어떤 문자로도 시작할 수 있습니다. 변수 이름과 행 이름은 유효한 MATLAB 식별자(유효 여부는 isvarname
함수의 판정에 따름)가 아니어도 됩니다. 변수 이름과 행 이름을 그대로 유지하려면 VariableNamingRule
의 값을 "preserve"
로 설정하십시오. VariableNamingRule
의 값이 "modify"
에서 "preserve"
로 변경될 때 변수 이름은 새로 고쳐지지 않습니다.
데이터형: char
| string
변수의 데이터형으로, 유효한 데이터형 이름을 포함하는 문자형 벡터로 구성된 셀형 배열 또는 string형 배열로 지정됩니다. VariableTypes
속성은 변수를 가져올 때 사용할 데이터형을 지정합니다.
VariableTypes
속성을 업데이트하려면 setvartype
함수를 사용하십시오.
예: opts.VariableTypes
는 현재 변수 데이터형을 반환합니다.
예: opts = setvartype(opts,'Height',{'double'})
은 변수 Height
의 데이터형을 double
로 변경합니다.
가져올 변수의 서브셋으로, 문자형 벡터, string형 스칼라, 문자형 벡터로 구성된 셀형 배열, string형 배열 또는 숫자형 인덱스로 구성된 배열로 지정됩니다.
SelectedVariableNames
는 VariableNames
속성에 포함된 이름의 서브셋이어야 합니다. 기본적으로, SelectedVariableNames
는 VariableNames
속성의 모든 변수 이름을 포함합니다. 즉, 모든 변수를 가져옵니다.
원하는 변수만 가져오려면 SelectedVariableNames
속성을 사용하십시오. 변수의 서브셋만 가져오려면 SelectedVariableNames
속성을 사용하여 서브셋을 지정하고 readtable
을 사용하십시오.
공백과 비ASCII 문자가 포함된 변수 이름과 같이 유효하지 않은 MATLAB 식별자를 변수 이름으로 사용할 수 있도록 하려면 VariableNamingRule
의 값을 'preserve'
로 설정하십시오.
예: opts.SelectedVariableNames = {'Height','LastName'}
은 가져오기 작업에 두 개의 변수 Height
와 LastName
만 선택합니다.
예: opts.SelectedVariableNames = [1 5]
는 가져오기 작업에 두 개의 변수, 즉 첫 번째 변수와 다섯 번째 변수만 선택합니다.
예: T = readtable(filename,opts)
는 opts
객체의 SelectedVariableNames
속성에 지정된 변수만 포함하는 테이블을 반환합니다.
데이터형: uint16
| uint32
| uint64
| char
| string
| cell
유형별 변수 가져오기 옵션으로, variable import options 객체로 구성된 배열로 반환됩니다. 이 배열은 VariableNames
속성에 지정된 각 변수에 대응되는 객체를 포함합니다. 배열에 포함된 각 객체는 해당 데이터형 데이터를 가져오는 데 필요한 속성을 포함합니다.
변수 옵션은 숫자, 텍스트, logical
, datetime
, 또는 categorical
데이터형을 지원합니다.
변수에 대한 현재(또는 감지된) 옵션을 쿼리하려면 getvaropts
함수를 사용하십시오.
변수에 대해 옵션을 설정하고 사용자 지정하려면 setvaropts
함수를 사용하십시오.
예: opts.VariableOptions
는 VariableImportOptions
객체의 모음을 반환합니다. 모음에 포함된 각 객체는 데이터의 각 변수에 대응됩니다.
예: getvaropts(opts,'Height')
는 Height
변수에 대한 VariableImportOptions
객체를 반환합니다.
예: opts = setvaropts(opts,'Height','FillValue',0)
은 변수 Height
의 FillValue
속성을 0
으로 설정합니다.
위치 속성
데이터 위치로, 양의 정수 스칼라로 지정되거나 양의 정수 스칼라로 구성된 N-
x-2
배열로 지정됩니다. 다음 형식 중 하나를 사용하여 DataLines
를 지정하십시오.
다음으로 지정 | 설명 |
---|---|
| 데이터를 포함하는 첫 번째 라인을 지정합니다.
|
| 데이터를 포함하는 라인 범위를 지정합니다. 배열 |
|
여러 개의 라인 범위로 구성된 유효한 배열은 다음을 충족해야 합니다.
여러 라인 범위를 지정할 때는 배열의 마지막 라인 범위의 끝을 지정할 때만 |
예: opts.DataLines = 5
는 DataLines
속성을 값 [5 inf]
로 설정합니다. 5
행부터 파일 끝까지 모든 행을 읽어 들입니다.
예: opts.DataLines = [2 6]
은 라인 2
부터 6
까지 읽도록 속성을 설정합니다.
예: opts.DataLines = [1 3; 5 6; 8 inf]
는 1
행, 2
행, 3
행, 5
행, 6
행, 그리고 8
행과 파일 끝 사이의 모든 행을 읽도록 속성을 설정합니다.
데이터형: single
| double
| uint8
| uint16
| uint32
| uint64
행 이름 위치로, 양의 정수 스칼라로 지정됩니다. RowNamesColumn
속성은 행 이름을 포함하는 열의 위치를 지정합니다.
RowNamesColumn
이 0으로 지정된 경우 행 이름을 가져오지 않습니다. 그렇지 않은 경우, 지정된 열에서 행 이름을 가져옵니다.
예: opts.RowNamesColumn = 2;
데이터형: single
| double
| uint8
| uint16
| uint32
| uint64
변수 이름 위치로, 양의 정수 스칼라로 지정됩니다. VariableNamesLine
속성은 변수 이름이 위치하는 라인 번호를 지정합니다.
VariableNamesLine
이 0으로 지정된 경우 변수 이름을 가져오지 않습니다. 그렇지 않은 경우, 지정된 라인에서 변수 이름을 가져옵니다.
예: opts.VariableNamesLine = 6;
데이터형: single
| double
| uint8
| uint16
| uint32
| uint64
변수 설명 위치로, 양의 정수 스칼라로 지정됩니다. VariableDescriptionsLine
속성은 변수 설명이 위치하는 라인 번호를 지정합니다.
VariableDescriptionsLine
이 0으로 지정된 경우 변수 설명을 가져오지 않습니다. 그렇지 않은 경우, 지정된 라인에서 변수 설명을 가져옵니다.
예: opts.VariableDescriptionsLine = 7;
데이터형: single
| double
| uint8
| uint16
| uint32
| uint64
변수 단위 위치로, 양의 정수 스칼라로 지정됩니다. VariableUnitsLine
속성은 변수 단위가 위치하는 라인 번호를 지정합니다.
VariableUnitsLine
이 0으로 지정된 경우 변수 단위를 가져오지 않습니다. 그렇지 않은 경우, 지정된 라인에서 변수 단위를 가져옵니다.
예: opts.VariableUnitsLine = 8;
데이터형: single
| double
| uint8
| uint16
| uint32
| uint64
구분된 텍스트 속성
구분된 텍스트 파일의 필드 구분 기호 문자로, string형 배열, 문자형 벡터 또는 문자형 벡터로 구성된 셀형 배열로 지정됩니다.
예: "Delimiter","|"
예: "Delimiter",[";","*"]
공백으로 처리할 문자로, 하나 이상의 문자를 포함하는 문자형 벡터 또는 string형 스칼라로 지정됩니다.
예: 'Whitespace',' _'
예: 'Whitespace','?!.,'
라인 끝(EOL) 문자로, string형 배열, 문자형 벡터 또는 문자형 벡터로 구성된 셀형 배열로 지정됩니다.
예: "LineEnding","\n"
예: "LineEnding","\r\n"
예: "LineEnding",["\b",":"]
주석 스타일로, string형 배열, 문자형 벡터 또는 문자형 벡터로 구성된 셀형 배열로 지정됩니다. 단일 라인 주석과 여러 라인 주석의 경우, 시작 식별자는 공백이 아닌 첫 번째 문자여야 합니다. 단일 라인의 주석에서는 단일 식별자를 지정하여 해당 식별자로 시작하는 라인을 주석으로 처리하십시오. 여러 라인의 주석에서는 시작(첫 번째) 식별자에서 끝(두 번째) 식별자까지의 라인이 주석으로 처리됩니다. 식별자로 구성된 2개 이하의 문자형 벡터만 지정할 수 있습니다.
예를 들어, CommentStyle
을 "%"
로 지정하면 공백이 아닌 첫 번째 문자로서의 퍼센트 기호 다음에 오는 라인이 무시됩니다.
예: "CommentStyle",["/*"]
예: "CommentStyle",["/*","*/"]
구분된 텍스트 파일의 연속된 구분 기호를 관리하는 절차로, 다음 표에 있는 값 중 하나로 지정됩니다.
값 | 동작 |
---|---|
"split" | 연속된 구분 기호를 여러 개의 필드로 분할합니다. |
"join" | 여러 구분 기호를 하나의 구분 기호로 결합합니다. |
"error" | 오류를 반환하고 가져오기 작업을 취소합니다. |
구분된 텍스트 파일의 선행 구분 기호를 관리하는 방법으로, 다음 표에 있는 값 중 하나로 지정됩니다.
값 | 동작 |
---|---|
"keep" | 구분 기호를 유지합니다. |
"ignore" | 구분 기호를 무시합니다. |
"error" | 오류를 반환하고 가져오기 작업을 취소합니다. |
구분된 텍스트 파일의 후행 구분 기호를 관리하는 방법으로, 다음 표에 있는 값 중 하나로 지정됩니다.
선행 구분 기호 규칙 | 동작 |
---|---|
'keep' | 구분 기호를 유지합니다. |
'ignore' | 구분 기호를 무시합니다. |
'error' | 오류를 반환하고 가져오기 작업을 중단합니다. |
파일과 연결된 문자 인코딩 체계로, 'Encoding'
과 함께 'system'
또는 표준 문자 인코딩 체계 이름이 쉼표로 구분되어 지정됩니다.
인코딩을 지정하지 않은 경우 함수는 파일을 읽을 때 문자 집합을 자동으로 감지하여 인코딩을 결정합니다.
예: 'Encoding','system'
은 시스템 디폴트 인코딩을 사용합니다.
데이터형: char
| string
대체 규칙
누락된 데이터를 관리하는 방법으로, 다음 표에 있는 값 중 하나로 지정됩니다.
누락 규칙 | 동작 |
---|---|
'fill' | 누락된 데이터를
|
'error' | 가져오기를 중지하고 누락된 레코드와 필드를 보여주는 오류 메시지를 표시합니다. |
'omitrow' | 누락된 데이터가 포함된 행을 생략합니다. |
'omitvar' | 누락된 데이터가 포함된 변수를 생략합니다. |
예: opts.MissingRule = 'omitrow';
데이터형: char
| string
데이터의 빈 라인을 처리하는 절차로, 'skip'
, 'read'
또는 'error'
로 지정됩니다. 가져오기 함수는 공백을 빈 것으로 해석합니다.
빈 라인 규칙 | 동작 |
---|---|
'skip' | 빈 라인을 건너뜁니다. |
'read' | 빈 라인을 가져옵니다. 가져오기 함수는 VariableWidths , VariableOptions , MissingRule 과 기타 관련 속성(예: Whitespace )에 지정된 값을 사용하여 빈 라인을 구문 분석합니다. |
'error' | 오류 메시지를 표시하고 가져오기 작업을 중단합니다. |
예: opts.EmptyLineRule = 'skip';
데이터형: char
| string
가져오기 오류를 처리하는 절차로, 다음 표에 있는 값 중 하나로 지정됩니다.
가져오기 오류 규칙 | 동작 |
---|---|
'fill' | 오류가 발생한 데이터를
|
'error' | 가져오기를 중지하고 오류를 일으킨 레코드와 필드를 보여주는 오류 메시지를 표시합니다. |
'omitrow' | 오류가 발생한 행을 생략합니다. |
'omitvar' | 오류가 발생한 변수를 생략합니다. |
예: opts.ImportErrorRule = 'omitvar';
데이터형: char
| string
데이터의 추가 열을 처리하는 절차로, 다음 표에 있는 값 중 하나로 지정됩니다.
추가 열 규칙 | 동작 |
---|---|
'addvars' | 추가 열을 가져오기 위해 새 변수를 생성합니다. |
'ignore' | 데이터의 추가 열을 무시합니다. |
'wrap' | 새 레코드로 데이터의 추가 열을 줄 바꿈합니다. 이 동작을 수행해도 변수의 개수는 변경되지 않습니다. |
'error' | 오류 메시지를 표시하고 가져오기 작업을 중단합니다. |
데이터형: char
| string
객체 함수
getvaropts | 변수에 대한 가져오기 옵션 가져오기 |
setvaropts | 변수에 대한 가져오기 옵션 설정 |
setvartype | 변수 데이터형 설정 |
preview | 가져오기 옵션을 사용하여 파일에서 8개 행 미리보기 |
예제
patients.dat
에서 여러 개의 변수를 읽기 위한 import options 객체를 정의합니다.
파일의 내용에 따라 이러한 변수의 속성(이름, 유형, 구분 기호 문자, 데이터 시작 위치, 기타 열 규칙)을 정의합니다.
varNames = {'LastName','Gender','Age','Location','Height','Weight','Smoker'} ; varTypes = {'char','categorical','int32','char','double','double','logical'} ; delimiter = ','; dataStartLine = 2; extraColRule = 'ignore';
delimitedTextImportOptions
와 변수 정보를 사용하여 import options 객체 opts
를 초기화합니다.
opts = delimitedTextImportOptions('VariableNames',varNames,... 'VariableTypes',varTypes,... 'Delimiter',delimiter,... 'DataLines', dataStartLine,... 'ExtraColumnsRule',extraColRule);
preview
함수와 import options 객체를 사용하여 데이터를 미리 봅니다.
preview('patients.dat',opts)
ans=8×7 table
LastName Gender Age Location Height Weight Smoker
____________ ______ ___ _____________________________ ______ ______ ______
{'Smith' } Male 38 {'County General Hospital' } 71 176 true
{'Johnson' } Male 43 {'VA Hospital' } 69 163 false
{'Williams'} Female 38 {'St. Mary's Medical Center'} 64 131 false
{'Jones' } Female 40 {'VA Hospital' } 67 133 false
{'Brown' } Female 49 {'County General Hospital' } 64 119 false
{'Davis' } Female 46 {'St. Mary's Medical Center'} 68 142 false
{'Miller' } Female 33 {'VA Hospital' } 64 142 true
{'Wilson' } Male 40 {'VA Hospital' } 68 180 false
readtable
을 사용하여 데이터를 가져옵니다.
T = readtable('patients.dat',opts); whos T
Name Size Bytes Class Attributes T 100x7 33987 table
버전 내역
R2016b에 개발됨delimitedTextImportOptions
함수를 사용하여 DelimitedTextImportOptions
객체를 만들 수 있습니다. 이전에는 detectImportOptions
함수를 사용해야만 이 객체를 만들 수 있었습니다.
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
웹사이트 선택
번역된 콘텐츠를 보고 지역별 이벤트와 혜택을 살펴보려면 웹사이트를 선택하십시오. 현재 계신 지역에 따라 다음 웹사이트를 권장합니다:
또한 다음 목록에서 웹사이트를 선택하실 수도 있습니다.
사이트 성능 최적화 방법
최고의 사이트 성능을 위해 중국 사이트(중국어 또는 영어)를 선택하십시오. 현재 계신 지역에서는 다른 국가의 MathWorks 사이트 방문이 최적화되지 않았습니다.
미주
- América Latina (Español)
- Canada (English)
- United States (English)
유럽
- 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)