sbioselect

Ищите объекты с заданными ограничениями

Синтаксис

Out = sbioselect('PropertyName', PropertyValue) Out = sbioselect('Where', 'PropertyName', 'Condition', PropertyValue) Out = sbioselect(Obj, 'PropertyName', PropertyValue) Out = sbioselect(Obj, 'Type', 'TypeValue', 'PropertyName', PropertyValue) Out = sbioselect(Obj, 'Where', 'PropertyName', 'Condition', PropertyValue) Out = sbioselect(Obj, 'Where', 'PropertyNameCondition', 'PropertyNamePattern', 'Condition', PropertyValue) Out = sbioselect(Obj, 'Where', 'PropertyName1', 'Condition1', PropertyValue1, 'Where', 'PropertyName2', 'Condition2', PropertyValue2,...) Out = sbioselect(Obj, 'Where', 'PropertyName1', 'Condition1', PropertyValue1,Bool_Operator, 'Where', 'PropertyName2', 'Condition2', PropertyValue2,...) Out = sbioselect(Obj, 'Depth', DepthValue,...)

Аргументы

`Out`	Объект или массив объектов, возвращенных `sbioselect` функция. `Out` может содержать смесь типов объектов (например, разновидности и параметры), в зависимости от выбора, который вы задаете. Если `PropertyValue` массив ячеек, затем функция возвращает все объекты со свойством `'PropertyName'` это совпадает с любым элементом `PropertyValue`.
`Obj`	Объект SimBiology^® или массив объектов искать. Если объект не задан, `sbioselect` ищет корень.
`PropertyName`	Любое свойство объекта ищется.
`PropertyValue`	Задайте `PropertyValue` включать в критерии выбора.
`TypeValue`	Тип объекта включать в выбор, например, `sbiomodel`, `species`, `reaction`, или `kineticlaw`.
`Condition`	Условие поиска. См. таблицу в соответствии с Описанием для списка условий.
`PropertyNameCondition`	Условие поиска, которое применяется только к свойству имени. См., что таблица перечисляет “Условия для Имен” ниже.
`PropertyNamePattern`	Вектор символов или строка раньше выбирали имя свойства согласно условию, наложенному `PropertyNameCondition`.
`DepthValue`	Задайте номер глубины, чтобы искать. Верные номера являются положительными целочисленными значениями и `inf`. Если `DepthValue` `isinf`, `sbioselect` поисковые запросы `Obj` и все его дочерние элементы. Если `DepthValue` `1`, `sbioselect` только поисковые запросы `Obj` и не его дочерние элементы. По умолчанию, `DepthValue` `isinf`.

Описание

sbioselect поиски объектов с заданными ограничениями.

Out = sbioselect('PropertyName', PropertyValue) ищет корневой объект (включая все объекты модели, содержавшие полностью, возражают), и возвращает объекты с именем свойства (PropertyName) и значение свойства (PropertyValue) содержавший полностью возражают.

Out = sbioselect('Where', 'PropertyName', 'Condition', PropertyValue) ищет корневой объект и находит объекты, которые имеют имя свойства (PropertyName) и значение (PropertyValue) это совпадает с условием (Condition).

Out = sbioselect(Obj, 'PropertyName', PropertyValue) возвращает объекты с именем свойства (PropertyName) и значение свойства (PropertyValue) найденный в любом объекте (Obj). Если имя свойства в паре значения свойства содержит любого '?' или '*', затем имя автоматически интерпретировано как выражение с подстановочными знаками, эквивалентное где пункт ('Where', 'wildcard', 'PropertyName', '==', PropertyValue).

Out = sbioselect(Obj, 'Type', 'TypeValue', 'PropertyName', PropertyValue) находит объекты типа (TypeValue), с именем свойства (PropertyName) и значение свойства (PropertyValue) найденный в любом объекте (Obj). TypeValue тип объекта SimBiology, который будет включен в выбор, например, species, reaction, или kineticlaw.

Out = sbioselect(Obj, 'Where', 'PropertyName', 'Condition', PropertyValue) находит объекты, которые имеют имя свойства (PropertyName) и значение (PropertyValue) то соответствие условие (Condition).

