Exponenta Banner

simbio.diagram.setLine

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

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

Синтаксис

simbio.diagram.setLine(sObj,propertyNames,propertyValues)
simbio.diagram.setLine(sObj,S)
simbio.diagram.setLine(sObj,Name,Value)
simbio.diagram.setLine(sObj)
outStruct = simbio.diagram.setLine(sObj)
CV = simbio.diagram.setLine(sObj,propertyName)
simbio.diagram.setLine(obj1,obj2,___)
simbio.diagram.setLine(obj1,obj2)

Описание

пример

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 должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

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

пример

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'

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

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

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

Поддержка