## 9.3.2 The `settings` section

The `settings` section can contain any of the following settings in any order:

`aspect` | Possible values: `auto`, or 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 `aspect` setting is ignored. Deprecated: new scripts should use `aspect=auto` instead.
`autoZAspect` | Possible values: `on`, `off`. Analogous set command: `set size zratio` Sets whether 3d plots have the automatic aspect ratio, which is the golden ratio. If `on`, then the `zAspect` setting is ignored. Deprecated: new scripts should use `zAspect=auto` instead.
`axesColor` | Possible values: Any recognised color. Analogous set command: `set axescolor` Sets the color of axis lines and ticks.
`axisUnitStyle` | Possible values: `Bracketed`, `Ratio`, `SquareBracketed` Analogous set command: `set axisunitstyle` Sets the style in which the physical units of quantities plotted against axes are appended to axis labels.
`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 tilde after its old filename (see Section 2.4).
`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.
`binOrigin` | Possible values: `auto`, or any floating-point number. Analogous set command: `set binorigin` Sets the point along the abscissa axis from which the bins used by the `histogram` command originate.
`binWidth` | Possible values: `auto`, or any floating-point number. Analogous set command: `set binwidth` Sets the widths of the bins used by the `histogram` command.
`boxFrom` | Possible values: `auto`, or 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: `auto`, or 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.
`calendarIn` | Possible values: `British`, `French`, `Greek`, `Gregorian`, `Hebrew`, `Islamic`, `Julian`, `Papal`, `Russian`. Analogous set command: `set calendar` Sets the default calendar for the input of dates from day, month and year representation into Julian Date representation. See Section 4.11 for more details.
`calendarOut` | Possible values: `British`, `French`, `Greek`, `Gregorian`, `Hebrew`, `Islamic`, `Julian`, `Papal`, `Russian`. Analogous set command: `set calendar` Sets the default calendar for the output of dates from Julian Date representation to day, month and year representation. See Section 4.11 for more details.
`clip` | Possible values: `on`, `off`. Analogous set command: `set clip` Sets whether datapoints close to the edges of graphs should be clipped at the edges (`on`) or allowed to overrun the axes (`off`).
`colKey` | Possible values: `on`, `off`. Analogous set command: `set colkey` Sets whether `colormap` plots have a scale along one side relating color to ordinate value.
`colKeyPos` | Possible values: `top`, `bottom`, `left`, `right`. Analogous set command: `set colkey` Sets the side of the plot along which the color legend should appear on `colormap` plots.
`color` | Possible values: `on`, `off`. Analogous set command: `set terminal` Sets whether output should be color (`on`) or monochrome (`off`).
`contour` | Possible values: Any integer. Analogous set command: `set contour` Sets the number of contours which are drawn in the `contourmap` plot style.

`c?Range_log`

Possible values: `true`, `false`.

Analogous set command: `set logscale c`

When the variables `c1`–`c4` are set to renormalise in the `c?Range_renorm` setting, this setting determines whether color maps are drawn with logarithmic or linear color scales. The `?` wildcard should be replaced with an integer in the range 1–4 to alter the renormalisation of the variables `c1` through `c4` respectively in the expressions supplied to the `colmap` setting. In the case of `c1`, this setting also determines whether contours demark linear or logarithmic intervals on contour maps.

`c?Range_max`

Possible values: Any floating-point number.

Analogous set command: `set crange`

When the variables `c1`–`c4` are set to renormalise in the `c?Range_renorm` setting, this setting determines the upper limit of the range of values demarked by differing colors on color maps. The `?` wildcard should be replaced with an integer in the range 1–4 to alter the renormalisation of the variables `c1` through `c4` respectively in the expressions supplied to the `colmap` setting. In the case of `c1`, this setting also determines the range of ordinate values for which contours are drawn on contour maps.

`c?Range_max_auto`

Possible values: `true`, `false`.

Analogous set command: `set crange`

When the variables `c1`–`c4` are set to renormalise in the `c?Range_renorm` setting, this setting determines whether the upper limit of the range of values demarked by differing colors on color maps should autoscale to fit the data, or be a fixed value as specified in the `C?Range_max` setting. The `?` wildcard should be replaced with an integer in the range 1–4 to alter the renormalisation of the variables `c1` through `c4` respectively. In the case of `c1`, this setting also affects the range of ordinate values for which contours are drawn on contour maps.

`c?Range_min`

Possible values: Any floating-point number.

Analogous set command: `set crange`

When the variables `c1`–`c4` are set to renormalise in the `c?Range_renorm` setting, this setting determines the lower limit of the range of values demarked by differing colors on color maps. The `?` wildcard should be replaced with an integer in the range 1–4 to alter the renormalisation of the variables `c1` through `c4` respectively in the expressions supplied to the `colmap` setting. In the case of `c1`, this setting also determines the range of ordinate values for which contours are drawn on contour maps.

`c?Range_min_auto`

Possible values: `true`, `false`.

Analogous set command: `set crange`

