mlreportgen.report.Sparkline 类
命名空间: mlreportgen.report
超类: mlreportgen.report.Reporter
描述
使用 mlreportgen.report.Sparkline 创建一个迷你图报告器。
mlreportgen.report.Sparkline 类是一个 handle 类。
创建对象
描述
reporter = mlreportgen.report.SparklineSparkline 报告器对象。使用报告器属性来指定迷你图的数据、迷你图的外观、要包含的迷你图相关信息以及报告选项。向报告中添加空的 Sparkline 报告器会产生错误。
reporter = mlreportgen.report.Sparkline(PropertyName=Value)
输入参量
属性
方法
示例
本示例演示了如何在报告表中添加迷你图。
导入报告和 DOM API 命名空间，以避免使用冗长的完全限定名称。
import mlreportgen.report.* import mlreportgen.dom.*
根据公司名称列表、销售数据以及月份名称，创建一张包含列表中四家公司 1 月至 6 月销售数据的表。销售数据矩阵的行对应于公司，列对应于月份。
companyNames = ["Apple", "Amazon", "Microsoft", "Google"]; salesData = [ 38, 56, 50, 2, 45, 65; % Data for Apple 43, 78, 53, 72, 48, 75; % Data for Amazon 50, 60, 55, 65, 52, 70; % Data for Microsoft 55, 70, 60, 75, 57, 80]; % Data for Google months = ["Jan", "Feb", "Mar", "Apr", "May", "Jun"];
"companyNames" 数组是第一列，后面各列分别对应每个月的销售数据。最后一列 "Trends" 为空。在本示例中，您将使用每家公司的迷你图来填充此列。
tbl = table(companyNames', ... salesData(:, 1), salesData(:, 2), salesData(:, 3), ... salesData(:, 4), salesData(:, 5), salesData(:, 6), ... char.empty(4, 0), ... 'VariableNames', ['CompanyName', months, "Trends"]);
创建一个标题为 "StockMarketReport" 的新报告，并将输出格式指定为 PDF。
rpt = Report("StockMarketReport","pdf");
根据表 tbl 创建一个 MATLABTable 报告器。
mlTable = MATLABTable(tbl);
遍历表中的每一行，并执行以下操作，根据各公司的销售数据添加迷你图。
为当前行创建一个新的表条目。
为当前公司的销售数据创建一个迷你图。
获取迷你图的快照图像，以将其包含在报告中。
使用捕获的快照图像创建一个 DOM 图像对象。
将 DOM 图像追加到表条目（这会将迷你图添加到单元格中）。
将表条目添加到 MATLAB 表中对应的行。
for iRow = 1:mlTable.Body.NRows tEntry = TableEntry(); sparkline = Sparkline(salesData(iRow, :)); image = getSnapshotImage(sparkline, rpt); domImage = Image(image); append(tEntry, domImage); append(mlTable.Body.row(iRow),tEntry); end
将包含迷你图的表追加到报告。
append(rpt,mlTable);
关闭并查看报告。
close(rpt); rptview(rpt);
本示例演示了如何在报告中添加一个带有题注的自定义迷你图。
导入报告和 DOM API 命名空间，以避免使用冗长的完全限定名称。
import mlreportgen.dom.* import mlreportgen.report.*
创建报告。
rpt = Report("MonthlyTrends", "pdf");
创建一个表，其中包含四周内的每日访客数据以及每周的访客总数。
headerContent = {...
'Weeks', 'Day 1', 'Day 2', 'Day 3', 'Day 4', ...
'Day 5', 'Day 6', 'Day 7', 'Total Visitors'...
};
totalVisitors = [193, 213, 195, 152];
bodyContent = {...
'Week 1', 12, 18, 25, 30, 33, 35, 40, totalVisitors(1); ...
'Week 2', 19, 28, 30, 31, 31, 36, 38, totalVisitors(2); ...
'Week 3', 12, 26, 29, 26, 30, 31, 33, totalVisitors(3);
'Week 4', 21, 8, 19, 23, 21, 30, 30, totalVisitors(4)...
};指定表的格式。
tableStyle = {Width("80%"), ...
Border("solid"), ...
RowSep("solid"), ...
ColSep("solid")};根据指定的内容和格式创建正式表。
tbl = FormalTable(headerContent, bodyContent); tbl.Style = tableStyle;
指定标题行的格式。
headerStyle = {BackgroundColor("Orange"), ...
Bold(true)};
firstRow = tbl.Children(1);
firstRow.Style = headerStyle;将表条目的对齐方式设置为居中。
tbl.TableEntriesHAlign = "center";将表追加到报告。
append(rpt,tbl);
添加一段文字，对该迷你图进行说明。
append(rpt, LineBreak()); append(rpt,Paragraph(... "Sparkline illustrating the monthly trend of visitor attendance")); append(rpt, LineBreak());
创建、自定义并将迷你图追加到报告中。
sparkline = Sparkline(totalVisitors); sparkline.LineColor = "green"; sparkline.LineStyle = "dotted"; sparkline.LineWidth = "1.5pt"; sparkline.MarkerColor = "blue"; sparkline.MarkerStyle = "circle"; sparkline.MarkerPoints = "all"; sparkline.MarkerSize = "3pt"; sparkline.Snapshot.Height = "1in"; sparkline.Snapshot.Width = "5in"; sparkline.Snapshot.Caption = "Monthly trend of visitor attendance"; append(rpt,sparkline);
关闭并查看报告。
close(rpt); rptview(rpt);
版本历史记录
在 R2026a 中推出
