이 페이지의 최신 내용은 아직 번역되지 않았습니다. 최신 내용은 영문으로 볼 수 있습니다.

setvaropts

변수에 대한 가져오기 옵션 설정

구문

opts = setvaropts(opts,Name,Value)
opts = setvaropts(opts,selection,Name,Value)

설명

opts = setvaropts(opts,Name,Value)Name,Value 인수에 포함된 조건을 기반으로 하여 opts 객체에 포함된 모든 변수를 업데이트하고 opts 객체를 반환합니다.

예제

opts = setvaropts(opts,selection,Name,Value)Name,Value 인수에 포함된 조건을 기반으로 하여 selection 인수에 지정된 변수에 대한 opts 객체를 업데이트하고 반환합니다.

예제

모두 축소

import options 객체를 생성하고, 선택한 변수에 대한 옵션을 설정하고, 조정된 옵션과 readtable 함수를 사용하여 데이터를 가져옵니다.

스프레드시트 patients.xls에 대한 옵션 객체를 생성합니다.

opts = detectImportOptions('patients.xls');

Smoker, Diastolic, Systolic 변수에 대한 FillValue 속성을 설정합니다.

opts = setvaropts(opts,'Smoker','FillValue',false);
opts = setvaropts(opts,{'Diastolic','Systolic'},'FillValue',0);

가져올 변수를 선택합니다.

opts.SelectedVariableNames = {'Smoker','Diastolic','Systolic'};

변수를 가져오고 요약을 표시합니다.

T = readtable('patients.xls',opts); 
summary(T) 
Variables:

    Smoker: 100x1 logical

        Values:

            True        34   
            False       66   

    Diastolic: 100x1 double

        Values:

            Min            68    
            Median       81.5    
            Max            99    

    Systolic: 100x1 double

        Values:

            Min          109    
            Median       122    
            Max          138    

누락된 필드나 불완전 필드를 가지는 데이터를 가져오려면 누락된 인스턴스를 인식하고 누락된 인스턴스를 가져올 방법을 결정해야 합니다. importOptions를 사용하여 이러한 경우를 모두 포착하고 readtable을 사용하여 데이터를 가져옵니다.

파일에 대한 import options 객체를 생성하고, 누락된 데이터 가져오기를 제어하는 속성을 업데이트하고, readtable을 사용하여 데이터를 가져옵니다. 참고로, 데이터셋 airlinesmall.csvNA로 지정된 누락된 데이터를 포함하는 두 개의 숫자형 변수 ArrDelayDepDelay를 가집니다.

파일에서 import options 객체를 생성합니다.

opts = detectImportOptions('airlinesmall.csv');

TreatAsMissing 속성을 사용하여 데이터에서 누락된 인스턴스로 간주할 자리 표시자 문자를 지정합니다. 이 예제에서 두 개의 숫자형 변수 ArrDelayDepDelay에는 텍스트 NA를 포함하는 누락된 필드가 있습니다.

opts = setvaropts(opts,{'ArrDelay','DepDelay'},'TreatAsMissing','NA');

누락된 인스턴스를 가져올 때 가져오기 함수가 취할 동작을 지정합니다. 추가 옵션은 ImportOptions 속성 페이지를 참조하십시오.

opts.MissingRule = 'fill';

가져오기 함수가 누락된 인스턴스를 발견할 경우 사용할 값을 지정합니다. 여기서는 변수 ArrDelayDepDelay에서 누락된 인스턴스가 0으로 대체됩니다.

opts = setvaropts(opts,{'ArrDelay','DepDelay'},'FillValue',0);

작업할 변수를 선택하고 readtable을 사용하여 가져옵니다.

opts.SelectedVariableNames = {'ArrDelay','DepDelay'}; 
T = readtable('airlinesmall.csv',opts);

ArrDelayDepDelay의 값을 검토합니다. 가져오기 함수가 NA로 표시된 누락된 값을 대체했는지 확인합니다.

T(166:180,:)
ans=15×2 table
    ArrDelay    DepDelay
    ________    ________

       -1           0   
      102         105   
      -11           0   
        0           0   
       -1           0   
        0           0   
        1           0   
        1           0   
       14           0   
      -14           0   
        5           0   
       25          38   
        0          -5   
        0           0   
        6           0   

setvaropts 함수를 사용하여 텍스트 데이터 가져오기를 제어하는 속성을 업데이트합니다. 우선, 파일에 대한 import options 객체를 가져옵니다. 다음으로, 텍스트 변수에 대한 옵션을 검토하고 업데이트합니다. 마지막으로, readtable 함수를 사용하여 변수를 가져옵니다.

patients.xls의 데이터를 미리 봅니다. 열 LastName에 텍스트 데이터가 있는 것을 알 수 있습니다. 여기에는 처음 10개 행의 미리보기만 표시되어 있습니다.

import options 객체를 가져옵니다.

opts = detectImportOptions('patients.xls');

변수 LastName에 대한 VariableImportOptions를 가져오고 검토합니다.

getvaropts(opts,'LastName')
ans = 
  TextVariableImportOptions with properties:

   Variable Properties:
              Name: 'LastName'
              Type: 'char'
         FillValue: ''
    TreatAsMissing: {}
         QuoteRule: 'remove'
          Prefixes: {}
          Suffixes: {}
    EmptyFieldRule: 'missing'

   String Options:
    WhitespaceRule: 'trim'

변수의 데이터형을 string으로 설정합니다.

opts = setvartype(opts,'LastName','string');

