exponenta event banner

DataMatrix

Создать объект DataMatrix

Синтаксис

DMobj = DataMatrix(Matrix)
DMobj = DataMatrix(Matrix, RowNames, ColumnNames)
DMobj = DataMatrix('File', FileName)
DMobj = DataMatrix(..., 'RowNames', RowNamesValue, ...)
DMobj = DataMatrix(..., 'ColNames', ColNamesValue, ...)
DMobj = DataMatrix(..., 'Name', NameValue, ...)
DMobj = DataMatrix('File', FileName, ...'Delimiter', DelimiterValue, ...)
DMobj = DataMatrix('File', FileName, ...'HLine', HLineValue, ...)
DMobj = DataMatrix('File', FileName, ...'Rows', RowsValue, ...)
DMobj = DataMatrix('File', FileName, ...'Columns', ColumnsValue, ...)

Аргументы

Matrix

Двумерный числовой или логический массив.

RowNames

Имена строк для объекта DataMatrix, определяемые числовым вектором, символьным массивом, строковым вектором или массивом ячеек символьных векторов, элементы которых равны числу строк в Matrix. RowNames обычно представляют собой имена генов или идентификаторы зондов из эксперимента с микрочипами.

Примечание

Имена строк не обязательно должны быть уникальными.

ColumnNames

Имена столбцов для объекта DataMatrix, определяемые числовым вектором, символьным массивом, строковым вектором или массивом ячеек символьных векторов, элементы которых равны числу столбцов в Matrix. ColumnNames обычно являются идентификаторами образцов из эксперимента с микрочипами.

Примечание

Имена столбцов не обязательно должны быть уникальными.

FileName

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

Примечание

Как правило, первая строка таблицы содержит имена столбцов, первый столбец содержит имена строк, а числовые данные начинаются с 2,2 позиция. DataMatrix определяет, не содержит ли первый столбец имен строк, и считывает данные из первого столбца. Однако если первая строка не содержит текста заголовка (имена столбцов), установите HLine свойство для 0.

RowNamesValue, ColNamesValue

Имена строк или столбцов для объекта DataMatrix. Возможны следующие варианты:

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

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

  • true - Уникальные имена строк или столбцов будут назначены с использованием форматов row1, row2, row3и т.д., или col1, col2, col3и т.д.

  • false - По умолчанию. Имена строк или столбцов не назначаются.

Примечание

Имена строк или столбцов не обязательно должны быть уникальными.

NameValue

Символьный вектор или строка, указывающая имя объекта DataMatrix. По умолчанию: ''.

DelimiterValue

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

  • ' '

  • '\t' (по умолчанию)

  • ','

  • ';'

  • '|'

HLineValue

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

При создании объекта DataMatrix DMobj, DataMatrix загружает данные функции из (HLineValue + 1) до конца файла.

Совет

Если входной файл не содержит текст заголовка столбца (имена столбцов), установите HLineValue кому 0.

RowsValue, ColumnsValue

Подмножество строк или столбцов в File, для DataMatrix для создания объекта DataMatrix. Возможны следующие варианты:

  • Массив ячеек символьных векторов

  • Символьный массив

  • Строковый вектор

  • Числовой или логический вектор

Описание

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

Примечание

Функция конструктора DataMatrix является частью пакета объектов микрочипов. Чтобы сделать его доступным, введите в командной строке MATLAB ® следующее:

import bioma.data.*

В противном случае используйте bioma.data.DataMatrix вместо DataMatrix, в следующих синтаксисах.

DMobj = DataMatrix(Matrix) создает объект DataMatrix, DMobj, от Matrixдвумерный числовой или логический массив. Matrix также может быть объектом DataMatrix.