Если вы ищете значение свойства вектора символов, не задавая условие, необходимо использовать тот же формат в качестве get возвращается. Например, если get возвращает Name как 'MyObject', sbioselect не найдет объект с Name значение свойства 'myobject'. Поэтому для этого примера, необходимо задать:

modelObj = sbioselect ('Name', 'MyObject')

Вместо этого если вы используете условие, можно задать:

modelObj = sbioselect ('Where', 'Name', '==i', 'myobject')

Таким образом условия позволяют вам управлять спецификой своего выбора.

sbioselect поиски объектов модели на корне в обоих случаях.

Out = sbioselect(Obj, 'Where', 'PropertyNameCondition', 'PropertyNamePattern', 'Condition', PropertyValue) находит объекты с именем свойства, которое совпадает с шаблоном в (PropertyNamePattern) с условием (PropertyNameCondition) и совпадает со значением (PropertyValue) с условием (Condition). Используйте этот синтаксис, когда это необходимо, условия поиска и на именах свойства и на значениях свойств.

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

Условия для числовых свойств	Синтаксис в качестве примера
`==`	Поиск в объекте модели (`modelObj`), и объекты возвращаемого параметра, которые имеют `Value` равняйтесь `0.5`. `sbioselect` возвращает объекты параметра, потому что только объекты параметра имеют свойство под названием `Value`. parameterObj = sbioselect (modelObj,... 'Where', 'Value', '==', 0.5) В случае `==`, это эквивалентно исключению условия как показано: parameterObj = sbioselect (modelObj,... 'Value', 0.5) Поиск в объекте модели (`modelObj`), и объекты возвращаемого параметра, которые имеют `ConstantValue` `false` (непостоянные параметры). parameterObj = sbioselect (modelObj,... 'Where', 'ConstantValue', '==', false)
`~=`	Поиск в объекте модели (`modelObj`), и объекты возвращаемого параметра, которые не имеют `Value` равняйтесь `0.5`. parameterObj = sbioselect (modelObj,... 'Where', 'Value', '~=', 0.5)
`>`,`<`,`>=`,`<=`	Поиск в объекте модели (`modelObj`), и возвратите объекты разновидностей, которые имеют начальную сумму (`InitialAmount`) больше, чем `50`. speciesObj = sbioselect (modelObj, ... 'Where', 'InitialAmount', '>', 50) Поиск в объекте модели (`modelObj`), и возвратите объекты разновидностей, которые имеют начальную сумму (`InitialAmount`) меньше чем или равный `50`. speciesObj = sbioselect (modelObj,... 'Where', 'InitialAmount', '<=', 50)
`between`	Поиск в объекте модели (`modelObj`), и возвратите объекты разновидностей, которые имеют начальную сумму (`InitialAmount`) между `200` и `300`. speciesObj = sbioselect (modelObj,... 'Where', 'InitialAmount',... 'between', [200 300])
`~between`	Поиск в объекте модели (`modelObj`), и возвратите объекты разновидностей, которые имеют начальную сумму (`InitialAmount`) это не между `200` и `300`. speciesObj = sbioselect (modelObj,... 'Where', 'InitialAmount',... '~between', [200 300])
equal_and_same_type	Подобно `==`, но кроме того требует, чтобы значение свойства имело тот же тип. Поиск в объекте модели (`modelObj`), и возвратите все объекты, содержащие свойство типа `double` и значение равняется `0`. (Используя `'=='` также выбрал бы объекты, содержащие свойство со значением лжи.) zeroObj = sbioselect(modelObj, ... 'Where', '*', 'equal_and_same_type', 0);
unequal_and_same_type	Подобно `~=`, но кроме того требует, чтобы значение свойства имело тот же тип. Выберите все объекты, содержащие свойство, типа double и значение, не равное 0. (Используя `'~='` также выбрал бы объекты, содержащие свойство со значением истины.) nonzeroObj = sbioselect(modelObj, ... 'Where', '*', 'unequal_and_same_type', 0);

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