누락된 값을 'NoName'으로 대체하도록 변수의 FillValue 속성을 설정합니다.

opts = setvaropts(opts,'LastName','FillValue','NoName');

변수의 처음 10개 행에 대한 미리보기를 선택하여 읽고 표시합니다.

opts.SelectedVariableNames = 'LastName';
T = readtable('patients.xls',opts); 
T.LastName(1:10)
ans = 10x1 string array
    "Smith"
    "Johnson"
    "Williams"
    "Jones"
    "Brown"
    "Davis"
    "Miller"
    "Wilson"
    "Moore"
    "Taylor"

setvaropts 함수를 사용하여 logical형 데이터 가져오기를 제어하는 속성을 업데이트합니다. 우선, 파일에 대한 import options 객체를 가져옵니다. 다음으로, 논리형 변수에 대한 옵션을 검토하고 업데이트합니다. 마지막으로, readtable 함수를 사용하여 변수를 가져옵니다.

airlinesmall_subset.xlsx의 데이터를 미리 봅니다. 열 Cancelled에 논리형 데이터가 있는 것을 알 수 있습니다. 여기에는 행 30~40의 미리보기만 표시되어 있습니다.

import options 객체를 가져옵니다.

opts = detectImportOptions('airlinesmall_subset.xlsx');

변수 Cancelled에 대한 VariableImportOptions를 가져오고 검토합니다.

getvaropts(opts,'Cancelled')
ans = 
  NumericVariableImportOptions with properties:

   Variable Properties:
                  Name: 'Cancelled'
                  Type: 'double'
             FillValue: NaN
        TreatAsMissing: {}
             QuoteRule: 'remove'
              Prefixes: {}
              Suffixes: {}
        EmptyFieldRule: 'missing'

   Numeric Options:
     ExponentCharacter: 'eEdD'
      DecimalSeparator: '.'
    ThousandsSeparator: ''
        TrimNonNumeric: 0

변수의 데이터형을 logical으로 설정합니다.

opts = setvartype(opts,'Cancelled','logical');

누락된 값을 true으로 대체하도록 변수의 FillValue 속성을 설정합니다.

opts = setvaropts(opts,'Cancelled','FillValue',true);

변수의 요약을 선택하여 읽고 표시합니다.

opts.SelectedVariableNames = 'Cancelled';
T = readtable('airlinesmall_subset.xlsx',opts); 
summary(T)
Variables:

    Cancelled: 1338x1 logical

        Values:

            True          29    
            False       1309    

DatetimeVariableImportOptions 속성을 사용하여 datetime형 데이터 가져오기를 제어합니다. 먼저, 파일에 대한 ImportOptions 객체를 가져옵니다. 다음으로, datetime형 변수에 대한 VariableImportOptions를 검토하고 업데이트합니다. 마지막으로, readtable을 사용하여 변수를 가져옵니다.

outages.csv의 데이터를 미리 봅니다. 열 OutageTimeRestorationTime에 날짜/시간 데이터가 있다는 것을 알 수 있습니다. 여기에는 처음 10개 행만 표시되어 있습니다.

import options 객체를 가져옵니다.

opts = detectImportOptions('outages.csv');

datetime형 변수 OutageTimeRestorationTime에 대한 VariableImportOptions를 가져오고 검토합니다.

varOpts = getvaropts(opts,{'OutageTime','RestorationTime'})
varOpts = 
  1x2 DatetimeVariableImportOptions array with properties:

    DatetimeFormat
    DatetimeLocale
    InputFormat
    Type
    FillValue
    TimeZone
    Name
    QuoteRule
    TreatAsMissing
    Prefixes
    Suffixes
    EmptyFieldRule

누락된 값을 현재 날짜와 시간으로 대체하도록 변수의 FillValue 속성을 설정합니다.

opts = setvaropts(opts,{'OutageTime','RestorationTime'},...
                                           'FillValue','now');

두 개의 변수를 선택하여 읽고 미리 봅니다. RestorationTime의 두 번째 행에서 누락된 값이 현재 날짜와 시간으로 채워져 있는 것을 알 수 있습니다.

opts.SelectedVariableNames = {'OutageTime','RestorationTime'};
T = readtable('outages.csv',opts); 
T(1:10,:)
ans=10×2 table
         OutageTime           RestorationTime   
    ____________________    ____________________

    01-Feb-2002 12:18:00    07-Feb-2002 16:50:00
    23-Jan-2003 00:49:00    02-Aug-2018 18:21:47
    07-Feb-2003 21:15:00    17-Feb-2003 08:14:00
    06-Apr-2004 05:44:00    06-Apr-2004 06:10:00
    16-Mar-2002 06:18:00    18-Mar-2002 23:23:00
    18-Jun-2003 02:49:00    18-Jun-2003 10:54:00
    20-Jun-2004 14:39:00    20-Jun-2004 19:16:00
    06-Jun-2002 19:28:00    07-Jun-2002 00:51:00
    16-Jul-2003 16:23:00    17-Jul-2003 01:12:00
    27-Sep-2004 11:09:00    27-Sep-2004 16:37:00

setvaropts 함수를 사용하여 categorical형 데이터 가져오기를 제어하는 속성을 업데이트합니다. 우선, 파일에 대한 import options 객체를 가져옵니다. 다음으로, categorical형 변수에 대한 옵션을 검토하고 업데이트합니다. 마지막으로, readtable 함수를 사용하여 변수를 가져옵니다.

outages.csv의 데이터를 미리 봅니다. 열 RegionCause에 categorical형 데이터가 있는 것을 알 수 있습니다. 다음 표에는 처음 10개 행만 표시되어 있습니다.

