Matlab Generate Report

import mlreportgen.dom.*

doc = Document("ReportName","html-multipage");
open(doc);

% First page — always becomes root.html (the entry point)
homePage = HTMLPage();
append(homePage,Heading(1,"Report Title"));
append(homePage,Paragraph("Welcome to the report."));
append(doc,homePage);

% Subsequent pages — set FileName explicitly
dataPage = HTMLPage("data.html");
append(dataPage,Heading(1,"Data Analysis"));
append(dataPage,Paragraph("Analysis content here."));
append(doc,dataPage);

close(doc);

import mlreportgen.dom.*

doc = Document("MultipageWithTOC","html-multipage");
open(doc);

% TOC page (first page = root.html)
tocPage = HTMLPage();
append(tocPage,Heading(1,"Contents"));
append(tocPage,Paragraph(ExternalLink("chapter1.html","Chapter 1: Introduction")));
append(tocPage,Paragraph(ExternalLink("chapter2.html","Chapter 2: Methods")));
append(tocPage,Paragraph(ExternalLink("chapter3.html","Chapter 3: Results")));
append(doc,tocPage);

% Content pages
chapters = {"Introduction","Methods","Results"};
for i = 1:3
    pg = HTMLPage(sprintf("chapter%d.html",i));
    append(pg,Heading(1,sprintf("Chapter %d: %s",i,chapters{i})));
    append(pg,Paragraph(sprintf("Content for %s.",chapters{i})));
    append(doc,pg);
end

close(doc);

pg = HTMLPage();                          % Default (first = root.html)
pg = HTMLPage("results.html");            % Explicit filename
pg = HTMLPage("results.html",tplPath);   % Custom template
pg = HTMLPage("results.html",domObj);    % Initialize with DOM content

p = Paragraph();
append(p,Text("Page "));
append(p,Page());
append(p,Text(" of "));
append(p,NumPages());

import mlreportgen.report.*
import mlreportgen.dom.*

rpt = Report("HTMLReport","pdf");
ch = Chapter("Dashboard");

% From a file
htmlContent = HTMLFile("dashboard.html");
append(ch,htmlContent);

% From a string
htmlStr = HTML("<p style="color:blue;">Inline HTML content</p>");
append(ch,htmlStr);

append(rpt,ch);
close(rpt);

import mlreportgen.dom.*

% Two-column layout: 60% narrative (left), 40% KPI sidebar (right)
leftContent = Paragraph("Main narrative content goes here.");
rightContent = Paragraph("Sidebar: key metrics, charts, KPIs.");

layoutTable = Table({leftContent,rightContent});
layoutTable.Style = [layoutTable.Style,{Width("100%"),Border("none")}];
layoutTable.TableEntriesStyle = {VAlign("top"),InnerMargin("6pt","6pt","4pt","4pt")};

% Set column widths
grp = TableColSpecGroup();
cs1 = TableColSpec();
cs1.Style = {Width("60%")};
cs2 = TableColSpec();
cs2.Style = {Width("40%")};
grp.ColSpecs = [cs1,cs2];
layoutTable.ColSpecGroups = grp;

append(ch,layoutTable);

import mlreportgen.report.*
import mlreportgen.dom.*

rpt = Report("TableWithImages","pdf");
ch = Chapter("Component Gallery");

% Create table from cell array — one row with image cell + description cell
img = Image("component_a.png");
img.Width = "2in";
img.Height = "1.5in";

desc = Paragraph("High-performance variant with thermal protection.");
desc.Style = {FontSize("9pt")};

t = Table({img,desc});

% Use entry(row,col) to style individual cells
e = entry(t,1,1);
e.Style = {VAlign("middle")};

e2 = entry(t,1,2);
e2.Style = {VAlign("middle"),InnerMargin("6pt")};

append(ch,t);
append(rpt,ch);
close(rpt);

% Nested cell array: {img,caption} become one cell,desc is another cell
img = Image("component_a.png");
img.Width = "2in";
caption = Paragraph("Component A");
caption.Style = {Bold(true),FontSize("10pt")};