When the variables `c1`–`c4` are set to renormalise in the `c?Range_renorm` setting, this setting determines whether the lower limit of the range of values demarked by differing colors on color maps should autoscale to fit the data, or be a fixed value as specified in the `C?Range_min` setting. The `?` wildcard should be replaced with an integer in the range 1–4 to alter the renormalisation of the variables `c1` through `c4` respectively. In the case of `c1`, this setting also affects the range of ordinate values for which contours are drawn on contour maps.

`c?Range_renorm`

Possible values: `true`, `false`.

Analogous set command: `set crange`

Sets whether the variables `c1`–`c4`, used in the construction of color maps, should be renormalised into the range 0–1 before being passed to the expressions supplied to the `set colmap` command, or whether they should contain the exact data values supplied in the 3rd–6th columns of data to the `colormap` plot style. The `?` wildcard should be replaced with an integer in the range 1–4 to alter the renormalisation of the variables `c1` through `c4` respectively.

`c?Range_reverse`

Possible values: `true`, `false`.

Analogous set command: `set crange`

When the variables `c1`–`c4` are set to renormalise in the `c?Range_renorm` setting, this setting determines whether the renormalisation into the range 0–1 is inverted such that the maximum value maps to zero and the minimum value maps to one. The `?` wildcard should be replaced with an integer in the range 1–4 to alter the renormalisation of the variables `c1` through `c4` respectively.

