slreportgen.report.MATLABFunction class

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

Блок MATLAB function или генератор отчетов функции MATLAB Stateflow

Описание

Создайте блок MATLAB Function или генератор отчетов функции Stateflow® MATLAB®.

Примечание

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

Конструкция

reporter = MATLABFunction() создает пустой MATLABFunction генератор отчетов на основе шаблона по умолчанию. Используйте его свойства задать блок Simulink® MATLAB Function или функцию MATLAB Stateflow, на которой можно сообщить и задать опции отчета.

reporter = MATLABFunction(mlfcnobj) создает MATLABFunction генератор отчетов для заданного mlfcnobj. Этот генератор отчетов добавляет эту информацию по умолчанию в сгенерированный отчет:

  • Свойства блока Simulink MATLAB Function или свойства функции MATLAB Stateflow, в зависимости от того, является ли функция MATLAB блоком или объектом

  • Входной параметр функции и сводные данные выходного аргумента

  • Код MATLAB, используемый функцией MATLAB, чтобы вычислить ее выходные параметры из ее входных параметров

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

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

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

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

Свойства

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

Блок MATLAB function Simulink или функция MATLAB Stateflow, чьи свойства сообщить в виде пути или указателя.

Примечание

Если вы используете средство поиска, чтобы найти блок Lookup Table и добавить его непосредственно в отчет, этот генератор отчетов LookupTable используется, а не генератор отчетов свойства объекта Simulink.

Включать ли свойства объектов в виде логического. Если true, отчет включает в себя таблицу свойств функции MATLAB. Если false, таблица свойства не включена.

Генератор отчетов свойств объектов в виде BaseTable генератор отчетов или пользовательский генератор отчетов. MATLABFunction генератор отчетов использует заданный генератор отчетов, чтобы составить таблицу свойств функции MATLAB. Свойства, о которых сообщат, зависят от того, является ли функция MATLAB блоком Simulink MATLAB Function или функцией MATLAB Stateflow.

Для блока MATLAB function Simulink сообщают об этих свойствах:

  • Метод Update

  • Размер шага

  • Поддержите массивы переменного размера

  • Насыщайте на целочисленном переполнении

  • Обработайте эти наследованные типы Сигнала Simulink как fi объекты

  • Блок MATLAB Function fimath

  • Введите fi математику

  • Описание

Для функции MATLAB Stateflow сообщают об этих свойствах:

  • Насыщайте на целочисленном переполнении

  • Функция MATLAB fimath

  • Введите fi математику

  • Описание

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

Включать ли сводную таблицу аргумента в виде логического. Если true, отчет включает в себя сводную таблицу свойств аргумента MATLAB Function. Если false, отчет не включает в себя сводную таблицу аргумента.

Свойства аргумента включать в сводную таблицу аргумента MATLAB Function в виде массива ячеек векторов символов имени свойства. Свойствами по умолчанию, включенными в сводные данные, является NameОсциллографПорт, Compiled Type, и Compiiled Size. Если модель уже не скомпилирована, MATLABFunction генератор отчетов компилирует модель, чтобы получить Compile Type и Compiled Size данные. Когда отчет закрывается, модель не скомпилирована.

Значение этого свойства может быть любой комбинацией этих свойств аргумента MATLAB Function.

  • Name

  • Scope

  • Port

  • Compiled Type (Data Type)

  • Compiled Size (Size)

  • Complexity

  • Description

  • Maximum (Max Value)

  • Minimum (Min Value)

  • Tunable

  • Variable Size

Генератор отчетов сводных данных аргумента в виде BaseTable генератор отчетов или пользовательский генератор отчетов. MATLABFunction генератор отчетов использует заданный генератор отчетов, чтобы составить таблицу аргументов функции MATLAB. Таблица включает сводные данные аргументов и свойств аргумента, заданных ArgumentSummaryProperties.

Чтобы настроить внешний вид сводной таблицы аргумента и содержимое ее заголовка, настройте BaseTable по умолчанию генератор отчетов или замена это с пользовательской версией BaseTable генератор отчетов.

Включать ли таблицу свойства с подробной информацией для каждого аргумента в виде логического. Если false, отчет не включает в себя таблицу свойства для каждого аргумента в функции MATLAB. Если true, отчет включает в себя таблицу свойства, и если модель уже не скомпилирована, MATLABFunction генератор отчетов компилирует модель. Когда отчет закрывается, модель не скомпилирована.

Генератор отчетов свойств аргумента в виде BaseTable генератор отчетов или пользовательский генератор отчетов. MATLABFunction генератор отчетов использует заданный генератор отчетов, чтобы составить таблицу свойств аргумента функции MATLAB. MATLABFunction генератор отчетов создает и использует копию этого генератора отчетов для каждого свойства аргумента, о котором сообщат.

