Пакет: mlreportgen.report
Суперклассы: mlreportgen.report.Reporter
Репортер фигуры
Создайте репортер рисунка с заголовком, рисунком и подписью.
The 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 класс reporter. Репортер использует gcf для получения текущей фигуры MATLAB. Он использует формального репортера изображений, чтобы вставить рисунок в отчет. Чтобы задать размер моментального снимка или подписи, используйте свойства FormalImage объект.
Примечание
Репортер рисунка инициализирует Snapshot свойство. Не сбрасывайте это свойство.
Source - Источник фигурыИсточник фигуры, заданный как:
Вектор символов или строковый скаляр, который указывает путь к допустимому файлу рисунка
Допустимый указатель на графику
SnapshotFormat - Формат изображения снимка'svg' (по умолчанию) |...Формат изображения снимка, заданный как вектор символов или строковый скаляр. Поддерживаемые форматы:
'bmp' - Растровое изображение.
'gif' - Формат графического обмена.
'jpg' - изображение JPEG.
'png' - Изображение PNG.
'emf' - Расширенный метафайл, поддерживаемый только в DOCX выходных данных в Windows® платформы.
'svg' - Масштабируемая векторная графика.
'tif' - Тег Image File формат, не поддерживается в HTML выходных данных.
'pdf' - PDF-изображение (поддерживается только в формате PDF).
Scaling - Опции масштабирования для изображения моментального снимка рисунка'auto' (по умолчанию) | 'custom' | 'ни один'Опции масштабирования для изображения моментального снимка рисунка, заданные как вектор символов или строковый скаляр. Scaling управляет размером рисунка изображения снимка в файле изображения. Поддерживаемые опции масштабирования:
'auto' - Для выхода PDF или Word (DOCX) масштабирует изображение снимка рисунка так, чтобы оно совпадало с текущим макетом страницы, сохраняя при этом соотношение сторон. Во-первых, изображение снимка рисунка масштабируется до ширины страницы. Если высота изображения превышает высоту страницы, изображение снова масштабируется. Это дополнительное масштабирование гарантирует, что изображение подходит для текущей страницы с дополнительным интервалом в один дюйм. Масштабирование не применяется к выходным данным HTML.
'custom' - Масштабирует изображение моментального снимка рисунка на основе значений Height и Width свойства.
Когда вы задаете Scaling на custom и иметь большие значения для Height и Width свойства, а java.lang.OutOfMemoryError может происходить во время генерации PDF. Чтобы избежать этой ошибки и убедиться, что рисунок помещается на странице, используйте меньшие Height и Width значения.
'none' - Калибровка не выполняется
Примечание
The 'auto' и 'custom' опции используют MATLAB print команда для изменения размера рисунка. Если рисунок слишком велика для четкого расположения в заданном пространстве, print команда обрабатывает изображение моментального снимка. Чтобы избежать обрезки, можно задать 'none' как значение Scaling опция и использовать репортер, заданный Snapshot свойство для размера изображения рисунка. Этот репортер уменьшает размер текста с остальной частью изображения, и пользователю, возможно, потребуется увеличить изображение в средстве просмотра, чтобы различить мелкие детали. См. раздел Изменение размера изображения снимка фигуры.
Height - Высота снимка изображенияВысота изображения снимка, заданная как вектор символов или строковый скаляр, который состоит из числа, за которым следует сокращение для единицы измерения. Для примера '2in' задает два дюйма. Допустимые сокращения:
px - пиксели (по умолчанию)
cm - сантиметров
in - дюймы
mm - миллиметры
pc - picas
pt - точки
Пример: '2in'
Width - Ширина изображения моментального снимкаШирина изображения моментального снимка, заданная как вектор символов или строковый скаляр, который состоит из числа, за которым следует сокращение для единицы измерения. Для примера '2in' задает два дюйма. Допустимые сокращения:
px - пиксели (по умолчанию)
cm - сантиметров
in - дюймы
mm - миллиметры
pc - picas
pt - точки
Пример: '3in'
PreserveBackgroundColor - Сохраните цвет фона рисункаСохраните цвет фона рисунка в моментальном снимке, заданный как true или false. Если PreserveBackgroundColor является trueцвет фона снимка совпадает с цветом фона рисунка. Если PreserveBackgroundColor является falseцвет фона снимка белый.
TemplateSrc - Источник шаблона для этого репортера[] (по умолчанию) | вектор символов | строковый скаляр | репортер или отчет | документе DOM или части документаИсточник шаблона для этого репортера, заданный одним из следующих способов:
Вектор символов или строковый скаляр, который задает путь к файлу, содержащему шаблон для этого репортера
Репортер или отчет, шаблон которого используется для этого репортера или библиотека шаблонов которого содержит шаблон для этого репортера
DOM-документ или деталь документа, шаблон которой используется для этого репортера или библиотека шаблонов которой содержит шаблон для этого репортера
Указанный шаблон должен совпадать с типом отчета, к которому добавлен этот репортер. Для примера, для Microsoft® Отчет о словах, TemplateSrc должен быть шаблоном репортера Word. Если на TemplateSrc свойство пусто, этот репортер использует шаблон репортера по умолчанию для типа выхода отчета.
TemplateName - Имя шаблона для этого репортераИмя шаблона для этого репортера, заданное как вектор символов или строковый скаляр. Шаблон для этого репортера должен быть в библиотеке шаблонов источника шаблона (TemplateSrc) для этого репортера.
LinkTarget - Цель гиперссылки для этого репортера[] (по умолчанию) | вектор символов | строковый скаляр | mlreportgen.dom.LinkTarget объектЦель гиперссылки для этого репортера, заданная как вектор символов или строковый скаляр, задающий идентификатор цели ссылки или mlreportgen.dom.LinkTarget объект. Вектор символов или строковое скалярное значение преобразуется в LinkTarget объект. Цель ссылки непосредственно предшествует содержимому этого репортера в выход отчете.
getSnapshotImage | Путь к изображению моментального снимка |
mlreportgen.report.Figure.getClassFolder | Расположение файла определения класса фигуры |
mlreportgen.report.Figure.createTemplate | Создайте шаблон рисунка |
mlreportgen.report.Figure.customizeReporter | Создайте пользовательский класс figure reporter |
copy | Создайте копию объекта reporter и сделайте глубокие копии определенных значений свойств |
getImpl | Получите реализацию reporter |
Добавьте фигуру объемной поверхностной диаграммы в отчет и установите заголовок и высоту рисунка.
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 Table.
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 reporter не изменяет размер рисунка.
Вторая Figure reporter использует print команда для изменения размера рисунка.
The третий Figure reporter использует Snapshot reporter, чтобы изменить размер рисунка.
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. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.