simbio.diagram.getBlock

Получите свойства блока схемы SimBiology

Описание

пример

SV = simbio.diagram.getBlock(sObj) возвращает имена и текущие значения свойств блока объекта SimBiology sObj как структура SV.

Примечание

Прежде чем вы запустите функцию в командной строке:

  1. Откройте соответствующую модель SimBiology в приложении SimBiology Model Builder.

  2. Экспортируйте модель от приложения до MATLAB® рабочая область путем выбора Export> Export Model to MATLAB Workspace на вкладке Home приложения.

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

пример

SV = simbio.diagram.getBlock(speciesObj,exprObj) возвращает имена и текущие значения свойств блока объекта speciesObj разновидностей это соединяется с выражением (реакция, правило скорости или повторное правило присвоения) объект exprObj. Можно использовать этот синтаксис, чтобы сконфигурировать Position, Pin, и Visible свойства определенного клонированного блока, когда у вас есть несколько клонов тех же разновидностей. Клоны имеют те же значения для всех других свойств.

пример

QV = simbio.diagram.getBlock(sObj,propertyNames) возвращает значения заданных свойств propertyNames блока из объекта SimBiology sObj.

пример

QV = simbio.diagram.getBlock(speciesObj,exprObj,propertyNames) возвращает имена и текущие значения заданных свойств propertyNames блока из объекта speciesObj разновидностей это соединяется с объектом exprObj выражения.

пример

simbio.diagram.getBlock(___) отображает имена и значения свойств блока. Используйте этот синтаксис с любым из входных параметров в предыдущих синтаксисах.

Примеры

свернуть все

Можно программно настроить внешние виды и местоположения блоков схемы модели SimBiology.

Откройте lotka модель в приложении SimBiology Model Builder.

simBiologyModelBuilder('lotka');

Приложение открывает и показывает модель во вкладке Diagram.

На вкладке Home приложения выберите Export> Export Model to MATLAB Workspace.

В диалоговом окне SimBiology Model Export нажмите OK, чтобы экспортировать модель с именем переменной m1.

Перейдите к командной строке MATLAB и подтвердите, что модель m1 находится в рабочей области. Получите список разновидностей модели.

m1.Species
ans = 

   SimBiology Species Array

   Index:    Compartment:    Name:    Value:    Units:
   1         unnamed         x        1               
   2         unnamed         y1       900             
   3         unnamed         y2       900             
   4         unnamed         z        0               

Получите текущую форму блока разновидностей x.

x = m1.Species(1);
v = simbio.diagram.getBlock(x,'Shape')
v =

    'rounded rectangle'

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

simbio.diagram.setBlock(x,'Shape')
ans =

  8×1 cell array

    {'rounded rectangle'}
    {'rectangle'        }
    {'oval'             }
    {'triangle'         }
    {'hexagon'          }
    {'chevron'          }
    {'parallelogram'    }
    {'diamond'          }

Установите форму блока разновидностей к овалу.

simbio.diagram.setBlock(x,'Shape','oval')

Получите текущее положение блока. Первые два числа представляют координаты X и Y относительно левого верхнего угла (x = 0, y = 0) схемы. Последние два числа представляют ширину и высоту блока.

simbio.diagram.getBlock(x,'Position')
ans =

   223   137    30    15

Установите положение на новое местоположение.

simbio.diagram.setBlock(x,'Position',[260 130 30 15])

Можно также сконфигурировать несколько свойств.

simbio.diagram.setBlock(x,'FaceColor','yellow','FontSize',20,'TextLocation','center')

Когда у вас есть несколько клонированных блоков для тех же разновидностей в схеме SimBiology, можно программно отрегулировать положение и видимость определенного клона путем определения блока выражения, с которым соединяется клонированная разновидность. Другими словами, можно изменить Position, Pin, и Visible свойства, характерные для отдельного клона. Все другие свойства имеют те же значения через все клоны тех же разновидностей.

Откройте gprotein модель в приложении SimBiology Model Builder.

simBiologyModelBuilder('gprotein');

Приложение открывает и показывает модель во вкладке Diagram.

На вкладке Home приложения выберите Export> Export Model to MATLAB Workspace.

В диалоговом окне SimBiology Model Export нажмите OK, чтобы экспортировать модель с именем переменной m1.

Перейдите к командной строке MATLAB и подтвердите, что модель m1 находится в рабочей области. Получите список разновидностей модели.

m1.Species
ans = 

   SimBiology Species Array

   Index:    Compartment:    Name:    Value:       Units:
   1         unnamed         G        7000               
   2         unnamed         Gd       3000               
   3         unnamed         Ga       0                  
   4         unnamed         RL       0                  
   5         unnamed         L        6.022e+17          
   6         unnamed         R        10000              
   7         unnamed         Gbg      3000 

