Exponenta Banner

slreportgen.report.Diagram class

Пакет: 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 свойства.

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

  • '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' — Системные блоки маскированные, которые имеют ссылку параметров на текстовые описания, такие как таблицы параметров маски. Системные блоки маскированные, которые не имеют ссылки параметров на соответствующую блок-схему в отчете.

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

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

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

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

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

  • zoom — Увеличивает или уменьшает размер изображения снимка состояния до процентного значения, заданного 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

Пример: '3in'

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

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

Пример: '3in'

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

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

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

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

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

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

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

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

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

Заданный шаблон должен быть тем же типом как отчет, к которому добавлен этот генератор отчетов. Например, для отчета Word Microsoft®, 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);

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

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

Поведение изменяется в R2019b

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

| | | | | | | | | |

Темы

Введенный в R2017b

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