Exponenta Banner
exponenta event 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 ®, выбрав команду Экспорт > Экспорт модели в рабочую область MATLAB на вкладке Главная страницы приложения.

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

пример

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');

Приложение откроется и отобразит модель на вкладке Схема.

На вкладке Главная приложения выберите Экспорт > Экспорт модели в рабочую область MATLAB.

В диалоговом окне «Экспорт модели SimBiology» нажмите кнопку «ОК» для экспорта модели с именем переменной 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 = 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');

Приложение откроется и отобразит модель на вкладке Схема.

На вкладке Главная приложения выберите Экспорт > Экспорт модели в рабочую область MATLAB.

В диалоговом окне «Экспорт модели SimBiology» нажмите кнопку «ОК» для экспорта модели с именем переменной 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-на-N значений, где N - количество свойств.

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

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

См. также

| | | | |

Темы

Представлен в R2021a

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

Поддержка