getSubset

Класс: BioIndexedFile

Создайте объект, содержащий подмножество элементов из объекта BioIndexedFile

Синтаксис

NewObj = getSubset(BioIFObj, Indices)
NewObj = getSubset(BioIFObj, Keys)

Описание

NewObj = getSubset(BioIFObj, Indices) возвращает NewObj, новый объект BioIndexedFile, который обращается к подмножеству записей в исходном файле, сопоставленном с BioIFObj, объект BioIndexedFile. Значения заданы как Indices, вектор, содержащий уникальные положительные целые числа.

NewObj = getSubset(BioIFObj, Keys) возвращает NewObj, новый объект BioIndexedFile, который обращается к подмножеству записей в исходном файле, сопоставленном с BioIFObj, объект BioIndexedFile. Значения заданы как Keys, вектор символов или массив ячеек уникальных векторов символов, задающих ключи.

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

BioIFObj

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

Indices

Вектор, содержащий уникальные положительные целые числа, которые задают значения в исходном файле для доступа с NewObj. Количество элементов в Indices не может превышать количество записей, индексируемых BioIFObj. Существует связь один к одному между элементами в Indices и записи, которые NewObj доступа.

Keys

Вектор символов или массив ячеек из уникальных векторов символов, задающих ключи, которые задают значения в исходном файле для доступа с NewObj. Количество элементов в Keys меньше или равно количеству записей, индексируемых BioIFObj. Если ключи в исходном файле не уникальны, все записи, которые соответствуют данному ключу, индексируются NewObj. В этом случае не существует отношения один к одному между элементами в Keys и записи, которые NewObj доступа. Если ключи в исходном файле уникальны, то между элементами существует связь один к одному Keys и записи, которые NewObj доступа.

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

NewObj

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

Примеры

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

% Create a variable containing the full absolute path of the 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','!')

Создайте новый объект BioIndexedFile, который обращается только к первой 1000 перекрестных ссылок и повторно использует тот же файл индекса, что и gene2goObj:

% Create a new BioIndexedFile object.
gene2goSubset = getSubset(gene2goObj,1:1000);

Совет

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