Exponenta Banner

simbio.diagram.getBlock

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

Свернуть все на странице

Синтаксис

SV = simbio.diagram.getBlock(sObj)
SV = simbio.diagram.getBlock(speciesObj,exprObj)
QV = simbio.diagram.getBlock(sObj,propertyNames)
QV = simbio.diagram.getBlock(speciesObj,exprObj,propertyNames)
simbio.diagram.getBlock(___)

Описание

пример

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, заданный как Compartment, Species, Reaction, Rule, или Parameter объект или как массив объектов.

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

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

Имя свойстваОписание

Connections

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

Cloned

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

EdgeColor

Ребро блока, заданный как одно из следующих значений:

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

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

Для получения дополнительной информации смотрите ColorSpec (Color Specification).

ExpressionLines

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

FaceColor

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

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

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

Для получения дополнительной информации смотрите ColorSpec (Color Specification).

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'

Для получения дополнительной информации смотрите ColorSpec (Color Specification).

TextLocation

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

Visible

Флаг, указывающий, виден ли блок в схеме. Установите значение свойства false чтобы скрыть блок.

Пример: 'Position'

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

Видовой объект, заданный как SimBiology Species объект. speciesObj должно быть скалярным.

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

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

свернуть все

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

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

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

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

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

См. также

| | | | |

Темы

Введенный в R2021a

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

Поддержка