Пакет: slreportgen.report
Суперклассы: slreportgen.report.Reporter
Блок MATLAB function или Stateflow MATLAB function reporter
Используйте объект slreportgen.report.MATLABFunction
класс для отчета по Simulink®
MATLAB Function блок или Stateflow® MATLAB® функция.
По умолчанию a MATLABFunction
reporter добавляет эту информацию в отчет:
Simulink MATLAB Function блок или свойства функции Stateflow MATLAB
A сводных данных входного параметра функции и выходных аргументов
Код MATLAB, используемый функцией, чтобы вычислить ее выходы из его входов
Используйте свойства reporter для включения другой информации, такой как свойства подробных аргументов, свойства символа функции и вспомогательные функции.
Примечание
Как использовать MATLABFunction
репортер в отчете, вы должны создать отчет с помощью slreportgen.report.Report
класс.
The slreportgen.report.MATLABFunction
класс является handle
класс.
HandleCompatible | true |
Для получения информации об атрибутах класса см. раздел «Атрибуты класса».
создает пустой reporter
= slreportgen.report.MATLABFunction()MATLABFunction
репортер на основе шаблона по умолчанию. Используйте Object
свойство для задания блока MATLAB Function Simulink или функции Stateflow MATLAB, подлежащей отчету.
устанавливает reporter
= slreportgen.report.MATLABFunction(mlfcnObj)Object
свойство блока MATLAB Function или функции Stateflow MATLAB, заданное как mlfcnObj
.
Object
- блок MATLAB function или функция Stateflow MATLAB[]
(по умолчанию) | вектор символов | строковый скаляр | указатель на функциюБлок MATLAB function или функция Stateflow MATLAB для отчета, заданная как одно из следующих значений:
Вектор символов или строковый скаляр, который содержит путь к блоку MATLAB Function
Указатель на MATLAB Function блок или функцию Stateflow MATLAB
Примечание
Если вы используете finder, чтобы найти MATLAB Function блок или функцию Stateflow MATLAB и добавить результат непосредственно к отчету, slreportgen.report.MATLABFunction
reporter используется вместо свойства объекта Simulink.
IncludeObjectProperties
- Включать ли свойства объектаВключать ли свойства объекта в качестве true
или false
. Если значение true
отчет включает таблицу свойств объекта Simulink или Stateflow, которая соответствует сообщаемому блоку MATLAB Function или функции Stateflow MATLAB.
ObjectPropertiesReporter
- Свойства объекта reportermlreportgen.report.BaseTable
объектСвойства объекта reporter, заданные как mlreportgen.report.BaseTable
объект. The MATLABFunction
reporter использует указанный репортер, чтобы создать таблицу свойств объекта Simulink или Stateflow, которая соответствует сообщаемому блоку MATLAB Function или функции Stateflow MATLAB.
Для блока MATLAB Function Simulink сообщаются следующие свойства:
Метод обновления
Шаг расчета
Поддержка массивов переменного размера
Насыщение при целочисленном переполнении
Обработайте эти унаследованные типы сигналов Simulink как объекты fi
MATLAB Function блок fimath
Входная математика
Описание
Для функции Stateflow MATLAB сообщаются эти свойства:
Насыщение при целочисленном переполнении
Fimath функции MATLAB
Входная математика
Описание
Чтобы настроить внешний вид таблицы свойств функции и ее заголовка, настройте BaseTable
по умолчанию репортер или замените его на пользовательскую версию
BaseTable
репортер. Чтобы настроить заголовок таблицы свойств функции, задайте содержимое в Title
свойство репортера по умолчанию или замены. Заданное содержимое помещается спереди заголовка по умолчанию.
IncludeArgumentSummary
- Включить сводные данные аргументовtrue
(по умолчанию) | false
Будет ли включать сводную таблицу аргументов, заданную как true
или false
. Если значение true
отчет включает сводную таблицу свойств аргументов сообщаемой функции.
ArgumentSummaryProperties
- Свойства аргумента, которые нужно включить{'Name' 'Scope' 'Port' 'Compiled Type' 'Compiled Size'}
(по умолчанию) | массив ячеек из векторов символов | строковых массивовСвойства аргумента, включаемые в сводную таблицу аргументов, заданные как массив ячеек из векторов символов или строковые массивы. Если модель еще не скомпилирована, MATLABFunction
reporter компилирует модель, чтобы получить Compile Type
и Compiled Size
данные. Когда отчет закроется, модель не компилируется.
Задайте любую комбинацию следующих свойств:
Name
Scope
Port
Compiled Type (Data Type)
Compiled Size (Size)
Complexity
Description
Maximum (Max Value)
Minimum (Min Value)
Tunable
Variable Size
ArgumentSummaryReporter
- Сводный репортер аргументовmlreportgen.report.BaseTable
объектСводные данные аргументов, заданный как mlreportgen.report.BaseTable
объект. The MATLABFunction
reporter использует этого репортера, чтобы создать таблицу аргументов функции MATLAB. Таблица включает сводные данные аргументов и свойств аргументов, заданных в ArgumentSummaryProperties
свойство.
Чтобы настроить внешний вид сводной таблицы аргументов и содержимого ее заголовка, настройте BaseTable по умолчанию
объект или замените его на пользовательскую версию BaseTable
объект.
IncludeArgumentProperties
- Включать ли подробную информацию для каждого аргументаВключать ли таблицу свойств с подробной информацией для каждого аргумента, заданную как true
или false
. Если значение true
отчет включает таблицу свойств для каждого аргумента функции MATLAB. Если модель еще не скомпилирована, MATLABFunction
reporter компилирует модель. Когда отчет закроется, модель не компилируется.
ArgumentPropertiesReporter
- Репортер свойств аргументаmlreportgen.report.BaseTable
объектСвойства аргумента reporter, заданные как mlreportgen.report.BaseTable
объект. The MATLABFunction
reporter использует указанный репортер, чтобы создать таблицу свойств каждого аргумента функции MATLAB.
Чтобы настроить внешний вид таблицы свойств аргументов, настройте BaseTable
по умолчанию репортер или замените его на пользовательский
BaseTable
репортер.
IncludeFunctionScript
- Включать ли скрипт функцииБудет ли включать скрипт функции MATLAB, заданный как true
или false
. Если значение true
, отчет включает код, который вычисляет выход функции MATLAB из ее входов.
FunctionScript
- Форматтер кода функцииmlreportgen.dom.Paragraph
объектФорматтер кода функции, заданный как mlreportgen.dom.Paragraph
объект. The Paragraph
объект управляет форматированием, таким как семейство шрифтов, размер шрифтов и выравнивание, кода в функции MATLAB. Он не контролирует, подсвечивает ли репортер синтаксис кода. Для управления подсветкой используйте HighlightScriptSyntax
свойство.
Чтобы настроить внешний вид кода, измените свойства Paragraph
по умолчанию репортер или замените репортер пользовательским репортером. Если вы добавляете содержимое к значению по умолчанию или замене
Paragraph
reporter, содержимое помещается перед скриптом Функции MATLAB в сгенерированный отчет.
FunctionScriptTitle
- заголовок раздела скриптmlreportgen.dom.Paragraph
объектЗаголовок раздела скрипта функции, заданный как mlreportgen.dom.Paragraph
объект. The Paragraph
объект содержит заголовок для раздела, содержащего код функции MATLAB. Заголовок по умолчанию является MATLAB Function именем блока, за которым следуют Function Script
. Для примера, для блока MATLAB Function с именем Covariance Derivative
, заголовок Covariance Derivative Function Script
. Свойства абзаца определяют внешний вид заголовка.
Чтобы настроить внешний вид заголовка, измените свойства Paragraph
по умолчанию либо заменить его другим объектом абзаца. Если вы добавляете содержимое в абзац заголовка по умолчанию или вместо него, то указанное содержимое помещается спереди заголовка по умолчанию.
HighlightScriptSyntax
- Подсветить ли синтаксические ключевые слова скриптаtrue
(по умолчанию) | false
Выделять ли синтаксические ключевые слова скриптов, задается как true
или false
. Если значение true
, отчет использует цвет, чтобы подсветить синтаксические ключевые слова кода функции.
IncludeFunctionSymbolData
- Включать ли данные о символе функцииfalse
(по умолчанию) | true
Включать ли данные символа функции в виде true
или false
.
Если значение true
, отчет включает информацию о символах, которые появляются в основном коде функции MATLAB. Если на IncludeSupportingFunctions
свойство true
, отчет также содержит информацию о символах, которые появляются в коде вспомогательных функций. Данные о символе функции сообщаются только в том случае, если Object
свойство задает блок MATLAB Function.
Примечание
Если вы включаете данные символа функции, генерация отчетов может быть медленнее, чем если вы не включаете его.
FunctionSymbolReporter
- Function symbol data reportermlreportgen.report.BaseTable
объектFunction symbol data reporter, заданный как mlreportgen.report.BaseTable
объект. The MATLABLFunction
reporter использует этого репортера, чтобы создать таблицы свойств каждого символа, который появляется в основном коде функции MATLAB и опционально в коде вспомогательных функций. Символы в сгенерированном отчете сгруппированы по типам, которые являются переменными, операцией и узлом вызова функции. Таблицы для каждого типа символов появляются после свойств функции. Сообщенные свойства функции и символа перечислены в следующих таблицах.
Свойства функции | Описание |
---|---|
Имя функции | Имя функции |
Идентификатор функции | Идентификатор функции. Simulink присваивает уникальный идентификатор каждому MATLAB Function в модели и каждой поддерживающей функции. Встроенная или определяемая пользователем вспомогательная функция использует тот же идентификатор, независимо от того, сколько функций она поддерживает в данной модели. |
Путь | Путь функции, которая является путем модели содержащего ее блока MATLAB Function или Stateflow. Путь поддерживающей функции - это путь к файлу MATLAB, который определяет его. |
Свойства переменной | Описание |
---|---|
Имя | Имя переменной |
Тип данных | Тип данных и размер переменной |
Начальное положение | Линия и номер столбца первого символа имени переменной в скрипте, в котором она появляется |
Свойства операции | Описание |
---|---|
Имя | Символ или символы, представляющие тип операции. Для примера, + |
Тип данных | Тип данных и размер значения, произведенного операцией |
Начальное положение | Линия и номер столбца первого символа операции в скрипте, в котором она появляется |
Свойства сайта вызова функции | Описание |
---|---|
Имя | Имя вызываемой функции |
Тип данных | Тип данных и размер значения, возвращаемого вызываемой функцией |
Я бы | Идентификатор вызываемой функции |
Начальное положение | Линия и номер столбца первого символа сайта вызова в скрипте, в котором он появляется |
Чтобы настроить внешний вид таблиц данных символов функций, настройте BaseTable
по умолчанию репортер или замените его на пользовательский
BaseTable
репортер. Если вы задаете Title
свойство по умолчанию или замена BaseTable
reporter, содержимое помещается перед заголовком по умолчанию в сгенерированном отчете.
IncludeSupportingFunctions
- включать ли вспомогательные функции;false
(по умолчанию) | true
Если значение true
отчет включает в себя список пользовательских функций, вызываемых прямо или косвенно основной функцией MATLAB Function блока, о котором сообщается.
SupportingFunctionsType
- Поддерживающие типы функций{'MATLAB' 'user-defined'}
(по умолчанию) | массив ячеек из векторов символов | строковых массивовПоддерживающие типы функций, которые будут сообщаться, заданные как массив ячеек из векторов символов или строковые массивы. Массив ячеек или строковые массивы могут задавать один или оба из этих типов.
MATLAB
- Включите вспомогательные функции MATLAB
user-defined
- Включить пользовательские вспомогательные функции
SupportingFunctionsReporter
- Репортер вспомогательных функцийslreportgen.report.BaseTable
Поддерживающие функции reporter, заданные как mlreportgen.report.BaseTable
объект. The BaseTable
объект сообщает о функциях, вызываемых прямо или косвенно основной функцией MATLAB. Функции сортируются по имени функции.
Чтобы настроить внешний вид таблицы вспомогательных функций, настройте BaseTable
по умолчанию репортер или замените его на настроенную версию
BaseTable
репортер.
IncludeSupportingFunctionsCode
- Включать ли код пользовательских вспомогательных функцийfalse
(по умолчанию) | true
Включать ли код пользовательских вспомогательных функций, заданный как true
или false
. Если значение true
отчет включает код пользовательских функций, прямо или косвенно вызываемых основной функцией.
SupportingFunctionsCode
- Пользовательский форматтер кода вспомогательных функцийmlreportgen.dom.Paragraph
объектПользовательский форматтер кода вспомогательных функций, заданный как mlreportgen.dom.Paragraph
объект. The Paragraph
объект управляет форматированием, таким как семейство шрифтов, размер шрифтов и выравнивание кода в отчете. The MATLABFunction
reporter подсвечивает синтаксис текста функции (кода) и добавляет выделенный текст к объекту абзаца.
Чтобы настроить внешний вид кода, измените свойства Paragraph
по умолчанию репортер или замените репортер пользовательским репортером. Если вы добавляете содержимое к значению по умолчанию или замене
Paragraph
reporter, содержимое помещается перед кодом вспомогательной функции в сгенерированный отчет.
SupportingFunctionsCodeTitle
- Определяемый пользователем заголовок раздела вспомогательной функцииmlreportgen.dom.Paragraph
Пользовательский заголовок раздела вспомогательной функции, заданный как mlreportgen.dom.Paragraph
объект. The MATLABFunction
reporter использует форматтер, чтобы создать заголовок для каждой пользовательской вспомогательной функции. Значение по умолчанию этого свойства является пустым абзацем со свойствами, которые задают внешний вид заголовка функции. По умолчанию в MATLABFunction
reporter добавляет имя вспомогательной функции к абзацу. Вы можете настроить внешний вид заголовка, изменив свойства объекта абзаца по умолчанию или заменив его другим объектом абзаца. Любое содержимое, добавленное к абзацу по умолчанию или замене, появляется перед каждым заголовком в сгенерированном отчете.
TemplateSrc
- Источник шаблона для этого репортера[]
(по умолчанию) | вектор символов | строковый скаляр | репортер или отчет | документе DOM или части документаИсточник шаблона для этого репортера, заданный одним из следующих способов:
Вектор символов или строковый скаляр, который задает путь к файлу, содержащему шаблон для этого репортера
Репортер или отчет, шаблон которого используется для этого репортера или библиотека шаблонов которого содержит шаблон для этого репортера
DOM-документ или деталь документа, шаблон которой используется для этого репортера или библиотека шаблонов которой содержит шаблон для этого репортера
Указанный шаблон должен совпадать с типом отчета, к которому добавлен этот репортер. Для примера, для Microsoft® Отчет о словах, TemplateSrc
должен быть шаблоном репортера Word. Если на TemplateSrc
свойство пусто, этот репортер использует шаблон reporter по умолчанию для типа выхода отчета.
TemplateName
- Имя шаблона для этого репортераИмя шаблона для этого репортера, заданное как вектор символов или строковый скаляр. Шаблон для этого репортера должен быть в библиотеке шаблонов источника шаблона (TemplateSrc
) для этого репортера.
LinkTarget
- Цель гиперссылки для этого репортера[]
(по умолчанию) | вектор символов | строковый скаляр | mlreportgen.dom.LinkTarget
объектЦель гиперссылки для этого репортера, заданная как вектор символов или строковый скаляр, задающий идентификатор цели ссылки или mlreportgen.dom.LinkTarget
объект. Вектор символов или строковое скалярное значение преобразуется в LinkTarget
объект. Цель ссылки непосредственно предшествует содержимому этого репортера в выход отчете.
slreportgen.report.MATLABFunction.createTemplate | Создание копии slreportgen.report.MATLABFunction шаблон репортера |
slreportgen.report.MATLABFunction.getClassFolder | Расположение папки, содержащей slreportgen.report.MATLABFunction файл определения класса |
slreportgen.report.MATLABFunction.customizeReporter | Создайте подкласс slreportgen.report.MATLABFunction класс |
copy | Создайте копию объекта-репортера Simulink и сделайте глубокие копии определенных значений свойств |
getImpl | Получите реализацию reporter |
Чтобы включить информацию о блоке MATLAB Function в отчет, используйте slreportgen.report.MATLABFunction
репортер. По умолчанию отчет включает таблицу свойств объекта, таблицу входа и выходных аргументов и скрипт функции.
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("MyReport","pdf"); chapter = Chapter(mlfcnObj); rptr = MATLABFunction(mlfcnObj); add(chapter,rptr); add(rpt,chapter); close(rpt); close_system(model_name); rptview(rpt);
Вот первая страница отчета:
Чтобы включить детали аргумента функции MATLAB в отчет, используйте IncludeArgumentProperties
свойство MATLABFunction
репортер.
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("myReport","pdf"); chapter = Chapter(mlfcnObj); rptr = MATLABFunction(mlfcnObj); rptr.IncludeArgumentProperties = true; add(chapter,rptr); add(rpt,chapter); close(rpt); close_system(model_name); rptview(rpt);
Вот некоторые подробные таблицы аргументов в сгенерированном отчете:
Чтобы настроить заголовок раздела скрипта функции, используйте FunctionScriptTitle
свойство. Чтобы изменить форматирование кода, создайте DOM-абзац, который задает семейство шрифтов, размер и цвет, и присвойте абзац FunctionScript
свойство.
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("myReport","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);
Вот фрагмент функции скрипта разделе, где показан заголовок и часть кода:
По умолчанию a MATLABFunction
reporter включает код основной функции, но не код пользовательских вспомогательных функций, которые вызываются основной функцией. Чтобы включить код пользовательских функций, используйте IncludeSupportingFunctionsCode
свойство.
import slreportgen.report.* import mlreportgen.report.* model_name = "slrgex_stats"; load_system(model_name); mlfcnObj = "slrgex_stats/MATLAB Function"; rpt = slreportgen.report.Report("myReport","pdf"); chapter = Chapter(mlfcnObj); rptr = MATLABFunction(mlfcnObj); rptr.IncludeSupportingFunctionsCode = true; add(chapter,rptr); add(rpt,chapter); close(rpt); close_system(model_name); rptview(rpt);
Вот раздел скрипта функции MATLAB, в котором показан код как для основной функции, так и для пользовательской вспомогательной функции, avg
.
MATLAB Function | mlreportgen.dom.Paragraph
| mlreportgen.report.BaseTable
| slreportgen.finder.BlockFinder
| slreportgen.finder.BlockResult
| slreportgen.finder.DiagramElementFinder
| slreportgen.finder.DiagramElementResult
| slreportgen.finder.StateflowDiagramElementFinder
| slreportgen.utils.isMATLABFunction
У вас есть измененная версия этого примера. Вы хотите открыть этот пример с вашими правками?
1. Если смысл перевода понятен, то лучше оставьте как есть и не придирайтесь к словам, синонимам и тому подобному. О вкусах не спорим.
2. Не дополняйте перевод комментариями “от себя”. В исправлении не должно появляться дополнительных смыслов и комментариев, отсутствующих в оригинале. Такие правки не получится интегрировать в алгоритме автоматического перевода.
3. Сохраняйте структуру оригинального текста - например, не разбивайте одно предложение на два.
4. Не имеет смысла однотипное исправление перевода какого-то термина во всех предложениях. Исправляйте только в одном месте. Когда Вашу правку одобрят, это исправление будет алгоритмически распространено и на другие части документации.
5. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.