Блок Gbg разновидностей клонирован и соединен с двумя реакциями: G protein activation и G protein complex formation. Получите текущее положение клонированного блока, соединенного со второй реакцией.

Gbg = m1.Species(7);
r2 = m1.Reaction(2);
simbio.diagram.getBlock(Gbg,r2,'Position')
ans =

   393   307    30    15

Не прикрепите клонированный блок и переместите его в другое положение.

simbio.diagram.setBlock(Gbg,r2,'Pin',false,'Position',[391 340 30 15])

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

свернуть все

Объект SimBiology в виде a Compartment, Species, Reaction, Rule, или Parameter объект, или как массив объектов.

Имена свойств блока в виде вектора символов, строки, представляют в виде строки вектор или массив ячеек из символьных векторов. Можно задать несколько имен свойства как 1- N или N-by-1 массив ячеек имен.

Доступные свойства блока следуют.

PropertyName Описание

Connections

Свойство только для чтения, которое перечисляет объекты, соединенные с входным блоком

Cloned

Флаг только для чтения, указывающий, существует ли больше чем один блок для входного объекта. Можно клонировать только блоки разновидностей.

EdgeColor

Блокируйте цвет обводки в виде одного из этих значений:

  • Триплет RGB, такой как [1 1 0]

  • Вектор символов или строка, представляющая название цвета, такое как 'y' или 'yellow'

ExpressionLines

Отметьте, чтобы показать линии от блока выражения до других компонентов модели, на которые ссылается выражение в виде 'show' или 'hide'. Можно установить это свойство для реакций или правил.

FaceColor

Блокируйте цвет поверхности в виде одного из этих значений:

  • Триплет RGB, такой как [1 1 0]

  • Вектор символов или строка, представляющая название цвета, такое как 'y' или 'yellow'

FontName

Блокируйте шрифт текста в виде вектора символов или строки. Допустимые опции:

  • 'Arial'

  • 'Arial Black'

  • 'Arial Narrow'

  • 'Comic Sans MS'

  • 'Courier'

  • 'Courier New'

  • 'Georgia'

  • 'Helvetica'

  • 'Impact'

  • 'Times New Roman'

  • 'Trebuchet MS'

  • 'Verdana'

FontSize

Блокируйте размер шрифта текста в виде положительной скалярной величины

FontWeight

Блокируйте толщину шрифта текста в виде 'plain', 'bold', 'italic', или 'bold italic'

Object

Свойство только для чтения, которое перечисляет соответствующий объект SimBiology блока

Pin

Отметьте, чтобы указать, может ли блок быть перемещен или нет. Установите свойство на false позволить перемещать блок в схему.

Position

Положение и размер блока в виде четырехэлементного векторного [x,y,width,height]. Положение верхнего левого угла схемы равно x = 0 и y = 0. SimBiology конфигурирует все положения блока относительно того угла. Можно сконфигурировать положения блока к отрицательным позициям.

Rotate

Блокируйте вращение в виде скаляра между 0 и 360. Вы не можете повернуть блоки отсека.

Shape

Блокируйте форму в виде вектора символов или строки. Допустимые опции:

  • 'rounded rectangle'

  • 'rectangle'

  • 'oval'

  • 'triangle'

  • 'hexagon'

  • 'chevron'

  • 'parallellogram'

  • 'diamond'

Блоками отсека должен быть 'rounded rectangle' или 'rectangle'.

TextColor

Блокируйте цвет текста в виде одного из этих значений:

  • Триплет RGB, такой как [1 1 0]

  • Вектор символов или строка, представляющая название цвета, такое как 'y' или 'yellow'

TextLocation

Блокируйте текстовое местоположение относительно блока в виде одного из следующего: 'top', 'left', 'bottom', 'right'центр , или 'none'

Visible

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

Пример: 'Position'

Типы данных: double | char | string | cell

Объект Species в виде SimBiology Species объект. speciesObj должен быть скаляр.

Объект Expression в виде a Reaction или Rule объект. Объект правила может быть правилом скорости или повторенным правилом присвоения. exprObj должен быть скаляр.

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

свернуть все

Значения запрошенных свойств, возвращенных как числовой вектор, вектор символов, логический скаляр, объект SimBiology или массив ячеек.

Если sObj массив объектов, QV M-by-1 массив ячеек значений, где M равняется длине sObj.

Если вы также задаете N-by-1 или 1- N массив ячеек для propertyNames, QV M-by-N массив ячеек значений, где N является количеством свойств.

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

Если sObj массив объектов, SV массив структур. Функция возвращает одну структуру на блок. Если sObj имеет несколько клонированных блоков, SV содержит структуру для каждого клонированного блока.

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