Exponenta Banner

slreportgen.report. Схематически изобразите класс

Пакет: slreportgen.report
Суперклассы:

Создайте генератор отчетов схемы

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

Описание

Создайте генератор отчетов схемы, включая снимок состояния схемы и заголовок, для схемы Stateflow® или Simulink®.

Примечание

Чтобы использовать генератор отчетов Схемы в отчете, необходимо создать отчет с помощью класса slreportgen.report.Report.

Конструкция

diagram = Diagram() создает пустой генератор отчетов схемы. Установите его свойства получить схема Stateflow или Simulink.

diagram = Diagram(source) создает генератор отчетов схемы для Simulink или схемы Stateflow, заданной source. Добавление этого генератора отчетов к отчету создает снимок состояния схемы. Затем снимок состояния отображается в отчете как изображение с заголовком. Изображение снимка состояния хранится во временной папке отчета. Когда отчет закрывается, изображение снимка состояния копируется в отчет и затем, изображение удалено из временной папки. Чтобы препятствовать тому, чтобы файл изображения снимка состояния был удален, используйте свойство Debug отчета. Смотрите slreportgen.report.Report

diagram = Diagram(Name,Value) свойства наборов с помощью пар "имя-значение". Можно задать несколько аргументов пары "имя-значение" в любом порядке. Заключите каждое имя свойства в одинарные или двойные кавычки.

Входные параметры

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

Смотрите свойство Source.

Свойства

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

Схематически изобразите источник изображения снимка состояния, заданный как одно из этих значений.

  • Имя открытой или загруженной модели Simulink

  • Путь блока Подсистемы Simulink, который содержит схему Simulink или диаграмму Stateflow

  • Обработайте к блоку подсистемы, содержащему схему Simulink или диаграмму Stateflow

  • Stateflow.Chart или подобъект диаграммы Stateflow. Подграфики являются графическими объектами, которые могут содержать те же объекты как график верхнего уровня, включая другие подграфики. Подграфики обычно задаются Stateflow.State, Stateflow.Function или объектом Stateflow.Box.

Создайте снимки генератор отчетов, установите по умолчанию на объект класса mlreportgen.report.FormalImage. Вы не должны устанавливать это свойство сами. Объект FormalImage добавляет снимок состояния схемы в отчет. Чтобы управлять размером снимка состояния, установите свойства mlreportgen.report.FormalImage.

Создайте снимки формат изображения, заданный как строка или символьный массив. Поддерживаемые форматы:

  • 'auto' Использование формат .svg для HTML или PDF вывод. Использование формат .emf для Word вывод на Windows. Использование .png для Word вывод на Unix или Mac.

  • BMP Растровое изображение

  • GIF - формат обмена графическими данными

  • .jpg — Изображение JPEG

  • .png — Изображение PNG

  • .emf — Расширенный метафайл, поддержанный только в DOCX вывод на платформах Windows®

  • .svg — Масштабируемая векторная графика

  • .tif — Пометьте формат Файла изображения, не поддержанный в выводе HTML

  • .pdf — Изображение PDF

Выбор включать гиперссылку каждого элемента диаграммы, заданного как логическое. Если этим свойством является true, каждый элемент становится гиперссылкой на объект в отчете, который описывает его. Это свойство применяется только к PDF и отчетам HTML. Гиперссылки позволяют вам перемещаться по отчету с помощью Simulink и диаграмм Stateflow.

Diagram, SimulinkObjectProperties и генераторы отчетов StateflowObjectProperties работают совместно, чтобы включить навигацию с помощью гиперссылок. Каждый генератор отчетов снабжает предисловием объект отчета, который он создает с целью гиперссылки. ID той цели основан на пути элемента, о котором сообщают, в модели. Генератор отчетов Схемы также накладывает элементы снимка состояния схемы с гиперссылками на соответствующий основанный на элементе целевой ID. Объект отчета, к которому элемент диаграммы ссылки зависит от типа элемента.

  • Основанный на схеме блок (подсистема, график, модель) соединяется со схемой блока.

  • Другие блоки соединяются с текстовыми описаниями блока, обычно блокируют таблицы свойства.

  • Блоки подсистемы маскированные, которые имеют ссылку параметров маски на текстовое описание блока, такого как таблицы параметров маски. Это соединение с текстовыми описаниями верно, только если свойство MaskedSystemLinkPolicy генератора отчетов Схемы установлено в 'block' или 'default'. В противном случае системный блок маскированный соединяется со своей схемой.

  • Блоки подсистемы маскированные, которые не имеют ссылки параметров маски на схему блока.

