simbio.diagram.getLine

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

Описание

пример

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

Примечание

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

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

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

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

пример

SV = simbio.diagram.getLine(obj1,obj2) возвращает все свойства линии, которая соединяет два объекта SimBiology obj1 и obj2 как структура SV. obj1 и obj2 должен быть скаляр.

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

пример

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

пример

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

Примеры

свернуть все

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

Откройте 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 объект, или как массив объектов.

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

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

PropertyName Описание

Color

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

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

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

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

Connections

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

Width

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

Пример: 'Width'

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

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

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

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

свернуть все

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

Если несколько линий соединяются с объектом SimBiology sObj или если sObj массив объектов, QV M-by-1 массив ячеек значений, где M равняется общему количеству линий, соединенных с каждым объектом в sObj.

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

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

Если несколько линий соединяются с объектом SimBiology sObj или если sObj массив объектов, SV массив структур. Функция возвращает одну структуру на строку.

Введенный в R2021a