4.4 Configuration Options: settings section

The following table provides a brief description of the function of each of the parameters in the settings section of the above configuration file, with a list of possible values for each:

ASPECT Possible values: Any floating-point number.

Analogous set command: set size ratio

Sets the aspect ratio of plots.

AUTOASPECT Possible values: ON / OFF

Analogous set command: set size ratio

Sets whether plots have the automatic aspect ratio, which is the golden ratio. If ON, then the above setting is ignored.

AXESCOLOUR Possible values: Any recognised colour.

Analogous set command: set axescolour

Sets the colour of axis lines and ticks.

BACKUP Possible values: ON / OFF

Analogous set command: set backup

When this switch is set to `ON', and plot output is being directed to file, attempts to write output over existing files cause a copy of the existing file to be preserved, with a tilda after its old filename (see section 3.3).

BAR Possible values: Any floating-point number.

Analogous set command: set bar

Sets the horizontal length of the lines drawn at the end of errorbars, in units of their default length.

BOXFROM Possible values: Any floating-point number.

Analogous set command: set boxfrom

Sets the horizontal point from which bars on bar charts appear to emanate.

BOXWIDTH Possible values: Any floating-point number.

Analogous set command: set boxwidth

Sets the default width of boxes on barcharts. If negative, then the boxes have automatically selected widths, so that the interfaces between bars occur at the horizontal midpoints between the specified datapoints.

COLOUR Possible values: ON / OFF

Analogous set command: set terminal

Sets whether output should be colour (ON) or monochrome (OFF).

DATASTYLE Possible values: Any plot style.

Analogous set command: set data style

Sets the plot style used by default when plotting datafiles.

DISPLAY Possible values: ON / OFF

Analogous set command: set display

When set to `ON', no output is produced until the set display command is issued. This is useful for speeding up scripts which produce large multiplots; see section 3.5.1 for more details.

DPI Possible values: Any floating-point number.

Analogous set command: set dpi

Sets the sampling quality used, in dots per inch, when output is sent to a bitmapped terminal (the jpeg/gif/png terminals).

ENHANCED Possible values: ON / OFF

Analogous set command: set terminal

Sets whether the postscript terminal produces encapsulated postscript (ON), or printable postscript (OFF).

FONTSIZE Possible values: Integers in the range $ -4 \to 5$.

Analogous set command: set fontsize

Sets the fontsize of text, varying between LATEX's tiny (-4) and Huge (5).

FUNCSTYLE Possible values: Any plot style.

Analogous set command: set function style

Sets the plot style used by default when plotting functions.

GRID Possible values: ON / OFF

Analogous set command: set grid

Sets whether a grid should be displayed on plots.

GRIDAXISX Possible values: Any integer.

Analogous set command: None

Sets the default $ x$-axis to which gridlines should attach, if the set grid command is called without specifying which axes to use.

GRIDAXISY Possible values: Any integer.

Analogous set command: None

Sets the default $ y$-axis to which gridlines should attach, if the set grid command is called without specifying which axes to use.

GRIDMAJCOLOUR Possible values: Any recognised colour.

Analogous set command: set gridmajcolour

Sets the colour of major grid lines.

GRIDMINCOLOUR Possible values: Any recognised colour.

Analogous set command: set gridmincolour

Sets the colour of minor grid lines.

KEY Possible values: ON / OFF

Analogous set command: set key

Sets whether a legend is displayed on plots.

KEYCOLUMNS Possible values: Any integer $ >0$.

Analogous set command: set keycolumns

Sets the number of columns into which the legends of plots should be divided.

KEYPOS Possible values: ``TOP RIGHT'', ``TOP MIDDLE'', ``TOP LEFT'', ``MIDDLE RIGHT'', ``MIDDLE MIDDLE'', ``MIDDLE LEFT'', ``BOTTOM RIGHT'', ``BOTTOM MIDDLE'', ``BOTTOM LEFT'', ``BELOW'', ``OUTSIDE''.

Analogous set command: set key

Sets where the legend should appear on plots.

KEY_XOFF Possible values: Any floating-point number.

Analogous set command: set key

Sets the horizontal offset, in approximate graph-widths, that should be applied to the legend, relative to its default position, as set by KEYPOS.

KEY_YOFF Possible values: Any floating-point number.

Analogous set command: set key

Sets the vertical offset, in approximate graph-heights, that should be applied to the legend, relative to its default position, as set by KEYPOS.

LANDSCAPE Possible values: ON / OFF

Analogous set command: set terminal

Sets whether output is in portrait orientation (OFF), or landscape orientation (ON).

LINEWIDTH Possible values: Any floating-point number.

Analogous set command: set linewidth

Sets the width of lines on plots, as a multiple of the default.

MULTIPLOT Possible values: ON / OFF

Analogous set command: set multiplot

Sets whether multiplot mode is on or off.

ORIGINX Possible values: Any floating point number.

Analogous set command: set origin

Sets the horizontal position, in centimetres, of the default origin of plots on the page. Most useful when multiplotting many plots.

ORIGINY Possible values: Any floating point number.

Analogous set command: set origin

Sets the vertical position, in centimetres, of the default origin of plots on the page. Most useful when multiplotting many plots.

OUTPUT Possible values: Any string.

Analogous set command: set output

Sets the output filename for plots. If blank, the default filename of pyxplot.foo is used, where `foo' is an extension appropriate for the file format.

POINTLINEWIDTH Possible values: Any floating-point number.

Analogous set command: set pointlinewidth / plot with pointlinewidth

Sets the linewidth used to stroke points onto plots, as a multiple of the default.

POINTSIZE Possible values: Any floating-point number.

Analogous set command: set pointsize / plot with pointsize

Sets the sizes of points on plots, as a multiple of their normal sizes.

SAMPLES Possible values: Any integer.

Analogous set command: set samples

Sets the number of samples (datapoints) to be evaluated along the $ x$-axis when plotting a function.

TERMINVERT Possible values: ON / OFF

Analogous set command: set terminal

Sets whether jpeg/gif/png output has normal colours (OFF), or inverted colours (ON).

TERMTRANSPARENT Possible values: ON / OFF

Analogous set command: set terminal

Sets whether jpeg/gif/png output has transparent background (ON), or solid background (OFF).

TERMTYPE Possible values: X11_singlewindow,

X11_multiwindow, PS, PNG, JPG, GIF

Analogous set command: set terminal

Sets whether output is sent to the screen or to disk, and, in the latter case, the format of the output. The ps option should be used for both encapsulated and normal postscript output; these are distinguished using the ENHANCED option, above.

TEXTCOLOUR Possible values: Any recognised colour.

Analogous set command: set textcolour

Sets the colour of all text output.

TEXTHALIGN Possible values: Left, Centre, Right

Analogous set command: set texthalign

Sets the horizontal alignment of text labels to their given reference positions.

TEXTVALIGN Possible values: Top, Centre, Bottom

Analogous set command: set textvalign

Sets the vertical alignment of text labels to their given reference positions.

TITLE Possible values: Any string.

Analogous set command: set title

Sets the title to appear at the top of the plot.

TIT_XOFF Possible values: Any floating point number.

Analogous set command: set title

Sets the horizontal offset of the title of the plot from its default central location.

TIT_YOFF Possible values: Any floating point number.

Analogous set command: set title

Sets the vertical offset of the title of the plot from its default location at the top of the plot.

WIDTH Possible values: Any floating-point number.

Analogous set command: set width / set size

Sets the width of plots in centimetres.

Dominic Ford 2006-09-09