Чтобы настроить основанную на схеме навигацию, создайте цели настраиваемой ссылки на основе целевых идентификаторов, сгенерированных служебной функцией slreportgen.utils.getObjectID.

Политика определить цели для гиперссылок системных блоков маскированных, заданных как одно из этих значений.

  • 'default' — Системные блоки маскированные, которые имеют ссылку параметров на текстовые описания, такие как таблицы параметров маски. Системные блоки маскированные, которые не имеют ссылки параметров на соответствующую блок-схему в отчете.

  • система Системные блоки маскированные соединяются со своей блок-схемой в отчете.

  • 'block' — Системные блоки маскированные соединяются со своим текстовым описанием, таким как таблица параметров маскированных или параметров подсистемы.

Масштабирование опций для схемы создает снимки изображение, заданное как строка, auto, custom или zoom. Scaling управляет размером изображения снимка состояния схемы в файле изображения.

  • 'auto' Для PDF или Word (docx) вывод, auto масштабирует изображение снимка состояния схемы, чтобы поместиться в текущий макет страницы при поддержании его соотношения сторон. Во-первых, изображение снимка состояния схемы масштабируется к странице width. Если высота изображения превышает высоту страницы, то изображение снова уменьшено масштаб. Это дополнительное масштабирование гарантирует, что изображение помещается в текущую страницу с дополнительным 1-дюймовым интервалом. Дополнительный интервал допускает дополнительный текст, такой как заголовок. Масштабирование не применяется к выводу HTML.

  • custom — Масштабирует изображение снимка состояния схемы на основе значений свойств Height и Width

  • изменение масштаба Увеличивает или уменьшает размер изображения снимка состояния до процентного значения, заданного свойством Zoom. Чтобы задать максимальную высоту изображения и максимальную ширину изображения, используйте свойства MaxHeight и MaxWidth, соответственно.

Примечание

java.lang.OutOfMemoryError может произойти, когда любая из этих комбинаций настроек свойства происходит:

  • Набор Scaling к zoom, и Zoom, MaxHeight и набор свойств MaxWidth к большим значениям

  • Набор Scaling к custom и набор свойств Height и Width к большим значениям

Избегать этой ошибки, для изменения масштаба Scaling, меньший Zoom использования, MaxHeight и значения свойств MaxWidth. Для пользовательского Scaling используйте меньший Height и значения свойств Width. Используя меньшие значения гарантирует, что схема соответствует на странице.

Высота снимка состояния отображает для пользовательского масштабирования, заданного как строка. Это свойство применяется, только если Scaling установлен в custom.

Форматом Height является valueUnits, где Units является сокращением от единиц высоты, и value является количеством модулей. Таблица показывает допустимые сокращения Units.

МодулиМодульное сокращение
'pixels'px
'centimeters'cm
'inches'in
миллиметрыmm
цицероpc
'points'pt

Ширина снимка состояния отображает для пользовательского масштабирования, заданного как строка. Это свойство применяется, только если Scaling установлен в custom.

Форматом Width является valueUnits, где Units является сокращением от единиц ширины, и value является количеством модулей. Смотрите свойство Height для таблицы допустимых сокращений Units.

Означайте, чтобы масштабировать изображение снимка состояния схемы, заданное как строка. Формат Zoom является % value, где value является процентом, которым изображение снимка состояния схемы увеличивается или уменьшается.

Максимальная высота для масштабирования изменения масштаба, заданного как строка. Это свойство применяется, только если Scaling установлен в zoom.

Форматом MaxHeight является valueUnits, где Units является сокращением от единиц высоты, и value является количеством модулей. Смотрите свойство Height для таблицы допустимых сокращений Units.

