simbio.diagram.setLine

Установите свойства линии схемы SimBiology

Описание

пример

simbio.diagram.setLine(sObj,propertyNames,propertyValues) устанавливает значения заданных свойств для линий, соединенных с объектом SimBiology или массивом объектов sObj.

Примечание

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

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

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

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

simbio.diagram.setLine(sObj,S) устанавливает значения свойств sObj использование структуры S. Имена полей S имена свойства, и значения полей являются значениями свойств.

пример

simbio.diagram.setLine(sObj,Name,Value) устанавливает значения свойств, заданные одними или несколькими аргументами name-value.

Name имя свойства и Value соответствующее значение. Name должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

Можно задать смесь аргументов name-value, структур и пар массива ячеек имен свойства и значений в том же вызове функции.

пример

simbio.diagram.setLine(sObj) отображает имена и возможные значения конфигурируемых свойств подключенного параллельно к объекту SimBiology sObj. Этот синтаксис требует, чтобы только одна линия была соединена с sObj. Если существует несколько линий, соединенных с sObj, задайте линию путем обеспечения двух объектов как входных параметров, которые соединяются линией. Функции возвращают массив пустой ячейки, когда свойство не имеет конечного множества возможных значений. sObj должен быть скаляр.

outStruct = simbio.diagram.setLine(sObj) возвращает структуру outStruct содержа имена и возможные значения конфигурируемых свойств подключенного параллельно к объекту SimBiology sObj. sObj должен быть скаляр.

CV = simbio.diagram.setLine(sObj,propertyName) возвращает массив ячеек возможных значений CV для свойства propertyName линии. sObj должен быть скаляр.

пример

simbio.diagram.setLine(obj1,obj2,___) устанавливает свойства линии, которая соединяется, SimBiology возражает obj1 и obj2 использование любого из предыдущих входных параметров. obj1 и obj2 должен быть скаляр.

simbio.diagram.setLine(obj1,obj2) отображает конфигурируемые свойства линии, которая соединяется, SimBiology возражает obj1 и obj2. obj1 и obj2 должен быть скаляр.

Примеры

свернуть все

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

Откройте 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);
sv = simbio.diagram.getLine(x)
sv = 

  struct with fields:

          Color: [66 66 66]
    Connections: [1×2 SimBiology.ModelComponent]
          Width: 1

Измените цвет линии в красный и увеличьте ширину линии.

simbio.diagram.setLine(x,'Color','red','Width',2)

Можно также запросить свойства линии, которая соединяет два объекта. Например, получите значения свойств линии, которая соединяет разновидности y1 и Reaction1.

y1 = m1.Species(2);
r1 = m1.Reactions(1);
simbio.diagram.getLine(y1,r1)
ans = 

  struct with fields:

          Color: [66 66 66]
    Connections: [1×2 SimBiology.ModelComponent]
          Width: 1

Измените цвет линии в новое значение RGB и увеличьте ширину линии.

simbio.diagram.setLine(y1,r1,'Color',[0.6 0.2 0.6],'Width',3)

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

свернуть все

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

Имя свойства линии в виде вектора символов или строки. Можно задать только одно имя свойства.

Пример: 'Color'

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

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

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

PropertyName Описание

Color

Цвет линии в виде одного из этих значений:

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

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

Connections

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

Width

Ширина линии в виде положительной скалярной величины

Пример: 'Width'

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

Значения свойств, чтобы установить в виде вектора символов, строки, представляют в виде строки вектор, числовой вектор или массив ячеек.

Если propertyNames массив ячеек 1- N или N-by-1, propertyValues может быть массив ячеек той же длины, содержащей соответствующие значения для каждого свойства в propertyNames.

Если sObj вектор и propertyNames содержит одно имя свойства и propertyValues содержит одно значение, функция обновляет свойство всех линий, соединенных с sObj к заданному значению.

Если sObj вектор, содержащий объекты M и propertyNames массив ячеек 1- N или N-by-1, propertyValues может быть массив ячеек M-by-N так, чтобы каждый объект был обновлен с различным множеством значений для списка свойств в propertyNames.

Пример: 'green'

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

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

Если sObj вектор и S скалярная структура, функция конфигурирует все объекты иметь те же значения свойств.

Можно задать различный набор значений свойств для каждого объекта. Для этого задайте S как массив той же длины как sObj.

Типы данных: structure

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

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

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

свернуть все

Возможные значения свойств, возвращенные как массив ячеек значений. CV массив пустой ячейки, если свойство не имеет конечного множества возможных значений.

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

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