rptview

Display report or presentation

Syntax

rptview(domObj)

rptview(reportPath)

rptview(reportName,format)

rptview(docxfile,'pdf')

rptview(pptObj)

rptview(pptPath)

Description

rptview(domObj) displays the report specified by the input mlreportgen.dom.Document object in an appropriate viewer.

To open a Word document on a Linux^® or Macintosh platform, rptview calls the soffice command. On Linux, Apache OpenOffice™ or LibreOffice^® must be installed. On Macintosh, Apache OpenOffice must be installed in the /Applications folder.

Note

The mlreportgen.report.Report class has a method named rptview. When you call rptview with an mlreportgen.report.Report object as the argument value, the method is invoked. For all other types of argument values, the rptview function is invoked. See Tips.

rptview(reportPath) displays the report specified by reportPath in an appropriate viewer, based on the file extension.

rptview(reportName,format) displays the report specified by reportName in an appropriate viewer, based on the format specified in format.

rptview(docxfile,'pdf') converts a Microsoft^® Word report to PDF and displays the report in a PDF viewer.

rptview(pptObj) displays the presentation specified by the input mlreportgen.ppt.Presentation object in Microsoft PowerPoint^®.

To open a presentation on a Linux or Macintosh platform, rptview calls the soffice command. On Linux, Apache OpenOffice or LibreOffice must be installed. On Macintosh, Apache OpenOffice must be installed in the /Applications folder.

rptview(pptPath) displays the presentation located at pptPath in Microsoft PowerPoint.

Examples

Display DOM Document in HTML Viewer

Display an HTML report that was generated using an mlreportgen.dom.Document object.

import mlreportgen.dom.*;
d = Document('mydoc');

p = Paragraph('Hello World');
append(d,p);

close(d);
rptview('mydoc');

Display DOM Document in PDF Viewer

Display a PDF report that was generated using an mlreportgen.dom.Document object.

import mlreportgen.dom.*;
d = Document('mydoc','pdf');

append(d, 'Hello World');

close(d);
rptview(d);

Display Report Using the OutputPath Property

Display a report that was generated using an mlreportgen.report.Report object. Specify the path and file name of the report by using the value of the OutputPath property of the object.

import mlreportgen.dom.*;
import mlreportgen.report.*;
rpt = Report('myReport','docx');

p = Paragraph('Hello World');
add(rpt,p);
close(rpt);
rptview(rpt.OutputPath);

Convert Word Report to PDF and Display It

Use the rptview function to convert a Word report to PDF and display it in a PDF viewer.

import mlreportgen.dom.*;
import mlreportgen.report.*;
rpt = Report('myReport','docx');

p = Paragraph('Hello World');
add(rpt,p);

close(rpt);
rptview('myReport.docx','pdf');

Display Word Report Based on Name

Create two reports with the same name, but with different formats and content. Specify the format to display the appropriate report.

import mlreportgen.dom.*;
import mlreportgen.report.*
rpt = Report("myReport","html");

p = Paragraph("Hello World");
add(rpt,p);
close(rpt);

rptWord = Report("myReport","docx");
p = Paragraph("Hello again, World");
add(rptWord,p);
close(rptWord);

rptview("myReport","docx");

Display Presentation Based on Presentation Object

Display a presentation by calling rptview with the name of the mlreportgen.ppt.Presentation object.

import mlreportgen.ppt.*
ppt = Presentation("MyPresentation");
open(ppt);

slide1 = add(ppt,"Title and Table");
replace(slide1,"Title","Magic Square Slide 1");
replace(slide1,"Table",Table(magic(3)));
close(ppt);
rptview(ppt);

Display Presentation Based on Path and File Name

Display a presentation by calling rptview with the path and file name, including the extension, of the generated PowerPoint presentation.

import mlreportgen.ppt.*
ppt = Presentation("MyPresentation");
open(ppt);

slide1 = add(ppt,"Title and Table");
replace(slide1,"Title","Magic Square Slide 1");
replace(slide1,"Table",Table(magic(3)));
close(ppt);
rptview("MyPresentation.pptx");

Input Arguments

domObj — Document object that generates report to view

mlreportgen.dom.Document object

Document object that generates the report to view, specified as an mlreportgen.dom.Document object.

reportPath — Report file path and name

string scalar | character vector

Path and name of a specific report file, including the file extension, specified as a string scalar or character vector. You can use the OutputPath property of an mlreportgen.dom.Document object or an mlreportgen.report.Report object to provide reportPath.

The report file name extension determines the viewer in which the report displays.

File Extension	Viewer
.htmx	MATLAB® web browser
.html	MATLAB web browser
.zip	MATLAB web browser
.docx	Microsoft Word
.pdf	PDF viewer

reportName — Report name

string scalar | character vector

Path and file name of a report, without the file extension, specified as a string scalar or character vector.

format — Report output format

'html' | 'html-file' | 'docx' | 'pdf'

Report output format, specified as one of these values:

• 'html'

• 'html-file'

• 'docx'

• 'pdf'

docxfile — Word .docx file to convert to PDF

string scalar | character vector

Word .docx file to convert to PDF, specified as a Word file having a .docx extension.

pptObj — Presentation object that generates the presentation

mlreportgen.ppt.Presentation

Presentation object that generates the presentation to view, specified as an mlreportgen.ppt.Presentation object.

pptPath — Presentation file path and name

string scalar | character vector

Path and name of a specific presentation file, including the file extension, specified as a string scalar or character vector. The file extension can be .pptx or .potx. You can use the OutputPath property of the mlreportgen.ppt.Presentation object to provide pptPath.

Tips

Calling rptview with an mlreportgen.report.Report object as the argument value, invokes the rptview method of the mlreportgen.report.Report object. The rptview method calls the rptview function with the value of the Document property of the report object as the argument value.

Calling rptview with an argument value other than an mlreportgen.report.Report object invokes the rptview function.

For example, in the following code, the first rptview call invokes the rptview method. The second rptview call invokes the rptview function.

import mlreportgen.report.*
rpt = Report('myReport','pdf');
add(rpt, 'Hello World');
close(rpt);
% Invokes rptview method
rptview(rpt);
% Invokes rptview function  
rptview('myReport.pdf');