mlreportgen.report.MATLABVariable class
Пакет: mlreportgen.report
Генератор отчетов переменной MATLAB
Описание
Создайте генератор отчетов, который сообщает относительно переменной MATLAB®.
Конструкция
rptr
= mlreportgen.report.MATLABVariable()
создает генератор отчетов переменной MATLAB на основе шаблона по умолчанию. Прежде, чем добавить этот генератор отчетов в отчет, используйте его свойства задать имя переменной, относительно которого можно сообщить.
rptr = mlreportgen.report.MATLABVariable(variable)
создает генератор отчетов переменной MATLAB для заданного MATLAB variable
. Чтобы задать локальную переменную, задайте ее имя, например, MATLABVariable(x)
. Чтобы задать переменную рабочего пространства MATLAB, задайте ее имя как строку или символьный массив, например, MATLABVariable('x')
. Чтобы задать другие опции отчета, используйте свойства этого генератора отчетов.
rptr
= mlreportgen.report.MATLABVariable(Name,Value
)
создает генератор отчетов переменной MATLAB с опциями, заданными одним или несколькими Name,Value
парные аргументы. Name
имя свойства и Value
соответствующее значение. Name
должен казаться внутри одним (''
) или дважды (""
) кавычки. Можно задать несколько аргументов пары "имя-значение" в любом порядке как Name1,Value1,...,NameN,ValueN
.
Вместо того, чтобы задать переменную MATLAB с помощью ее Name
Значение
пара, можно задать его с помощью только ее значение, но это должен быть первый входной параметр. Например, для глобальной переменной MATLAB под названием x
, можно использовать любой mlreportgen.report.MATLABVariable(x,"Location","Global")
или mlreportgen.report.MATLABVariable("Variable","x","Location","Global")
.
Входные параметры
развернуть все
variable
— Имя переменной MATLAB
представьте скаляр в виде строки | вектор символов | имя локальной переменной
Имя переменной MATLAB, заданное как скаляр строки, вектор символов или имя локальной переменной. Чтобы задать локальную переменную, задайте ее имя, например, MATLABVariable(x)
. Чтобы задать переменную рабочего пространства MATLAB, задайте ее имя как скаляр строки или вектор символов, например, MATLABVariable('x')
. Для получения дополнительной информации о входе смотрите свойство Variable.
Свойства
развернуть все
Variable
— Имя переменной MATLAB
представьте скаляр в виде строки | вектор символов
Имя переменной MATLAB, заданное как скаляр строки или вектор символов. Заданная переменная может быть любым из этих типов данных:
Символ или символьный массив
Строка
Векторный массив ячейки или массив ячеек
Логический скаляр, логический вектор или логический массив
Числовой скаляр, числовой массив или числовой вектор
Таблица MATLAB
Вектор объекта MATLAB или объектный массив
Объект Simulink®
Stateflow®object
Графический объект
Структура MATLAB, вектор структуры или массив структур
Location
— Местоположение переменной
"MATLAB"
(значение по умолчанию) | "MAT-File"
| "Global"
| "Local"
| "Model"
Местоположение переменной, заданной как одна из этих строк или как символьные массивы:
"MATLAB"
— Базовое рабочее пространство
"MAT-File"
— MAT-файл задан в FileName
свойство этого генератора отчетов
"Global"
— Глобальное пространство имен
"Local"
— Локальное пространство имен, обычно пространство имен функциональной или рабочей области, в которой был создан этот генератор отчетов
"Model"
— Рабочая область модели Simulink Report Generator™ задана в FileName
свойство этого генератора отчетов
FileName
— Имя файла или модели, которая содержит переменную
представьте скаляр в виде строки | вектор символов
Имя модели MAT-файл или Simulink, которая содержит переменную, заданную как скаляр строки или как вектор символов. Это свойство применяется только если Location
значением свойства является MAT-File
или Model
. Если Location
MAT-File
, имя файла является именем MAT-файла, из которого можно получить переменную. Если Location
Model
, FileName
имя файла модели Simulink, который содержит переменную.
FormatPolicy
— Формат значений переменных
"Auto"
(значение по умолчанию) | "Table"
| "Paragraph"
| "Inline Text"
Формат значений переменных, заданных как одна из этих строк или векторов символов:
"Auto"
— Форматирует значения переменных как таблицу или абзац, в зависимости от типа данных значения.
Типы данных, отформатированные как таблица, включают:
Типы данных, отформатированные как абзац, включают:
Вектор ячейки
Логический скаляр или вектор
Числовой скаляр или вектор
Символ или символьный массив
Строка
Вектор структуры MATLAB
Вектор объекта MATLAB
"Table"
— Форматирует значения переменных в таблице. Переменные, которые по умолчанию появляются как абзацы, отформатированы вместо этого как записи таблицы. Переменные, которые иерархически структурированы объекты, такие как MATLAB структуры, объекты MATLAB, объекты Simulink, объекты Stateflow или графические объекты, могут иметь свойства, которые являются самостоятельно объектами. В этом случае иерархия сглажена, и значение свойства отображено как гиперссылка на таблицу свойств того объекта. Таблица свойства объекта также имеет гиперссылку назад на исходную таблицу.
"Paragraph"
— Отформатируйте значения переменных как абзац. Переменные, которые по умолчанию отформатированы как таблицы, сглажены и отформатированы как абзац.
"Inline Text"
— Форматирует переменную в соответствии с сопроводительным текстом.
TableReporter
— Табличный генератор отчетов для значений переменных
mlreportgen.report.BaseTable
Табличный генератор отчетов используется этим MATLABVariable
генератор отчетов, чтобы отформатировать значения переменных, заданные как mlreportgen.report.BaseTable
объект. Чтобы настроить внешний вид таблицы, измените BaseTable
по умолчанию
свойства генератора отчетов или замена это с индивидуально настраиваемым BaseTable
генератор отчетов. Если вы добавляете содержимое в Title
свойство значения по умолчанию или настроенного генератора отчетов, то содержимое появляется перед табличным заголовком в сгенерированном отчете.
ParagraphFormatter
— Средство форматирования абзаца для переменной MATLAB
mlreportgen.dom.Paragraph
объект
Средство форматирования абзаца возражает, чтобы отформатировать значение переменной MATLAB, заданной как mlreportgen.dom.Paragraph
объект. Чтобы настроить внешний вид абзаца, измените Paragraph
DOM
свойства объектов или замена объект с индивидуально настраиваемым Paragraph
объект. Если вы добавляете содержимое в значение по умолчанию или заменяющий объект абзаца, то содержимое появляется перед переменным содержимым в сгенерированном отчете.
TextFormatter
— Текстовое средство форматирования для переменной MATLAB
mlreportgen.dom.Text
объект
Текстовое средство форматирования возражает, чтобы отформатировать текстовые значения переменной MATLAB в таблицах или абзацах, заданных как mlreportgen.dom.Text
объект. Чтобы настроить внешний вид текста, измените Text
DOM
свойства объектов или замена объект с индивидуально настраиваемым Text
объект. Если вы добавляете содержимое в объект или текста замены по умолчанию, то содержимое появляется перед переменным содержимым в сгенерированном отчете.
MaxCols
— Максимальное количество столбцов таблицы, чтобы отобразиться
32 (значения по умолчанию) | положительное целое число
Максимальное количество столбцов таблицы, чтобы отобразиться, заданный как положительное целое число. Поскольку переменные типа массив сообщили об использовании таблицы, если количество столбцов больше значения MaxCols
свойство, таблица нарезана вертикально. Разрезание делит таблицу на несколько таблиц.
DepthLimit
— Максимальное количество вложенных уровней, чтобы сообщить
10 (значений по умолчанию) | неотрицательное целое число
Максимальное количество уровней, чтобы сообщить для переменной, которая является структурированным объектом или массивом структурированных объектов, заданных как неотрицательное целое число. Уровни, меньше чем или равные значению DepthLimit
сглажены в последовательность связанных таблиц (см. FormatPolicy
свойство. Об уровнях, больше, чем предел глубины, не сообщают. Если вы устанавливаете DepthLimit
свойство к 0, структурированные объекты не расширены.
ObjectLimit
— Максимальное количество вложенных объектов, чтобы сообщить
200 (значений по умолчанию) | положительное целое число
Максимальное количество объектов в иерархии объектов, чтобы сообщить, заданный как положительное целое число.
IncludeTitle
— Включать ли заголовок
true
(значение по умолчанию) | false
Включать ли заголовок, заданный как true
или false
. Заголовок содержит имя переменной и опционально, тип данных. Если IncludeTitle
true
, заголовок включен. По умолчанию заголовок включает только имя переменной. Чтобы включать тип данных переменной, установите ShowDataType
свойство к true
.
ShowDataType
— Показать ли тип данных переменной в заголовке
false
(значение по умолчанию) | true
Показать ли тип данных переменной в заголовке, заданном как true
или false
.
ShowEmptyValues
— Показать ли свойства, которые имеют пустые значения
true
(значение по умолчанию) | false
Показать ли свойства, которые имеют пустые значения, заданные как true
или false
. ShowEmptyValues
свойство применяется только к объекту MATLAB, объекту Simulink и переменным объекта Stateflow.
ShowDefaultValues
— Показать ли свойствам то использование значения по умолчанию
true
(значение по умолчанию) | 0
Показать ли свойства, которые используют значение по умолчанию, заданное как true
или false
. ShowDefaultValues
свойство применяется только к объекту MATLAB, объекту Simulink и переменным объекта Stateflow.
PropertyFilterFcn
— Функция или выражение к свойствам фильтра переменной, о которой сообщают,
[]
(значение по умолчанию) | указатель на функцию | представляет скаляр в виде строки | вектор символов
Функция или выражение, чтобы отфильтровать свойства переменной из отчета. Задайте функцию как указатель на функцию. Задайте выражение как скаляр строки или вектор символов. Это свойство применяется только к переменным, которые содержат объекты. Если вы не обеспечиваете PropertyFilterFcn
, все свойства переменной включены в отчет.
Если вы обеспечиваете указатель на функцию, присоединенная функция должна:
Например, этот код предотвращает отображение NumRegions
и NumHoles
свойства polyshape
объект.
Если вы обеспечиваете скаляр строки или вектор символов, это должно содержать выражение. Выражение:
Может использовать переменные variableName
, variableObject
, и propertyName
Должен установить переменную isFiltered
к true
отфильтровать заданное свойство из отчета или false
включать свойство в отчет
Например, этот код фильтрует NumHoles
свойство polyshape
объект из отчета.
NumericFormat
— Формат или точность раньше отображали числовые значения нецелого числа
[]
(значение по умолчанию) | представляет скаляр в виде строки | вектор символов | положительное целое число
Формат или точность раньше отображали числовые значения нецелого числа.
Задайте формат как скаляр строки или вектор символов. Смотрите formatSpec
аргумент на sprintf
страница с описанием.
Задайте точность как положительное целое число. Смотрите precision
аргумент на num2str
страница с описанием.
Пример: "%.2f"
отображения удваивают значения с двумя цифрами справа от десятичного разряда.
Пример 2
отображает максимальное количество двух значительных цифр.
TemplateSrc
— Источник шаблона для этого генератора отчетов
вектор символов | представляет скаляр в виде строки | генератор отчетов или отчет | документ DOM или часть документа
Источник шаблона для этого генератора отчетов, заданного одним из этих способов:
Вектор символов или скаляр строки, который задает путь файла, который содержит шаблон для этого генератора отчетов
Генератор отчетов или отчет, шаблон которого используется в этом генераторе отчетов или чья библиотека шаблонов содержит шаблон для этого генератора отчетов
Документ DOM или часть документа, шаблон которой используется в этом генераторе отчетов или чья библиотека шаблонов содержит шаблон для этого генератора отчетов
Заданный шаблон должен быть тем же типом как отчет, к которому добавлен этот генератор отчетов. Например, для отчета Word Microsoft®, TemplateSrc
должен быть шаблон генератора отчетов Word. Если TemplateSrc
свойство пусто, этот генератор отчетов использует шаблон генератора отчетов по умолчанию в выходном типе отчета.
TemplateName
— Имя шаблона для этого генератора отчетов
вектор символов | представляет скаляр в виде строки
Имя шаблона для этого генератора отчетов, заданного как вектор символов или скаляр строки. Шаблон для этого генератора отчетов находится в библиотеке шаблонов источника шаблона (TemplateSrc
) для этого генератора отчетов.
LinkTarget
— Цель гиперссылки для этого генератора отчетов
[]
(значение по умолчанию) | вектор символов | представляет скаляр в виде строки | mlreportgen.dom.LinkTarget
объект
Цель гиперссылки для этого генератора отчетов, заданного как строка или символьный массив, который задает ID цели ссылки или mlreportgen.dom.LinkTarget
объект. Значение строки или символьного массива преобразовано в LinkTarget
объект. Объект цели ссылки сразу предшествует содержимому этого генератора отчетов в выходном отчете.
Копировать семантику
Указатель. Чтобы изучить, как классы Handle влияют на операции копии, смотрите Копирование Объектов (MATLAB).
Примеры
Переменные отчета Используя прямые имена или строки
В этом примере показано, как сообщить относительно переменных MATLAB. Локальная переменная использует только свое имя, как введено к MATLABVariable
класс и переменная рабочей области используют строку. Первая часть использования в качестве примера настройки свойства по умолчанию и вторая часть изменяет отображение в таблицу.
Примечание
Прежде чем вы запустите этот пример, создадите эту переменную в основном рабочем пространстве MATLAB:
workspace_var = ['Workspace variable input ',...
'specified as a string'];
rpt = mlreportgen.report.Report("MyReport","pdf");
local_var = ['Local variable input specified ',...
'using its variable name'];
chapter = mlreportgen.report.Chapter();
chapter.Title = "MATLAB Variable Reporter Example";
% Format using default paragraphs
rptr_local1 = mlreportgen.report.MATLABVariable...
(local_var);
rptr_workspace1 = mlreportgen.report.MATLABVariable...
("workspace_var");
add(chapter,rptr_local1)
add(chapter,rptr_workspace1)
% Format as a table
rptr_local2 = mlreportgen.report.MATLABVariable...
(local_var);
rptr_workspace2 = mlreportgen.report.MATLABVariable...
("workspace_var");
rptr_local2.FormatPolicy = 'Table';
rptr_workspace2.FormatPolicy = 'Table';
add(chapter,rptr_local2)
add(chapter,rptr_workspace2)
add(rpt,chapter)
close(rpt)
rptview(rpt)
Введенный в R2018b