Code covered by the BSD License  

Highlights from
Panel

image thumbnail

Panel

by

 

21 May 2008 (Updated )

Like subplot, but easier, and WYSIWYG export to file. Also fixes dashed/dotted lines in export.

Editor's Notes:

This file was selected as MATLAB Central Pick of the Week

demopanelA.m
% Panel builds image files, not just on-screen figures.
%
% (a) Use demopanel1 to create a layout.
% (b) Export the result to file.
% (c) Export to different physical sizes.
% (d) Export at high quality.
% (e) Adjust margins.
% (f) Export using smoothing.
% (g) Export to EPS, rather than PNG.



%% (a)

% delegate
demopanel1

% see "help panel/export" for the full range of options.



%% (b)

% the default sizing model for export targets a piece of
% paper. the default paper model is A4, single column, with
% 20mm margins. the default aspect ratio is the golden ratio
% (landscape). therefore, if you provide only a filename,
% you get this...

% do a default export
p.export('export_b');

% the default export resolution is 150DPI, so the resulting
% file will look a bit scraggy, but it's a nice small file
% that is probably fine for laying out your document. note
% that we did not supply a file extension, so PNG format is
% assumed.



%% (c)

% one thing you might want to vary from figure to
% figure is the aspect ratio. the default (golden ratio) is
% a little short, here, so let's make it a touch taller.
p.export('export_c', '-a1.4');

% the other thing is the column layout. we've exported to a
% single column, above - let's target a single column of a
% two-column layout.
p.export('export_c_c2', '-a1.4', '-c2');

% ach... that's never going to work, it doesn't fit in one
% column does it. this figure will have to span two columns,
% so let's leave it how it was.

% NB: here, we have used the "paper sizing model". if you
% prefer, you can use the "direct sizing model" and just
% specify width and height directly. see "help
% panel/export".



%% (d)

% when you're done drafting your document, you can bring up
% the export resolution to get a nice looking figure. "-rp"
% means "publication resolution" (600DPI).
p.export('export_d', '-a1.4', '-rp');



%% (e)

% once exported at final resolution, i can't help
% noticing the margins are a little generous. let's pull
% them in as tight as we dare to reduce the whitespace.
p.de.margin = 1;
p(1,1).marginbottom = 9;
p(2).marginleft = 12;
p.margin = [10 8 0.5 0.5];
p.export('export_e', '-a1.4', '-rp');

% NB: when the margins are this tight and the output
% resolution this high, you may notice small differences in
% layout between the on-screen renderer, the PNG renderer,
% and the EPS renderer.



%% (f)

% that's now exported at 600DPI, which is fine for most
% purposes. however, the matlab renderer you are using may
% not do nice anti-aliasing like some renderers. one way to
% mitigate this is to export at a higher DPI, but that makes
% for a very large figure file. an alternative is to ask
% panel to render at a higher DPI but then to smooth back
% down to the specfied resolution. you'll have to wait a few
% seconds for the result, since rendering at these sizes
% takes time. here, we'll smooth by factor 2. since this
% takes a little while, i don't usually do this until i'm
% preparing a manuscript for submission. you can smooth by
% factor 4, but this takes even longer.
disp('rendering with smoothing, this may take some time...');
p.export('export_f', '-a1.4', '-rp/2');

% NB: this is brute force smoothing, and is not the same as
% anti-aliasing. nonetheless, i find the results can be
% useful.



%% (g)

% export by default is to PNG format - other formats are
% available (see "help panel/export" for a full list).
% usually, you can set the output format just by specifying
% the file extension of the output file, as follows.
p.export('export_g.pdf', '-a1.4', '-rp');

% NB: if you try to export to "svg" format, panel will use
% plot2svg() if it is present. if not, you can find it at
% file exchange (http://goo.gl/VzHIR at time of writing).



Contact us