Graphics Parameters for Evaluation Graphs (plots)

Description

Set default graphics parameters for the evaluation.plot function, similar to par for general graphics parameters. The current parameter values are queried by giving their names as character strings. The values can be set by specifying them as arguments in name=value form, or by passing a single list of named values.

Usage

ucs.par(...)

.ucs.PAR

Arguments

Details

The current default parameters are stored in the global variable .ucs.PAR. They can be queried by giving their names as one or more character vectors to ucs.par. ucs.par() (no arguments) returns all UCS 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 ucs.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("plots", 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 ucs.par to restore the parameter values.

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).

UCS Graphics Parameters

col

A character or integer vector specifying line colours for up to 10 evaluation graphs (see the par manpage for details). Values are recycled if necessary.

lty

A character or integer vector specifying line styles for up to 10 evaluation graphs (see the par manpage for details). Values are recycled if necessary.

lwd

A numeric vector specifying line widths for up to 10 evaluation graphs (see the par manpage for details). Values are recycled if necessary.

bw.col

The line colours used in B/W mode (see the evaluation.plot manpage for details).

bw.lty

The line styles used in B/W mode.

bw.lwd

The line widths in B/W mode.

n.first

The smallest n-best list to be evaluated (default: 100). Shorter n-best lists typically lead to highly unstable evaluation graphs. It may be necessary to set n.first to a higher value for evaluation based on random samples (cf. evaluation.plot).

n.step

The step width for n-best lists in evaluation graphs (default: 1). The default setting evaluates all possible n-best lists. Higher values speed up computation, make graphs look less jagged, and reduce the size of PostScript files. A useful range is 5 … 20, depending on the size of the data set file.

test.step

Step width for n-best lists where significance tests for result differences are applied, as a multiple of n.step (default: 10). Since these tests are time-consuming and significant differences are indicated by fairly large symbols in the plot, values below 5 are rarely useful.

cex

A character expansion factor for labels, annotations, and symbols in evaluation plots (see par for details).

lex

This parameter can be used to increase the line widths of evaluation graphs and some decorations. Not that lex is not an expansion factor, but is simply added to all line widths in the plot.

do.file

If FALSE, evaluation.file will not generate PostScript files, which is useful while testing and fine-tuning plots (default: TRUE).

See Also

evaluation.plot, evaluation.file, par

Examples

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

ucs.par("col", "lty", "lwd")    # the default line styles
ucs.par(c("col", "lty", "lwd")) # works as well

## temporary changes to graphics paramters:
par.save <- ucs.par(n.first=200, n.step=5)
## plots use the modified parameters here
ucs.par(par.save)		# restore previous values

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