import options 객체를 가져옵니다.

opts = detectImportOptions('outages.csv');

변수 RegionCause에 대한 옵션을 가져오고 검토합니다.

getvaropts(opts,{'Region','Cause'})
ans = 
  1x2 TextVariableImportOptions array with properties:

    WhitespaceRule
    Type
    FillValue
    Name
    QuoteRule
    TreatAsMissing
    Prefixes
    Suffixes
    EmptyFieldRule

변수의 데이터형을 categorical로 설정합니다.

opts = setvartype(opts,{'Region','Cause'},'categorical');

누락된 값을 범주 이름 'Miscellaneous'로 대체하도록 변수의 FillValue 속성을 설정합니다. TreatAsMissing 속성을 'unknown'으로 설정합니다.

opts = setvaropts(opts,{'Region','Cause'},...
                                   'FillValue','Miscellaneous',...
                                   'TreatAsMissing','unknown');

두 개 변수의 요약을 선택하여 읽고 표시합니다.

opts.SelectedVariableNames = {'Region','Cause'};
T = readtable('outages.csv',opts); 
summary(T)
Variables:

    Region: 1468x1 categorical

        Values:

            MidWest        142   
            NorthEast      557   
            SouthEast      389   
            SouthWest       26   
            West           354   

    Cause: 1468x1 categorical

        Values:

            Miscellaneous          24  
            attack                294  
            earthquake              2  
            energy emergency      188  
            equipment fault       156  
            fire                   25  
            severe storm          338  
            thunder storm         201  
            wind                   95  
            winter storm          145  

원치 않는 접두사 문자와 접미사 문자를 포함하는 변수를 갖는 테이블 형식 데이터를 가져옵니다. 먼저 import options 객체를 생성하여 데이터를 미리 봅니다. 그런 다음 원하는 변수를 선택하고 해당 변수의 변수 유형과 속성을 설정하여 원치 않는 문자를 제거합니다. 마지막으로 원하는 데이터를 가져옵니다.

파일의 가져오기 옵션을 생성하고 테이블을 미리 봅니다.

filename = 'pref_suff_trim.csv';
opts = detectImportOptions(filename);
preview(filename,opts)
ans=8×5 table
             Time                 DayOfWeek          Power        Total_Fees    Temperature
    _______________________    _______________    ____________    __________    ___________

    'Timestamp:1/1/06 0:00'    '& Sun %20'    '54.5448 MW'    '$1.23'       '-7.2222 C'
    'Timestamp:1/2/06 1:00'    '& Thu %20'    '.3898 MW'      '$300.00'     '-7.3056 C'
    'Timestamp:1/3/06 2:00'    '& Sun %20'    '51.6344 MW'    '£2.50'      '-7.8528 C'
    'Timestamp:1/4/06 3:00'    '& Sun %20'    '51.5597 MW'    '$0.00'       '-8.1778 C'
    'Timestamp:1/5/06 4:00'    '& Wed %20'    '51.7148 MW'    'Â¥4.00'      '-8.9343 C'
    'Timestamp:1/6/06 5:00'    '& Sun %20'    '52.6898 MW'    '$0.00'       '-8.7556 C'
    'Timestamp:1/7/06 6:00'    '& Mon %20'    '55.341 MW'     '$50.70'      '-8.0417 C'
    'Timestamp:1/8/06 7:00'    '& Sat %20'    '57.9512 MW'    '$0.00'       '-8.2028 C'

원하는 변수를 선택하고 선택한 변수의 유형을 지정한 다음 변수 가져오기 옵션 값을 검토합니다.

opts.SelectedVariableNames = {'Time','Total_Fees','Temperature'};
opts = setvartype(opts,'Time','datetime');
opts = setvaropts(opts,'Time','InputFormat','MM/dd/uu HH:mm'); % Specify datetime format
opts = setvartype(opts,{'Total_Fees','Temperature'},'double');
getvaropts(opts,{'Time','Total_Fees','Temperature'})
ans = 
    1x3 VariableImportOptions array with properties:

   Variable Options:
                         (1) |          (2) |           (3)  
            Name:     'Time' | 'Total_Fees' | 'Temperature'
            Type: 'datetime' |     'double' |      'double'
       FillValue:      [NaT] |        [NaN] |         [NaN]
  TreatAsMissing:         {} |           {} |            {}
       QuoteRule:   'remove' |     'remove' |      'remove'
        Prefixes:         {} |           {} |            {}
        Suffixes:         {} |           {} |            {}

	To access sub-properties of each variable, use getvaropts

변수 가져오기 옵션의 Prefixes 속성, Suffixes 속성, TrimNonNumeric 속성이 변수 Time에서 'Timestamp:'를 제거하고, 변수 Temperature에서 접미사 'C'를 제거하고, 변수 Total_Fees에서 숫자형이 아닌 모든 문자를 제거하도록 설정합니다. 새로운 가져오기 옵션을 갖는 테이블을 미리 봅니다.

opts = setvaropts(opts,'Time','Prefixes','Timestamp:');
opts = setvaropts(opts,'Temperature','Suffixes','C');
opts = setvaropts(opts,'Total_Fees','TrimNonNumeric',true);
preview(filename,opts)
ans=8×3 table
         Time         Total_Fees    Temperature
    ______________    __________    ___________

    01/01/06 00:00       1.23         -7.2222  
    01/02/06 01:00        300         -7.3056  
    01/03/06 02:00        2.5         -7.8528  
    01/04/06 03:00          0         -8.1778  
    01/05/06 04:00          4         -8.9343  
    01/06/06 05:00          0         -8.7556  
    01/07/06 06:00       50.7         -8.0417  
    01/08/06 07:00          0         -8.2028  