Максимальная ширина для масштабирования изменения масштаба, заданного как строка. Это свойство применяется, только если Scaling установлен в zoom.

Форматом MaxWidth является valueUnits, где Units является сокращением от единиц высоты, и value является количеством модулей. Смотрите свойство Height для таблицы допустимых сокращений Units.

Источник шаблона для этого генератора отчетов, заданного как одно из этих значений:

  • Строка или символьный массив, задающий путь файла, содержащего шаблон для этого генератора отчетов

  • Генератор отчетов или отчет, шаблон которого используется в качестве шаблона для этого генератора отчетов или чья библиотека шаблонов содержит шаблон для этого генератора отчетов

  • Документ DOM или часть документа, шаблон которой используется в качестве шаблона для этого генератора отчетов или чья библиотека шаблонов содержит шаблон для этого генератора отчетов

Заданный шаблон должен иметь тот же тип как отчет, к которому добавлен этот генератор отчетов. Например, для отчета Word, TemplateSrc должен быть шаблоном генератора отчетов Word. Если свойство TemplateSrc пусто, этот генератор отчетов использует шаблон генератора отчетов по умолчанию для выходного типа отчета.

Имя шаблона для этого генератора отчетов, заданного как строка или символьный массив. Шаблон для этого генератора отчетов находится в библиотеке шаблонов источника шаблона (TemplateSrc) для этого генератора отчетов.

Цель гиперссылки для этого генератора отчетов, заданного как строка или символьный массив, который задает ID цели ссылки или объект mlreportgen.dom.LinkTarget. Значение строки или символьного массива преобразовано в объект LinkTarget. Объект цели ссылки сразу предшествует содержимому этого генератора отчетов в выходном отчете.

Методы

createTemplate Создайте шаблон схемы
customizeReporter Создайте пользовательский класс генератора отчетов схемы
getClassFolder Схематически изобразите расположение файла определения класса
getSnapshotImage Схематически изобразите местоположение файла изображения снимка состояния

Унаследованные методы

getImplПолучите реализацию генератора отчетов

Копировать семантику

Указатель. Чтобы изучить, как классы Handle влияют на операции копии, смотрите Копирование Объектов (MATLAB).

Примеры

Добавьте верхний уровень диаграммы модели

Добавьте снимок состояния верхнего уровня модели vdp к отчету.

load_system('vdp')
import slreportgen.report.*
import mlreportgen.report.*
rpt = slreportgen.report.Report('output','pdf');
 
chapter = Chapter();
chapter.Title = 'Diagram Reporter Example';
 
diagram = Diagram("vdp");
diagram.Snapshot.Caption = 'The van der Pol Equation';
diagram.SnapshotFormat = 'svg';
diagram.Snapshot.Height = '4in';

add(chapter,diagram);
add(rpt,chapter);
rptview(rpt);

Добавьте связанную гиперссылками схему в отчет

Создайте отчет PDF и добавьте снимки состояния схемы корневой системы и подсистемы от модели sf_car до него. Добавьте гиперссылку на подсистему передачи и добавьте абзац как цель для той ссылки.

import mlreportgen.report.*
import slreportgen.report.*
import slreportgen.utils.*
import mlreportgen.dom.*
rpt = slreportgen.report.Report('output','pdf');
chapter = Chapter('sf_car');

load_system('sf_car');
diag1 = Diagram('sf_car');
diag1.Snapshot.Caption = 'Root System: sf_car';
add(chapter,diag1);
add(chapter,PageBreak);

diag2 = Diagram('sf_car/Engine');
diag2.Snapshot.Caption = 'Subsystem: sf_car/Engine';
add(chapter,diag2);
add(chapter, PageBreak);

para = Paragraph('Custom target for sf_car/transmission');
id = getObjectID('sf_car/transmission');
append(para,mlreportgen.dom.LinkTarget(id));
add(chapter,para);
add(chapter,PageBreak);

add(rpt, chapter);
close(rpt);
rptview(rpt);

Смотрите также

| | | | | | | | | |

Темы

Введенный в R2017b

Документация Simulink Report Generator
Поддержка