desc = Paragraph("High-performance variant with thermal protection.");

t = Table({{img,caption},desc});
% Result: row 1 has two cells — cell 1 contains image + caption,cell 2 contains desc

import mlreportgen.dom.*

header = {"Element","Atomic Number","Mass (g/mol)"};
body = {"Hydrogen","1","1.008"; "Helium","2","4.003"; "Carbon","6","12.011"};
ft = FormalTable(header,body);

% Style the entire table
ft.Border = "solid";
ft.ColSep = "solid";
ft.RowSep = "solid";
ft.TableEntriesStyle = {HAlign("center"),InnerMargin("4pt")};

% Style the header
ft.Header.Style = {BackgroundColor("#003366"),Color("white"),Bold(true)};

% Style the footer
ft.Footer.Style = [ft.Footer.Style,{BackgroundColor("#e0e0e0"),Bold(true)}];

% Alternating row colors (zebra striping)
for r = 1:numel(ft.Body.Children)
    if mod(r,2) == 0
        ft.Body.Children(r).Style = [ft.Body.Children(r).Style,{BackgroundColor("#f0f4f4")}];
    end
end

import mlreportgen.dom.*

ft = FormalTable(header,body);
ft.Width = "6.5in";  % absolute width for PDF (letter page minus 1in margins)
ft.Style = [ft.Style {ResizeToFitContents(false)}];

% Define column widths (percentages or absolute: "1.5in", "3cm")
colWidths = ["25%","15%","15%","20%","10%","15%"];
colSpecs = TableColSpec.empty();
for i = 1:numel(colWidths)
    cs = TableColSpec();
    cs.Style = {Width(colWidths(i))};
    colSpecs(end+1) = cs;
end
grp = TableColSpecGroup();
grp.ColSpecs = colSpecs;
ft.ColSpecGroups = grp;

ft.TableEntriesStyle = {HAlign("left"),InnerMargin("8pt","8pt","3pt","3pt")};

ft.TableEntriesInnerMargin = "6pt";  % Uniform — single string value only

import mlreportgen.dom.*

n = Number(pi);
n.Style = [n.Style {NumberFormat("%.4f")}];  % Renders as "3.1416"

% Integer — use %.0f,NOT %d
n2 = Number(42);
n2.Style = [n2.Style {NumberFormat("%.0f")}];  % Renders as "42"

import mlreportgen.dom.*

n = Number(42);
n.Style = [n.Style {NumberFormat("%.0f")}];

t = FormalTable({"Count","Status"},{n,"PASS"});

import mlreportgen.dom.*

% Currency: "$42"
n = Number(42);
n.Style = [n.Style {NumberFormat("%.0f")}];
p = Paragraph("$");
append(p,n);

% With suffix: "$42M"
n2 = Number(42);
n2.Style = [n2.Style {NumberFormat("%.0f")}];
p2 = Paragraph("$");
append(p2,n2);
append(p2,"M");

% Percentage: "12.5%"
n3 = Number(12.5);
n3.Style = [n3.Style {NumberFormat("%.1f")}];
p3 = Paragraph(n3);
append(p3,"%");

n = Number(pi);
n.Style = [n.Style {NumberFormat("%.4f")}];

p = Paragraph(n);
append(p," Ohms");

t = FormalTable({"Value","Pass"},{p,"yes"});

% Apply to all body entries
for r = 1:numel(ft.Body.Children)
    row = ft.Body.Children(r);
    for c = 1:numel(row.Children)
        entryNode = row.Children(c);
        for k = 1:numel(entryNode.Children)
            child = entryNode.Children(k);
            if isa(child,"mlreportgen.dom.Paragraph") || isa(child,"mlreportgen.dom.Text")
                child.Style = [child.Style,{OuterMargin("0pt","0pt","0pt","0pt")}];
            end
        end
    end
end

ch = mlreportgen.report.Chapter("Title","Wide Content");
ch.Layout.Landscape = true;  % Entire chapter is landscape

ch = mlreportgen.report.Chapter("Title","Mixed Orientation");
ch.Layout.Landscape = true;  % First page(s): landscape

% ... append landscape content ...