readtable을 사용하여 데이터를 가져옵니다.

T = readtable(filename,opts);

빈 필드를 포함하는 파일에 대한 import options 객체를 생성합니다. EmptyFieldRule 파라미터를 사용하여 데이터의 빈 필드에 대한 가져오기를 관리합니다. 먼저 데이터를 미리 본 다음 특정 변수에 대해 EmptyFieldRule 파라미터를 설정합니다. 마지막으로, 모든 변수에 대해 EmptyFieldRule 을 설정하고 데이터를 가져옵니다.

빈 필드를 포함하는 파일에 대한 import options 객체를 생성합니다. preview 함수를 사용하여 테이블의 처음 8개 행을 가져옵니다. EmptyFieldRule의 디폴트 값은 'missing'입니다. 따라서 가져오기 함수는 빈 필드를 누락된 것으로 처리하고 해당 필드를 이 변수의 FillValue 값으로 대체합니다. 세 번째 변수에 대해 VariableOptions를 사용하여 데이터를 미리 봅니다. 이때 preview 함수는 세 번째 변수의 빈 필드를 NaN으로 가져옵니다.

filename = 'DataWithEmptyFields.csv';
opts = detectImportOptions(filename);
opts.VariableOptions(3) % Display the Variable Options for the 3rd Variable
ans = 
  NumericVariableImportOptions with properties:

   Variable Properties:
                  Name: 'Double'
                  Type: 'double'
             FillValue: NaN
        TreatAsMissing: {}
             QuoteRule: 'remove'
              Prefixes: {}
              Suffixes: {}
        EmptyFieldRule: 'missing'

   Numeric Options:
     ExponentCharacter: 'eEdD'
      DecimalSeparator: '.'
    ThousandsSeparator: ''
        TrimNonNumeric: 0

preview(filename,opts)
ans=8×7 table
    Text     Categorical    Double          Datetime          Logical    Duration    String
    _____    ___________    ______    ____________________    _______    ________    ______

    'abc'        'a'           1      14-Jan-0018 00:00:00    'TRUE'     00:00:01    'abc' 
    ''           'b'           2      21-Jan-0018 00:00:00    'FALSE'    09:00:01    'def' 
    'ghi'        ''            3      31-Jan-0018 00:00:00    'TRUE'     02:00:01    'ghi' 
    'jkl'        'a'         NaN      23-Feb-2018 00:00:00    'FALSE'    03:00:01    'jkl' 
    'mno'        'a'           4                       NaT    'FALSE'    04:00:01    'mno' 
    'pqr'        'b'           5      23-Jan-0018 00:00:00    ''         05:00:01    'pqr' 
    'stu'        'b'           5      23-Mar-0018 00:00:00    'FALSE'         NaN    'stu' 
    ''           'a'           6      24-Mar-2018 00:00:00    'TRUE'     07:00:01    ''    

테이블의 두 번째 변수에 대해 EmptyFieldRule을 설정합니다. 먼저 변수를 선택한 다음 EmptyFieldRule'auto'로 설정합니다. 여기서 readtable 함수는 categorical형 변수의 빈 필드를 <undefined>로 가져옵니다.

opts.SelectedVariableNames = 'Categorical'; 
opts = setvartype(opts,'Categorical','categorical'); 
opts = setvaropts(opts,'Categorical','EmptyFieldRule','auto');
T = readtable(filename,opts)
T=11×1 table
    Categorical
    ___________

    a          
    b          
    <undefined>
    a          
    a          
    b          
    b          
    a          
    a          
    <undefined>
    <undefined>

그런 다음 테이블의 모든 변수에 대해 EmptyFieldRule 파라미터를 설정합니다. 먼저 변수의 데이터형을 적절히 업데이트합니다. 이 예제에서는 5번째 변수와 7번째 변수의 데이터형을 각각 logicalstring으로 설정합니다. 그런 다음 모든 변수에 대해 EmptyFieldRule'auto'로 설정합니다. 가져오기 함수는 변수의 데이터형을 기준으로 빈 필드를 가져옵니다. 이때 readtable 함수는 logical형 변수의 빈 필드를 0으로 가져오고 categorical형 변수의 빈 필드를 <undefined>로 가져옵니다.

VariableNames = opts.VariableNames;
opts.SelectedVariableNames =  VariableNames; % select all variables
opts = setvartype(opts,{'Logical','String'},{'logical','string'});
opts = setvaropts(opts,VariableNames,'EmptyFieldRule','auto');
T = readtable(filename,opts)
T=11×7 table
    Text     Categorical    Double          Datetime          Logical    Duration     String  
    _____    ___________    ______    ____________________    _______    ________    _________

    'abc'    a                 1      14-Jan-0018 00:00:00     true      00:00:01    "abc"    
    ''       b                 2      21-Jan-0018 00:00:00     false     09:00:01    "def"    
    'ghi'    <undefined>       3      31-Jan-0018 00:00:00     true      02:00:01    "ghi"    
    'jkl'    a               NaN      23-Feb-2018 00:00:00     false     03:00:01    "jkl"    
    'mno'    a                 4                       NaT     false     04:00:01    "mno"    
    'pqr'    b                 5      23-Jan-0018 00:00:00     false     05:00:01    "pqr"    
    'stu'    b                 5      23-Mar-0018 00:00:00     false          NaN    "stu"    
    ''       a                 6      24-Mar-2018 00:00:00     true      07:00:01    ""       
    ''       a                 7      25-Mar-2018 00:00:00     true      08:00:01    ""       
    'xyz'    <undefined>     NaN                       NaT     true      06:00:01    "xyz"    
    ''       <undefined>     NaN                       NaT     false          NaN    <missing>