`dataStyle` | Possible values: Any plot style. Analogous set command: `set data style` Sets the plot style used by default when plotting data files.
`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.3 for more details.
`dpi` | Possible values: Any floating-point number. Analogous set command: `set terminal dpi` Sets the sampling quality used, in dots per inch, when output is sent to a bitmapped terminal (the bmp, jpeg, gif, png and tif terminals).
`fontSize` | Possible values: Any floating-point number. Analogous set command: `set fontsize` Sets the fontsize of text, where represents 10-point text, and other values differ multiplicatively.
`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 horizontal 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 vertical axis to which gridlines should attach, if the `set grid` command is called without specifying which axes to use.
`gridAxisZ` | Possible values: Any integer. Analogous set command: None Sets the default -axis to which gridlines should attach, if the `set grid` command is called without specifying which axes to use.
`gridMajColor` | Possible values: Any recognised color. Analogous set command: `set gridmajcolor` Sets the color of major grid lines.
`gridMinColor` | Possible values: Any recognised color. Analogous set command: `set gridmincolor` Sets the color 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 . Analogous set command: `set keycolumns` Sets the number of columns into which the legends of plots should be divided. If a value of zero is given, then the number of columns is decided automatically for each plot.
`keyPos` | Possible values: `top right`, `top xcenter`, `top left`, `ycenter right`, `ycenter xcenter`, `ycenter left`, `bottom right`, `bottom xcenter`, `bottom left`, `above`, `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.
`numComplex` | Possible values: `on`, `off`. Analogous set command: `set numerics` Sets whether complex arithmetic is enabled, or whether all non-real results to calculations should raise numerical exceptions.
`numDisplay` | Possible values: `latex`, `natural`, `typeable`. Analogous set command: `set numerics` Sets whether numerical results are displayed in a natural human-readable way, e.g. , in LaTeX, e.g. `$,mathrm{m}$`, or in a way which may be pasted back into Pyxplot, e.g. `2*unit(m)`.
`numErr` | Possible values: `on`, `off`. Analogous set command: `set numerics` Sets whether explicit error messages are thrown when calculations yield undefined results, as in the cases of division by zero or the evaluation of functions in regions where they are undefined or infinite. If explicit error messages are disabled, such calculations quietly return `nan`.
`numSF` | Possible values: Any integer between 0 and 30. Analogous set command: `set numerics` Sets the number of significant figures to which numerical quantities are displayed by default.
`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 (case sensitive). 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.
`paperHeight` | Possible values: Any floating-point number. Analogous set command: `set papersize` Sets the height of the papersize for PostScript output in millimetres.
`paperName` | Possible values: A string matching any of the papersizes listed in Chapter 6. Analogous set command: `set papersize` Sets the papersize for PostScript output to one of the pre-defined papersizes listed in Chapter 6.
`paperWidth` | Possible values: Any floating-point number. Analogous set command: `set papersize` Sets the width of the papersize for PostScript output in millimetres.
`pointLineWidth` | Possible values: Any floating-point number. Analogous set command: `set 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` 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 abscissa axis when plotting a function.
`samples_method` | Possible values: `inverseSquare`, `monaghanLattanzio`, `nearestNeighbor`. Analogous set command: `set samples` Sets the method used to interpolate two-dimensional non-gridded arrays of datapoints from datafiles within the `interpolate` command and when plotting using the `colormap`, `contourmap` and `surface` plot styles.
`samples_x` | Possible values: Any integer. Analogous set command: `set samples` Sets the number of samples (datapoints) to be evaluated along the first abscissa axis when drawing color maps and surfaces, and when calculating contour maps.
`samples_x_auto` | Possible values: `true`, `false`. Analogous set command: `set samples` Sets whether the number of samples (datapoints) to be evaluated along the first abscissa axis when drawing color maps and surfaces, and when calculating contour maps should follow the number of samples set with the `set samples` command.
`samples_y` | Possible values: Any integer. Analogous set command: `set samples` Sets the number of samples (datapoints) to be evaluated along the second abscissa axis when drawing color maps and surfaces, and when calculating contour maps.
`samples_y_auto` | Possible values: `true`, `false`. Analogous set command: `set samples` Sets whether the number of samples (datapoints) to be evaluated along the second abscissa axis when drawing color maps and surfaces, and when calculating contour maps should follow the number of samples set with the `set samples` command.
`termAntiAlias` | Possible values: `on`, `off`. Analogous set command: `set terminal` Sets whether output sent to the bitmapped graphics output terminals – i.e. the bmp, jpeg, gif, png and tif terminals – is antialiased. Antialiasing smooths the color boundaries to disguise the effects of pixelisation and is almost invariably desirable.
`termEnlarge` | Possible values: `on`, `off`. Analogous set command: `set terminal` When set to `on` output is enlarged or shrunk to fit the current paper size.
`termInvert` | Possible values: `on`, `off`. Analogous set command: `set terminal` Sets whether jpeg/gif/png output has normal colors (`off`), or inverted colors (`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: `bmp`, `eps`, `gif`, `jpg`, `pdf`, `png`, `ps`, `svg`, `tif`, `X11_multiWindow`, `X11_persist`, `X11_singleWindow`. Analogous set command: `set terminal` Sets whether output is sent to the screen, using one of the `X11_`... terminals, or to disk. In the latter case, output may be produced in a wide variety of graphical formats.
`textColor` | Possible values: Any recognised color. Analogous set command: `set textcolor` Sets the color of all text output.
`textHAlign` | Possible values: `left`, `center`, `right`. Analogous set command: `set texthalign` Sets the horizontal alignment of text labels to their given reference positions.
`textVAlign` | Possible values: `top`, `center`, `bottom`. Analogous set command: `set textvalign` Sets the vertical alignment of text labels to their given reference positions.
`title` | Possible values: Any string (case sensitive). Analogous set command: `set title` Sets the title to appear at the top of the plot.
`title_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.
`title_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.
`tRange_log` | Possible values: `true`, `false`. Analogous set command: `set logscale t` Sets whether the -axis – used for parametric plotting – is linear or logarithmic.
`tRange_max` | Possible values: Any floating-point number. Analogous set command: `set trange` Sets upper limit of the -axis, used for parametric plotting.
`tRange_min` | Possible values: Any floating-point number. Analogous set command: `set trange` Sets lower limit of the -axis, used for parametric plotting.
`unitAbbrev` | Possible values: `on`, `off`. Analogous set command: `set unit` Sets whether physical units are displayed in abbreviated form, e.g. `mm`, or in full, e.g. `millimetres`.
`unitAngleDimless` | Possible values: `on`, `off`. Analogous set command: `set unit` Sets whether angles are treated as dimensionless units, or whether the radian is treated as a base unit.
`unitPrefix` | Possible values: `on`, `off`. Analogous set command: `set unit` Sets whether SI prefixes, such as `milli-` and `mega-` are prepended to SI units where appropriate.
`unitScheme` | Possible values: `ancient`, `cgs`, `imperial`, `planck`, `si`, `USCustomary`. Analogous set command: `set unit` Sets the scheme of physical units in which quantities are displayed.
`uRange_log` | Possible values: `true`, `false`. Analogous set command: `set logscale u` Sets whether the -axis – used for parametric plotting – is linear or logarithmic.
`uRange_max` | Possible values: Any floating-point number. Analogous set command: `set urange` Sets upper limit of the -axis, used for parametric plotting.
`uRange_min` | Possible values: Any floating-point number. Analogous set command: `set urange` Sets lower limit of the -axis, used for parametric plotting.
`vRange_log` | Possible values: `true`, `false`. Analogous set command: `set logscale v` Sets whether the -axis – used for parametric plotting – is linear or logarithmic.
`vRange_max` | Possible values: Any floating-point number. Analogous set command: `set vrange` Sets upper limit of the -axis, used for parametric plotting.
`vRange_min` | Possible values: Any floating-point number. Analogous set command: `set vrange` Sets lower limit of the -axis, used for parametric plotting.
`width` | Possible values: Any floating-point number. Analogous set commands: `set width`, `set size` Sets the width of plots in centimetres.
`view_xy` | Possible values: Any floating-point number. Analogous set commands: `set view` Sets the viewing angle of three-dimensional plots in the - plane in degrees.
`view_yz` | Possible values: Any floating-point number. Analogous set commands: `set view` Sets the viewing angle of three-dimensional plots in the - plane in degrees.
`zAspect` | Possible values: `auto`, or any floating-point number. Analogous set command: `set size ratio` Sets the aspect ratio of 3d plots.