% Switch to portrait mid-chapter
pl = mlreportgen.dom.PDFPageLayout;  % default = portrait (8.5x11)
append(ch,pl);

% ... append portrait content ...

% Switch back to landscape
pl2 = mlreportgen.dom.PDFPageLayout;
rotate(pl2);  % now landscape (11x8.5)
append(ch,pl2);

% ... append landscape content ...

% Determine orientation from content aspect ratio
if contentWidth >= contentHeight
    pl = mlreportgen.dom.PDFPageLayout;
    rotate(pl);  % landscape
else
    pl = mlreportgen.dom.PDFPageLayout;  % portrait (default)
end
append(ch,pl);

import mlreportgen.report.*
import mlreportgen.dom.*

% Create a temporary report+chapter to extract the template layout
tempRpt = Report(fullfile(tempdir,"tmp_layout"),"pdf");
tempCh = Chapter("Title","tmp");
open(tempRpt);
docPart = getImpl(tempCh,tempRpt);
chLayout = docPart.Children(1);  % PDFPageLayout with headers/footers from template
close(tempRpt);

pl = clone(chLayout);

% Set orientation
if needsLandscape
    rotate(pl);
end

% Fix 1: Continue page numbering (don't reset to 1)
pl.FirstPageNumber = '';

% Fix 2: Remove first-page header (it's empty — hides StyleRef)
% This forces the page to use the "default" header which has StyleRef
firstIdx = strcmp({pl.PageHeaders.PageType},"first");
pl.PageHeaders = pl.PageHeaders(~firstIdx);

append(ch,pl);

% Build the chapter title string (must match what the template renders)
chapterTitle = "Chapter 1. " + modelName;  % adjust numbering as needed

% Create fo:marker that the header can find
marker = CustomElement("fo:marker");
marker.CustomAttributes = CustomAttribute("marker-class-name","SectionTitle1");
append(marker,Text(chapterTitle));

% Wrap in a near-invisible paragraph (present in flow but not visible)
% NOTE: Paragraph() constructor does not accept CustomElement — create then append
anchor = Paragraph();
anchor.Style = {FontSize("1pt"),OuterMargin("0pt","0pt","0pt","0pt"),...
    LineSpacing(0.01),Color("white")};
append(anchor,marker);
append(ch,anchor);

import mlreportgen.report.*
import mlreportgen.dom.*

rpt = Report(outputPath,"pdf");
ch = Chapter("Title",chapterName);

% Extract chapter template layout
tempRpt = Report(fullfile(tempdir,"tmp_layout"),"pdf");
tempCh = Chapter("Title","tmp");
open(tempRpt);
docPart = getImpl(tempCh,tempRpt);
chLayout = docPart.Children(1);
close(tempRpt);

% First page uses Chapter.Layout (no PDFPageLayout needed)
ch.Layout.Landscape = (firstPageOrientation == "landscape");
% ... append first page content ...

% Each subsequent page
chapterTitle = "Chapter 1. " + chapterName;
for i = 1:numSections
    % Clone and configure layout
    pl = clone(chLayout);
    if sectionOrientations(i) == "landscape"
        rotate(pl);
    end
    pl.FirstPageNumber = '';
    pl.PageHeaders = pl.PageHeaders(~strcmp({pl.PageHeaders.PageType},"first"));
    append(ch,pl);

    % Re-inject chapter title marker for header StyleRef
    marker = CustomElement("fo:marker");
    marker.CustomAttributes = CustomAttribute("marker-class-name","SectionTitle1");
    append(marker,Text(chapterTitle));
    % NOTE: Paragraph() constructor does not accept CustomElement — create then append
    anchor = Paragraph();
    anchor.Style = {FontSize("1pt"),OuterMargin("0pt","0pt","0pt","0pt"),...
        LineSpacing(0.01),Color("white")};
    append(anchor,marker);
    append(ch,anchor);

    % ... append section content ...
end

append(rpt,ch);
close(rpt);

ch = mlreportgen.report.Chapter("Title","Wide Content");
ch.Layout.Landscape = true;  % Entire chapter is landscape

import mlreportgen.report.*
import mlreportgen.dom.*

ch = Chapter("Title","Mixed Orientation");
ch.Layout.Landscape = false;  % First page(s): portrait

% ... append portrait content ...

% Switch to landscape mid-chapter
pl = DOCXPageLayout();
pl.PageSize.Orientation = "landscape";
pl.PageSize.Height = "8.5in";
pl.PageSize.Width = "11in";
append(ch,pl);

% ... append landscape content ...

import mlreportgen.report.*
import mlreportgen.dom.*

ch = Chapter("Title",chapterName);
ch.Layout.Landscape = false;  % Start portrait for intro text

% Introduction section (uses chapter default — portrait)
introSec = Section("Title","Introduction");
append(introSec,Paragraph("Introductory content here."));
append(ch,introSec);

% Each diagram gets its own orientation
for i = 1:numDiagrams
    if diagramWidths(i) >= diagramHeights(i)
        pl = DOCXPageLayout();
        pl.PageSize.Orientation = "landscape";
        pl.PageSize.Height = "8.5in";
        pl.PageSize.Width = "11in";
    else
        pl = DOCXPageLayout();
        pl.PageSize.Orientation = "portrait";
        pl.PageSize.Height = "11in";
        pl.PageSize.Width = "8.5in";
    end
    append(ch,pl);

    sec = Section("Title",diagramNames(i));
    % ... append diagram content ...
    append(ch,sec);
end

append(rpt,ch);
close(rpt);
rptview(rpt);  % REQUIRED — updates fields (TOC, heading numbers)

import mlreportgen.dom.*

% Create a custom FO element
elem = CustomElement("fo:leader");
elem.CustomAttributes = [
    CustomAttribute("leader-pattern","rule")
    CustomAttribute("rule-thickness","0.5pt")
    CustomAttribute("leader-length","100%")
];

import mlreportgen.dom.*

% 1. Create a copy of the default Figure template
srcPath = fullfile(tempdir,"figure_src.pdftx");
mlreportgen.report.Figure.createTemplate(srcPath,"pdf");

% 2. Open with Template API (3-arg form copies source to output)
centeredTemplatePath = fullfile(tempdir,"centered_figure.pdftx");
tpl = Template(centeredTemplatePath,"pdf",srcPath);
open(tpl);

% 3. Modify FigureImage style — append text-align: center to CSS
ss = tpl.Stylesheet;
figStyle = getStyle(ss,"FigureImage");
figStyle.RawFormats = strtrim(figStyle.RawFormats) + " text-align: center;";
replaceStyle(ss,figStyle);

close(tpl);

% 4. Use the custom template on each Figure reporter
fig = mlreportgen.report.Figure();
fig.TemplateSrc = centeredTemplatePath;
append(ch,fig);

import mlreportgen.dom.*

% 1. Create a copy of the default Figure template for Word
srcPath = fullfile(tempdir,"figure_src.dotx");
mlreportgen.report.Figure.createTemplate(srcPath,"docx");

% 2. Open with Template API (3-arg form copies source to output)
centeredTemplatePath = fullfile(tempdir,"centered_figure.dotx");
tpl = Template(centeredTemplatePath,"docx",srcPath);
open(tpl);

% 3. Modify FigureImage style — add center alignment
ss = tpl.Stylesheet;
figStyle = getStyle(ss,"FigureImage");
figStyle.Formats = [figStyle.Formats,HAlign("center")];
replaceStyle(ss,figStyle);

close(tpl);

% 4. Use the custom template on each Figure reporter
fig = mlreportgen.report.Figure();
fig.TemplateSrc = centeredTemplatePath;
append(ch,fig);

p = Paragraph("Important note");
p.Style = [p.Style,{Bold(true),FontSize("12pt"),Color("red")}];

t = Text("highlighted");
t.Style = [t.Style,{BackgroundColor("yellow"),Italic(true)}];

append(grp,HorizontalRule());

grp = Group();
append(grp,Paragraph("First paragraph"));
append(grp,HorizontalRule());
append(grp,Paragraph("Second paragraph"));