setvaropts

Установите переменные настройки импорта

Описание

opts = setvaropts(opts,Name,Value) обновления все переменные в opts основанный на объектах на технических требованиях в Name,Value аргументы и возвращают opts объект.

пример

opts = setvaropts(opts,selection,Name,Value) обновления и возвращают opts для переменных, заданных в selection аргумент, на основе технических требований в Name,Value аргументы.

Примеры

свернуть все

Создайте объект настроек импорта, установите опции для выбранных переменных и импортируйте данные с помощью адаптированных опций и readtable функция.

Создайте объект опций для электронной таблицы patients.xls.

opts = detectImportOptions('patients.xls');

Установите FillValue свойство для Smoker, Diastolic, и Systolic переменные.

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.

Создайте объект настроек импорта для файла, свойства обновления, которые управляют импортом недостающих данных, и затем используют readtable импортировать данные. Обратите внимание на то, что набор данных airlinesmall.csv имеет две числовых переменные ArrDelay и DepDelay, это содержит недостающие данные, обозначенные NA.

Создайте объект настроек импорта из файла.

opts = detectImportOptions('airlinesmall.csv');

Используйте TreatAsMissing свойство задать символы в данных, которые являются заполнителями для недостающих экземпляров. В этом примере, эти две числовые переменные ArrDelay и DepDelay содержите недостающие поля, которые содержат текст NA.

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

Задайте действие для функции импорта, чтобы взять при импорте недостающих экземпляров. Смотрите ImportOptions страница свойств для большего количества опций.

opts.MissingRule = 'fill';

Задайте значение, чтобы использовать, когда функция импорта найдет недостающий экземпляр. Здесь недостающие экземпляры в переменных ArrDelay и DepDelay заменяются 0.

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

Выберите переменные, с которыми вы хотите работать и импортировать их использующий readtable.

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

Исследуйте значения в ArrDelay и DepDelay. Проверьте, что функция импорта заменила отсутствующие значения, обозначенные 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   

readtable функция автоматически обнаруживает шестнадцатеричные и двоичные числа с 0x и 0b префиксы. Чтобы импортировать такие числа, когда у них не будет префиксов, используйте объект настроек импорта.

Создайте объект настроек импорта для файла hexAndBinary.txt. Его третий столбец имеет шестнадцатеричные числа без 0x префикс.

opts = detectImportOptions('hexAndBinary.txt')
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: '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
           VariableNamingRule: 'modify'

   Location Properties:
                    DataLines: [1 Inf]
            VariableNamesLine: 0
               RowNamesColumn: 0
            VariableUnitsLine: 0
     VariableDescriptionsLine: 0 
	To display a preview of the table, use preview

Чтобы указать, что третий столбец должен быть импортирован, как, шестнадцатеричные значения, несмотря на отсутствие префикса, используют setvaropts функция. Установите тип переменной третьей переменной к int32. Установите систему счисления для импорта третьего столбца к hex.

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'
       TrailingDelimitersRule: 'ignore'
                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
           VariableNamingRule: 'modify'

   Location Properties:
                    DataLines: [1 Inf]
            VariableNamesLine: 0
               RowNamesColumn: 0
            VariableUnitsLine: 0
     VariableDescriptionsLine: 0 
	To display a preview of the table, use preview

Считайте файл и импортируйте первые три столбца как числовые значения. readtable функция автоматически обнаруживает, что первые и вторые столбцы содержат шестнадцатеричные и двоичные значения. Объект настроек импорта указывает, что третий столбец также содержит шестнадцатеричные значения.

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'}

Используйте setvaropts функционируйте, чтобы обновить свойства, которые управляют импортом текстовых данных. Во-первых, получите объект настроек импорта для файла. Затем исследуйте и обновите опции для текстовых переменных. Наконец, импортируйте переменные с помощью readtable функция.

Предварительно просмотрите данные в patients.xls. Заметьте текстовые данные в столбце LastName. Только предварительный просмотр первых 10 строк показывают здесь.

Получите объект настроек импорта.

opts = detectImportOptions('patients.xls');