Условия для имен	Синтаксис в качестве примера
`==`	Поиск в объекте модели (`modelObj`), и возвратите объекты разновидностей, названные `'Glucose'`. speciesObj = sbioselect (modelObj,... 'Type', 'species', 'Where',... 'Name', '==', 'Glucose')
`~=`	Поиск в объекте модели (`modelObj`), и возвратите объекты разновидностей, которые не называют `'Glucose'`. speciesObj = sbioselect (modelObj,... 'Type', 'species', 'Where',... 'Name', '~=', 'Glucose')
`==i`	То же самое как `==`; кроме того, это является нечувствительным к регистру.
`~=i`	Поиск в объекте модели (`modelObj`), и возвратите объекты разновидностей, которые не называют `'Glucose'`'IgnoringCase' . speciesObj = sbioselect (modelObj,... 'Type', 'species', 'Where',... 'Name', '~=i', 'glucose')
`regexp`. Выражения поддержек, поддержанные функциями `regexp` и `regexpi`.	Поиск в объекте модели (`modelObj`), и возвратите объекты, которые имеют `'ese'` или `'ase'` где угодно в имени. Obj = sbioselect (modelObj, 'Where',... 'Name', 'regexp', '[ea]se') Поиск в корне, и возвращает объекты, которые имеют `kinase` где угодно в имени. Obj = sbioselect ('Where',... 'Name', 'regexp', 'kinase') Обратите внимание на то, что этот запрос мог привести к смеси типов объектов (например, разновидности и параметры).
`regexpi`	То же самое как `regexp`; кроме того, это является нечувствительным к регистру.
`~regexp`	Поиск в объекте модели (`modelObj`), и возвратите объекты, которые не имеют `kinase` где угодно в имени. Obj = sbioselect (modelObj, 'Where',... 'Name', '~regexp', 'kinase')
`~regexpi`	То же самое как `~regexp`; кроме того, это является нечувствительным к регистру.
`wildcard`	Поддержки `DOS-style` подстановочные знаки ('`?`'соответствия любой отдельный символ, '`*`'соответствия любое количество символов и шаблон должны совпадать с целым вектором символов). Смотрите `regexptranslate` для получения дополнительной информации.
`wildcardi`	То же самое как `wildcard`; кроме того, это является нечувствительным к регистру.
`~wildcard`	Поиск в объекте модели (`modelObj`), и возвратите объекты, которые имеют имена, которые не начинаются `с kin`. Obj = sbioselect (modelObj, 'Where',... 'Name', '~wildcard', 'kin')
`~wildcardi`	То же самое как `~wildcard`; кроме того, это является нечувствительным к регистру.

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

Условие Синтаксис в качестве примера

Условие	Синтаксис в качестве примера
`'function'`	Поиск в объекте модели и возвращает объекты реакции чей `Stoichiometry` свойство содержит заданную стехиометрию. Out = sbioselect(modelObj, 'Where',... 'Stoichiometry', 'function',... @(x)any(x>2)) Выберите все объекты с числовым значением, которое является четным. iseven = @(x) isnumeric(x)... && isvector(x) && mod(x, 2) == 0; evenValuedObj = sbioselect(modelObj, ... 'where', 'Value', 'function', iseven);

'function'

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

Out = sbioselect(modelObj, 'Where',...
'Stoichiometry', 'function',...
 @(x)any(x>2))

Выберите все объекты с числовым значением, которое является четным.

iseven = @(x) isnumeric(x)...
 && isvector(x) && mod(x, 2) == 0; 
evenValuedObj = sbioselect(modelObj, ...
'where', 'Value', 'function', iseven);

Условие 'contains' может использоваться только для тех свойств, значения которых являются массивом объектов SimBiology. Следующая таблица показывает пример использования contains.

Условие Синтаксис в качестве примера

Условие	Синтаксис в качестве примера
`'contains'`	Поиск в объекте модели и возвращает объекты реакции чей `Reactant` свойство содержит заданные разновидности. Out = sbioselect(modelObj, 'Where',... 'Reactants', 'contains',... modelObj.Species(1))

'contains'

Поиск в объекте модели и возвращает объекты реакции чей Reactant свойство содержит заданные разновидности.

