Exponenta Banner
exponenta event banner

Simulink.sdi.report

Создание отчета инспектора расчетных данных

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

Синтаксис

Simulink.sdi.report
Simulink.sdi.report (имя, значение)

Описание

Simulink.sdi.report создает отчет, содержащий снимки печати и метаданные для сигналов, выводимых на печать на панели «Проверка» инспектора данных моделирования.

пример

Simulink.sdi.report(Name,Value) создает отчет, как указано одним или несколькими Name,Value аргументы пары. С помощью этого синтаксиса можно создать отчет о данных, выводимых на печать на панели «Проверка», или отчет о результатах сравнения. Для каждого отчета можно указать подробные данные.

Примеры

свернуть все

Открыть сценарий в реальном времени

Создайте отчет, содержащий информацию и графики сигналов, выводимых на печать на панели «Проверка» инспектора данных моделирования. По умолчанию отчет содержит метаданные, отображаемые для сигналов в таблице на панели Проверка (Inspect). В этом примере показано, как указать, какие метаданные следует включить в отчет.

Загрузить файл сеанса

В этом примере инспектор данных моделирования заполняется данными и печатаемыми сигналами путем загрузки сохраненного файла сеанса. Файл сеанса содержит данные сигнала, а также информацию о выводимых на печать сигналах и компоновке печати. Загрузите файл сеанса.

Simulink.sdi.load('ex_sldemo_absbrake_slp_Ww.mldatx');

Создание отчета по выводимым на печать сигналам

Отчет включает графики и метаданные для выводимых на печать сигналов. По умолчанию отчет включает метаданные, соответствующие столбцам, отображаемым в таблице сигналов на панели Проверка (Inspect). Можно включить дополнительные данные в отчет, отображая дополнительные столбцы на панели Проверка (Inspect). Можно также указать нужную информацию в отчете программным способом с помощью 'ColumnsToReport' пара имя-значение и класс перечисления Simulink.sdi.SignalMetaData.

signalMetadata = [Simulink.sdi.SignalMetaData.Run, ...
    Simulink.sdi.SignalMetaData.Line, ... 
    Simulink.sdi.SignalMetaData.BlockName, ...
    Simulink.sdi.SignalMetaData.SignalName];

Simulink.sdi.report('ReportType','Inspect', 'ReportOutputFile', ...
    'absbrake_slp_report.html', 'ColumnsToReport', signalMetadata);

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

Открыть сценарий в реальном времени

Используйте Simulink.sdi.report для создания отчета о результатах сравнения. Отчет является веб-интерактивным, и можно переключаться между интерактивным представлением и печатаемым представлением.

Результаты сравнения нагрузок

В этом примере загружаются ранее вычисленные результаты сравнения, сохраненные в файле MLDATX с помощью saveResult функция. Данные получены из двух имитаций slexAircraftExample модель, в которой использовались различные значения временных констант для входного фильтра.

Simulink.sdi.load('slexAircraftExampleTsComparison.mldatx');

Создать отчет о сравнении

Создайте отчет, содержащий результаты сравнения, используя Simulink.sdi.report функция. Можно указать название и автора отчета, которые отображаются в заголовке отчета.

Simulink.sdi.report('ReportType','Compare', 'ReportTitle',...
    'Compare: Ts = 0.1 vs Ts = 1','ReportAuthor', 'Jane Smith');

Отчет открывается в браузере системы после его создания. Выберите сигналы для просмотра результатов, отображаемых на графике, и метаданных для сигналов на панели «Свойства». HTML-файл отчета находится в sdireports в рабочей папке.

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

свернуть все

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

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

Пример: 'ReportType','Compare','ShortenBlockPath',true

Тип создаваемого отчета, определяемый как разделенная запятыми пара, состоящая из 'ReportType' и 'Inspect' или 'Compare'.

  • 'Inspect' - Создание отчета, содержащего снимки графика и метаданные для сигналов, выводимых на печать на панели «Проверка» инспектора данных моделирования.

  • 'Compare' - Создание отчета, обобщающего результаты сравнения. Отчет сравнения является интерактивным и включает в себя снимки графика результатов сравнения, а также метаданные для сравниваемых сигналов.

Пример: 'ReportType','Compare'

Заголовок отчета, отображаемый в заголовке для сравнительного отчета, указанный как пара, разделенная запятыми, состоящая из 'ReportTitle' и вектор символов.

Можно указать только заголовок отчета для сравнительного отчета.

Пример: 'ReportTitle','Trial 1 vs. Trial 2'

Автор отчета, отображаемый в заголовке для сравнительного отчета, указанного как пара, разделенная запятыми, состоящая из 'ReportAuthor' и вектор символов.