EmptyFieldRule 파라미터는 'missing''auto' 외에도 'error'로 설정할 수 있습니다. 'error'로 설정하는 경우 readtable 함수는 ImportErrorRule 파라미터에 지정된 방법에 따라 빈 필드를 가져옵니다.

입력 인수

모두 축소

파일 가져오기 옵션으로, detectImportOptions 함수에 의해 생성된 SpreadsheetImportOptions, DelimitedTextImportOptions 또는 FixedWidthImportOptions 객체로 지정됩니다. opts 객체는 변수 속성, 데이터 위치 속성, 대체 규칙 같은 데이터 가져오기 프로세스를 제어하는 속성을 포함합니다.

선택한 변수로, 문자형 벡터, string형 스칼라, 문자형 벡터로 구성된 셀형 배열, string형 배열, 숫자형 인덱스로 구성된 배열 또는 논리형 배열로 지정됩니다.

변수 이름(또는 인덱스)은 opts 객체의 VariableNames 속성에 포함된 이름의 서브셋이어야 합니다.

예: 'Height'

예: {'Height','LastName'}

예: [5 9]

데이터형: char | string | cell | uint64 | logical

이름-값 쌍의 인수

선택적으로 Name,Value 인수가 쉼표로 구분되어 지정됩니다. 여기서 Name은 인수 이름이고 Value는 대응값입니다. Name은 따옴표 안에 표시해야 합니다. Name1,Value1,...,NameN,ValueN과 같이 여러 개의 이름-값 쌍의 인수를 어떤 순서로든 지정할 수 있습니다.

예: opts = setvaropts(opts,'Weight','FillValue',0)은 변수 Weight에 대한 FillValue0으로 설정합니다.

모든 변수 유형의 공통 옵션

모두 축소

누락된 데이터에 대한 대체 값으로, 변수의 유형에 따라 문자형 벡터, string형 스칼라, 숫자형 스칼라, 논리값 true 또는 false로 지정됩니다.

변수의 유형설명
텍스트

대체 텍스트로, 문자형 벡터 또는 string형 스칼라로 지정됩니다.

예: 'not applicable'

숫자형

누락된 인스턴스를 대체할 숫자형 스칼라

가져오기 함수는 FillValue에 대한 입력값을 변수의 Type 속성으로 지정된 데이터형으로 변환합니다. 예를 들어, Type 속성값이 uint8이면 가져오기 함수가 FillValue 속성의 값도 uint8로 변환합니다.

예: 0

논리형

true 또는 false.

예: false

datetime형

날짜/시간 데이터를 나타내는 문자형 벡터나 string형 스칼라, 또는 스칼라 값. 유효한 datetime형 입력값에 대한 자세한 내용은 datetime 함수 도움말 페이지를 참조하십시오.

예: 'now'는 누락된 datetime형 인스턴스를 현재 날짜/시간으로 설정합니다.

예: [1998 12 1]은 누락된 datetime형 인스턴스를 1998년 12월 1일로 설정합니다.

duration형

duration형 데이터를 나타내는 문자형 벡터나 string형 스칼라, 또는 스칼라 값. 유효한 duration형 입력값에 대한 자세한 내용은 duration 함수 페이지를 참조하십시오.

예: '12:30:16'은 누락된 duration형 인스턴스를 12시간, 30분, 16초의 duration형 데이터로 설정합니다.

categorical형

대체 범주에 사용할 이름을 포함하는 문자형 벡터 또는 string형 스칼라.

예: 'Miscellaneous'는 categorical형 데이터에서 누락된 인스턴스에 범주 이름 Miscellaneous를 할당합니다.

누락되거나 변환할 수 없거나 오류를 발생시킨 데이터를 가져오도록 지시하려면 FillValue, TreatAsMissing, MissingRule, ErrorRule의 4개 속성을 함께 사용하십시오. 가져오기 함수는 다음과 같은 경우 FillValue 속성에 지정된 값을 사용합니다.

  • 데이터가 TreatAsMissing의 값과 일치하거나 변환할 수 없는 경우.

  • MissingRule 또는 ErrorRulefill로 설정된 경우.

누락된 데이터로 해석할 텍스트로, 문자형 벡터, string형 스칼라, 문자형 벡터로 구성된 셀형 배열 또는 string형 배열로 지정됩니다.

가져오기 함수가 누락된 인스턴스를 발견하면 MissingRule 속성의 조건을 사용하여 적합한 동작을 결정합니다.

예: 'TreatAsMissing',{'NA','TBD'}는 가져오기 함수에 NA 또는 TBD 인스턴스를 누락된 필드로 처리하도록 지시합니다.

데이터형: char | string | cell

데이터에서 큰따옴표를 관리하는 방법으로, 다음 표에 있는 값 중 하나로 지정됩니다.

따옴표 규칙프로세스
'remove'