Out = sbioselect(modelObj, 'Where',...
'Reactants', 'contains',...
 modelObj.Species(1))

Out = sbioselect(Obj, 'Where', 'PropertyName1', 'Condition1', PropertyValue1, 'Where', 'PropertyName2', 'Condition2', PropertyValue2,...) находит объекты содержавшими в Obj это совпадает со всеми заданными условиями.

Можно объединить любое количество имени свойства / пары значения свойства и условия в sbioselect команда.

Out = sbioselect(Obj, 'Where', 'PropertyName1', 'Condition1', PropertyValue1,Bool_Operator, 'Where', 'PropertyName2', 'Condition2', PropertyValue2,...) находит объекты содержавшими в Obj это совпадает со всеми заданными условиями. Векторы поддерживаемого символа для Bool_Operator следующие.

`'and'`	Верный, если (`'Where'`, `'PropertyName1'`, `'Condition1'`, `PropertyValue1`) и (`'Where'`, `'PropertyName2'`, `'Condition2'`, `PropertyValue2`) оба верны.
`'or'`	Верный, если любой (`'Where'`, `'PropertyName1'`, `'Condition1'`, `PropertyValue1`) или (`'Where'`, `'PropertyName2'`, `'Condition2'`, `PropertyValue2`) верно.
`'xor'`	Верный, если точно один из (`'Where'`, `'PropertyName1'`, `'Condition1'`, `PropertyValue1`) или (`'Where'`, `'PropertyName2'`, `'Condition2'`, `PropertyValue2`) верно.
`'not'`	Верный, если (`'Where'`, `'PropertyName1'`, `'Condition1'`, `PropertyValue1`) верно и (`'Where'`, `'PropertyName2'`, `'Condition2'`, `PropertyValue2`) не верно.

Поддерживаются составные выражения с несколькими булевыми операторами. Приоритет операторов выполняет приказ операций для булевой алгебры not –> and –> xor –> or.

Out = sbioselect(Obj, 'Depth', DepthValue,...) находит объекты с помощью поисковой глубины модели DepthValue.

Примечание

Порядок результатов sbioselect не гарантируется. Следовательно, не рекомендуется зависеть от порядка результатов.

Примеры

свернуть все

Найдите разновидности из модели SimBiology

Скрипт Open Live Script

Импортируйте модель.

modelObj = sbmlimport('oscillator');

Найдите и возвратите объект под названием pA.

pA = sbioselect(modelObj, 'Name', 'pA')

pA = 
   SimBiology Species Array

   Index:    Compartment:    Name:    Value:    Units:
   1         unnamed         pA       100

Найдите и возвратите объекты разновидностей чей Name запускается с p и имейте A или B как следующая буква на имя.

speciesObjs = sbioselect(modelObj, 'Type', 'species', 'Where',...
                        'Name', 'regexp', '^p[AB]')

speciesObjs = 
   SimBiology Species Array

   Index:    Compartment:    Name:        Value:    Units:
   1         unnamed         pA           100             
   2         unnamed         pB           0               
   3         unnamed         pA_OpB1      0               
   4         unnamed         pB_OpC1      0               
   5         unnamed         pA_OpB_pA    20              
   6         unnamed         pA_OpB2      0               
   7         unnamed         pB_OpC2      0               
   8         unnamed         pB_OpC_pB    0

Найдите массив ячеек. Отметьте, как значения массива ячеек должны быть заданы в другом массиве ячеек.

modelObj.Species(2).UserData = {'a' 'b'}; 
Obj = sbioselect(modelObj, 'UserData', {{'a' 'b'}})

Obj = 
   SimBiology Species Array

   Index:    Compartment:    Name:    Value:    Units:
   1         unnamed         pB       0

Найдите и возвратите объекты, которым не установили их модули.

unitlessObj = sbioselect(modelObj, 'Where', 'wildcard', '*Units', '==', '');

В качестве альтернативы можно сделать следующее.

unitlessObj = sbioselect(modelObj, '*Units', '');

Смотрите также

regexp

Представлено до R2006a

Документация