HPx

< 

[(k <:str:Key> ] 

[vk <:bool:KeyVisible> [<:str:KeyOption>]] 

[style <:txt:Line Style Type>] 

[smooth <:txt:Line Style Type>] 

([lt <:int: Line Type Number>|<:txt:Variable>] | [ls <:int: Line Style Number>|<:txt:Variable>])] 

[dt <:int:Dash Type Number>|<:txt:Variable>]  

[pt <:int:Point Type Number>|<:txt:Variable>] 

[lc <str:variable>]

[(x|y|x2|y2) <:int:List Number>|<:txt:Variable>] 

[i (<txt:Option>|<int:Index>)]

[ds <str:filename>]

[t <str:transform>]

[q <str:transform>]

[s <str:transform>]

[smooth <str:transform>] 

[lc <str:variable>]

[extra <str:transform>]

> 

       Identifiers

k identifies the key of the line

By default, the key is defined by the type of variable (e.g. molality, activity,...) and the variable name (e.g., Na+, calcite, ...). The user can overwrite the key of a specific plot line with a string following k.

For example, 

       -fig_y &mol Cd+2

will plot the molality of Cd2+ and the key in the legend is "Molality - Cd+2"

Alternatively, the user can change the key as:

-fig_y &mol Cd+2 <k "Cd^{2+}">

When the figure is made using gnuplot, gnuplot interprets the string to format it when enhanced text mode is used (see gnuplot manual - Enhanced text mode and enhanced_utf8.dem). The key will be "Cd2+".

If the key is "__nc" in combination with a multi-dataset file, only the label of the particular dataset is used in the key.

 

vk identifies if the key of the specific line is visible in the legend of the plot. Besides true (or 1) or false (or 0), the indicator option (-1) can be given. The visibility of the legend depends then on the value of the variable defined between quotes. If the value is 0, the key is not visible; otherwise the key is  visible. 

style defines the style of the line such as a line or points (see gnuplot manual - with).

smooth defines options of the implemented general interpolation and approximation functions (see gnuplot manual - smooth).

lt and ls defines the appearance of the line in terms of width, colour and points (see gnuplot manual linetype and linestyle). They are mutually exclusive - if both of them are defined, lt is used. If they are not defined, default numbering for different lines is used using linetype incremented by 1 for each line.  Line types and line styles defaults are those defined by gnuplot (gnuplot version 5: a terminal-independent sequence of 8 colours), but can be redefined with gnuplot statements in blocks defined by -fig_start - -fig_end or -start - -end in a selected_graph data block. For example:

       set linetype 1 linewidth 3 linecolor "red"

       set style line 1 linewidth 2 linecolor "orange"

dt defines the dash pattern of the plot line (gnuplot version 5, see gnuplot manual - dashtype). Besides the default gnuplot definitions, one can (re)define alternative dahstypes with gnuplot statements in blocks defined by  -fig_start - -fig_end or -start - -end in a selected_graph data block.

x, y, x2, y2 indicates that the independent variable will be taken from, respectively, -fig_x, -fig_y, -fix_sx, or -fig_sy using a zero-based index. 

For example, for a XY plot, all plot lines use by default the variables defined by -fig_x as the independent variable. When x2 1 is defined for a specific plot line, that line will use the second variable defined by -fig_sx as the independent variable using the secondary x-axis. When x 1 is defined for a specific plot line, that line will use the second variable defined by -fig_x as the independent variable using the primary x-axis. 

i indicates which data sets in a multi-data-set file have to be used (zero-based index). In a multi-dataset file, different datasets must be separated by two empty lines and a heading. By default, only the first dataset (data set 0) is plotted. For the option all, a line is plotted for each dataset in the multi-dataset file. For a single line, one zero-based index number is given. For a list of indexes, the txt Option input should start with a (letter) l, followed by the list of numbers (comma separated, or with a hyphen (-), no spaces!) to give a range of indexes. 

       i all                   # a separate curve is generated for each dataset in the output file

i last                   # a separate curve is generated for the last dataset in the output file

       i 1                    # a curve for the second dataset in the output file is generated

       i l2,4,6-8         # separate curves for datasets 3, 5, 7, 8, and 9 in the output file are generated

With multiple lines to be plotted (e.g.,for the first and the last example given before), the curve options lt, ls and dt 

Transformation

also qa (-> extra)

linecolor variable

To have the colour of the line defined by one or more values in data columns, the identifier lc is used. The string variable indicates how 

If the dataset to plot is a result of a querry (identifier q), the additioni

Extra

The extra identifier is only relevant when query is combined with transform and/or linecolor. The query identifier filters the data and includes an inline dataset in the gnuplot script.  

Examples

See Plotting multiple datasets for more information and examples.

To be documented:

legendsoptions?