DMobj = DataMatrix(Matrix, RowNames, ColumnNames) создает объект DataMatrix, DMobj, от Matrixдвумерный числовой или логический массив с именами строк и столбцов, указанными RowNames и ColumnNames. RowNames и ColumnNames может быть числовым вектором, символьным массивом, строковым вектором или массивом ячеек символьных векторов, элементы которых по количеству равны количеству строк и количеству столбцов, соответственно, в Matrix. RowNames обычно являются именами генов или идентификаторами зондов, в то время как ColumnNames обычно являются идентификаторами образцов.

Примечание

Имена строк или столбцов не обязательно должны быть уникальными.

DMobj = DataMatrix('File', FileName) создает объект DataMatrix, DMobj, от FileName, символьный вектор или строка, указывающая имя файла или путь и имя файла TXT или XLS с разделителями табуляции, который содержит табличные данные и метаданные.

Примечание

Как правило, первая строка таблицы содержит имена столбцов, первый столбец содержит имена строк, а числовые данные начинаются с 2,2 позиция. DataMatrix определяет, не содержит ли первый столбец имен строк, и считывает данные из первого столбца. Однако если первая строка не содержит текста заголовка (имена столбцов), установите HLine свойство для 0.

DMobj = DataMatrix(..., 'PropertyName', PropertyValue, ...) требования DataMatrix с необязательными свойствами, использующими пары имя/значение свойства. Можно указать одно или несколько свойств в любом порядке. Каждый PropertyName должен быть заключен в одинарные кавычки и не учитывать регистр. Эти пары имя/значение свойства следующие:

DMobj = DataMatrix(..., 'RowNames', RowNamesValue, ...) задает имена строк для DMobj. RowNamesValue может быть любым из следующих:

  • Числовой вектор, символьный массив, строковый вектор или массив ячеек символьных векторов, элементы которых по числу равны количеству строк числовых данных во входной матрице.

  • Символьный вектор или строка, используемый в качестве префикса для имен строк. Номера строк будут добавлены к префиксу.

  • true - Уникальные имена строк будут назначены в формате row1, row2, row3и т.д.

  • false - По умолчанию. Имена строк не назначены.

Примечание

Имена строк не обязательно должны быть уникальными.

DMobj = DataMatrix(..., 'ColNames', ColNamesValue, ...) задает имена столбцов для DMobj. ColNamesValue может быть любым из следующих:

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

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

  • true - Уникальные имена столбцов будут назначены в формате col1, col2, col3и т.д.

  • false - По умолчанию. Имена столбцов не назначены.

Примечание

Имена столбцов не обязательно должны быть уникальными.

DMobj = DataMatrix(..., 'Name', NameValue, ...) задает имя для DMobj. По умолчанию: ''.

DMobj = DataMatrix('File', FileName, ...'Delimiter', DelimiterValue, ...) определяет символ разделителя для использования во входном файле. Типичные варианты:

  • ' '

  • '\t' (по умолчанию)

  • ','

  • ';'

  • '|'

DMobj = DataMatrix('File', FileName, ...'HLine', HLineValue, ...) указывает, какая строка входного файла содержит текст заголовка столбца (имена столбцов). HLineValue является положительным целым числом. По умолчанию: 1. При создании объекта DataMatrix DMobj, DataMatrix загружает данные функции из (HLineValue + 1) до конца файла.

Совет

Если входной файл не содержит текст заголовка столбца (имена столбцов), установите HLineValue кому 0.

DMobj = DataMatrix('File', FileName, ...'Rows', RowsValue, ...) задает подмножество имен строк в File для DataMatrix функция для создания DMobj. RowsValue может быть массивом ячеек символьных векторов, массивом символов, строковым вектором или числовым или логическим вектором.

DMobj = DataMatrix('File', FileName, ...'Columns', ColumnsValue, ...) задает подмножество имен столбцов в File для DataMatrix функция для создания DMobj. ColumnsValue может быть массивом ячеек символьных векторов, строковым вектором, символьным массивом или числовым или логическим вектором.

Примеры

Примеры создания и использования объектов DataMatrix см. в разделе Представление значений данных выражения в объектах DataMatrix.

Представлен в R2008b