Чтобы настроить внешний вид таблицы свойства аргумента, настройте BaseTable по умолчанию генератор отчетов или замена это с настроенной версией BaseTable генератор отчетов.

Включать ли функциональный скрипт в виде логического. Если true, отчет включает в себя скрипт функции MATLAB, который вычисляет выход блока MATLAB Function из его входных параметров. Если false, отчет не включает в себя функциональный скрипт.

Функциональный формат кода скрипта в виде mlreportgen.dom.Paragraph абзац. Чтобы настроить функциональный формат скрипта, такой как семейство шрифтов, размер шрифта, выравнивание и другие атрибуты, устанавливают свой mlreportgen.dom.Paragraph свойства. mlreportgen.dom.Paragraph не управляет, использует ли генератор отчетов цвета, чтобы подсветить синтаксис сценария. Смотрите HighlightScriptSyntax, чтобы управлять выделением.

Чтобы настроить внешний вид скрипта, измените свойства абзаца по умолчанию или замените абзац на другой объект абзаца. Если вы добавляете содержимое в значение по умолчанию или заменяющий абзац, то содержимое помещается перед скриптом функции MATLAB в сгенерированном отчете.

Функциональный заголовок скрипта в виде mlreportgen.dom.Paragraph, который содержит заголовок для раздела, который содержит скрипт функции MATLAB. Заголовок по умолчанию является именем блока MATLAB Function, сопровождаемым "Функциональным Скриптом", который добавлен к абзацу. Например, для блока MATLAB function, названного "Производная Ковариации", заголовок является "Производной Ковариации Функциональный Скрипт". Свойства абзаца задают внешний вид заголовка скрипта.

Чтобы настроить внешний вид заголовка, измените свойства объекта абзаца по умолчанию или замените его на другой объект абзаца. Если вы добавляете содержимое в значение по умолчанию или заменяющий абзац заголовка, содержимое, которое вы задаете, помещается впереди заголовка по умолчанию.

Подсветите ключевые слова синтаксиса сценария в виде логического. Если true, отчет использует цвета, чтобы подсветить ключевые слова синтаксиса сценария. Если false, отчет не подсвечивает ключевые слова.

Включать ли функциональные данные о символе в виде логического.

Если false, отчет не включает в себя информацию о символах, которые появляются в основном скрипте функции MATLAB. Если true, отчет включает в себя информацию о данных о символе. Если IncludeSupportingFunctions свойством является также true, отчет также содержит информацию о символах, которые появляются в поддерживании функций. О функциональных данных о символе сообщают, только если свойство исходного объекта этого генератора отчетов является блоком Simulink MATLAB Function.

Примечание

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

Функциональный генератор отчетов данных о символе в виде mlreportgen.report.BaseTable. Этот генератор отчетов является основанием для создания отчетов о свойствах символов, которые появляются в основном скрипте функции MATLAB. Символы в сгенерированном отчете сгруппированы типами, которые являются переменными, операция и сайт вызова функции. Таблица, которая перечисляет каждый тип символа, появляется после функциональных свойств. Таблицы символов перечисляют все символы конкретных типов, которые появляются в основной функции или определенных функциях поддержки. Отчет включает в себя символы функции поддержки, только если IncludeSupportingFunctions является true. MATLABFunction генератор отчетов создает копию этого генератора отчетов для каждого символа, о котором сообщат, и использует копию, чтобы сообщить относительно свойств символа. Функция, о которой сообщают, и свойства символа:

Функциональные свойстваОписание
FunctionName Имя функции
Функциональный IDID функции. Simulink присваивает уникальный идентификатор каждому MATLAB Function в модели и к каждой поддерживающей функции. Встроенная или пользовательская функция поддержки использует свой тот же ID, независимо от того, сколько функций она поддерживает в данной модели.
PathПуть функции, которая является моделью path блока MATLAB Function или блока Stateflow, который содержит его. Путь функции поддержки является путем файла MATLAB, который задает его.

Variable PropertiesОписание
ИмяИмя переменной
Тип данныхТип данных и размер переменной
Запустите положениеНомер строки и номер столбца первого символа имени переменной в скрипте, в котором это появляется

Свойства операцииОписание
ВводСимвол или символы, которые представляют тип операции. Например, +
Тип данныхТип данных и размер значения производятся операцией
Запустите положениеНомер строки и номер столбца первого символа операции в скрипте, в котором это появляется

Свойства сайта вызова функцииОписание
ИмяИмя вызванной функции
Тип данныхТип данных и размер значения, возвращенного вызванной функцией
IDID вызванной функции
Запустите положениеНомер строки и номер столбца первого символа сайта вызова в скрипте, в котором это появляется

