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, заданный как Compartment, Species, Reaction, Rule, или Parameter объект или как массив объектов.

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

Ниже приведены доступные свойства линий.

Имя свойстваОписание

Color

Цвет линии, заданный как одно из следующих значений:

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

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

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

Connections

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

Width

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

Пример: 'Width'

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

Объект SimBiology, заданный как Compartment, Species, Reaction, Rule, или Parameter объект.

Объект SimBiology, заданный как Compartment, Species, Reaction, Rule, или Parameter объект.

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

свернуть все

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

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

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

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

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

Введенный в R2021a