큰따옴표(")로 문자가 묶여 있으면 가져오기 함수가 여는 큰따옴표와, 닫는 따옴표로 해석되는 그 다음 큰따옴표를 모두 제거합니다.

예: "500"500으로 가져옵니다.

두 개의 큰따옴표("") 세트로 문자가 묶여 있으면 가져오기 함수가 처음 두 개의 큰따옴표를 제거합니다.

예: ""abc""abc""로 가져옵니다.

문자를 둘러싸는 여는 따옴표와 닫는 따옴표 쌍 다음에 쌍으로 구성되지 않은 단일의 큰따옴표가 오는 경우, 가져오기 함수는 쌍으로 구성되지 않은 이 단일 큰따옴표를 무시합니다.

예: "abc""abc"로 가져옵니다.

'keep'

모든 따옴표를 유지합니다.

'error'큰따옴표(")로 시작하는 데이터를 변환할 때 오류를 보고합니다. 필드가 따옴표로 묶이면 안 되는 경우 이 설정을 사용하십시오.

예: 'QuoteRule''remove'로 설정되어 있으면 가져오기 함수가 "abc"def"abcdef"로 가져옵니다.

데이터형: char | string

데이터의 빈 필드를 관리하는 방법으로, 다음 값 중 하나로 지정됩니다.

  • 'missing'MissingRule 속성에 지정된 방법 사용

  • 'error'ImportErrorRule 속성에 지정된 방법 사용

  • 'auto' — 변수의 데이터형을 기준으로 빈 값 사용

    데이터형빈 값
    text

    길이가 0인 char 또는 string

    numeric

    부동소수점 숫자의 경우 NaN

    정수의 경우 0

    duration

    NaN

    datetime

    NaT

    logical

    false

    categorical

    <undefined>

예: opts = setvaropts(opts,'RestorationTime','EmptyFieldRule','auto');

데이터형: char | string

변수 값의 접두사 위치에서 제거할 텍스트로, 문자형 벡터, 문자형 벡터로 구성된 셀형 배열, string형 스칼라 또는 string형 배열로 지정됩니다.

예: opts = setvaropts(opts,'Var1','Prefixes','$')는 변수 Var1Prefixes 옵션을 설정합니다. Var1이 값 '$500'를 포함하면 readtable은 이것을 '500'으로 읽어 들입니다.

데이터형: char | string | cell

변수 값의 접미사 위치에서 제거할 텍스트로, 문자형 벡터, 문자형 벡터로 구성된 셀형 배열, string형 스칼라 또는 string형 배열로 지정됩니다.

예: opts = setvaropts(opts,'Var1','Suffixes','/-')는 변수 Var1Suffixes 옵션을 설정합니다. Var1이 값 '$500/-'를 포함하면 readtable은 이것을 '$500'로 읽어 들입니다.

데이터형: char | string | cell

텍스트 변수 옵션

모두 축소

텍스트 데이터를 가져올 때 선행 공백과 후행 공백을 관리하는 방법으로, 다음 표에 있는 값 중 하나로 지정됩니다.

공백 규칙프로세스
'trim'

텍스트에서 선행 공백이나 후행 공백을 제거합니다. 내부 공백은 영향을 받지 않습니다.

예: ' World Time ''World Time'으로 가져옵니다.

'trimleading'

선행 공백만 제거합니다.

예: ' World Time ''World Time '으로 가져옵니다.

'trimtrailing'

후행 공백만 제거합니다.

예: ' World Time ''World Time'으로 가져옵니다.

'preserve'

공백을 유지합니다.

예: ' World Time '' World Time '으로 가져옵니다.

데이터형: char | string

숫자형 변수 옵션

모두 축소

지수를 나타내는 문자로, 문자형 벡터 또는 string형 스칼라로 지정됩니다. 가져오기 함수는 과학 표기법으로 표현된 숫자의 지수를 나타내는 문자를 ExponentCharacter 속성을 사용하여 인식합니다.

예: varOpts.ExponentCharacter = 'a'인 경우 가져오기 함수가 텍스트 "1.2a3"을 숫자 1200으로 가져옵니다.

데이터형: char | string

소수점 구분 기호를 나타내는 문자로, 문자형 벡터 또는 string형 스칼라로 지정됩니다. 가져오기 함수는 DecimalSeparator 속성을 사용하여 숫자의 정수부와 소수부를 구별합니다.

정수 데이터형으로 변환할 때는 소수부 숫자가 가장 가까운 정수로 반올림됩니다.

예: varOpts.DecimalSeparator = ','인 경우 가져오기 함수는 텍스트 "3,14159"를 숫자 3.14159로 가져옵니다.

데이터형: char | string

천 단위 분류를 나타내는 문자로, 문자형 벡터 또는 string형 스칼라로 지정됩니다. 천 단위 분류 문자는 매 세 자리값에서 숫자를 분류하는 시각적 구분 기호로 동작합니다. 가져오기 함수는 ThousandsSeparator 속성의 문자를 사용하여 가져올 숫자를 해석합니다.

예: varOpts.ThousandsSeparator = ','인 경우 가져오기 함수는 텍스트 "1,234,000"1234000으로 가져옵니다.

데이터형: char | string

숫자형 변수에서 숫자형이 아닌 문자를 제거하며, 논리형 true 또는 false로 지정됩니다.

예: opts = setvaropts(opts,'Var1','TrimNonNumeric',true)는 변수 Var1TrimNonNumeric 옵션을 설정합니다. Var1이 값 '$500/-'를 포함하면 readtable은 이것을 500으로 읽어 들입니다.

데이터형: logical

논리형 변수 옵션

모두 축소

논리값 true로 처리할 텍스트로, 문자형 벡터, string형 스칼라, 문자형 벡터로 구성된 셀형 배열 또는 string형 배열로 지정됩니다.

예: varOpts.TrueSymbols = {'t','TRUE'}인 경우 가져오기 함수는 tTRUE를 포함하는 모든 필드를 논리값 true로 가져옵니다.

데이터형: char | string | cell

논리값 false로 처리할 텍스트로, 문자형 벡터, string형 스칼라, 문자형 벡터로 구성된 셀형 배열 또는 string형 배열로 지정됩니다.

예: varOpts.FalseSymbols = {'f','FALSE'}인 경우 가져오기 함수는 fFALSE를 포함하는 모든 필드를 논리값 false로 가져옵니다.

데이터형: char | string | cell

대/소문자를 구분할지 여부에 대한 표시자로, 논리값 true 또는 false로 지정됩니다.

입력 데이터를 누락된 값, true, false 중 하나로 해석하기 위해 가져오기 함수는 데이터를 TreatAsMissing, TrueSymbols, FalseSymbols에 지정된 값과 일치시킵니다.

datetime형 변수 옵션

모두 축소

표시 형식으로, 문자형 벡터 또는 string형 스칼라로 지정됩니다. DatetimeFormat 속성은 출력값에서 날짜/시간의 표시 형식을 제어합니다. DatetimeFormat을 다음 값 중 하나로 지정합니다.

DatetimeFormat의 값설명

'default'

디폴트 표시 형식을 사용합니다.

'defaultdate'

시간 구성요소 없이 생성된 datetime형 값의 디폴트 표시 형식을 사용합니다.

'preserveinput'

입력 형식 InputFormat으로 지정된 형식을 사용합니다.

사용자 지정 형식

문자 A-Za-z를 사용하여 DatetimeFormat의 사용자 지정 값을 생성합니다. 이러한 문자는 날짜의 Unicode® LDML(Locale Data Markup Language) 표준에 대응합니다. 비ASCII 문자나 하이픈, 공백, 콜론과 같은 비문자를 포함하여 필드를 구분할 수 있습니다. 문자 A-Za-z를 형식에 리터럴 문자로 포함하려면 문자를 작은따옴표로 묶으십시오.

공장 초기화 형식은 시스템 로케일에 따라 다릅니다. 디폴트 표시 형식을 변경하려면 datetime형의 디폴트 형식 항목을 참조하십시오.

데이터형: char | string

날짜/시간을 나타내는 입력 텍스트 형식으로, 문자 식별자를 포함하는 문자형 벡터 또는 string형 스칼라로 지정됩니다.

다음 표에는 여러 가지 일반적인 입력 형식이 나와 있으며, 뉴욕 시의 날짜 2014년 4월 19일 토요일 9:41:06 PM에 대해 형식이 지정된 입력값의 예를 보여줍니다.

InputFormat의 값예제
'yyyy-MM-dd'2014-04-19
'dd/MM/yyyy'19/04/2014
'dd.MM.yyyy'19.04.2014
'yyyy年 MM月 dd日'2014年 04月 19日
'MMMM d, yyyy'April 19, 2014
'eeee, MMMM d, yyyy h:mm a'Saturday, April 19, 2014 9:41 PM
'MMMM d, yyyy HH:mm:ss Z'April 19, 2014 21:41:06 -0400
'yyyy-MM-dd''T''HH:mmXXX' 2014-04-19T21:41-04:00

유효한 문자 식별자의 전체 목록을 보려면 datetime형 배열의 Format 속성을 참조하십시오.

예: 'InputFormat','eeee, MMMM d, yyyy HH:mm:ss'

데이터형: char | string

날짜를 해석하는 데 사용할 로케일로, 문자형 벡터 또는 string형 스칼라로 지정됩니다. DatetimeLocale 값은 가져오기 함수가 날짜/시간을 나타내는 텍스트를 해석하는 방법을 결정합니다.

DatetimeLocale을 다음 값 중 하나로 설정하십시오.

  • 'system' — 시스템 로케일을 지정합니다.

  • 문자형 벡터 또는 string형 스칼라 — xx_YY 형식을 사용하십시오. 여기서 xx는 언어를 지정하는 ISO 639-1 두 자로 된 코드(소문자)이고, YY는 국가를 지정하는 ISO 3166-1 alpha-2 코드(대문자)입니다.

다음 표에는 로케일에 일반적으로 사용되는 일부 값이 나와 있습니다.

로케일 언어국가
'de_DE'독일어독일
'en_GB'영어영국
'en_US'영어미국
'es_ES'스페인어스페인
'fr_FR'프랑스어프랑스
'it_IT'이탈리아어이탈리아
'ja_JP'일본어일본
'ko_KR'한국어한국
'nl_NL'네덜란드어네덜란드
'zh_CN'중국어(간체)중국

예: varOpts.DatetimeLocale = 'de_DE'는 날짜/시간 로케일을 독일어로 설정합니다.

참고

Locale 값에 따라 입력값이 해석되는 방식이 결정됩니다. 표시 형식과 언어는 기본 설정 패널의 날짜/시간 형식 섹션에 있는 로케일 옵션에 의해 지정됩니다. 디폴트 날짜/시간 로케일을 변경하려면 명령 창 기본 설정 지정하기 항목을 참조하십시오.

데이터형: char | string

표준 시간대로, 문자형 벡터 또는 string형 스칼라로 지정됩니다. TimeZone의 값은 가져오기 함수가 입력 데이터를 해석하는 데 사용하는 표준 시간대를 지정합니다. TimeZone은 출력 배열의 표준 시간대도 지정합니다. 입력 데이터가 표준 시간대를 포함하는 문자형 벡터이면 가져오기 함수는 모든 값을 지정된 표준 시간대로 변환합니다.

TimeZone은 다음 값 중 하나를 사용합니다.

  • ''. 특정 표준 시간대에 속하지 않는 “표준 시간대가 지정되지 않은” datetime형 값을 만들려는 경우 사용합니다.

  • IANA 표준 시간대 데이터베이스의 표준 시간대 영역(예: 'America/Los_Angeles'). 표준 시간대 영역의 이름은 지리적 지역에서 준수하는, UTC와의 표준 오프셋 및 일광 절약 시간제 오프셋에 대한 현재 규칙과 이전 규칙을 고려합니다.

  • +HH:mm 또는 -HH:mm 형식의 ISO 8601 문자형 벡터. 예를 들어, '+01:00'은 UTC로부터의 고정된 오프셋인 표준 시간대를 지정합니다.

  • 'UTC'. UTC 기준 datetime형 값을 만들려는 경우 사용합니다.

  • 'UTCLeapSeconds'. 윤초(Leap Second)를 고려하는 UTC 기준 datetime형 값을 만들려는 경우 사용합니다.

다음 표에는 IANA 표준 시간대 데이터베이스에 제공된 표준 시간대 영역의 일반적인 이름이 나와 있습니다.

TimeZone의 값UTC 오프셋UTC DST 오프셋
'Africa/Johannesburg'+02:00+02:00
'America/Chicago'−06:00−05:00
'America/Denver'−07:00−06:00
'America/Los_Angeles'−08:00−07:00
'America/New_York'−05:00−04:00
'America/Sao_Paulo'−03:00−02:00
'Asia/Hong_Kong'+08:00+08:00
'Asia/Kolkata'+05:30+05:30
'Asia/Tokyo'+09:00+09:00
'Australia/Sydney'+10:00+11:00
'Europe/London'+00:00+01:00
'Europe/Zurich'+01:00+02:00

지정된 TimeZone이 없는 datetime형 배열은 TimeZone 속성이 특정 표준 시간대로 설정된 배열과 비교하거나 결합할 수 없습니다.

데이터형: char | string

범주 관련 변수 옵션

모두 축소

예상 범주로, 범주 이름 목록을 포함하는 문자형 벡터로 구성된 셀형 배열 또는 string형 배열로 지정됩니다.

변환 오류를 피하려면 입력 필드의 이름이 Categories 속성에 지정된 이름 중 하나와 일치해야 합니다.

예: varOpts.Categories = {'BareLand','Forest','Water','Roads','Buildings'};

범주 보호 표시자로, 논리형 true 또는 false로 지정됩니다. 순서형 categorical형 배열의 범주는 항상 보호됩니다. Ordinal 속성이 true로 설정될 경우 Protected의 디폴트 값은 true가 됩니다. 그렇지 않을 경우, Protected의 값은 false가 됩니다. categorical형 배열에 대한 자세한 내용은 categorical 함수 도움말 페이지를 참조하십시오.

수학적 정렬 표시자로, false, true, 0, 1 중 하나로 지정됩니다. categorical형 배열에 대한 자세한 내용은 categorical 함수 도움말 페이지를 참조하십시오.

기간 관련 변수 옵션

모두 축소

duration형 데이터를 나타내는 입력 텍스트의 형식으로, 문자형 벡터 또는 string형 배열로 지정됩니다.

InputFormat을 다음 형식 중 하나로 지정합니다. 여기서 dd, hh, mm, ss는 각각 일, 시, 분, 초를 나타냅니다.

  • 'dd:hh:mm:ss'

  • 'hh:mm:ss'

  • 'mm:ss'

  • 'hh:mm'

  • 처음 세 형식 중 하나와, 소수 초(Fractional Second) 자릿수를 나타내는 최대 9개의 S 문자를 함께 사용(예: 'hh:mm:ss.SSSS')

예: varOpts.InputFormat = 'dd:hh:mm:ss'

데이터형: char | string

duration형 데이터의 표시 형식으로, 문자형 벡터 또는 string형 스칼라로 지정됩니다.

시간 단위를 포함한 숫자의 경우, 다음 값 중 하나를 지정하십시오.

  • 'y' — 고정 길이 연 수. 1년은 365.2425일입니다.

  • 'd' — 고정 길이 일 수. 1일은 24시간입니다.

  • 'h' — 시간

  • 'm' — 분

  • 's' — 초

디지털 타이머의 경우, 다음 형식 중 하나를 지정하십시오.

  • 'dd:hh:mm:ss'

  • 'hh:mm:ss'

  • 'mm:ss'

  • 'hh:mm'

  • 처음 세 형식 중 하나와, 소수 초(Fractional Second) 자릿수를 나타내는 최대 9개의 S 문자를 함께 사용(예: 'hh:mm:ss.SSSS')

예: DurationFormat은 시간 단위를 포함한 단일 숫자(예: 0.5 yr)이거나 디지털 타이머(예: 10:30:15 - 10시간, 30분, 15초)일 수 있습니다.

데이터형: char | string

소수 초를 구분하는 문자로, 문자형 벡터 또는 string형 스칼라로 지정됩니다. 가져오기 함수는 DecimalSeparator 속성을 사용하여 duration형 값의 정수부와 소수 초 부분을 구분합니다.

데이터형: char | string

duration형 데이터의 필드 구분을 나타내는 문자로, 문자형 벡터 또는 string형 스칼라로 지정됩니다.

데이터형: char | string

R2016b에 개발됨