Получите и исследуйте VariableImportOptions для переменной LastName.

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');

Установите FillValue свойство переменной заменить отсутствующие значения на 'NoName'.

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

Выберите, считайте и отобразите предварительный просмотр первых 10 строк переменной.

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

Используйте setvaropts функционируйте, чтобы обновить свойства, которые управляют импортом logical данные. Во-первых, получите объект настроек импорта для файла. Затем исследуйте и обновите опции для логических переменных. Наконец, импортируйте переменные с помощью readtable функция.

Предварительно просмотрите данные в airlinesmall_subset.xlsx. Заметьте логические данные в столбце Cancelled. Только предварительный просмотр строк 30 - 40 показывают здесь.

Получите объект настроек импорта.

opts = detectImportOptions('airlinesmall_subset.xlsx');

Получите и исследуйте VariableImportOptions для переменной Cancelled.

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
          NumberSystem: 'decimal'

Установите тип данных переменной к logical.

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

Установите FillValue свойство переменной заменить отсутствующие значения на true.

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 объект для файла. Затем исследуйте и обновите VariableImportOptions для переменных datetime. Наконец, импортируйте переменные с помощью readtable.

Предварительный просмотр данных в outages.csv. Заметьте данные о дате и времени в столбцах OutageTime и RestorationTime. Только первые 10 строк показывают здесь.

Получите объект настроек импорта.

opts = detectImportOptions('outages.csv');

Получите и исследуйте VariableImportOptions для переменных OutageTime datetime и RestorationTime.

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

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

Установите 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 
    ________________    ________________

    2002-02-01 12:18    2002-02-07 16:50
    2003-01-23 00:49    2021-03-23 17:10
    2003-02-07 21:15    2003-02-17 08:14
    2004-04-06 05:44    2004-04-06 06:10
    2002-03-16 06:18    2002-03-18 23:23
    2003-06-18 02:49    2003-06-18 10:54
    2004-06-20 14:39    2004-06-20 19:16
    2002-06-06 19:28    2002-06-07 00:51
    2003-07-16 16:23    2003-07-17 01:12
    2004-09-27 11:09    2004-09-27 16:37

Используйте setvaropts функционируйте, чтобы обновить свойства, которые управляют импортом categorical данные. Во-первых, получите объект настроек импорта для файла. Затем исследуйте и обновите опции для категориальных переменных. Наконец, импортируйте переменные с помощью readtable функция.

Предварительно просмотрите данные в outages.csv. Заметьте категориальные данные в столбцах Region и Cause. Эта таблица показывает только первые 10 строк.

Получите объект настроек импорта.

opts = detectImportOptions('outages.csv');

Получите и исследуйте опции на переменные Region и Cause.

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

    Name
    Type
    FillValue
    TreatAsMissing
    QuoteRule
    Prefixes
    Suffixes
    EmptyFieldRule
    WhitespaceRule

Установите тип данных переменных к categorical.

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

Установите FillValue свойство переменных заменить отсутствующие значения на название категории 'Miscellaneous'. Установите 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   

Импортируйте табличные данные содержащие переменные, которые имеют нежелательные префиксные и суффиксные символы. Во-первых, создайте, настройки импорта возражают и предварительно просматривают данные. Затем выберите переменные интереса и установите их типы переменных и свойства удалить нежелательные символы. Наконец, импортируйте данные интереса.

Создайте настройки импорта для файла и предварительно просмотрите таблицу.

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 свойства переменных настроек импорта удалить 'Timestamp:' от переменной Time, удалите суффиксный 'C' от переменной Temperature, и удалите все нечисловые символы из переменной 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);

Создайте объект настроек импорта для файла, содержащего пустые поля. Используйте EmptyFieldRule параметр, чтобы управлять импортом пустых полей в ваших данных. Во-первых, предварительно просмотрите данные, и затем установите EmptyFieldRule параметр для определенной переменной. Наконец, установите EmptyFieldRule для всех переменных и импортируют данные.