Можно указать только автора отчета для отчета сравнения.

Пример: 'ReportAuthor','John Smith'

Папка, в которой сохранен отчет, указанная как разделенная запятыми пара, состоящая из 'ReportOutputFolder' и вектор символов.

Пример: 'ReportOutputFolder','C:\Users\user1\Desktop'

Имя файла отчета, указанное как разделенная запятыми пара, состоящая из 'ReportOutputFile' и вектор символов.

Пример: 'ReportOutputFile','MyReport.html'

Следует ли запретить перезапись файлов отчетов, указанных как пара, разделенная запятыми, состоящая из 'PreventOverwritingFile' и true или false.

  • true включает защиту от перезаписи файлов.

  • false отключает защиту от перезаписи файлов.

Защита от перезаписи файлов запрещает инспектору данных моделирования перезаписывать существующий файл, добавляя к имени файла число, которое увеличивается при каждом создании отчета. При отключении защиты от перезаписи файлов инспектор данных моделирования перезаписывает существующий файл отчета, если не указано уникальное имя файла.

Пример: 'PreventOverwritingFile',false

Метаданные сигнала, включаемые в отчет о сигналах, отображаемых на панели «Inspect» инспектора данных моделирования, определяемые как пара, разделенная запятыми, состоящая из 'ColumnsToReport' и массив. По умолчанию Inspect отчет включает путь блока, имя, стиль и цвет линии, а также параметры источника данных для каждого выводимого на печать сигнала.

Примечание

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

Укажите метаданные для включения в массив с помощью класса перечисления Simulink.sdi.SignalMetaData. Например, чтобы включить имя прогона моделирования и имя сигнала:

signal_metadata = [Simulink.sdi.SignalMetaData.Run,...
                    Simulink.sdi.SignalMetaData.SignalName];

Затем укажите ColumnsToReport как signal_metadata в паре имя-значение:

Simulink.sdi.report('ColumnsToReport',signal_metadata)

Таблица суммирует метаданные, доступные для Inspect отчет.

Значение столбцаОписание
SignalName (по умолчанию)Название сигнала
Line (по умолчанию)Стиль и цвет сигнальной линии
SID

Идентификатор Simulink ®

Дополнительные сведения о SID см. в разделе Идентификаторы Simulink

UnitsЕдиницы измерения сигналов
SigDataTypeТип данных сигнала
SigSampleTimeМетод, используемый для выборки сигнала
ModelИмя модели, генерировавшей сигнал
BlockNameИмя блока источника сигнала
BlockPath Путь к блоку источника сигнала
PortИндекс сигнала на выходном порту его блока
DimensionsРазмеры матрицы, содержащей сигнал
ChannelИндекс сигнала в матрице
RunИмя прогона моделирования, содержащего сигнал
AbsTol Абсолютный допуск для сигнала
RelTol Относительный допуск для сигнала
OverrideGlobalTolСвойство, указывающее, имеют ли допуски сигнала приоритет над глобальными допусками
TimeTolДопуск по времени для сигнала
InterpMethodМетод интерполяции
SyncMethodМетод синхронизации, используемый для координат сигналов для сравнения
TimeSeriesRootИмя переменной, связанной с сигналом для сигналов, импортированных из рабочей области MATLAB ®
TimeSourceИмя массива, содержащего временные данные для сигналов, импортированных из рабочей области MATLAB
DataSourceИмя массива, содержащего данные сигнала для сигналов, импортированных из рабочей области MATLAB

Пример: 'ColumnsToReport',metadata

Сокращать ли путь блока в отчете, указанный как разделенная запятыми пара, состоящая из 'ShortenBlockPath' и true или false.

  • true - Используйте укороченный путь блока в отчете.

  • false - Включить полный путь блокировки в отчет.

Пример: 'ShortenBlockPath',false

Открывать ли отчет при его создании, указывается как разделенная запятыми пара, состоящая из 'LaunchReport' и true или false.

  • true - Открытие отчета при его создании.

  • false - Не открывайте отчет автоматически.

Пример: 'LaunchReport',false

Сигналы для включения в отчет сравнения, указанные как разделенная запятыми пара, состоящая из 'SignalsToReport' и 'ReportOnlyMismatchedSignals' или 'ReportAllSignals'.

  • ReportOnlyMismatchedSignals - Включать только сигналы с результатами сравнения отклонений.

  • ReportAllSignals - Включить все сигналы.

Пример: 'SignalsToReport','ReportAllSignals'

Вопросы совместимости

развернуть все

В R2020b изменилось поведение

См. также

| | |

Темы

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

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

Поддержка