Пакет: mlreportgen.report
Суперклассы: mlreportgen.report.Reporter
Изобразите генератор отчетов
Создайте генератор отчетов фигуры с заголовком, фигурой и заголовком.
mlreportgen.report.Figure
классом является handle
класс.
HandleCompatible | true |
Для получения информации об атрибутах класса см. Атрибуты класса.
fig = mlreportgen.report.Figure()
создает генератор отчетов, который заставляет снимок состояния фигуры в настоящее время открыться в MATLAB® и добавляет его в отчет. Используйте свойства фигуры добавить заголовок или изменить размер фигуры. Изображение снимка состояния хранится во временной папке отчета. Когда отчет закрывается, изображение снимка состояния копируется в отчет, и изображение удалено из временной папки. Чтобы препятствовать тому, чтобы файлы изображений снимка состояния были удалены, используйте Debug
свойство отчета. Смотрите mlreportgen.report.Report
.
Примечание
Фигура должна остаться открытой, пока генератор отчетов фигуры не добавляется к отчету.
fig = mlreportgen.report.Figure(source)
создает генератор отчетов, который добавляет фигуру, заданную source
и устанавливает свойство Source на source
.
fig = mlreportgen.report.Figure(Name,Value)
свойства наборов с помощью пар "имя-значение". Можно задать несколько аргументов пары "имя-значение" в любом порядке. Заключите каждое имя свойства в одинарные или двойные кавычки.
Snapshot
— Изобразите изображениеmlreportgen.report.FormalImage
объектИзобразите изображение в виде объекта mlreportgen.report.FormalImage
класс генератора отчетов. Использование генератора отчетов gcf
получить текущую фигуру MATLAB. Это использует формальный генератор отчетов изображений, чтобы ввести фигуру в отчет. Чтобы задать размер снимка состояния или заголовка, используйте свойства FormalImage
объект.
Примечание
Генератор отчетов фигуры инициализирует Snapshot
свойство. Не сбрасывайте это свойство.
Source
— Изобразите источникИзобразите источник в виде a:
Вектор символов или строковый скаляр, который указывает на путь к допустимому файлу фигуры
Допустимый графический указатель
SnapshotFormat
— Создайте снимки формат изображения'svg'
(значение по умолчанию) |...Создайте снимки формат изображения в виде вектора символов или строкового скаляра. Поддерживаемые форматы:
'bmp'
— Растровое изображение.
'gif'
— Формат обмена графическими данными.
'jpg'
— Изображение JPEG.
'png'
— Изображение PNG.
'emf'
— Расширенный метафайл, поддержанный только в DOCX выход на платформах Windows®.
'svg'
— Масштабируемая векторная графика.
'tif'
— Пометьте формат Файла изображения, не поддержанный в выводе HTML.
'pdf'
— Изображение PDF (поддерживаемый только в PDF выход).
Scaling
— Масштабирование опций для фигуры создает снимки изображение'auto'
(значение по умолчанию) | 'custom'
| 'ни один'Масштабирование опций для фигуры создает снимки изображение в виде вектора символов или строкового скаляра. Scaling
управляет размером изображения снимка состояния фигуры в файле изображения. Поддерживаемые опции масштабирования:
'auto'
— Для PDF или Word (DOCX) выход, масштабирует изображение снимка состояния фигуры, чтобы соответствовать текущему макету страницы при поддержании его соотношения сторон. Во-первых, изображение снимка состояния фигуры масштабируется к странице width. Если высота изображения превышает высоту страницы, изображение уменьшено масштаб снова. Это дополнительное масштабирование гарантирует, что изображение соответствует текущей странице дополнительным однодюймовым интервалом. Масштабирование не применяется к выводу HTML.
'custom'
— Масштабирует изображение снимка состояния фигуры на основе значений Height
и Width
свойства.
Когда вы устанавливаете Scaling
к custom
и имейте большие значения для Height
и Width
свойства, java.lang.OutOfMemoryError
может произойти во время генерации PDF. Чтобы избежать этой ошибки и гарантировать, что фигура соответствует на странице, используйте меньший Height
и Width
значения.
'none'
— Никакая калибровка не выполняется
Примечание
'auto'
и 'custom'
опции используют MATLAB print
команда, чтобы изменить размер фигуры. Если фигура является слишком крупной, чтобы соответствовать четко на заданном пробеле, print
обрезки команды изображение снимка состояния. Чтобы постараться не обрезать, можно задать 'none'
как значение Scaling
опция и использование генератор отчетов заданы Snapshot
свойство измерить изображение фигуры. Этот генератор отчетов уменьшает размер текста с остальной частью изображения, и пользователь может должен быть масштабировать изображение в средстве просмотра, чтобы различить мелкие детали. Смотрите Изменяют размер Изображения Снимка состояния фигуры.
Height
— Высота изображения снимка состоянияВысота снимка состояния отображает в виде вектора символов или строкового скаляра, который состоит из номера, сопровождаемого сокращением от единицы измерения. Например, '2 дюйма' задает два дюйма. Допустимые сокращения:
px
— пиксели (значение по умолчанию)
cm
'centimeters'
in
'inches'
mm
— миллиметры
pc
— цицеро
pt
'points'
Пример: '2in'
Width
— Ширина изображения снимка состоянияШирина снимка состояния отображает в виде вектора символов или строкового скаляра, который состоит из номера, сопровождаемого сокращением от единицы измерения. Например, '2 дюйма' задает два дюйма. Допустимые сокращения:
px
— пиксели (значение по умолчанию)
cm
'centimeters'
in
'inches'
mm
— миллиметры
pc
— цицеро
pt
'points'
Пример: '3in'
PreserveBackgroundColor
— Сохраните цвет фона фигурыСохраните цвет фона фигуры в снимке состояния в виде true
или false
. Если PreserveBackgroundColor
true
, цвет фона снимка состояния совпадает с цветом фона фигуры. Если PreserveBackgroundColor
false
, цвет фона снимка состояния является белым.
TemplateSrc
— Источник шаблона для этого генератора отчетов[]
(значение по умолчанию) | вектор символов | строковый скаляр | генератор отчетов или отчет | документ DOM или часть документаИсточник шаблона для этого генератора отчетов, заданного одним из этих способов:
Вектор символов или строковый скаляр, который задает путь файла, который содержит шаблон для этого генератора отчетов
Генератор отчетов или отчет, шаблон которого используется для этого генератора отчетов или чья библиотека шаблонов содержит шаблон для этого генератора отчетов
Документ DOM или часть документа, шаблон которой используется для этого генератора отчетов или чья библиотека шаблонов содержит шаблон для этого генератора отчетов
Заданный шаблон должен быть тем же типом как отчет, к которому добавлен этот генератор отчетов. Например, для отчета Word Microsoft®, TemplateSrc
должен быть шаблон генератора отчетов Word. Если TemplateSrc
свойство пусто, этот генератор отчетов использует шаблон генератора отчетов по умолчанию для выходного типа отчета.
TemplateName
— Имя шаблона для этого генератора отчетовИмя шаблона для этого генератора отчетов в виде вектора символов или строкового скаляра. Шаблон для этого генератора отчетов должен быть в библиотеке шаблонов источника шаблона (TemplateSrc
) для этого генератора отчетов.
LinkTarget
— Цель гиперссылки для этого генератора отчетов[]
(значение по умолчанию) | вектор символов | строковый скаляр | mlreportgen.dom.LinkTarget
объектЦель гиперссылки для этого генератора отчетов в виде вектора символов или строкового скаляра, который задает ID цели ссылки или mlreportgen.dom.LinkTarget
объект. Значение вектора символов или строкового скаляра преобразовано в LinkTarget
объект. Цель ссылки сразу предшествует содержимому этого генератора отчетов в выходном отчете.
getSnapshotImage | Получите канал передачи изображения снимка состояния |
mlreportgen.report.Figure.getClassFolder | Изобразите расположение файла определения класса |
mlreportgen.report.Figure.createTemplate | Создайте шаблон фигуры |
mlreportgen.report.Figure.customizeReporter | Создайте пользовательский класс генератора отчетов фигуры |
copy | Создайте копию генератора отчетов, возражают и делают глубокие копии значений свойств, которые ссылаются на генератор отчетов, ReporterLayout или Объект DOM |
getImpl | Получите реализацию генератора отчетов |
Добавьте фигуру объемной поверхностной диаграммы к отчету и установите название рисунка и высоту.
import mlreportgen.report.* surf(peaks); rpt = Report('peaks'); chapter = Chapter(); chapter.Title = 'Figure Example'; add(rpt,chapter); fig = Figure(); fig.Snapshot.Caption = '3-D shaded surface plot'; fig.Snapshot.Height = '5in'; add(rpt,fig); delete(gcf); rptview(rpt);
Добавьте две фигуры в отчет. Чтобы разместить их друг рядом с другом на странице, используйте Объект таблицы DOM.
import mlreportgen.report.* import mlreportgen.dom.* rpt = Report('peaks'); surf(peaks(20)); figure = Figure(); peaks20 = Image(getSnapshotImage(figure,rpt)); peaks20.Width = '3in'; peaks20.Height = []; delete(gcf); surf(peaks(40)); figure = Figure(); peaks40 = Image(getSnapshotImage(figure,rpt)); peaks40.Width = '3in'; peaks40.Height = []; delete(gcf); t = Table({peaks20,peaks40;'peaks(20)','peaks(40)'}); add(rpt,t); close(rpt); rptview(rpt);
Этот пример генерирует отчет PDF, который иллюстрирует различие между изменением размеров изображения снимка состояния фигуры с помощью print
команда и изменяющий размер использования генератора отчетов задана Snapshot
свойство Figure
генератор отчетов.
Создайте широкую фигуру MATLAB®. Создайте три mlreportgen.report.Figure
генераторы отчетов от фигуры и добавляют их в отчет.
Первый Figure
генератор отчетов не изменяет размер фигуры.
Второй Figure
генератор отчетов использует print
команда, чтобы изменить размер фигуры.
The
треть Figure
генератор отчетов использует Snapshot
генератор отчетов, чтобы изменить размер фигуры.
import mlreportgen.report.* fig = figure(); ax = axes(fig); plot(ax, rand(1,100)); pos = fig.Position; fig.Position = [pos(1) pos(2) 2*pos(3) pos(4)]; rpt = Report('example','pdf'); add(rpt, "Intrinsic figure size"); figReporter0 = Figure(fig); figReporter0.Scaling = 'none'; add(rpt,figReporter0); add(rpt, "Resized by print command"); figReporter1 = Figure(fig); add(rpt,figReporter1); add(rpt, "Resized by snapshot reporter"); figReporter2 = Figure(fig); figReporter2.Scaling = 'none'; figReporter2.Snapshot.ScaleToFit = true; add(rpt,figReporter2);
close(rpt); delete(fig) rptview(rpt);
Вот фигуры в сгенерированном отчете:
SnapshotFormat
'svg'
для всех типов отчетаПоведение изменяется в R2019b
Начиная в R2019b, изображения Масштабируемой векторной графики (SVG) поддерживаются для отчетов Word. Для всех типов отчета (HTML, PDF и Word), значение по умолчанию SnapshotFormat
свойством является 'svg'
и значение 'auto'
указывает на 'svg'
. В предыдущих релизах, значении по умолчанию SnapshotFormat
свойством был 'auto'
, который указал на 'svg'
для HTML и отчетов PDF и 'emf'
или 'png'
поскольку Word сообщает, в зависимости от платформы.
Отчеты Word, которые содержат изображения SVG, требуют Word 2016 или более поздней версии. В MATLAB R2019b или более позднем релизе, чтобы сгенерировать отчет с изображениями, которые совместимы с более ранними версиями Word, устанавливает SnapshotFormat
свойство к значению кроме 'svg'
. Чтобы задать формат изображения, используемый по умолчанию в более ранних релизах MATLAB, установите SnapshotFormat
к:
'emf'
для платформы Windows
'png'
для UNIX® или платформы Mac
gca
| mlreportgen.dom.Table
| mlreportgen.report.FormalImage
| mlreportgen.report.Report
| mlreportgen.report.Reporter
У вас есть модифицированная версия этого примера. Вы хотите открыть этот пример со своими редактированиями?
1. Если смысл перевода понятен, то лучше оставьте как есть и не придирайтесь к словам, синонимам и тому подобному. О вкусах не спорим.
2. Не дополняйте перевод комментариями “от себя”. В исправлении не должно появляться дополнительных смыслов и комментариев, отсутствующих в оригинале. Такие правки не получится интегрировать в алгоритме автоматического перевода.
3. Сохраняйте структуру оригинального текста - например, не разбивайте одно предложение на два.
4. Не имеет смысла однотипное исправление перевода какого-то термина во всех предложениях. Исправляйте только в одном месте. Когда Вашу правку одобрят, это исправление будет алгоритмически распространено и на другие части документации.
5. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.