Создайте объект настроек импорта для файла, содержащего пустые поля. Получите первые восемь строк таблицы с помощью preview функция. Значение по умолчанию для EmptyFieldRule ismissing. Поэтому функция импорта обрабатывает пустые поля как пропавших без вести и заменяет их на FillValue значение для той переменной. Используя VariableOptions для третьей переменной предварительно просмотрите данные. Здесь, preview функционируйте импортирует пустые поля в третьей переменной как NaNs.

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
          NumberSystem: 'decimal'

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

    {'abc'   }    {'a'     }        1      01/14/0018    {'TRUE'  }    00:00:01    {'abc'   }
    {0x0 char}    {'b'     }        2      01/21/0018    {'FALSE' }    09:00:01    {'def'   }
    {'ghi'   }    {0x0 char}        3      01/31/0018    {'TRUE'  }    02:00:01    {'ghi'   }
    {'jkl'   }    {'a'     }      NaN      02/23/2018    {'FALSE' }    03:00:01    {'jkl'   }
    {'mno'   }    {'a'     }        4             NaT    {'FALSE' }    04:00:01    {'mno'   }
    {'pqr'   }    {'b'     }        5      01/23/0018    {0x0 char}    05:00:01    {'pqr'   }
    {'stu'   }    {'b'     }        5      03/23/0018    {'FALSE' }         NaN    {'stu'   }
    {0x0 char}    {'a'     }        6      03/24/2018    {'TRUE'  }    07:00:01    {0x0 char}

Установите 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=10×1 table
    Categorical
    ___________

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

Затем установите EmptyFieldRule параметр для всех переменных в таблице. Во-первых, обновите типы данных переменных соответственно. В данном примере установите тип данных пятых и седьмых переменных к logical и string, соответственно. Затем установите 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=10×7 table
       Text       Categorical    Double     Datetime     Logical    Duration     String  
    __________    ___________    ______    __________    _______    ________    _________

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

В дополнение к 'missing' и 'auto', можно также установить EmptyFieldRule параметр к 'error'. Когда вы устанавливаете его на 'error', readtable функционируйте импортирует пустые поля путем выполнения процедуры, заданной в ImportErrorRule параметр.

Входные параметры

свернуть все

Настройки импорта файла в виде SpreadsheetImportOptionsDelimitedTextImportOptions, или FixedWidthImportOptions объект, созданный detectImportOptions функция. opts объект содержит свойства, которые управляют процессом импорта данных, таким как переменные свойства, свойства местоположения данных, заменяющие правила и другие.

Выбранные переменные в виде вектора символов, строкового скаляра, массива ячеек из символьных векторов, массива строк, массива числовых индексов или логического массива.

Имена переменных (или индексы) должны быть подмножеством имен, содержавшихся в VariableNames свойство opts объект.

Пример: '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) устанавливает FillValue для переменной Weight к 0.
Общие опции для всех тип переменных

свернуть все

Тип данных переменных в виде перечисленного в таблице типа данных.

Тип данных

Описание

'char'

'string'

Текст.

'single'

'double'

Один - или числа плавающей точки двойной точности.

'int8'int16int32int64

'uint8'uint16uint32uint64

Целые числа со знаком или беззнаковое целое, сохраненное как 8-, 16-, 32-, или 64-битные целые числа.

Целочисленные типы данных не задают значения, соответствующие числам с плавающей запятой NaNInf, и +Inf. Поэтому, когда вы импортируете данные с плавающей точкой как массив целых чисел, функция импорта преобразует неопределенные числа с плавающей запятой:

  • NaN преобразован в 0.

  • -Inf преобразован в самое маленькое целое число для заданного целочисленного типа данных с помощью intmin функция.

  • +Inf преобразован в самое большое целое число для заданного целочисленного типа данных с помощью intmax функция.

'logical'

Истинные или ложные значения (например, trueложь, 1, или 0).

'datetime'

Даты и времена, которые задают моменты времени (например, 2019-12-10 09:12:56 задавая 10 декабря 2019, 9:12:56 a.m.).

'duration'

Отрезки времени (например, 05:13:45 определение 5 часов, 13 минут и 45 секунд).

