![[download]](../icons/download.gif){kind=icon}
get panels.sas)| panels | Macro to display a set of plots in rectangular panels | panels |
get panels.sas)ORDER=DOWN) or bottom (ORDER=UP). If the number of rows and columns are unequal, the aspect ratio of
individual panels can be maintained by setting equate=Y. It is assumed that
all the plots have already been created, and stored in a graphics catalog
(the default, WORK.GSEG is used automatically by SAS/GRAPH procedures).
For interactive use within the SAS Session Manager you should be aware that all plots are stored cumulatively in the graphics catalog throughout your session, unless explicitly changed with the GOUT= option in graphics procedures or macros To create multiple panelled plots you can use the FIRST= and LAST= parameters or a REPLAY= list to specify which plots are used in a given call.
goptions hsize=7in vsize=5in;
%gdispla(OFF);
proc gplot data=mydata;
plot y * x = group;
by sex;
%gdispla(ON);
%panels(rows=1, cols=2);
ROWS= and COLS= arguments are required, and specify the
size of the array of plots to be displayed. These are the only
required arguments.
PLOTS= argument. Optionally, there can be an additional
plot, which is displayed (as a GSLIDE title, for example) in
the top nn% of the display, as specified by the TOP= argument.
TOPHEIGHT= argument.
TOPHEIGHT=100. If you want to use a graph
rescaled to fit entirely within the top panel (i.e., with
TOPHEIGHT=&TOP), that graph should be created with an aspect ratio
to match the shape of the desired top panel; otherwise it will be
deformed to fit.
ORDER= argument specifies the order of the panels in the
REPLAY= list, when REPLAY= is not specified.
Typically, the panels are displayed across the columns, starting
in the top row.
ORDER=UP means that the panels in the bottom row are
are drawn first, and numbered 1, 2, ..., &COLs. ORDER=DOWN means
that the panels in the top row are drawn first, numbered 1, 2, ...,
&COLs. If you add the keyword BYROWS to ORDER=, the panels are
displayed up or down the rows. For example, when ROWS=3, COLS=5,
ORDER=DOWN BYROWS generates the REPLAY= list as,
replay=1:1 2:4 3:7 4:10 5:13
6:2 7:5 8:8 9:11 10:14
11:3 12:6 13:9 14:12 15:15
EQUATE= argument determines if the size of the panels is adjusted
so that the aspect ratio of the plots is preserved. If EQUATE=Y,
the size of each plot is adjusted to the maximum of &ROWS and &COLS.
This is usually desired, as long as the graphic options HSIZE and
VSIZE are the same when the plots are replayed in the panels
template as when they were originally generated. The default is
EQUATE=Y.
REPLAY= argument specifies the list of plots to be replayed
in the constructed template, in one of the forms used with the
PROC GREPLAY REPLAY statement, for example, REPLAY=1:1 2:3 3:2
4:4 or REPLAY=1:plot1 2:plot3 3:plot2 4:plot4. If TOP= is used
for a top panel, that graph should be replayed in panel 0.
TEMPLATE=PANEL&ROWS.&COLS.
REPLAY= argument is constructed to replay plot
i in panel i. If the REPLAY= argument is not specified, you can
override this default assignment by specifying FIRST= the sequential
number of the first graph in the graphics catalog to plot (default:
FIRST=1), where:
FIRST=3 starts with the third graph.
FIRST=0 means
last graph only, FIRST=-1 means the first is the one before last, etc.)
LAST= parameter may be used to specify the number of the last graph
in the input graphics catalog to be replayed. The default is LAST=0,
which refers to the last plot in the graphics catalog. The LAST= value
is interpreted as follows:
LAST=4 ends with the fourth graph.
LAST=0 means
last graph only, LAST=-1 means to end with the one before last, etc.)
SHAPE=RECT),
but for some applications graphs are generated as the lower or upper triangle
of a square matrix, with or without the diagonal. Specify SHAPE=
LOWTRI(D) or UPTRI(D) for these cases.
GIN=WORK.GSEG.
GOUT=WORK.GSEG.
To use PANELS within another macro (such as SCATMAT), it is best to generate the individual graphs to a temporary graphics catalog rather than to the same catalog used for the replayed graphs.
The GREPLAY procedure does not allow a graph name to be assigned to the graph generated by by a TREPLAY or REPLAY statement.
%include macros(panels); *-- or include in an autocall library;
data test;
drop i;
do i=1 to 60;
gp = 1 + mod(i,3);
x1 = round( 100*uniform(0));
x2 = round( 100*uniform(0)) + x1 - 50;
x3 = round( 100*uniform(0)) - x1 + x2;
x4 = round( 100*uniform(0)) + x1 - x3;
output;
end;
%let nv = 3;
*-- Don't display the individual panels;
goptions nodisplay gsfmode=none;
*-- Quick & dirty scatterplot matrix;
title h=.1 '';
proc gplot data=test;
plot (x1-x&nv) * (x1-x&nv) = gp
/ frame nolegend;
symbol1 v=square c=black i=rl;
symbol2 v=dot c=red i=rl;
symbol3 v=triangle c=blue i=rl;
run;
title "A &nv x &nv display with the panels macro";
title2 "(with a subtitle too)";
proc gslide name='mytitle';
run;
goptions display gsfmode=append;
%panels (rows=&nv, cols=&nv, order=down, top=5, topname=mytitle);