exponenta event banner

simbio.diagram.getLine

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

Описание

пример

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

Примечание

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

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

  2. Экспортируйте модель из приложения в рабочую область MATLAB ®, выбрав команду Экспорт > Экспорт модели в рабочую область MATLAB на вкладке Главная страницы приложения.

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

пример

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');

Приложение откроется и отобразит модель на вкладке Схема.

На вкладке Главная приложения выберите Экспорт > Экспорт модели в рабочую область MATLAB.

В диалоговом окне «Экспорт модели SimBiology» нажмите кнопку «ОК» для экспорта модели с именем переменной 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-на-N значений, где N - количество свойств.

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

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

Представлен в R2021a