'categorical'

Числовой или текстовые данные, которые задают категории (например, 'red', 'green', и 'blue' определение имен трех категорий).

Заменяющее значение для недостающих данных, в зависимости от типа переменной в виде вектора символов, строкового скаляра, числовой скаляр, или логическое значение true или false.

Тип переменнойОписание
Текст

Текст замены, заданный как вектор символов или строковый скаляр.

Пример: 'not applicable'

Числовой

Скаляр, числовой, чтобы заменить недостающие экземпляры

Функция импорта преобразует вход для FillValue к типу данных, заданному Type свойство переменной. Например, если Type значением свойства является uint8, затем функция импорта также преобразует значение FillValue свойство к uint8.

Пример: 0

Логический

true или false.

Пример: false

Datetime

Вектор символов или строковый скаляр или скалярное значение, представляющее данные о дате и времени. Для получения дополнительной информации о допустимом datetime входные параметры, смотрите datetime функциональная страница.

Пример: 'now' устанавливает недостающие экземпляры datetime на текущую дату и время.

Пример: [1998 12 1] устанавливает недостающие экземпляры datetime на дату 1-го декабря 1998.

Длительность

Вектор символов или строковый скаляр или скалярное значение, представляющее данные о длительности. Для получения дополнительной информации о допустимом duration входные параметры, смотрите duration функциональная страница.

Пример: '12:30:16' устанавливает недостающие экземпляры длительности на длительность 12 часов, 30 минут и 16 секунд.

Категориальный

Вектор символов или строковый скаляр, содержащий имя, чтобы использовать для заменяющей категории.

Пример: 'Miscellaneous' присваивает Разное названия категории недостающим экземплярам в категориальных данных.

Чтобы направить импорт данных, которые отсутствуют, неконвертируемый, или это вызывает ошибки, используйте эти четыре свойства вместе: FillValue'TreatAsMissing' MissingRule , и ErrorRule. Функция импорта использует значение, заданное в FillValue свойство, когда:

  • Данные неконвертируемы или совпадают со значением в TreatAsMissing.

  • MissingRule или ErrorRule установлен в fill.

Текст, чтобы интерпретировать как недостающие данные в виде вектора символов, строкового скаляра, массива ячеек из символьных векторов или массива строк.

Когда функция импорта находит недостающие экземпляры, она использует спецификацию в MissingRule свойство определить соответствующие меры.

Пример: 'TreatAsMissing',{'NA','TBD'} дает функции импорта команду обрабатывать любое вхождение NA или TBD как недостающие поля.

Типы данных: char | string | cell

Процедура, чтобы управлять двойными кавычками в данных в виде одного из значений в этой таблице.

'QuoteRule' Процесс
'remove'

