mat2dataset

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

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

Синтаксис

ds = mat2dataset(X)
ds = mat2dataset(X,Name,Value)

Описание

пример

ds = mat2dataset(X) преобразовывает матрицу в массив dataset.

пример

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

Примеры

свернуть все

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

Загрузка демонстрационных данных.

load('fisheriris')
X = meas;
size(X)
ans = 1×2

   150     4

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

ds = mat2dataset(X);
size(ds)
ans = 1×2

   150     4

ds(1:5,:)
ans = 
    X1     X2     X3     X4 
    5.1    3.5    1.4    0.2
    4.9      3    1.4    0.2
    4.7    3.2    1.3    0.2
    4.6    3.1    1.5    0.2
      5    3.6    1.4    0.2

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

Загрузка демонстрационных данных.

load('fisheriris')
X = meas;
size(X)
ans = 1×2

   150     4

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

ds = mat2dataset(X,'VarNames',{'SLength',...
'SWidth','PLength','PWidth'});
size(ds)
ans = 1×2

   150     4

ds(1:5,:)
ans = 
    SLength    SWidth    PLength    PWidth
    5.1        3.5       1.4        0.2   
    4.9          3       1.4        0.2   
    4.7        3.2       1.3        0.2   
    4.6        3.1       1.5        0.2   
      5        3.6       1.4        0.2   

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

Загрузка демонстрационных данных.

load('fisheriris')
X = meas;
size(X)
ans = 1×2

   150     4

Преобразуйте матрицу в массив набора данных, комбинируя измерения чашелистика (первые два столбца) в одну переменную под названием SepalMeas и лепестковые измерения (третьи и четвертые столбцы) в имена переменных PetalMeas.

ds = mat2dataset(X,'NumCols',[2,2],...
'VarNames',{'SepalMeas','PetalMeas'});
ds(1:5,:)
ans = 
    SepalMeas          PetalMeas      
    5.1         3.5    1.4         0.2
    4.9           3    1.4         0.2
    4.7         3.2    1.3         0.2
    4.6         3.1    1.5         0.2
      5         3.6    1.4         0.2

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

size(ds)
ans = 1×2

   150     2

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

свернуть все

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

Типы данных: single | double

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

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

Пример: 'NumCols',[1,1,2,1] указывает, что 3-и и 4-е столбцы входной матрицы должны быть объединены в одну переменную.

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

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

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

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

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

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

свернуть все

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

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