Чтобы настроить внешний вид функциональных таблиц данных символа, настройте BaseTable по умолчанию генератор отчетов или замена это с настроенной версией BaseTable генератор отчетов. Если вы задаете Title содержимое свойства в значении по умолчанию или замене BaseTable генератор отчетов, то содержимое помещается впереди заголовка по умолчанию в сгенерированном отчете.

Включать ли поддерживающие функции в виде логического. Если false, отчет не включает в себя список функций, вызванных прямо или косвенно функциональным скриптом. Если true, отчет включает в себя функции поддержки.

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

  • 'MATLAB' — Включайте только MATLAB, поддерживающий функции

  • 'пользовательский' — Включают только пользовательские функции поддержки

Поддержка генератора отчетов функций в виде BaseTable, который перечисляет функции, вызванные прямо или косвенно скриптом функции MATLAB. Функции сортируются по имени функции.

Чтобы настроить внешний вид таблицы функций поддержки, настройте BaseTable по умолчанию генератор отчетов или замена это с настроенной версией BaseTable генератор отчетов.

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

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

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

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

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

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

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

Методы

createTemplateСоздайте шаблон генератора отчетов функции MATLAB
customizeReporterСоздайте пользовательский класс генератора отчетов функции MATLAB
getClassFolderРасположение файла определения класса генератора отчетов функции MATLAB

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

copyСоздайте копию генератора отчетов, возражают и делают глубокие копии значений свойств, которые ссылаются на генератор отчетов, ReporterLayout или Объект DOM
getImplПолучите реализацию генератора отчетов

Примеры

Добавьте свойства функции MATLAB, аргументы и функциональный скрипт

Создайте генератор отчетов PDF, который использует MATLABFunction генератор отчетов. Этот генератор отчетов включает информацию о блоке MATLAB Function в sldemo_radar_eml модель.. Отчет, по умолчанию, включает в себя таблицу свойств объектов, таблицу аргументов ввода и вывода и функциональный скрипт.

import slreportgen.report.*
import mlreportgen.report.*

model_name = 'sldemo_radar_eml';
load_system(model_name); 
mlfcnobj = 'sldemo_radar_eml/MATLAB Function';

rpt = slreportgen.report.Report('output','pdf');
chapter = Chapter(mlfcnobj); 
rptr = MATLABFunction(mlfcnobj); 
add(chapter,rptr); 
add(rpt,chapter); 

close(rpt); 
close_system(model_name);
rptview(rpt);

Первую страницу сгенерированного отчета показывают.

Добавьте детали аргумента функции MATLAB

Создайте генератор отчета HTML, который использует MATLABFunction генератор отчетов и включает детали аргумента MATLAB Function. Используйте IncludeArgumentProperties свойство включать таблицу для каждого аргумента ввода и вывода блока MATLAB Function. Этот пример использует sldemo_radar_eml модель.

import slreportgen.report.*
import mlreportgen.report.*

model_name = 'sldemo_radar_eml';
load_system(model_name); 
mlfcnobj = 'sldemo_radar_eml/MATLAB Function';

rpt = slreportgen.report.Report('output','html');
chapter = Chapter(mlfcnobj); 
rptr = MATLABFunction(mlfcnobj);
rptr.IncludeArgumentProperties = true;

add(chapter,rptr); 
add(rpt,chapter); 

close(rpt); 
close_system(model_name);
rptview(rpt);

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

Измените форматирование скрипта функции MATLAB и заголовок

Создайте генератор отчета HTML, который использует MATLABFunction генератор отчетов и наборы внешний вид функционального скрипта и заголовка. Измените внешний вид раздела скрипта функции блока MATLAB Function отчета. Используйте FunctionScriptTitle свойство задать текст, чтобы добавить впереди функционального табличного заголовка скрипта по умолчанию. Создайте и используйте абзац DOM, чтобы изменить шрифт, размер шрифта и цвет скрипта. Этот пример использует sldemo_radar_eml модель.

import slreportgen.report.*
import mlreportgen.report.*

model_name = 'sldemo_radar_eml';
load_system(model_name); 
mlfcnobj = 'sldemo_radar_eml/MATLAB Function';

rpt = slreportgen.report.Report('output','html');
chapter = Chapter(mlfcnobj); 
rptr = MATLABFunction(mlfcnobj);

paraTitle = mlreportgen.dom.Paragraph('SCRIPT: ');
rptr.FunctionScriptTitle = paraTitle;

paraScript = mlreportgen.dom.Paragraph;
paraScript.FontFamilyName = 'Arial';
paraScript.FontSize = '12pt';
paraScript.Color = 'blue';
rptr.FunctionScript = paraScript;

add(chapter,rptr); 
add(rpt,chapter); 

close(rpt); 
close_system(model_name);
rptview(rpt);

Этот раздел сгенерированного отчета показывает "СКРИПТ": добавленный к заголовку и Arial на 12 ПБ синий шрифт.

Введенный в R2018a