Exponenta Banner
exponenta event banner

simscape.logging.plot

Печать данных моделирования в журнале для узла или серии

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

Синтаксис

fh = simscape.logging.plot (logobject)
fh = simscape.logging.plot (logobject, Name, Value)

Описание

пример

fh = simscape.logging.plot(logobject) строит график значений серии моделирования вдоль y-axis, со временем вдоль x-axis. logobject является simscape.logging.Node или simscape.logging.Series объект или однородный массив ячеек таких объектов. Если logobject является узлом, функция отображает все непустые ряды, связанные с указанным узлом и его потомками. В зависимости от типа logobj, fh - структура (для узла) или массив ячеек (для ряда) дескрипторов результирующих фигур.

пример

fh = simscape.logging.plot(logobject,Name,Value) позволяет фильтровать выводимые на печать данные с помощью одного или нескольких Name,Value аргументы пары. Например, укажите 'unitsПосле этого следует имя единицы измерения для вывода на график только тех узлов и серий, которые соответствуют указанной единице измерения.

Примеры

свернуть все

Постройте график скорости порта R блока поступательной пружины.

Откройте пример модели Mass-Spring-Damper с контроллером:

ssc_mass_spring_damper_control

В этом примере модели включено ведение журнала данных для всей модели, для параметра Имя переменной рабочей области (Workspace variable name) установлено значение simlog_ssc_mass_spring_damper_control.

Моделирование модели для регистрации данных моделирования:

sim('ssc_mass_spring_damper_control');

График скорости порта R блока поступательной пружины Spring. 

simscape.logging.plot(simlog_ssc_mass_spring_damper_control.Spring.R);

Используйте аргументы пары «имя-значение» для фильтрации выводимых на печать данных моделирования.

Для модели с именем переменной рабочей области по умолчанию: simlog, построить график только линейных положений и скоростей (серии, которые соизмеримы с единицами mm и mm/s) в этих единицах для узла модели верхнего уровня, его нижестоящих элементов и их нижестоящих элементов в диапазоне времени от 1 до 3 секунд:

fh = simscape.logging.plot(simlog,'units',{'mm','mm/s'},'time',[1 3],'depth',2);

Использовать имя переменной рабочего пространства simlog1 для регистрации данных из первого прогона и имени переменной рабочей области simlog2 для регистрации данных из второго прогона.

Печать деформации блока поступательной пружины TS от обоих участков на одной оси с соответствующей легендой.

simscape.logging.plot({simlog1.TS.x simlog2.TS.x},'names',{'Run1' 'Run2'});

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

свернуть все

Расчетные данные для печати, указанные как simscape.logging.Node или simscape.logging.Series объект или однородный массив ячеек таких объектов. logobject должен включать полный путь идентификатора к узлу или серии, начиная с имени переменной журнала рабочей области.

Таблица описывает полученные графики на основе типа logobject аргумент:

Скаляр Series объект

Строит график значений серии моделирования вдоль y-axis, со временем вдоль x-axis.

Нескаляр Series объект

Строит график каждого размера ряда значений на другой оси в одном и том же окне фигуры.

Массив ячеек Series объекты

Печать всех объектов серии с соответствующими единицами измерения на одной оси (наложенной) и каждого размера для нескалярного ряда на другой оси в том же окне фигуры.

Входные аргументы привязываются на основе соизмеримых единиц. Для каждой ячейки, все Series объекты с тем же размером, что и первый Series объекты в этой ячейке печатаются, а другие игнорируются.

Node объект

Отображает все непустые ряды, связанные с Node и его дети (вплоть до уровня, определенного depth). Если Node имеет несколько узлов переменных моделирования в качестве нижестоящих элементов на уровне 1, эти нижестоящие элементы отображаются в одном окне фигуры, но на другой оси. Потомки на других уровнях отображаются в различных окнах рисунков. Все размеры нескалярного ряда отображаются на одной оси.

Массив ячеек Node объекты

Печать соответствующих рядов, наложенных на одну и ту же ось.

Предназначен для сравнения данных моделирования из различных прогонов. Все записи массива ячеек должны быть эквивалентны друг другу, что означает, что Node объекты должны иметь одинаковую иерархию, а ряды для каждого узла должны иметь одинаковые размеры и соответствующие единицы измерения.

Аргументы пары «имя-значение»

Укажите дополнительные пары, разделенные запятыми Name,Value аргументы. Name является именем аргумента и Value - соответствующее значение. Name должен отображаться внутри кавычек. Можно указать несколько аргументов пары имен и значений в любом порядке как Name1,Value1,...,NameN,ValueN.

Пример: fh = simscape.logging.plot(simlog,'units','mm','time',[1 3]) строит график всех линейных переменных положения в модели (серии, которые соизмеримы с единицами измерения mm), в этих единицах, в диапазоне времени от 1 до 3 секунд.

Количество дочерних уровней для построения графика Node объект, указанный как разделенная запятыми пара, состоящая из 'depth'и неотрицательное целое число. По умолчанию функция отображает все потомки Node объект, имеющий непустые ряды. Определение depth позволяет ограничить количество уровней для печати, например:

'depth',0 Детей нет; постройте график только непустого ряда указанного узла.
'depth',1Постройте график непустого ряда указанного узла и его нижестоящих элементов.
'depth',2Постройте график непустого ряда указанного узла, его нижестоящих элементов и их нижестоящих элементов.

Если logobject является Series объект, этот аргумент игнорируется.

Пример: simscape.logging.plot(simlog.Translational_Spring,'depth',1) отображает все переменные, связанные с блоком поступательной пружины, но не с его портами.

Легенда графика, заданная как разделенная запятыми пара, состоящая из 'namesи массив ячеек из векторов символов или строковых скаляров. Число элементов в массиве ячеек должно совпадать с числом элементов logobject.

По умолчанию графики не имеют условных обозначений.

Временной диапазон для печати данных, указанный как разделенная запятыми пара, состоящая из 'time'и вектор 1x2, [start_time end_time], в секундах.

[] строит график всех данных.

Единицы для печати данных, указанные как разделенная запятыми пара, состоящая из 'units«и имя единицы или массив ячеек имен единиц». Имена единиц должны отображаться в отдельных кавычках ('') или двойные цитаты ("").

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

Пример: fh = simscape.logging.plot(simlog,'units',{'mm','mm/s'}) строит график всех линейных переменных положения и скорости в модели (серии, которые соизмеримы с единицами измерения mm и mm/s), в этих подразделениях.

Альтернативное место назначения для печати данных для Node объект, указанный как разделенная запятыми пара, состоящая из 'viewer«и» datainspector внутри одиночных кавычек ('') или двойные цитаты ("").

При указании этого аргумента пары «имя-значение» функция отображает данные в инспекторе данных моделирования. По умолчанию функция отображает данные в окне печати.

Если logobject является Series объект, этот аргумент игнорируется.

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

свернуть все

Обрабатывает полученные окна рисунков, возвращаемые в виде структуры или массива ячеек, в зависимости от типа logobject:

  • Если logobject является Node, fh - структура с той же иерархией, что и выводимый на печать объект. Например, если конкретный нижестоящий элемент не выведен на печать, то это поле в структуре вывода будет пустым.

  • Если logobject является Series, fh является массивом ячеек.

См. также

| |

Темы

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

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

Поддержка