Predict !PLOT
PLOT graphic control qualifiers
This section was drafted by Damian Collins.
The !PLOT qualifier produces a graphic of the predictions.
Where there is more than one prediction factor,
a multi-panel 'trellis' arrangement may be used.
Alternatively, one or more factors can be superimposed on the one panel.
The data can be added to the plot to assist informal examination of the model fit.
With no sub-options, ASReml chooses an arrangement for plotting
the predictions by recognising any covariates and noting the size of factors.
However, the user is able to customize how the predictions
are plotted by either using sub-options to the
!PLOT qualifier or by using the graphical interface.
The graphical interface is accessed by typing ESC when
the figure is displayed.
The !PLOT qualifier has the following sub-options:
Lines and data
^addData
superimposes the raw data.
^addlabels factors
superimposes the raw data with
the data points labelled using the given factors (which must not be
prediction factors).
This option may be useful to identify individual data points on the graph
-- for instance, potential outliers -- or alternatively, to identify groups
of data points (e.g. all data points in the same stratum).
^addlines factors
superimposes the raw data with the
data points joined using the given factors which must not
be prediction factors. This option may be useful for repeated measures data.
^noSEs
specifies that no error bars should be plotted (by default, they
are plotted)
^semult r
specifies the multiplier of the SE used
for creating error bars (default=1.0)
^joinmeans
specifies that the predicted values should be joined by lines
(by default, they are only joined if the x-axis variable is numeric)
Predictions involving two or more factors
If these arguments are used,
all prediction factors (except for those specified with only one prediction
level) must be listed once and only once, otherwise these arguments are ignored.
^xaxis factor
specifies the prediction factor to be plotted
on the x-axis
^superimpose factors
specifies the prediction factors
to be superimposed on the one panel.
^condition factors
specifies the conditioning factors which define
the panels. These should be listed in the order that they will be used.
Layout
^goto n
specifies the page to start at, for
multi-page predictions.
^saveplot filename
specifies the name of the file to save
the plot to.
^layout rows cols
specifies the panel layout on each page
^bycols
specifies that the panels be arranged by columns (default is by rows)
^blankpanels n
specifies that each page contains n
blank panels. This sub-option can only be
used in combination with the layout sub-option.
^extrablanks n ^extraspan p
specifies that an additional n blank panels be used every p pages
These can only be used
with the ^layout sub-option.
Improving the graphical appearance (and readability)
^labcharsize n
specifies the relative size of the data
points/labels (default=0.4)
^panelcharsize n
specifies the relative size of the labels
used for the panels (default=1.0)
^vertxlab
specifies that vertical annotation be used on the x-axis (default
is horizontal).
^abbrdlab n
specifies that the labels used for the data
be abbreviated to n characters.
^abbrxlab n
specifies that the labels used for the x-axis
annotation be appreviated to n characters.
^abbrslab n
specifies that the labels used for superimposed
factors be abbreviated to n characters.
Return to start