reportgen
本文将介绍Matlab的一个实用技巧。一键生成Word版本的报告。Matlab之前都是通过调用COM接口来实现的,类似于VBA,虽然可做的事情很多,但并不适合一般的童鞋。
- 自动化报告
测试平台: MATLAB 2015b
先来看一个最简单的例子(demo1.m)
% demo1.m
import mlreportgen.dom.;
d = Document(‘demo1’,‘docx’);
open(d);
append(d,‘hello world!’);
close(d);
rptview(d.OutputPath);
import mlreportgen.dom.;
第一行是将所需要的类和函数导入工作空间。这里我们最常用的类就是Document.
d = Document(‘test’,‘docx’);
open(d);
在第二、三行中我们新建一个文档,其中文件类型docx可以替换成html或者pdf. Document类的相关属性可以通过命令查看 (doc mlreportgen.dom.Document)
append(d,‘hello world!’);
在第四行我们给文档添加了一句经典的话,我们还可以自定义它们的样式。比如加粗、斜体、改成蓝色、字体大小等等。
% 替换上面的一行代码
p=Text(‘hello world’);
p.Style={Bold(true),FontSize(‘16pt’),Color(‘blue’)};
p.Strike=‘double’;
append(d,p)
这里出现了第一个文档类:Text,即文本。Matlab提供了很多可调节的属性,如下表。修改起来也很方便,如要把文本改为斜体,则添加:p.Italic=1;即可。
Text的属性 取值 备注
Bold true/false 加粗
Color str(‘red’、'blue’等) 颜色
Italic true/false 斜体
BackgroundColor str 背景色
Underline str(‘single’、'dotdash’等) 下划线
FontFamilyName str 字体
FontSize str(‘12pt’) 字体大小
Strike str 删除线
StyleName str 模板中的样式名
接下来我们将生成一个更复杂的文档。首先想想一个word文档一班都有哪些元素。MATLAB提供了很多(下面的表格仅列出了部分)。本文主要介绍其中的五个:页面设置、标题、段落、表格、图片。
属性 含义
CustomAttribute Custom element attribute
CustomElement Custom element of a document
CustomText Plain text to be appended to a custom element
DOCXPageFooter Page footer for a Word document.
DOCXPageHdrFtr Page Base class for page header and footer
DOCXPageHeader Page header for a Word document.
DOCXPageMargins Margins of pages in a Word page layout
DOCXPageSize Size, orientation of pages in a Word layout
DOCXSection Page layout section of a Word document
Document Create a dom document
ExternalLink Create a hyperlink to an external target
Form Defines a form
FormalTable Create a formal table
Group Group of document objects
Heading Create a heading paragraph.
HorizontalRule Create a horizontal rule.
Image Create an image to be included in a report.
ImageArea Defines an image area as a hyperlink
InternalLink Create a hyperlink to a target in this
LinkTarget Create a target for a hyperlink.
ListItem Item in a list
Node Defines a document node
Object Defines a document object
OrderedList Ordered (numbered) list
Paragraph Create a formatted block of text, i.e., a paragraph.
Table Create a table.
TableColSpecGroup Defines style of a group of table columns
TableEntry Create a table Entry
TableRow Creates a table row
Template Create a template for a document
Text Create a text object
接下来我们做一个完整的模板。首先新建空白文档。
% demo2.m
import mlreportgen.dom.*;
d=Document(‘demo2’,‘docx’);
open(d);
1.1 页面
页面设置包括页面大小('A4’等)、页面方向、页边距.
% 页面设置
s = d.CurrentDOCXSection;
s.PageSize.Orientation =‘landscape’; % portrait(default)
s.PageSize.Height = ‘8.5in’;
s.PageSize.Width = ‘11in’;
s.PageMargins.Left = ‘3.0cm’;
s.PageMargins.Right = ‘3.0cm’;
s.PageMargins.Top = ‘2.5cm’;
s.PageMargins.Bottom = ‘2.5cm’;
% 中文字体样式设置
heiti=FontFamily;
heiti.FamilyName=‘Arial’;
heiti.EastAsiaFamilyName=‘黑体’;
songti=FontFamily;
songti.FamilyName=‘Arial’;
songti.EastAsiaFamilyName=‘宋体’;
1.2 标题
标题的初始格式由模板中自带的标题样式决定,当然也可以自己修改。
%% 标题
p=Heading(1,‘Matlab 自动化报告模板’);% 一级标题
%p.Color=‘red’;
%p.HAlign=‘center’;
p.Style={heiti,Color(‘red’),HAlign(‘center’)};
append(d,p);
1.3 段落
与文本不同,段落除下文本的属性外,还有边距、对齐、首行缩进、行间距、段前、段后等属性需要调节。在下面的代码框中,FirstLineIndent代表首行缩进的宽度,LineSpacing代表行间距,OuterMargin代表边距。在这里我们还引入了一个新的类:ExternalLink(外部链接),当然Matlab也提供文档内部链接:InternalLink.
%% 段落
append(d,Heading(2,‘一、段落模板’));
s=‘这里是段落。’;
s=repmat(s,[1,12]);
p = Paragraph(s);
% 中文字体样式自定义
p.Style={songti,Color(‘blue’),…
LineSpacing(1.5),…
OuterMargin(‘10pt’,‘0pt’,‘0pt’,‘10pt’)};
p1=Text(‘下划线。’);%同段落差不多.
p1.Underline=‘single’;
p1.Color=‘red’;
append(p,p1);
append(p,s);
p2=ExternalLink(‘http://github.com/gasongjian/’, ‘超链接’);
append(p,p2);
p.FontSize=‘14pt’;
p.FirstLineIndent=‘28pt’;%这里差不多就是2个字符大小
append(d,p);
完整资料领取请加QQ群免费下载: