cell2dataset

Преобразуйте массив ячеек в массив набора данных

Тип данных dataset может быть удален в будущем релизе. Чтобы работать с гетерогенными данными, используйте тип данных MATLAB® table вместо этого. Смотрите MATLAB документация table для получения дополнительной информации.

Синтаксис

ds = cell2dataset(C)
ds = cell2dataset(C,Name,Value)

Описание

пример

ds = cell2dataset(C) преобразовывает массив ячеек в массив dataset.

пример

ds = cell2dataset(C,Name,Value) выполняет преобразование с помощью дополнительных опций, заданных одним или несколькими аргументами пары Name,Value.

Примеры

свернуть все

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

Создайте массив ячеек, чтобы преобразовать.

C = {'Name','Gender','SystolicBP','DiastolicBP';
     'CLARK','M',124,93;
     'BROWN','F',122,80;
     'MARTIN','M',130,92}
C = 4x4 cell array
    {'Name'  }    {'Gender'}    {'SystolicBP'}    {'DiastolicBP'}
    {'CLARK' }    {'M'     }    {[       124]}    {[         93]}
    {'BROWN' }    {'F'     }    {[       122]}    {[         80]}
    {'MARTIN'}    {'M'     }    {[       130]}    {[         92]}

Преобразуйте массив ячеек в массив набора данных.

ds = cell2dataset(C)
ds = 
    Name            Gender     SystolicBP    DiastolicBP
    'CLARK'         'M'        124           93         
    'BROWN'         'F'        122           80         
    'MARTIN'        'M'        130           92         

Первая строка C становится именами переменных в выходном массиве набора данных, ds.

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

Создайте массив ячеек, чтобы преобразовать.

C = {'Name','Gender','SystolicBP','DiastolicBP';
     'CLARK','M',124,93;
     'BROWN','F',122,80;
     'MARTIN','M',130,92}
C = 4x4 cell array
    {'Name'  }    {'Gender'}    {'SystolicBP'}    {'DiastolicBP'}
    {'CLARK' }    {'M'     }    {[       124]}    {[         93]}
    {'BROWN' }    {'F'     }    {[       122]}    {[         80]}
    {'MARTIN'}    {'M'     }    {[       130]}    {[         92]}

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

ds = cell2dataset(C,'NumCols',[1,1,2]);
ds.Properties.VarNames{3} = 'BloodPressure';
ds
ds = 
    Name            Gender     BloodPressure  
    'CLARK'         'M'        124          93
    'BROWN'         'F'        122          80
    'MARTIN'        'M'        130          92

Выходной массив набора данных имеет три наблюдения и три переменные.

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

свернуть все

Введите массив ячеек, чтобы преобразовать в массив набора данных, заданный как M-by-N массив ячеек. Каждый столбец C становится переменной в выходном массиве набора данных, ds. По умолчанию cell2dataset принимает, что первая строка C содержит имена переменных.

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

Аргументы в виде пар имя-значение

Укажите необязательные аргументы в виде пар ""имя, значение"", разделенных запятыми. Имя (Name) — это имя аргумента, а значение (Value) — соответствующее значение. Name должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

Пример: 'ReadVarNames',false,'ReadObsNames',true указывает, что первая строка массива ячеек не содержит имена переменных, но первый столбец содержит имена наблюдения.

Индикатор для того, считать ли имена переменных из первой строки входного массива ячеек, заданного как пара, разделенная запятой, состоящая из 'ReadVarNames' и или true или false. Значением по умолчанию является true, если имена переменных не заданы с помощью аргумента пары "имя-значение" VarNames. Когда ReadVarNames является false, cell2dataset создает имена переменных по умолчанию, если вы не предоставляете никому.

Пример: 'ReadVarNames',false

Имена переменных для выходного массива набора данных, заданного как пара, разделенная запятой, состоящая из 'VarNames' и массива строк или массива ячеек из символьных векторов. Необходимо обеспечить имя переменной для каждой переменной в ds. Имена должны быть допустимыми идентификаторами MATLAB и должны быть уникальными.

Пример: 'VarNames',{'myVar1','myVar2','myVar3'}

Индикатор для того, считать ли наблюдение, называет от входного массива ячеек, заданного как пара, разделенная запятой, состоящая из 'ReadObsNames' и или true или false. Когда ReadObsNames имеет значение true, cell2dataset создает имена наблюдения в ds с помощью первого столбца C и устанавливает ds.Properties.DimNames, равный {C{1,1},'Variables'}.

Пример: 'ReadObsNames',true

Наблюдение называет для выходного массива набора данных, заданного как пара, разделенная запятой, состоящая из 'ObsNames' и массива строк или массива ячеек из символьных векторов. Имена не должны быть допустимыми идентификаторами MATLAB, но они должны быть уникальными.

Количество столбцов для каждой переменной в ds, заданном как пара, разделенная запятой, состоящая из 'NumCols' и вектор неотрицательных целых чисел. Когда количество столбцов для переменной больше, чем один, cell2dataset комбинирует несколько столбцов в C в одну переменную в ds. Вектор, который вы присваиваете NumCols, должен суммировать к size(C,2), или size(C,1) ReadObsNames равен true.

Например, чтобы преобразовать массив ячеек с восемью столбцами в массив набора данных с пятью переменными, задайте вектор с пятью элементами, которые суммируют к восемь, такие как 'NumCols',[1,1,3,1,2].

Выходные аргументы

свернуть все

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

  • Если вы устанавливаете ReadVarNames, равный false (или задайте VarNames), то существует наблюдение в ds для каждой строки C, и cell2dataset создает имена переменных по умолчанию (или использует имена в VarNames).

  • Если вы устанавливаете ReadObsNames, равный true, то cell2dataset использует первый столбец C как имена наблюдения.

  • Если вы задаете NumCols, то количество переменных в ds равно длине заданного вектора номеров столбцов.

Представленный в R2012b