Если двойные кавычки (") окружите символы, затем функция импорта удаляет и вводную двойную кавычку и следующую происходящую двойную кавычку, которая была бы интерпретирована как заключительная двойная кавычка.

Пример: "500" импортируется как 500.

Если два набора двойных кавычек ("") окружите символы, затем функция импорта удаляет первые два случаев.

Пример: ""abc"" импортируется как abc"".

Если пара открытия и закрытия заключает окружающие символы в кавычки, сопровождается синглом одинокие непарные двойные кавычки, то функция импорта игнорирует одинокую непарную двойную кавычку.

Пример: "abc"" импортируется как abc".

'keep'

Сохраните все кавычки.

'error'Сообщите об ошибке при преобразовании данных, которые начинаются с двойной кавычки ("). Используйте эту установку, если поле никогда не должно заключаться в кавычки.

Пример: если 'QuoteRule' установлен в 'remove', затем функция импорта импортирует "abc"def" как abcdef".

Типы данных: char | string

Процедура, чтобы управлять пустыми полями в данных в виде одного из этих значений:

  • 'missing' — Используйте процедуру, заданную в MissingRule свойство

  • 'error' — Используйте процедуру, заданную в ImportErrorRule свойство

  • 'auto' — Используйте пустое значение на основе типа данных переменной

    Тип данных'EmptyValue'
    text

    нулевая длина char или string

    numeric

    NaN для чисел с плавающей запятой

    0 для целых чисел

    duration

    NaN

    datetime

    NaT

    logical

    false

    categorical

    <undefined>

Пример: opts = setvaropts(opts,'RestorationTime','EmptyFieldRule','auto');

Типы данных: char | string

Текст, чтобы удалить из префиксного положения значения переменных в виде вектора символов, массива ячеек из символьных векторов, строкового скаляра или массива строк.

Пример: opts = setvaropts(opts,'Var1','Prefixes','$') устанавливает Prefixes опция для переменной Var1. Если Var1 содержит значение '$500', затем readtable чтения это как '500'.

Типы данных: char | string | cell

Текст, чтобы удалить из суффиксного положения значения переменных в виде вектора символов, массива ячеек из символьных векторов, строкового скаляра или массива строк.

Пример: opts = setvaropts(opts,'Var1','Suffixes','/-') устанавливает Suffixes опция для переменной Var1. Если Var1 содержит значение '$500/-' , затем readtable чтения это как '$500'.

Типы данных: char | string | cell

Опции текстовой переменной

свернуть все

Процедура, чтобы управлять начальными и конечными пробелами при импортировании текстовых данных в виде одного из значений в таблице.

WhiteSpaceRule Процесс
'trim'

Удалите любое продвижение или конечные пробелы из текста. Внутренний пробел незатронут.

Пример: ' World Time ' импортируется как 'World Time'

'trimleading'

Удалите только ведущие пробелы.

Пример: ' World Time ' импортируется как 'World Time '

'trimtrailing'

Удалите только конечные пробелы.

Пример: ' World Time ' импортируется как ' World Time'

'preserve'

Сохраните пробелы.

Пример: ' World Time ' импортируется как ' World Time '

Типы данных: char | string

Опции числовой переменной

свернуть все

Символы, указывающие на экспоненту в виде вектора символов или строкового скаляра. Функция импорта использует ExponentCharacter свойство распознать символы, указывающие на экспоненту для номера, описанного в экспоненциальном представлении.

Пример: если varOpts.ExponentCharacter = 'a', затем функция импорта импортирует текст "1.2a3" как номер 1200.

Типы данных: char | string

Символы, указывающие на десятичный разделитель в числовых переменных в виде вектора символов или строкового скаляра. Функция импорта использует символы, заданные в DecimalSeparator пара "имя-значение", чтобы отличить целую часть номера от десятичной части.

При преобразовании в целочисленные типы данных числа с десятичной частью округлены до ближайшего целого числа.

Пример: Если пара "имя-значение" задана как 'DecimalSeparator',',', затем функция импорта импортирует текст "3,14159" как номер 3.14159.

Типы данных: char | string

Символы, которые указывают на тысячи группировки в числовых переменных в виде вектора символов или строкового скаляра. Тысячи группирующихся символов действуют как визуальные диафрагмы, группируя номер в каждых трех значениях места. Функция импорта использует символы, заданные в ThousandsSeparator пара "имя-значение", чтобы интерпретировать импортируемые числа.

Пример: Если пара "имя-значение" задана как 'ThousandsSeparator',',', затем функция импорта импортирует текст "1,234,000" как 1234000.

Типы данных: char | string

Удалите нечисловые символы из числовой переменной в виде логического true или false.

Пример: Если пара "имя-значение" задана как 'TrimNonNumeric',true, затем функция импорта читает '$500/-' как 500.

Типы данных: логический

Система для интерпретации числовых переменных в виде 'decimal', 'hex', или 'binary'.

Значение 'NumberSystem'

Описание

'decimal'

  • Обработки вводят числовые переменные как имеющий десятичные значения.

  • Интерпретирует значения как определение типа данных 'Type' пара "имя-значение" или 'double' если 'Type' не задан.

'hex'

  • Обработки вводят числовые переменные как наличие шестнадцатеричного (базируйтесь 16), значения. Входные значения могут иметь '0x' или '0X' как префиксы, но префиксы не требуются.

  • Интерпретирует значения как определение целочисленного типа данных 'Type' пара "имя-значение".

'binary'

  • Обработки вводят числовые переменные как наличие двоичного файла (базируйтесь 2), значения. Входные значения могут иметь '0b' или '0B' как префиксы, но префиксы не требуются.

  • Интерпретирует значения как определение целочисленного типа данных 'Type' пара "имя-значение".

Опции логической переменной

свернуть все

Текст, чтобы обработать как логическое значение trueВ виде вектора символов, строкового скаляра, массива ячеек из символьных векторов или массива строк.

Пример: если varOpts.TrueSymbols = {'t','TRUE'}, затем функция импорта импортирует любые поля, содержащие t или TRUE как логическое значение true.

Типы данных: char | string | cell

Текст, чтобы обработать как логическое значение falseВ виде вектора символов, строкового скаляра, массива ячеек из символьных векторов или массива строк.

Пример: если varOpts.FalseSymbols = {'f','FALSE'}, затем функция импорта импортирует любые поля, содержащие f или FALSE как логическое значение false.

Типы данных: char | string | cell

Индикатор, чтобы совпадать со случаем в виде логического значения true или false.

Интерпретировать входные данные как пропавших без вести, true, или false, функция импорта совпадает с данными к значениям, заданным в TreatAsMissingTrueSymbols , и FalseSymbols.

Параметры переменной datetime

свернуть все

Формат отображения в виде вектора символов или строкового скаляра. DatetimeFormat свойство управляет форматом отображения дат и времен в выходе. Задайте DatetimeFormat как одно из этих значений.

Значение DatetimeFormatОписание

'default'

Используйте формат отображения по умолчанию.

'defaultdate'

Используйте формат отображения по умолчанию для стоимости datetime, созданной без компонентов времени.

'preserveinput'

Используйте формат, заданный форматом ввода, InputFormat.

Пользовательские форматы

Используйте буквы A-Z и a-z создать пользовательское значение для DatetimeFormat. Эти буквы соответствуют Unicode® Locale Data Markup Language (LDML) стандарт для дат. Можно включать non-ASCII или не обозначить буквами символы, такие как дефис, пробел или двоеточие, чтобы разделить поля. Включать буквы A-Z и a-z как буквенные символы в формате, заключите их с одинарными кавычками.

Формат заводской настройки зависит от вашей системной локали. Чтобы изменить формат отображения по умолчанию, смотрите Формат datetime По умолчанию.

Типы данных: char | string

Формат входного текста, представляющего даты и времена в виде вектора символов или строкового скаляра, который содержит идентификаторы буквы.

Эта таблица показывает несколько общих форматов ввода и примеров отформатированного входа для даты, суббота, 19 апреля 2014 в 21:41:06 в Нью-Йорке.

Значение 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

Для полного списка допустимых идентификаторов буквы смотрите Format свойство для массивов datetime.

Пример: 'InputFormat','eeee, MMMM d, yyyy HH:mm:ss'

Типы данных: char | string

Локаль, чтобы интерпретировать даты в виде вектора символов или строкового скаляра. DatetimeLocale значение определяет, как функция импорта интерпретирует текст, который представляет даты и времена.

Установите DatetimeLocale к одному из этих значений:

  • 'system' — Задайте свою системную локаль.

  • Вектор символов или строковый скаляр — Использование форма xx_YY, где xx строчный ISO 639-1 двухбуквенный код, который задает язык и YY прописная альфа ISO 3166-1 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 значение определяет, как интерпретированы входные значения. Формат отображения и язык заданы опцией Локали в разделе формата Datetime окна Preferences. Чтобы изменить локаль datetime по умолчанию, см. Настройку параметров командного окна.

Типы данных: char | string

Часовой пояс в виде вектора символов или строкового скаляра. Значение TimeZone задает часовой пояс, что импорт функционирует использование, чтобы интерпретировать входные данные. TimeZone также задает часовой пояс выходного массива. Если входные данные являются векторами символов, которые включают часовой пояс, то функция импорта преобразует все значения в зону требуемого времени.

TimeZone используйте любое из этих значений:

  • '', создавать “незонную” стоимость datetime, которая не принадлежит определенному часовому поясу.

  • Область часового пояса от Базы данных Часового пояса IANA; например, 'America/Los_Angeles'. Имя области часового пояса составляет текущие и исторические правила для стандарта и смещений дневного света от UTC, которые наблюдаются в географической области.

  • Вектор символов ISO 8601 формы +HH:mm или -HH:mm. Например, '+01:00', задает часовой пояс, который является фиксированным смещением от UTC.

  • 'UTC', создать стоимость datetime в универсальное время.

  • 'UTCLeapSeconds', создать стоимость datetime в универсальное время, которая считает в течение секунд прыжка.

Эта таблица приводит некоторые общие названия областей часового пояса от Базы данных Часового пояса IANA.

Значение TimeZoneСмещение UTCСмещение DST UTC
'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

Массивы datetime без заданного TimeZone не может быть сравнен или объединен с массивами, которые имеют их TimeZone набор свойств к определенному часовому поясу.

Типы данных: char | string

Категориальные параметры переменной

свернуть все

Ожидаемые категории в виде массива ячеек из символьных векторов или массива строк, содержащего список названий категории.

Имена в полях ввода должны совпадать с одним из имен, заданных в Categories свойство избежать ошибки преобразования.

Пример: varOpts.Categories = {'BareLand','Forest','Water','Roads','Buildings'};

Индикатор защиты категории в виде логического true или false. Категории порядковых категориальных массивов всегда защищаются. Если Ordinal свойство установлено в true, затем значение по умолчанию для Protected true. В противном случае, значение для Protected false. Для получения дополнительной информации о категориальных массивах смотрите categorical страница ссылки на функцию.

Математический индикатор упорядоченного расположения в виде любого falseTRUE, 0, или 1. Для получения дополнительной информации о категориальных массивах смотрите categorical страница ссылки на функцию.

Параметры переменной длительности

свернуть все

Формат входного текста, представляющего данные о длительности в виде вектора символов или массива строк.

Задайте InputFormat как любой из следующих форматов, где dd, hh, mm, и ss представляйте дни, часы, минуты и секунды, соответственно:

  • 'dd:hh:mm:ss'

  • 'hh:mm:ss'

  • 'mm:ss'

  • 'hh:mm'

  • Любой из первых трех форматов, максимум с девятью S символы, чтобы указать на цифры доли секунды, такие как 'hh:mm:ss.SSSS'

Пример: varOpts.InputFormat = 'dd:hh:mm:ss'

Типы данных: char | string

Формат отображения для данных о длительности в виде вектора символов или строкового скаляра.

Для чисел с единицами измерения времени задайте одно из этих значений:

  • 'y' — Годы фиксированной длины, где 1 год равняется 365,2425 дням

  • 'd' — Дни фиксированной длины, где 1 день равняется 24 часам

  • 'h' часы

  • 'm' минуты

  • 's' секунды

Для цифрового таймера задайте один из этих форматов:

  • 'dd:hh:mm:ss'

  • 'hh:mm:ss'

  • 'mm:ss'

  • 'hh:mm'

  • Любой из первых трех форматов, максимум с девятью S символы, чтобы указать на цифры доли секунды, такие как 'hh:mm:ss.SSSS'

Пример: DurationFormat может быть любой один номер с единицами измерения времени (такими как 0.5 yr) или цифровой таймер (такой как 10:30:15 в течение 10 часов, 30 минут и 15 секунд).

Типы данных: char | string

Символы, разделяющие доли секунды в виде вектора символов или строкового скаляра. Функция импорта использует DecimalSeparator свойство отличить целую часть значения длительности от части долей секунды.

Типы данных: char | string

Символы, указывающие на полевое разделение в данных о длительности в виде вектора символов или строкового скаляра.

Типы данных: char | string

Смотрите также

| | |

Введенный в R2017b
Для просмотра документации необходимо авторизоваться на сайте