getIndexByKey

Класс: BioIndexedFile

Получите индексы из исходного файла, сопоставленного с объектом BioIndexedFile с помощью алфавитно-цифрового ключа

Синтаксис

Indices = getIndexByKey(BioIFobj, Key)
[Indices, LogicalVals] = getIndexByKey(BioIFobj, Key)

Описание

Indices = getIndexByKey(BioIFobj, Key) возвращает индексы записей в исходном файле, сопоставленном с BioIFobj, объект BioIndexedFile. Это возвращает индексы записей, которым задал ключи Key, вектор символов или массив ячеек из символьных векторов, задающий один или несколько алфавитно-цифровых ключей. Это возвращает Indices, числовой вектор индексов записей, которым задал алфавитно-цифровые ключи Key. Если ключи в исходном файле не уникальны, он возвращает все индексы записей, которые совпадают с заданным ключом, всеми в положении ключа в Key cellArray. Если ключи в исходном файле уникальны, существует непосредственное отношение между номером и порядком элементов в Key и выход Indices.

[Indices, LogicalVals] = getIndexByKey(BioIFobj, Key) возвращает логический вектор, который указывает только на последнее соответствие для каждого ключа, такого, что существует непосредственное отношение между номером и порядком элементов в Key и Indices(LogicalVals).

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

BioIFobj

Объект BioIndexedFile класс.

Key

Вектор символов или массив ячеек из символьных векторов, задающий один или несколько ключей в исходном файле, сопоставлены с BioIFobj, объект BioIndexedFile.

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

Indices

Числовой вектор индексов записей в исходном файле, которым задал алфавитно-цифровые ключи Key.

LogicalVals

Логический вектор, содержащий то же число элементов как Indices. Вектор указывает только на последнее соответствие для каждого ключа, заданного в Key, таким образом, что существует непосредственное отношение между номером и порядком элементов в Key и Indices(LogicalVals).

Совет

Некоторые файлы содержат повторенные ключи. Например, SAM-отформатированные файлы используют тот же ключ в записях, которые соединяются чтения конца. Используйте Indices(LogicalVals) синтаксис, чтобы возвратить только последний индекс повторного ключа. Для получения дополнительной информации смотрите Примеры.

Примеры

Создайте объект BioIndexedFile получить доступ к таблице, содержащей перекрестные ссылки между условиями генной онтологии (GO) и названиями генов:

% Create variable containing full absolute path of source file
sourcefile = which('yeastgenes.sgd');
% Create a BioIndexedFile object from the source file. Indicate
% the source file is a tab-delimited file where contiguous rows
% with the same key are considered a single entry. Store the
% index file in the Current Folder. Indicate that keys are
% located in column 3 and that header lines are prefaced with !
gene2goObj = BioIndexedFile('mrtab', sourcefile, '.', ...
                            'KeyColumn', 3, 'HeaderPrefix','!')

Возвратите индексы для записей в исходном файле, которые заданы ключами AAC1 и AAD10.

% Access indices for entries that have the keys AAC1 and AAD10
indices = getIndexByKey(gene2goObj, {'AAC1' 'AAD10'})
indices =

           3
				 5

Создайте объект BioIndexedFile получить доступ к SAM-отформатированному файлу, который повторил ключи.

% Create variable containing full absolute path of source file
samsourcefile = which('ex1.sam');
% Create a BioIndexedFile object from the source file. Store the
% index file in the Current Folder. 
samObj = BioIndexedFile('sam', samsourcefile, '.')

Возвратите только последние индексы для записей в исходном файле, которые заданы двумя ключами, 'B7_593:7:15:244:876 и EAS56_65:4:296:78:421, оба из которых являются повторными ключами.

% Return all indices for entries that have two specific keys
[Indices, LogicalVal] = getIndexByKey(samObj, ...
                  {'B7_593:7:15:244:876', 'EAS56_65:4:296:78:421'})
Indices =

        3058
        3238
        3292
        3293

LogicalVal =

     0
     1
     0
     1
% Return only the last index for each key
LastIndices = Indices(LogicalVal)
LastIndices =

        3238
        3293

Советы

Используйте этот метод, чтобы определить индексы определенных записей с известными ключами.

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