eo.par {UCS}R Documentation

Graphics Parameters for (e,o) Plots (eo)

Description

Set default graphics parameters for (e,o) plots, similar to ucs.par in the plots module and par for general graphics parameters. Parameter values can be set by specifying them as arguments in name=value form, or by passing a single list of named values. The current values can be queried by giving their names as character strings.

Usage


eo.par(...)

.eo.PAR

Arguments

... either character strings (or vectors) specifying the names of parameters to be queried, or parameters to be set in name=value form, or a single list of named values. Valid parameter names are described below.

Details

The current default parameters are stored in the global variable .eo.PAR. They can be queried by giving their names as one or more character vectors to eo.par. eo.par() (no arguments) returns all eo graphics parameters.

Parameters are set by specifying their names and the new values as name=value pairs. Such a list can also be passed as a single argument to eo.par, which is typically used to restore previous parameter values (that have been saved in a list variable).

In order to restore the "factory settings", reload the module with the command ucs.library("eo", reload=TRUE).

Value

When parameters are set, their former values are returned in an invisible named list. Such a list can be passed as a single argument to eo.par to restore the previous settings.

When a single parameter is queried, its value is returned directly. When two or more parameters are queried, the result is a named list.

Note the inconsistency, which is the same as for par: setting one parameter returns a list, but querying one parameter returns a vector (or a scalar, i.e. a vector of length 1).

Graphics Parameters for (e,o) Plots

bw
If TRUE, (e,o) plots are created in B/W mode by default.

xlim, ylim
Integer vectors of length 2, specifying default ranges for the e-axis (xlim) and o-axis (ylim) in orders of magnitude (i.e., base 10 logarithms: -2 corresponds to .01, 0 corresponds to 1, and 3 corresponds to 1000). When the default values are not set, every call to the eo.setup function must either specify xlim and ylim values or a data set, from which suitable ranges are computed.

aspect
If TRUE, an aspect ratio of 1:1 is enforced for every (e,o) plot, i.e. the axis ranges are extended as necessary (assuming a square plotting region). The factory setting is TRUE.

log.marks
If TRUE, tick marks on the axes are labelled in logarithmic units, i.e. orders of magnitude. Otherwise, absolute numbers are used. The factory setting is FALSE. (Note that (e,o) plots are always drawn in logarithmic scale.)

steps
An integer specifying the number of equidistant steps used for drawing iso-lines. The factory setting is 100.

jitter
If TRUE, always uses jittered coordinates for plotting data sets and computing n-best thresholds. Note that all data sets must be annotated with the add.jitter function first. The factory setting is FALSE.

cex
Overall character expansion factor (for tick marks, axis labels and legends). The factory setting is 1.3.

col
A character of integer vector specifying line colours for the different styles of iso-lines in colour mode (see the par manpage for details on colour specification). Values are recycled to match the length of the lty and lwd parameters when necessary. The factory setting defines 5 styles in black, blue, red, magenta and cyan.

lty
A character or integer vector specifying line types for the different styles of iso-lines in colour mode (see the par manpage for details). Values are recycled to match the length of the col and lwd parameters when necessary.

lwd
A numeric vector specifying line widths for the different styles of iso-lines in colour mode. Values are recycled to match the length of the col and lty parameters when necessary.

angle, density
Numeric vectors specifying the angle and density of shading lines when the acceptance region bounded by a given iso-line is filled. These vectors should supportas many styles as col, lty and lwd above. Details on shading lines can be found on the polygon help page.

solid
A character or integer vector specifying background colours for the different styles of iso-lines when the acceptance region is filled with solid colour (rather than shading lines).

bw.col, bw.lty, bw.lwd
Colour, line type and line width for iso-lines in B/W mode (corresponding to col, lty and lwd in colour mode). The factory setting defines 5 styles with solid, dashed, grey, dotted and dark grey dot-dash lines.

bw.angle, bw.density, bw.solid
Angle and density of shading lines, as well as solid colour, for filled acceptance regions in B/W mode (corresponding to angle, density and solid in colour mode)

pt.pch
A character or integer vector specifying plot symbols for the different styles of data set points in colour mode (see the points help page for a full list of available plot symbols). Values are recycled to match the length of the pt.cex and pt.col parameters when necessary. The factory setting defines 5 styles with black, green, red, yellow and orange dots.

pt.cex
A numeric vector specifying character expansion factors for the different styles of data set points in colour mode. Values are recycled to match the length of the pt.pch and pt.col parameters when necessary.

pt.col
A character or integer vector specifying colours for the different styles of data set points in colour mode (see the par help page for details on colour specification). Values are recycled to match the length of the pt.pch and pt.cex parameters when necessary.

bw.pt.pch, bw.pt.cex, bw.pt.col
Plot symbol, character expansion and colour for data set points in B/W mode (corresponding to pt.pch, pt.cex and pt.col in colour mode). The factory setting defines 5 styles with black dots, circles, + crosses, triangles and x crosses.

See Also

eo.setup, eo.iso, eo.iso.diff, eo.points, eo.legend, ucs.par, par

Examples


print(names(ucs.eo()))          # list available parameters

eo.par("col", "lty", "lwd")     # the default styles for iso-lines
eo.par(c("col", "lty", "lwd"))  # works as well

## temporary changes to graphics paramters:
par.save <- eo.par(bw=TRUE, steps=200)
## (e,o) plots use the modified parameters here
eo.par(par.save)		# restore previous values

ucs.library("eo", reload=TRUE)  # reload module for factory defaults


[Package UCS version 0.5 Index]