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'

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