Provided by: ctioga2_0.14.1-2_all bug

NAME

       ctioga2 - a command-line front-end for the Tioga plotting library

SYNOPSIS

       ctioga2 arguments ...

DESCRIPTION

       ctioga2  is  a  command-line front-end to the wonderful Tioga plotting library. It aims at
       plotting quickly both data files and mathematical functions, with however the  possibility
       of a high control over the details.

       The main feature that was introduced compared to the old ctioga is that it is now possible
       to use command files for ctioga2:  every  single  command-line  option  corresponds  to  a
       command,  whose  name  is  written.  Just  give  the  command the same arguments as to the
       command-line option. To read a command file, feed it to the -f command-line option.

EXAMPLES

       Here are a few examples, both from command-line and using the corresponding files.

       ctioga2 File.dat
               Produces a file Plot.pdf showing the second column of File.dat as  a  function  of
               the first.

       The corresponding command file would be:

         #!/usr/bin/env ctioga2 -f
         plot(File.dat)

OPTIONS

   Plots
       Plots

       --plot DATASET
               Use  the  current  backend to load the given datasets onto the data stack and plot
               them. It is a combination of the load and the plot-last commands; you  might  want
               to see their documentation.

               Optional  arguments:  as  bypass-transforms class clipped color color-map contour-
               conrec contour-minor-number contour-minor-scale contour-minor-style contour-number
               depth  error-bar-color  error-bar-line-width  fill  fill-color  fill-pattern fill-
               transparency id ignore_hooks legend line-cap line-style line-width marker  marker-
               angle   marker-color   marker-color-map   marker-fill-color  marker-fill-color-map
               marker-line-color marker-line-color-map marker-line-width marker-min-scale marker-
               scale name path-style region-side split-on-nan where xaxis yaxis zaxis
               Corresponding command: plot(dataset,option=...)

       -p, --plot-last
               Plots  the  last dataset pushed onto the data stack (or the one specified with the
               which option), with the current style. All aspects of  the  curve  style  (colors,
               markers, line styles...) can be overridden through the use of options.

               Optional  arguments:  class  clipped color color-map contour-conrec contour-minor-
               number contour-minor-scale  contour-minor-style  contour-number  depth  error-bar-
               color  error-bar-line-width  fill  fill-color  fill-pattern  fill-transparency  id
               legend line-cap line-style line-width  marker  marker-angle  marker-color  marker-
               color-map  marker-fill-color  marker-fill-color-map marker-line-color marker-line-
               color-map marker-line-width marker-min-scale marker-scale  path-style  region-side
               split-on-nan which xaxis yaxis zaxis
               Corresponding command: plot-last(,option=...)

   Curves styles
       Set stylistic details of curves or other object drawn from data

       --[no-]clipped
               Sets the clipped for subsequent curves, until cancelled with auto as argument.

               Corresponding command: clipped(boolean-or-auto)

       -c, --color COLOR-OR-FALSE-OR-AUTO
               Sets the line color for subsequent curves, until cancelled with auto as argument.

               Corresponding command: color(color-or-false-or-auto)

       --color-map COLORMAP-OR-AUTO
               Sets the color map for the subsequent curves, until cancelled by an auto argument.

               Color  maps  are used for 3D plots, ie under the effet of contour, xyz-map and xy-
               parametric.

               Corresponding command: color-map(colormap-or-auto)

       --color-set COLOR-OR-FALSE-SET
               Chooses a set for the line color of subsequent curves. Also sets color to auto, so
               that the set takes effect immediately

               Corresponding command: color-set(color-or-false-set)

       --[no-]contour-conrec
               If  on, the subsequent curves will use the CONREC algorithm for contouring. In the
               opposite case, the contouring algorithm of Gri is used.

               Only useful when contour is in effect.

               Corresponding command: contour-conrec(boolean-or-auto)

       --contour-minor-number INTEGER-OR-AUTO
               Sets the number of minor level lines between major ones  (approx)  for  subsequent
               curves, until cancelled with auto as argument.

               Corresponding command: contour-minor-number(integer-or-auto)

       --contour-minor-scale FLOAT-OR-AUTO
               Sets  the  relative  scale  of  minor  level  lines  for  subsequent curves, until
               cancelled with auto as argument.

               Corresponding command: contour-minor-scale(float-or-auto)

       --contour-minor-style LINE-STYLE-OR-AUTO
               Sets the minor ticks line style for subsequent curves, until cancelled  with  auto
               as argument.

               Corresponding command: contour-minor-style(line-style-or-auto)

       --contour-number INTEGER-OR-AUTO
               Sets the overall number of level lines for subsequent curves, until cancelled with
               auto as argument.

               Corresponding command: contour-number(integer-or-auto)

       --depth INTEGER-OR-AUTO
               Sets the depth for subsequent curves, until cancelled with auto as argument.

               Corresponding command: depth(integer-or-auto)

       --error-bar-color COLOR-OR-FALSE-OR-AUTO
               Sets the error bar color for subsequent  curves,  until  cancelled  with  auto  as
               argument.

               Corresponding command: error-bar-color(color-or-false-or-auto)

       --error-bar-color-set COLOR-OR-FALSE-SET
               Chooses  a  set for the error bar color of subsequent curves. Also sets error-bar-
               color to auto, so that the set takes effect immediately

               Corresponding command: error-bar-color-set(color-or-false-set)

       --error-bar-line-width FLOAT-OR-AUTO
               Sets the error bar line width for subsequent curves, until cancelled with auto  as
               argument.

               Corresponding command: error-bar-line-width(float-or-auto)

       --error-bar-line-width-set FLOAT-SET
               Chooses  a set for the error bar line width of subsequent curves. Also sets error-
               bar-line-width to auto, so that the set takes effect immediately

               Corresponding command: error-bar-line-width-set(float-set)

       --fill FILL-UNTIL-OR-AUTO
               Sets the Fill until for subsequent curves, until cancelled with auto as argument.

               Corresponding command: fill(fill-until-or-auto)

       --fill-color COLOR-OR-AUTO
               Sets the fill color for subsequent curves, until cancelled with auto as argument.

               Corresponding command: fill-color(color-or-auto)

       --fill-color-set COLOR-SET
               Chooses a set for the fill color of subsequent curves.  Also  sets  fill-color  to
               auto, so that the set takes effect immediately

               Corresponding command: fill-color-set(color-set)

       --fill-pattern FILL-PATTERN-OR-AUTO
               Sets  the  fill  pattern  for  subsequent  curves,  until  cancelled  with auto as
               argument.

               Corresponding command: fill-pattern(fill-pattern-or-auto)

       --fill-set FILL-UNTIL-SET
               Chooses a set for the Fill until of subsequent curves. Also sets fill to auto,  so
               that the set takes effect immediately

               Corresponding command: fill-set(fill-until-set)

       --fill-transparency FLOAT-OR-AUTO
               Sets  the  fill  transparency  for subsequent curves, until cancelled with auto as
               argument.

               Corresponding command: fill-transparency(float-or-auto)

       --fill-transparency-set FLOAT-SET
               Chooses a set for the fill transparency of  subsequent  curves.  Also  sets  fill-
               transparency to auto, so that the set takes effect immediately

               Corresponding command: fill-transparency-set(float-set)

       --line-cap LINE-CAP-OR-AUTO
               Sets the line cap for subsequent curves, until cancelled with auto as argument.

               Corresponding command: line-cap(line-cap-or-auto)

       --line-style LINE-STYLE-OR-AUTO
               Sets the line style for subsequent curves, until cancelled with auto as argument.

               Corresponding command: line-style(line-style-or-auto)

       --line-style-set LINE-STYLE-SET
               Chooses  a  set  for  the line style of subsequent curves. Also sets line-style to
               auto, so that the set takes effect immediately

               Corresponding command: line-style-set(line-style-set)

       --line-width FLOAT-OR-AUTO
               Sets the line width for subsequent curves, until cancelled with auto as argument.

               Corresponding command: line-width(float-or-auto)

       --line-width-set FLOAT-SET
               Chooses a set for the line width of subsequent curves.  Also  sets  line-width  to
               auto, so that the set takes effect immediately

               Corresponding command: line-width-set(float-set)

       -m, --marker MARKER-OR-AUTO
               Sets the marker for subsequent curves, until cancelled with auto as argument.

               Corresponding command: marker(marker-or-auto)

       --marker-angle FLOAT-OR-AUTO
               Sets  the  marker  angle  for  subsequent  curves,  until  cancelled  with auto as
               argument.

               Corresponding command: marker-angle(float-or-auto)

       --marker-color COLOR-OR-FALSE-OR-AUTO
               Sets the marker  color  for  subsequent  curves,  until  cancelled  with  auto  as
               argument.

               Corresponding command: marker-color(color-or-false-or-auto)

       --marker-color-map COLORMAP-OR-AUTO
               Sets the color map for markers for subsequent curves, until cancelled with auto as
               argument.

               Corresponding command: marker-color-map(colormap-or-auto)

       --marker-color-set COLOR-OR-FALSE-SET
               Chooses a set for the marker color of subsequent curves. Also sets marker-color to
               auto, so that the set takes effect immediately

               Corresponding command: marker-color-set(color-or-false-set)

       --marker-fill-color COLOR-OR-FALSE-OR-AUTO
               Sets  the  marker  fill  color for subsequent curves, until cancelled with auto as
               argument.

               Corresponding command: marker-fill-color(color-or-false-or-auto)

       --marker-fill-color-map COLORMAP-OR-AUTO
               Sets the color map for the lines of markers for subsequent curves, until cancelled
               with auto as argument.

               Corresponding command: marker-fill-color-map(colormap-or-auto)

       --marker-fill-color-set COLOR-OR-FALSE-SET
               Chooses  a  set  for the marker fill color of subsequent curves. Also sets marker-
               fill-color to auto, so that the set takes effect immediately

               Corresponding command: marker-fill-color-set(color-or-false-set)

       --marker-line-color COLOR-OR-FALSE-OR-AUTO
               Sets the marker stroke color for subsequent curves, until cancelled with  auto  as
               argument.

               Corresponding command: marker-line-color(color-or-false-or-auto)

       --marker-line-color-map COLORMAP-OR-AUTO
               Sets the color map for the lines of markers for subsequent curves, until cancelled
               with auto as argument.

               Corresponding command: marker-line-color-map(colormap-or-auto)

       --marker-line-color-set COLOR-OR-FALSE-SET
               Chooses a set for the marker stroke color of subsequent curves. Also sets  marker-
               line-color to auto, so that the set takes effect immediately

               Corresponding command: marker-line-color-set(color-or-false-set)

       --marker-line-width FLOAT-OR-AUTO
               Sets  the  marker  line  width for subsequent curves, until cancelled with auto as
               argument.

               Corresponding command: marker-line-width(float-or-auto)

       --marker-min-scale FLOAT-OR-FALSE-OR-AUTO
               Sets the marker  scale  for  subsequent  curves,  until  cancelled  with  auto  as
               argument.

               Corresponding command: marker-min-scale(float-or-false-or-auto)

       --marker-scale FLOAT-OR-AUTO
               Sets  the  marker  scale  for  subsequent  curves,  until  cancelled  with auto as
               argument.

               Corresponding command: marker-scale(float-or-auto)

       --marker-scale-set FLOAT-SET
               Chooses a set for the marker scale of subsequent curves. Also sets marker-scale to
               auto, so that the set takes effect immediately

               Corresponding command: marker-scale-set(float-set)

       --marker-set MARKER-SET
               Chooses  a  set  for the marker of subsequent curves. Also sets marker to auto, so
               that the set takes effect immediately

               Corresponding command: marker-set(marker-set)

       --path-style TEXT-OR-AUTO
               Sets the path style for subsequent curves, until cancelled with auto as argument.

               Corresponding command: path-style(text-or-auto)

       --path-style-set TEXT-SET
               Chooses a set for the path style of subsequent curves.  Also  sets  path-style  to
               auto, so that the set takes effect immediately

               Corresponding command: path-style-set(text-set)

       --region-side REGION-SIDE-OR-AUTO
               Sets the region side for subsequent curves, until cancelled with auto as argument.

               Corresponding command: region-side(region-side-or-auto)

       --region-side-set REGION-SIDE-SET
               Chooses  a  set for the region side of subsequent curves. Also sets region-side to
               auto, so that the set takes effect immediately

               Corresponding command: region-side-set(region-side-set)

       --reuse-style OBJECT
               After using this command, the next curve will have the same  style  as  the  curve
               whose  name  was  given  as the first argument (it is the name given to the `/id=`
               option to plot.

               Corresponding command: reuse-style(object)

       --skip  This command acts as if one (or number) dataset had been drawn with respect to the
               style of the next dataset to be drawn.

               Optional arguments: number
               Corresponding command: skip(,option=...)

       --[no-]split-on-nan
               In  general,  the  NaN  (not a number, ie invalid data points in the dataset) in a
               dataset are silently ignored. When this option is on, the lines  of  xy-plot-style
               plots are split upon encountering a NaN.

               Corresponding command: split-on-nan(boolean-or-auto)

       --zaxis TEXT-OR-AUTO
               Sets  the  name  of the zaxis for the subsequent curves. This must be an axis that
               has been previously created using new-zaxis.

               This axis will be used to display the colormaps of the following curve.

               Corresponding command: zaxis(text-or-auto)

   Legends
       Commands to specify legends and tweak their look.

       --[no-]auto-legend
               When this option is in effect (off by default), all datasets get a  legend,  their
               'dataset name', unless another legend is manually specified.

               Corresponding command: auto-legend(boolean)

       -l, --legend TEXT
               Sets  the legend for the next dataset. Overridden by the legend option to the plot
               command.

               Corresponding command: legend(text)

       --legend-inside ALIGNED-POINT
               Using this command sets the position of the  legends  for  the  current  (sub)plot
               inside it, at the precise location given.

               As  a  shortcut, legend-inside also takes all the options that legend-style takes,
               with the same effect.

               Optional   arguments:   class   dy    frame_cap    frame_color    frame_fill_color
               frame_fill_pattern  frame_fill_transparency frame_padding frame_radius frame_shape
               frame_style  frame_width   id   picto_height   picto_to_text   picto_width   scale
               symbol_scale text_scale vpadding
               Corresponding command: legend-inside(aligned-point,option=...)

       --legend-line TEXT
               Adds a line of text unrelated to any curve to the legend.

               The  options  controlling  the  aspect of the legend are documented in the define-
               text-style command.

               Optional arguments: align alignment  angle  color  halign  justification  position
               scale shift text_align text_width valign
               Corresponding command: legend-line(text,option=...)

       --legend-multicol
               Following  legends  will be layed out in multiple columns, until a call to legend-
               multicol-end.

               Optional arguments: columns dx
               Corresponding command: legend-multicol(,option=...)

       --legend-multicol-end
               Stop layout out legends in several columns

               Corresponding command: legend-multicol-end()

       --legend-style
               Sets the various aspects of the style of the legends throught its options:

                 * dy: the spacing between the baseline of consecutive lines;    it is deprecated
                   now in favor of vpadding;

                 * vpadding:  the  space  left between the bottom of a line and the top of    the
                   next one;

                 * scale: the overall scale of the legends

                 * text-scale: the scale of the text (and the markers) inside the legends

               The frame- options control the drawing of a frame around the legend; they have the
               same  meaning  as  corresponding  ones  of  define-box-style  with  the frame- bit
               dropped.

               Optional   arguments:   class   dy    frame_cap    frame_color    frame_fill_color
               frame_fill_pattern  frame_fill_transparency frame_padding frame_radius frame_shape
               frame_style  frame_width   id   picto_height   picto_to_text   picto_width   scale
               symbol_scale text_scale vpadding
               Corresponding command: legend-style(,option=...)

   Switch between different kinds of plots
       How to switch between different kinds of plot types

       --contour
               Switch  to  contour  plots  for  later  curves.  Contour  plots need three columns
               (X,Y,Z). They have major and minor lines.

               Corresponding command: contour()

       --histogram
               Switch to drawing histograms.

               Optional arguments: compute_dx cumulative gap intra_sep
               Corresponding command: histogram(,option=...)

       --xy-parametric
               Switch to XY parametric plots, that is standard XY plots whose appearance (such as
               color,  marker color, and, potentially, marker kinds and more) are governed by one
               (or more ?) Z values.

               Optional arguments: z1 z2 z3 z4
               Corresponding command: xy-parametric(,option=...)

       --xy-plot
               Switch (back) to standard XY plots (ctioga's default)

               Corresponding command: xy-plot()

       --xyz-map
               Switch to XYZ maps, ie plots where the color at a XY location is given  by  its  Z
               value.

               Corresponding command: xyz-map()

   Plot coordinates
       Plot coordinates

       --margin FLOAT
               Leaves  a  margin  around the data points. Expressed in relative size of the whole
               plot.

               Corresponding command: margin(float)

       --xfact FLOAT
               Alias for xscale.

               Corresponding command: xfact(float)

       --[no-]xlog
               Uses a logarithmic scale for the X axis.

               Corresponding command: xlog(boolean)

       --xoffset FLOAT
               Adds the given offset to all X coordinates.

               Corresponding command: xoffset(float)

       --xrange PARTIAL-FLOAT-RANGE
               Sets the range of the X coordinates.

               *Important note:* when the axis is in log range (using xlog), the numbers you give
               are not the or ylog values, but their log10, so that to display X values from 1e-2
               to 1e3, use:

                 xyrange -2:3
               Corresponding command: xrange(partial-float-range)

       --xscale FLOAT
               Multiplies the X coordinates by this factor.

               Corresponding command: xscale(float)

       --yfact FLOAT
               Alias for yscale.

               Corresponding command: yfact(float)

       --[no-]ylog
               Uses a logarithmic scale for the Y axis.

               Corresponding command: ylog(boolean)

       --yoffset FLOAT
               Adds the given offset to all Y coordinates.

               Corresponding command: yoffset(float)

       --yrange PARTIAL-FLOAT-RANGE
               Sets the range of the Y coordinates.

               *Important note:* when the axis is in log range (using ylog), the numbers you give
               are not the or ylog values, but their log10, so that to display Y values from 1e-2
               to 1e3, use:

                 yyrange -2:3
               Corresponding command: yrange(partial-float-range)

       --yscale FLOAT
               Multiplies the Y coordinates by this factor.

               Corresponding command: yscale(float)

   Graphics primitives
       Tioga graphics primitives

       --draw DRAWING-SPEC
               Tries to emulate the old --draw behavior of ctioga. Don't use it for new things.

               Corresponding command: draw(drawing-spec)

       --draw-arrow POINT POINT
               Draws arrow on the current plot, using the given style. For  more  information  on
               the available options, see the define-arrow-style command.

               Optional   arguments:   cap   class  clipped  color  depth  head_angle  head_color
               head_marker  head_scale  id  line_style  line_width  style  tail_angle  tail_color
               tail_marker tail_scale width
               Corresponding command: draw-arrow(point,point,option=...)

       --draw-box POINT POINT
               Draws  box on the current plot, using the given style. For more information on the
               available options, see the define-box-style command.

               Optional arguments: cap class clipped  color  depth  fill-color  fill-transparency
               fill_color fill_pattern fill_transparency id radius shape style width
               Corresponding command: draw-box(point,point,option=...)

       --draw-color-list POINT DIMENSION
               Directly draws the list of all named colors on the current plot

               Optional arguments: class clipped columns depth id padding scale
               Corresponding command: draw-color-list(point,dimension,option=...)

       --draw-color-set-list POINT DIMENSION
               Directly draws the list of all color sets on the current plot

               Optional arguments: class clipped depth exclude id include scale
               Corresponding command: draw-color-set-list(point,dimension,option=...)

       --draw-contour LEVEL
               Directly draws contour on the current plot

               Optional arguments: class clipped closed color depth id style width
               Corresponding command: draw-contour(level,option=...)

       --draw-image FILE TOP-LEFT BOTTOM-RIGHT
               Draws  image  on  the current plot, using the given style. For more information on
               the available options, see the define-image-style command.

               Optional arguments: aspect_ratio auto_rotate class clipped depth id transparency
               Corresponding command: draw-image(file,top-left,bottom-right,option=...)

       --draw-legend-pictogram POINT OBJECT
               Draws the legend pictogram for the given curve

               Optional arguments: class clipped depth id width
               Corresponding command: draw-legend-pictogram(point,object,option=...)

       --draw-line POINT POINT
               Draws line on the current plot, using the given style. For more information on the
               available options, see the define-line-style command.

               Optional   arguments:   cap   class  clipped  color  depth  head_angle  head_color
               head_marker  head_scale  id  line_style  line_width  style  tail_angle  tail_color
               tail_marker tail_scale width
               Corresponding command: draw-line(point,point,option=...)

       --draw-line-style-list POINT DIMENSION
               Directly draws the list of all named line styles on the current plot

               Optional arguments: class clipped columns depth id padding scale
               Corresponding command: draw-line-style-list(point,dimension,option=...)

       --draw-marker POINT MARKER
               Draws  marker  on the current plot, using the given style. For more information on
               the available options, see the define-marker-style command.

               Optional  arguments:  alignment  angle  class  clipped  color   depth   fill_color
               horizontal_scale id justification scale stroke_color stroke_width vertical_scale
               Corresponding command: draw-marker(point,marker,option=...)

       --draw-marker-list POINT DIMENSION
               Directly draws the list of all named markers on the current plot

               Optional arguments: class clipped columns depth id padding scale
               Corresponding command: draw-marker-list(point,dimension,option=...)

       --draw-marker-set-list POINT DIMENSION
               Directly draws the list of all marker sets on the current plot

               Optional arguments: class clipped depth exclude id include scale
               Corresponding command: draw-marker-set-list(point,dimension,option=...)

       --draw-oriented-line POINT DIMENSION
               Draws  oriented-line  on  the  current  plot,  using  the  given  style.  For more
               information on the available options, see the define-oriented-line-style command.

               Optional arguments: angle cap class  clipped  color  depth  head_angle  head_color
               head_marker   head_scale   id   origin  style  tail_angle  tail_color  tail_marker
               tail_scale width
               Corresponding command: draw-oriented-line(point,dimension,option=...)

       --draw-string-marker POINT TEXT
               Draws marker on the current plot, using the given style. For more  information  on
               the available options, see the define-marker-style command.

               Optional  arguments:  alignment  angle  class  clipped color depth fill_color font
               horizontal_scale id justification scale stroke_color stroke_width vertical_scale
               Corresponding command: draw-string-marker(point,text,option=...)

       --draw-tangent DATA-POINT
               Draws tangent on the current plot, using the given style. For more information  on
               the available options, see the define-arrow-style command.

               Optional   arguments:   cap   class  clipped  color  depth  head_angle  head_color
               head_marker head_scale id line_style line_width nbavg style tail_angle  tail_color
               tail_marker tail_scale width xextent xfrom xto yextent yfrom yto
               Corresponding command: draw-tangent(data-point,option=...)

       --draw-text POINT TEXT
               Draws text on the current plot, using the given style. For more information on the
               available options, see the define-text-style command.

               Optional arguments: alignment angle class  clipped  color  depth  font  halign  id
               justification position scale shift text_align text_width valign
               Corresponding command: draw-text(point,text,option=...)

   The 'direct' backend: Direct format
       The  commands  in  this  group  drive  the  behaviour  of  the  direct  backend;  see  its
       documentation for more information

       --direct
               Selects the 'direct' backend

               Corresponding command: direct()

   The 'gnuplot' backend: Gnuplot files
       The commands  in  this  group  drive  the  behaviour  of  the  gnuplot  backend;  see  its
       documentation for more information

       --gnuplot
               Selects the 'gnuplot' backend

               Optional arguments: range samples vars
               Corresponding command: gnuplot(,option=...)

       --gnuplot-range RANGE
               The plotting X range, such as 0:2

               Corresponding command: gnuplot-range(range)

       --gnuplot-samples SAMPLES
               The number of samples

               Corresponding command: gnuplot-samples(samples)

       --gnuplot-vars VARS
               A colon-separated override of local variables, such as a=1;b=3;c=5

               Corresponding command: gnuplot-vars(vars)

   The 'math' backend: Mathematical functions
       The  commands in this group drive the behaviour of the math backend; see its documentation
       for more information

       --math  Selects the 'math' backend

               Optional arguments: log samples trange xrange
               Corresponding command: math(,option=...)

       --[no-]math-log
               Space samples logarithmically

               Corresponding command: math-log(log)

       --math-samples SAMPLES
               The number of points

               Corresponding command: math-samples(samples)

       --math-trange TRANGE
               T range (a:b) (parametric plot)

               Corresponding command: math-trange(trange)

       --math-xrange XRANGE
               X range (a:b)

               Corresponding command: math-xrange(xrange)

   The 'smath' backend: Mathematical functions (multi-D)
       The commands in this group drive the behaviour of the smath backend; see its documentation
       for more information

       --smath Selects the 'smath' backend

               Optional arguments: samples urange usamples vrange vsamples
               Corresponding command: smath(,option=...)

       --smath-samples SAMPLES
               Number of samples (default, overriden by variable-specific specs)

               Corresponding command: smath-samples(samples)

       --smath-urange URANGE
               U range (a:b)

               Corresponding command: smath-urange(urange)

       --smath-usamples USAMPLES
               Number of U samples

               Corresponding command: smath-usamples(usamples)

       --smath-vrange VRANGE
               V range (a:b)

               Corresponding command: smath-vrange(vrange)

       --smath-vsamples VSAMPLES
               Number of V samples

               Corresponding command: smath-vsamples(vsamples)

   The 'text' backend: Text format
       The  commands in this group drive the behaviour of the text backend; see its documentation
       for more information

       --csv   Now parse the following data files as CSV. Equivalent to

                 text /separator=/[,;]/
               Corresponding command: csv()

       --text  Selects the 'text' backend

               Optional arguments: col header-line parameters separator skip split
               Corresponding command: text(,option=...)

       --text-col COL
               Which columns to use when the @1:2 syntax is not used

               Corresponding command: text-col(col)

       --text-header-line HEADER-LINE
               Regular expression indicating the header line (containing column  names)  (default
               /^##/

               Corresponding command: text-header-line(header-line)

       --text-parameters PARAMETERS
               Regular  expression  for  extracting  parameters  from a file. Defaults to nil (ie
               nothing)

               Corresponding command: text-parameters(parameters)

       --text-separator SEPARATOR
               The columns separator. Defaults to / +/

               Corresponding command: text-separator(separator)

       --text-skip SKIP
               Number of lines to be skipped at the beginning of the file

               Corresponding command: text-skip(skip)

       --[no-]text-split
               If true, splits files into subsets on blank/non number lines

               Corresponding command: text-split(split)

   LaTeX
       Commands providing control over the LaTeX output (preamble, packages...)

       --preamble TEXT
               Adds the given string to the LaTeX preamble of the output.

               Corresponding command: preamble(text)

       --set-global-font
               Set global font. Sets the size of everything, including  that  of  text  that  has
               already been used.

               Optional arguments: size
               Corresponding command: set-global-font(,option=...)

       --use TEXT
               Adds  a  command to include the LaTeX package into the preamble. The arguments, if
               given, are given within [square backets].

               Optional arguments: arguments
               Corresponding command: use(text,option=...)

       --utf8  Makes ctioga2 use UTF-8 for all text. It is  exactly  equivalent  to  the  command
               preamble with the argument:

                 sepackage[utf8]{inputenc}sepackage[T1]{fontenc}
               Corresponding command: utf8()

   Subplots and assimilated
       Subplots and assimilated

       --end   Leaves the current subobject.

               Corresponding command: end()

       --frame-margins FRAME-MARGINS
               Sets the margins for the current plot. Margins are the same things as the position
               (such as specified for and inset). Using this within  an  inset  or  more  complex
               plots  might  produce  unexpected  results.  The  main  use of this function is to
               control the padding around simple plots.

               The options override the contents of the margin, which makes it easy  to  set  all
               the dimensions to a given value and just override the ones you need to:

                 frame-margins  2mm  /left=1cm  This  sets all the margins around the side to 2mm
               excepted the left one, which means in particular the bottom axis tick labels  will
               be cut.

               Optional arguments: bottom left right top
               Corresponding command: frame-margins(frame-margins,option=...)

       --gradient COLOR COLOR
               All  the  curves  between  this  command and the corresponding end will have their
               color set to a weighted average of the colors given as argument. This gives a neat
               gradient effect.

               Optional arguments: class id
               Corresponding command: gradient(color,color,option=...)

       --hide OBJECTS
               Hides all the named objects in the list. Useful for creating animations.

               Optional arguments: show
               Corresponding command: hide(objects,option=...)

       --inset BOX
               Starts a new inset within the given box.

               If no graph has been started yet, it just creates a new graph using the given box.
               In short, it does what it seems it should.

               Optional arguments: class id
               Corresponding command: inset(box,option=...)

       --next-inset BOX
               Has the same effet as end followed by inset.

               Particularly useful for chaining subgraphs. In that case, you might be  interested
               in the grid box specification and setup-grid.

               Optional arguments: class id
               Corresponding command: next-inset(box,option=...)

       --padding DIMENSION
               When  the frame-margins is set to automatic, ctioga2 leaves that much space around
               the plot on the sides where there are no labels.

               Corresponding command: padding(dimension)

       --plot-scale FLOAT
               Applies a scaling factor to the whole current subplot.  Depending  on  the  'what'
               option (default text), the scale applies to:

                 * text ('text' or 'both')

                 * marker size ('text' or 'both')

                 * line  widths  ('lines'  or 'both') Scaling also applies to all elements of the
                   plot that were added before the call to plot-scale.

               Optional arguments: what
               Corresponding command: plot-scale(float,option=...)

       --region
               The curves up to the corresponding end will be considered for delimiting a colored
               region  between them. The actual position of the curves with respect to the region
               can be fine-tuned using the region-side command (or the  corresponding  option  to
               plot).

               Optional   arguments:  class  color  id  pattern  reversed_color  reversed_pattern
               reversed_transparency transparency
               Corresponding command: region(,option=...)

       --reopen OBJECT
               Reopens a previously finished  container,  such  as  a  subplot,  a  region  or  a
               gradient. Provide the unique name you gave as the /id= option to the first command

               Corresponding command: reopen(object)

       --root-plot
               Begins  the  root plot. This command is only necessary if you want to give styling
               information to the root plot.

               Optional arguments: class id
               Corresponding command: root-plot(,option=...)

       --setup-grid TEXT
               Sets up a grid of the given layout (such as 2x1). After  this  command,  arguments
               such as grid:0,1 can be used as the box argument of inset and next-inset commands.

               Alternatively,  the  layout can be specified as 1,2,1x1,4, in which case there are
               three columns and two rows; the second column is 2 times  larger  than  the  other
               ones, while the second row is four times larger than the first.

               Optional arguments: bottom dx dy left right top
               Corresponding command: setup-grid(text,option=...)

       --text-adjust-mode TEXT-ADJUST-MODE
               When  this  is  on  (the default), ctioga2 tries to be smart about the size of the
               text bits around the plot. However, this can be bothersome at times,  so  you  can
               disable that with this command.

               Corresponding command: text-adjust-mode(text-adjust-mode)

   Axes and labels
       Axes and labels

       --axis-style AXIS
               This  command  can  be used to set various aspects of the style of the given axis,
               through its various options, which are documented in more details in  the  define-
               axis-style command -- excepted for the ticks bit which are documented in the ticks
               command.

               If the option also-axes is specified, the style is  also  applied  to  the  comma-
               separated list of axes it contains.

               Optional     arguments:     also-axes     axis_label_alignment    axis_label_angle
               axis_label_color   axis_label_halign    axis_label_justification    axis_label_loc
               axis_label_position      axis_label_scale     axis_label_shift     axis_label_text
               axis_label_text_align axis_label_text_width axis_label_valign background_lines_cap
               background_lines_color  background_lines_style  background_lines_width  decoration
               line_width  location  log  major_tick_length  major_tick_width   minor_tick_length
               minor_tick_width   offset   stroke_color   tick_label_alignment   tick_label_angle
               tick_label_color  tick_label_halign  tick_label_justification  tick_label_position
               tick_label_scale   tick_label_shift   tick_label_text_align  tick_label_text_width
               tick_label_valign   ticks_format   ticks_format_last   ticks_labels    ticks_major
               ticks_major_delta ticks_major_number ticks_major_sep ticks_minor ticks_minor_delta
               ticks_minor_number ticks_minor_sep_min ticks_side transform
               Corresponding command: axis-style(axis,option=...)

       --background-grid COLOR-OR-FALSE
               Shortcut to set the color for the left and bottom axes

               Optional arguments: cap style width
               Corresponding command: background-grid(color-or-false,option=...)

       --background-lines AXIS COLOR-OR-FALSE
               Sets the color of the background lines for the given axis.

               Optional arguments: cap style width
               Corresponding command: background-lines(axis,color-or-false,option=...)

       --bottom AXIS-DECORATION
               Sets the type of the bottom axis.

               The options have the same meaning as for define-axis-style, see that  command  for
               more information.

               Optional   arguments:   axis_label_alignment   axis_label_angle   axis_label_color
               axis_label_halign  axis_label_justification   axis_label_loc   axis_label_position
               axis_label_scale     axis_label_shift     axis_label_text    axis_label_text_align
               axis_label_text_width            axis_label_valign            background_lines_cap
               background_lines_color  background_lines_style  background_lines_width  line_width
               location log major_tick_length major_tick_width minor_tick_length minor_tick_width
               offset   stroke_color   tick_label_alignment   tick_label_angle   tick_label_color
               tick_label_halign  tick_label_justification  tick_label_position  tick_label_scale
               tick_label_shift   tick_label_text_align  tick_label_text_width  tick_label_valign
               ticks_format   ticks_format_last   ticks_labels   ticks_major    ticks_major_delta
               ticks_major_number       ticks_major_sep       ticks_minor       ticks_minor_delta
               ticks_minor_number ticks_minor_sep_min ticks_side transform
               Corresponding command: bottom(axis-decoration,option=...)

       --clear-axes
               Removes all the axes and their associated labels

               Corresponding command: clear-axes()

       --drawing-frame
               Setup a drawing frame, ie a frame in which the top-left point is at  0,0,  with  X
               and  Y  values  positive over the whole frame, and counted in centimeters (or with
               the unit given using the /units option, ie /units=mm expressed in  millimeters  or
               /units=12pt expressed in multiple of 12 TeX points).

               Optional arguments: units
               Corresponding command: drawing-frame(,option=...)

       --label-style LABEL
               Sets  the  style of the given label (see the type label for more information). See
               define-text-style for detailed information about the meaning of the options.

               The option text permits to also set the text of  the  label  (does  not  work  for
               ticks).

               For tick labels, setting the color option also sets the color for the lines of the
               corresponding axis. If you don't want that, you can override the color  using  the
               stroke-color  option of axis-style. This will only work with Tioga version 1.11 or
               greater.

               Optional arguments: align alignment angle color halign justification loc  position
               scale shift text text_align text_width valign
               Corresponding command: label-style(label,option=...)

       --left AXIS-DECORATION
               Sets the type of the left axis.

               The  options  have the same meaning as for define-axis-style, see that command for
               more information.

               Optional   arguments:   axis_label_alignment   axis_label_angle   axis_label_color
               axis_label_halign   axis_label_justification   axis_label_loc  axis_label_position
               axis_label_scale    axis_label_shift     axis_label_text     axis_label_text_align
               axis_label_text_width            axis_label_valign            background_lines_cap
               background_lines_color  background_lines_style  background_lines_width  line_width
               location log major_tick_length major_tick_width minor_tick_length minor_tick_width
               offset   stroke_color   tick_label_alignment   tick_label_angle   tick_label_color
               tick_label_halign  tick_label_justification  tick_label_position  tick_label_scale
               tick_label_shift  tick_label_text_align  tick_label_text_width   tick_label_valign
               ticks_format    ticks_format_last   ticks_labels   ticks_major   ticks_major_delta
               ticks_major_number       ticks_major_sep       ticks_minor       ticks_minor_delta
               ticks_minor_number ticks_minor_sep_min ticks_side transform
               Corresponding command: left(axis-decoration,option=...)

       --new-zaxis TEXT
               Creates a named Z axis that can display information from Z color maps

               Optional   arguments:   axis_label_alignment   axis_label_angle   axis_label_color
               axis_label_halign  axis_label_justification   axis_label_loc   axis_label_position
               axis_label_scale     axis_label_shift     axis_label_text    axis_label_text_align
               axis_label_text_width            axis_label_valign            background_lines_cap
               background_lines_color   background_lines_style  background_lines_width  bar_shift
               bar_size bounds class decoration  id  line_width  location  log  major_tick_length
               major_tick_width  minor_tick_length  minor_tick_width  offset padding stroke_color
               tick_label_alignment    tick_label_angle    tick_label_color     tick_label_halign
               tick_label_justification   tick_label_position  tick_label_scale  tick_label_shift
               tick_label_text_align   tick_label_text_width    tick_label_valign    ticks_format
               ticks_format_last  ticks_labels  ticks_major  ticks_major_delta ticks_major_number
               ticks_major_sep       ticks_minor       ticks_minor_delta       ticks_minor_number
               ticks_minor_sep_min ticks_side transform
               Corresponding command: new-zaxis(text,option=...)

       --no-title
               Removes the title of the current plot.

               Corresponding command: no-title()

       --no-xlabel
               Removes the X label for the current plot.

               Corresponding command: no-xlabel()

       --no-ylabel
               Removes the Y label for the current plot.

               Corresponding command: no-ylabel()

       --right AXIS-DECORATION
               Sets the type of the right axis.

               The  options  have the same meaning as for define-axis-style, see that command for
               more information.

               Optional   arguments:   axis_label_alignment   axis_label_angle   axis_label_color
               axis_label_halign   axis_label_justification   axis_label_loc  axis_label_position
               axis_label_scale    axis_label_shift     axis_label_text     axis_label_text_align
               axis_label_text_width            axis_label_valign            background_lines_cap
               background_lines_color  background_lines_style  background_lines_width  line_width
               location log major_tick_length major_tick_width minor_tick_length minor_tick_width
               offset   stroke_color   tick_label_alignment   tick_label_angle   tick_label_color
               tick_label_halign  tick_label_justification  tick_label_position  tick_label_scale
               tick_label_shift  tick_label_text_align  tick_label_text_width   tick_label_valign
               ticks_format    ticks_format_last   ticks_labels   ticks_major   ticks_major_delta
               ticks_major_number       ticks_major_sep       ticks_minor       ticks_minor_delta
               ticks_minor_number ticks_minor_sep_min ticks_side transform
               Corresponding command: right(axis-decoration,option=...)

       --ticks AXIS
               This  command can be used to control the location of major and minor ticks and the
               text of their labels for the given axis. Options available:

                 * format the format of the tick labels,  using  a  sprintf-like     syntax  (see
                   below)

                 * format-last the format of the last of the tick labels (useful to    include an
                   overall "power-of-ten" factor

                 * major a space or  comma-separated  list  of  the  positions  of  the     major
                   (labeled) ticks

                 * minor same for the minor ticks

                 * label a comma-separated list of the tick labels (must be the same    number of
                   elements as that of the major list). If you must    include  a  comma  inside,
                   then use || as a separator.

               Format is a normal sprintf format, with the following additional special codes:

                 * %p  the  "common  power  of 10": if you divide the tick values by 10    to the
                   power %p, the smallest absolute value will be between 1    and 10 (excluding 0
                   of course)

                 * %b...  is  the  tick  value  divided by this common power of 10. You    *must*
                   follow this spec by a usual sprintf format: %b.3g would    get  you  a  number
                   with 3 significant digits

               Optional  arguments:  format  format_last  labels  major  major_delta major_number
               major_sep minor minor_delta minor_number minor_sep_min
               Corresponding command: ticks(axis,option=...)

       -t, --title TEXT
               Sets the title of the current plot.

               Optional arguments: align alignment angle color halign justification loc  position
               scale shift text_align text_width valign
               Corresponding command: title(text,option=...)

       --top AXIS-DECORATION
               Sets the type of the top axis.

               The  options  have the same meaning as for define-axis-style, see that command for
               more information.

               Optional   arguments:   axis_label_alignment   axis_label_angle   axis_label_color
               axis_label_halign   axis_label_justification   axis_label_loc  axis_label_position
               axis_label_scale    axis_label_shift     axis_label_text     axis_label_text_align
               axis_label_text_width            axis_label_valign            background_lines_cap
               background_lines_color  background_lines_style  background_lines_width  line_width
               location log major_tick_length major_tick_width minor_tick_length minor_tick_width
               offset   stroke_color   tick_label_alignment   tick_label_angle   tick_label_color
               tick_label_halign  tick_label_justification  tick_label_position  tick_label_scale
               tick_label_shift  tick_label_text_align  tick_label_text_width   tick_label_valign
               ticks_format    ticks_format_last   ticks_labels   ticks_major   ticks_major_delta
               ticks_major_number       ticks_major_sep       ticks_minor       ticks_minor_delta
               ticks_minor_number ticks_minor_sep_min ticks_side transform
               Corresponding command: top(axis-decoration,option=...)

       --x2    Switches  to using the top axis for X axis for the subsequent curves, and turns on
               full decoration for the right axis. Shortcut for:

                 xaxis top
                 axis-style top /decoration=full
               Corresponding command: x2()

       --xaxis AXIS
               Sets the default axis for the X axis for all  subsequent  commands  take  rely  on
               default axes (such as plot, xrange, yrange...).

               Corresponding command: xaxis(axis)

       -x, --xlabel TEXT
               Sets the X label of the current plot.

               Optional  arguments: align alignment angle color halign justification loc position
               scale shift text_align text_width valign
               Corresponding command: xlabel(text,option=...)

       --y2    Switches to using the right axis for Y axis for the subsequent curves,  and  turns
               on full decoration for the right axis. Shortcut for:

                 yaxis right
                 axis-style right /decoration=full
               Corresponding command: y2()

       --yaxis AXIS
               Sets  the  default  axis  for  the Y axis for all subsequent commands take rely on
               default axes (such as plot, xrange, yrange...).

               Corresponding command: yaxis(axis)

       -y, --ylabel TEXT
               Sets the Y label of the current plot.

               Optional arguments: align alignment angle color halign justification loc  position
               scale shift text_align text_width valign
               Corresponding command: ylabel(text,option=...)

   Background
       Commands  dealing with the aspect of the background of a plot (excluding background lines,
       which are linked to axes).

       --background COLOR-OR-FALSE
               Sets the background color for the current (and subsequent?) plot.

               Corresponding command: background(color-or-false)

       --watermark TEXT
               Sets a watermark for the background of the current plot.

               Optional  arguments:  alignment  angle  color  fill_color  font   horizontal_scale
               justification scale stroke_color stroke_width vertical_scale
               Corresponding command: watermark(text,option=...)

   Default styles
       Commands for defining default styles.

       All  commands  take  the  selector  of the style to be defined. It is a CSS-like selector,
       relying on #id and .class, and using #parentality. Therefore, defining a style for .insets
       #stuff  will  define  it  for  an  object  named stuff, but only if it is contained within
       another one that has a .insets class.

       ctioga2 does not support changing a style after its use. It may affect only the  following
       objects  or  all  the ones that were created from the beginning, depending on the context.
       For safety, only define style before issueing any graphics command.

       --define-arrow-style TEXT
               Sets the default style for arrows. All arrow styles descend from the  base  style.
               Use  a  style different than base by passing its name as the /base-style option to
               the draw-arrow command.

               Meaning of the style parameters:

                 * color, style and width: same as in define-line-style

                 * head-marker, tail-marker: a marker to be used for the head    or for the tail

                 * head-scale, tail-scale: scale of the head or tail markers

                 * head-angle, tail-angle: rotate the head or the tail by that many    degrees

                 * head-color, tail-color: the color of the head or tail

               Optional arguments: cap color head_angle head_color head_marker  head_scale  style
               tail_angle tail_color tail_marker tail_scale width
               Corresponding command: define-arrow-style(text,option=...)

       --define-axis-style TEXT
               Sets  the  style  for  a  whole axis. All axis styles descend from the base style.
               Horizontal and vertical axis styles descend from the x  and  y  styles,  and  plot
               sides are styled with the left, right, top and bottom styles.

               Axis styles have lots of parameters:

                 * axis-label-  and  tick-label-  parameters  are title style parameters    whose
                   meaning is given in define-title-style, that affect    ticks and axis labels

                 * decoration: a axis-decoration that specify which ticks and    tick  labels  to
                   draw

                 * background-lines-  parameters  define  the style of background lines,    as in
                   define-line-style

               Optional   arguments:   axis_label_alignment   axis_label_angle   axis_label_color
               axis_label_halign   axis_label_justification   axis_label_loc  axis_label_position
               axis_label_scale    axis_label_shift     axis_label_text     axis_label_text_align
               axis_label_text_width            axis_label_valign            background_lines_cap
               background_lines_color  background_lines_style  background_lines_width  decoration
               line_width   location  log  major_tick_length  major_tick_width  minor_tick_length
               minor_tick_width   offset   stroke_color   tick_label_alignment   tick_label_angle
               tick_label_color  tick_label_halign  tick_label_justification  tick_label_position
               tick_label_scale  tick_label_shift   tick_label_text_align   tick_label_text_width
               tick_label_valign    ticks_format   ticks_format_last   ticks_labels   ticks_major
               ticks_major_delta ticks_major_number ticks_major_sep ticks_minor ticks_minor_delta
               ticks_minor_number ticks_minor_sep_min ticks_side transform
               Corresponding command: define-axis-style(text,option=...)

       --define-background-style TEXT
               Sets  the  style  for plot background. All background styles descend from the base
               style. In addition, the  background  of  a  plot  is  change  by  the  style  name
               background.

               Meaning of the style parameters:

                 * watermark: the text of the watermark

                 * all watermark_ styles have the same meaning as in    define-text-style, as the
                   watermark is a string marker

                 * background_color: the color of the background

               Optional arguments: background_color watermark watermark_alignment watermark_angle
               watermark_color   watermark_fill_color  watermark_font  watermark_horizontal_scale
               watermark_justification           watermark_scale           watermark_stroke_color
               watermark_stroke_width watermark_vertical_scale
               Corresponding command: define-background-style(text,option=...)

       --define-box-style TEXT
               Sets  the default style for boxes. All box styles descend from the base style. Use
               a style different than base by passing its name as the /base-style option  to  the
               draw-box command.

               Meaning of the style parameters:

                 * color, style and width: same as in define-line-style

                 * fill-color: fill color for the box

                 * fill-transparency: the transparency for the fill, from 0 to 1

               Optional  arguments:  cap  color  fill_color fill_pattern fill_transparency radius
               shape style width
               Corresponding command: define-box-style(text,option=...)

       --define-curve-style TEXT
               Sets the default style for the named plot background.

               Optional arguments: clipped color  color_map  contour_conrec  contour_minor_number
               contour_minor_scale    contour_minor_style    contour_minor_width   contour_number
               contour_use_naturals depth error_bar_color error_bar_line_cap error_bar_line_color
               error_bar_line_style    error_bar_line_width   fill   fill_close_type   fill_color
               fill_pattern fill_transparency legend line_cap  line_color  line_style  line_width
               location_xaxis  location_yaxis  marker  marker_angle marker_color marker_color_map
               marker_fill_color  marker_fill_color_map  marker_line_color  marker_line_color_map
               marker_line_width    marker_marker    marker_min_scale   marker_scale   path_style
               region_position split_on_nan zaxis
               Corresponding command: define-curve-style(text,option=...)

       --define-image-style TEXT
               Sets the default style for the named image.

               Optional arguments: aspect_ratio auto_rotate transparency
               Corresponding command: define-image-style(text,option=...)

       --define-legend-style TEXT
               Sets the style for legends.

               Optional arguments: dy frame_cap frame_color  frame_fill_color  frame_fill_pattern
               frame_fill_transparency   frame_padding   frame_radius   frame_shape   frame_style
               frame_width picto_height picto_to_text picto_width scale  symbol_scale  text_scale
               vpadding
               Corresponding command: define-legend-style(text,option=...)

       --define-line-style TEXT
               Sets the default style for lines. All line styles descend from the base style. Use
               a style different than base by passing its name as the /base-style option  to  the
               draw-line command.

               Meaning of the style parameters:

                 * color: the color of the line, see color

                 * style: the line style, see line-style

                 * width: the line width (in points)

                 --define-line-style * /color=Pink makes all lines  pink (unless overriden by the
               /color option to draw-line), while

                 --define-line-style .pink /color=Pink only affect those to which the /class=pink
               style option was given.

               Optional arguments: cap color style width
               Corresponding command: define-line-style(text,option=...)

       --define-marker-style TEXT
               Sets the style for marker and marker strings.  All marker and marker string styles
               descend from the base style. Use a style different than base by passing  its  name
               as the /base-style option to the draw-marker or draw-string-marker commands.

               Meaning of the style parameters:

                 * alignment, justification, angle, color and scale:    as in define-text-style

                 * fill-color  and  stroke_color: markers are both stroked and filled,    you can
                   control all colors in one go using color or specifying each    with fill-color
                   and stroke_color

                 * font: is a PDF font number (from 1 to 14), only used for marker    strings

                 * horizontal-scale,  vertical-scale:  scales  the marker only    horizontally or
                   vertically

               Optional  arguments:  alignment  angle  color  fill_color  font   horizontal_scale
               justification scale stroke_color stroke_width vertical_scale
               Corresponding command: define-marker-style(text,option=...)

       --define-oriented-line-style TEXT
               Sets the default style for the named oriented lines.

               Optional  arguments:  angle cap color head_angle head_color head_marker head_scale
               origin style tail_angle tail_color tail_marker tail_scale width
               Corresponding command: define-oriented-line-style(text,option=...)

       --define-style TEXT

               Optional arguments: alignment angle aspect_ratio auto_rotate  axis_label_alignment
               axis_label_angle   axis_label_color   axis_label_halign   axis_label_justification
               axis_label_loc     axis_label_position      axis_label_scale      axis_label_shift
               axis_label_text   axis_label_text_align   axis_label_text_width  axis_label_valign
               background_color            background_lines_cap            background_lines_color
               background_lines_style   background_lines_width   cap   clipped   color  color_map
               contour_conrec   contour_minor_number   contour_minor_scale    contour_minor_style
               contour_minor_width   contour_number   contour_use_naturals  decoration  depth  dy
               error_bar_color   error_bar_line_cap   error_bar_line_color   error_bar_line_style
               error_bar_line_width      fill     fill_close_type     fill_color     fill_pattern
               fill_transparency font frame_cap frame_color  frame_fill_color  frame_fill_pattern
               frame_fill_transparency   frame_padding   frame_radius   frame_shape   frame_style
               frame_width halign head_angle head_color head_marker  head_scale  horizontal_scale
               justification  legend  line_cap  line_color  line_style  line_width  loc  location
               location_xaxis  location_yaxis  log  major_tick_length   major_tick_width   marker
               marker_angle marker_color marker_color_map marker_fill_color marker_fill_color_map
               marker_line_color    marker_line_color_map     marker_line_width     marker_marker
               marker_min_scale  marker_scale  minor_tick_length  minor_tick_width  offset origin
               path_style picto_height picto_to_text picto_width position radius  region_position
               scale  shape  shift  split_on_nan  stroke_color  stroke_width  style  symbol_scale
               tail_angle tail_color tail_marker tail_scale text text_align text_scale text_width
               tick_label_alignment     tick_label_angle    tick_label_color    tick_label_halign
               tick_label_justification  tick_label_position  tick_label_scale   tick_label_shift
               tick_label_text_align    tick_label_text_width    tick_label_valign   ticks_format
               ticks_format_last ticks_labels  ticks_major  ticks_major_delta  ticks_major_number
               ticks_major_sep       ticks_minor       ticks_minor_delta       ticks_minor_number
               ticks_minor_sep_min  ticks_side  transform  transparency   valign   vertical_scale
               vpadding    watermark    watermark_alignment    watermark_angle    watermark_color
               watermark_fill_color           watermark_font           watermark_horizontal_scale
               watermark_justification           watermark_scale           watermark_stroke_color
               watermark_stroke_width watermark_vertical_scale width zaxis
               Corresponding command: define-style(text,option=...)

       --define-text-style TEXT
               Sets the default style for texts. All text styles descend from the base style. Use
               a  style  different than base by passing its name as the /base-style option to the
               draw-text command.

               Meaning of the style parameters:

                 * alignment: vertical alignment

                 * justification: horizontal alignment

                 * angle: angle in degrees to the horizontal (or default orientation  in     some
                   cases)

                 * color: text color

                 * scale: text scale

               Optional  arguments:  alignment  angle  color  halign justification position scale
               shift text_align text_width valign
               Corresponding command: define-text-style(text,option=...)

       --define-title-style TEXT
               Sets the style for title. All  title  styles  descend  from  the  base  style.  In
               addition, the title of a plot is addressed by the style name title.

               Meaning of the style parameters:

                 * alignment, justification, angle, color and scale:    as in define-text-style

                 * text: sets the title text

                 * loc: the side on which to display the title, a location

                 * shift:  the  distance  away  from  the  plot  in  text  size units    (maybe a
                   dimension should be better later)

                 * position: shift from the center (parallel to the plot side)

               Optional arguments: alignment angle color halign justification loc position  scale
               shift text text_align text_width valign
               Corresponding command: define-title-style(text,option=...)

       --load-style FILE

               Corresponding command: load-style(file)

   Output setup
       Commands in this group deal with various aspects of the production of output files:

         * output file location

         * post-processing (including automatic display)

         * cleanup...

       --[no-]clean
               When  this is on (the default), ctioga2 automatically cleans up intermediate files
               produced by Tioga. When LaTeX fails, it can be useful to have  a  closer  look  at
               them, so disable it to be able to look into them.

               Corresponding command: clean(boolean)

       --[no-]cleanup-pdf
               If  this is on, then ctioga2 uses ghostscript to cleanup the PDF file produced. It
               is on by default is ctioga2 is able to find the gs executable.

               Corresponding command: cleanup-pdf(boolean)

       --dependencies FILE
               Saves the dependencies as a Makefike into the given file name.

               Corresponding command: dependencies(file)

       --[no-]eps
               When this feature is on, all produced PDF files are converted  to  EPS  using  the
               pdftops program (from the xpdf tools suite).

               Corresponding command: eps(boolean)

       --[no-]mark
               When  this  feature  is on (which is the default, as it comes in very useful), the
               'title' field of the PDF informations is set to the command-line that resulted  in
               the PDF file. Disable it if you don't want any information to leak.

               Please  note that this will not log the values of the CTIOGA2_PRE and CTIOGA2_POST
               variables, so you might still get a different output if  you  make  heavy  use  of
               those.

               Corresponding command: mark(boolean)

       -n, --name FIGURE_NAME
               Sets the name of the figure, which is also the base name for the output file. This
               has nothing to do with the title of the plot, which can be set using  the  command
               title.

               If the name contains a %, it is interpreted by ctioga2 as a printf-like format. It
               will attempt to find  the  first  file  that  does  not  exist,  feeding  it  with
               increasing numbers.

               The  default  value  is  now  Plot-%03d, which means you'll get increasing numbers
               automatically.

               Corresponding command: name(figure name)

       --open  Uses open (available on MacOS) to view the PDF files produced by ctioga2.

               Corresponding command: open()

       -o, --output FIGURE_NAME
               Writes a figure with the given name (see name) and keeps the current  state.  This
               can be used to create an animation.

               Corresponding command: output-now(figure name)

       --output-and-reset
               Writes  the  current  figure and starts a fresh one. All non-graphical information
               are kept (curves loaded, figure names, preamble, and so on).

               Corresponding command: output-and-reset()

       -O, --output-directory TEXT
               Sets the directory to which files  will  be  plot.  It  defaults  to  the  current
               directory.

               Corresponding command: output-directory(text)

       -r, --page-size TEXT
               Sets  the  size of the output PDF file, in real units. Takes arguments in the form
               of 12cm x 3in (spaces can be omitted).

               Optional arguments: count-legend
               Corresponding command: page-size(text,option=...)

       --png RESOLUTION
               Turns all produced PDF files  into  PNG  images  of  the  given  resolution  using
               convert.  This  also has for effect to set the page-size to the resolution divided
               by the 'scale' option in Postscript points. By default, 2 pixels are rendered  for
               1  final  to  produce a nicely antialiased image. Use the 'oversampling' option to
               change that, in case the output looks too  pixelized.  This  option  only  affects
               conversion time.

               Optional arguments: oversampling pdftoppm scale
               Corresponding command: png(resolution,option=...)

       --resolution FLOAT
               By  default,  ctioga2  has  a resolution of 1/100th of a postscript point. This is
               clearly enough for most tasks, but  you  can  increase  it  should  you  need,  or
               decrease it to generate possibly a little more jaggy but less large PDF files.

               The number given is the number of output points per postscript point.

               Better change that at the beginning of the plot.

               Corresponding command: resolution(float)

       --[no-]svg
               When  this  feature  is  on, all produced PDF files are converted to SVG using the
               neat pdf2svg program.

               Corresponding command: svg(boolean)

       --viewer TEXT
               Sets the command for viewing the PDF file after ctioga2 has been run.

               Corresponding command: viewer(text)

       -X, --xpdf
               Uses xpdf to view the PDF files produced by ctioga2.

               If xpdf is not found, then it tries to guess which viewers are available:

                 * on windows, it uses the system file associations to open the PDF file

                 * on mac, it uses the open command

                 * on linux, it  tries,  mime-open,  and  if  that  is  missing,  falls  back  to
                   commonly available PDF viewers.

               Corresponding command: xpdf()

   Data stack manipulation
       Commands for manipulation of the data stack

       --append DATASET
               Use  the  current  backend  to  load  the  given dataset(s) and append to the last
               dataset on the stack (without creating a new dataset). Roughly the  equivalent  of
               first running load and then join-datasets.

               Optional arguments: as ignore_hooks where
               Corresponding command: append(dataset,option=...)

       --apply-formula TEXT
               Applies a formula to the last dataset (or the named one)

               Optional arguments: name which
               Corresponding command: apply-formula(text,option=...)

       --bin   This  command  bins the contents of the Y column of the last dataset on the stack,
               and pushes the results as a new dataset.

               Optional arguments: column delta max min name normalize number which
               Corresponding command: bin(,option=...)

       --compute-contour FLOAT
               Computes the contour at the given level for the given dataset (or the last on  the
               stack if none is specified) and pushes it onto the data stack.

               You can further manipulate it as usual.

               Optional arguments: which
               Corresponding command: compute-contour(float,option=...)

       --dataset-hook COMMANDS
               The  dataset  hook is a series of commands such as those in the command files that
               are run every time after a dataset is added onto the data stack. Its main  use  is
               to  provide automatic filtering of data, but any arbitrary command can be used, so
               enjoy !

               Corresponding command: dataset-hook(commands)

       --dataset-hook-add COMMANDS
               Adds the given commands to the dataset hook. See dataset-hook for more information
               about the dataset hook.

               Corresponding command: dataset-hook-add(commands)

       --dataset-hook-clear
               Clears the dataset hook. See dataset-hook for more information.

               Corresponding command: dataset-hook-clear()

       --drop STORED-DATASET
               Removes the given dataset from the stack.

               Can become useful when dealing with large datasets, some of which are only used as
               intermediates for apply-formula or compute-contour, for instance.

               Corresponding command: drop(stored-dataset)

       -j, --join-datasets
               Pops the last two (or number,  if  it  is  specified)  datasets  from  the  stack,
               concatenates  them (older last) and push them back onto the stack. The name option
               can be used to give a name to the new dataset.

               Optional arguments: name number which
               Corresponding command: join-datasets(,option=...)

       -L, --load DATASET
               Use the current backend to load the given dataset(s) onto the data stack.

               If the name option is  given,  the  last  dataset  loaded  this  way  (if  dataset
               expansion occurs) gets named, or, if it contains a %d (or similar construct), each
               dataset gets named with %d replace with the  number  of  the  dataset  within  the
               expansion  (starting  at  0).  This  name  can  be used to further use the dataset
               without remembering its number. See the type stored-dataset for more information.

               Optional arguments: as ignore_hooks name where
               Corresponding command: load(dataset,option=...)

       --make-contour FLOAT

               Optional arguments: as ignore_hooks name where which
               Corresponding command: make-contour(float,option=...)

       --merge-datasets
               This commands merges data with matching X values from a dataset  (by  default  the
               one  before  the last) into the last one. Data points that have no corresponding X
               value in the current  dataset  are  simply  ignored.  If  the  columns  option  is
               provided,  the  numbered  columns  are use instead of the X columns (X is 1). More
               than one column can be provided this way, in which case *all* values must match.

               This can be used to build 3D datasets for xyz-map or xy-parametric.

               Optional arguments: columns number precision which
               Corresponding command: merge-datasets(,option=...)

       -P, --print-dataset
               Prints to standard output data contained in  the  last  dataset  pushed  onto  the
               stack, or the given stored dataset if the which option is given.

               Optional arguments: save which
               Corresponding command: print-dataset(,option=...)

       --show-stack
               Displays the current contents of the dataset stack.

               Mostly  used  for  debugging  when operations like merge-datasets or join-datasets
               don't work as expected.

               Corresponding command: show-stack()

       --xy-reglin

               This command will get documented some day.

               Optional arguments: linear which
               Corresponding command: xy-reglin(,option=...)

   Introspection
       Commands  displaying  information  about  the  internals  of  ctioga2,   such   as   known
       types/commands/backends...

       --edit-command TEXT
               Edit the given command in an editor. It will only work from the top directory of a
               ctioga2 source tree.

               Optional arguments: doc
               Corresponding command: edit-command(text,option=...)

       --edit-group TEXT
               Edit the given group in an editor. It will only work from the top directory  of  a
               ctioga2 source tree.

               Corresponding command: edit-group(text)

       --edit-type TEXT
               Edit  the  given  type in an editor. It will only work from the top directory of a
               ctioga2 source tree.

               Corresponding command: edit-type(text)

       --list-commands
               List all commands known to ctioga2

               Optional arguments: format raw
               Corresponding command: list-commands(,option=...)

       --list-groups
               List all command groups known to ctioga2

               Optional arguments: raw
               Corresponding command: list-groups(,option=...)

       --list-styles
               Lists all available color sets, marker sets and the like.

               Optional arguments: raw
               Corresponding command: list-styles(,option=...)

       --list-types
               List all types known to ctioga2

               Optional arguments: raw
               Corresponding command: list-types(,option=...)

       --version-raw
               Prints the raw version number, without any other decoration and newline.

               Corresponding command: version-raw()

   Filters
       The commands in this group act upon the last dataset pushed unto the data stack: they  can
       be viewed as filters.

       --avg-dup
               Install  the  avg-dup-last  command  as  a  dataset  hook  (see dataset-hook): all
               datasets acquired after this is  on  will  be  averaged  if  they  have  identical
               successive values of X.

               Corresponding command: avg-dup()

       --avg-dup-last
               Averages  successive  points with identical X values. This algorithm is naive with
               respect to the min/max values and averages them just as well,  whereas  one  might
               expect something more clever.

               To  average  over  all  X  values when they are not successive in the dataset, you
               should use sort-last first.

               Optional arguments: mode
               Corresponding command: avg-dup-last(,option=...)

       --cherry-pick TEXT
               Install the cherry-pick-last command as a dataset  hook  (see  dataset-hook):  all
               points  for  which  the  formula  returns  false  for  subsequent datasets will be
               removed.

               Corresponding command: cherry-pick(text)

       --cherry-pick-last TEXT
               Removes the data from the last dataset in the data stack  for  which  the  formula
               returns false.

               See also the cherry-pick command to apply the selection to all datasets.

               You  might  find  it  much  easier  to  use  the /where option of the plot or load
               commands.

               Corresponding command: cherry-pick-last(text)

       --smooth INTEGER
               Install the smooth-last command as a dataset hook (see dataset-hook): from now on,
               the datasets are all smoothed

               Corresponding command: smooth(integer)

       --smooth-last INTEGER
               Smooth  the  data  using a simple (naive even) gaussian filter. Good for producing
               'lines to guide the eye'

               Corresponding command: smooth-last(integer)

       --sort  Install the sort-last command as a dataset hook (see dataset-hook): all subsequent
               datasets will be sorted according to their X values.

               Corresponding command: sort()

       --sort-last
               Sorts the last dataset pushed unto the stack according to X values. Can be used as
               a filter.

               This command sorts in-place.

               See also sort.

               Corresponding command: sort-last()

       --trim INTEGER
               Install the trim-last command as a dataset hook (see dataset-hook): all subsequent
               datasets will be trimmed to keep only every n point.

               Corresponding command: trim(integer)

       --trim-last INTEGER
               Only  keeps one every ? data point on the last dataset pushed unto the data stack.
               Useful when data have too many points to avoid creating heavy PDF files that  take
               ages to display with no additional benefits.

               This operation is very crude and does not average data.

               See also trim.

               Corresponding command: trim-last(integer)

   General commands
       General scope commands

       --debug With  this  on,  ctioga2 writes a whole lot of debugging information. You probably
               will not need that unless you intend to file a bug report or to tackle  a  problem
               yourself.

               Be  warned  that  it *will* slow down very significantly the processing of ctioga2
               (up to hundreds of times slower), especially if you are not redirecting the output
               to a file.

               Corresponding command: debug()

       --echo  Writes the whole command-line used to standard error, quoted in such a way that it
               should be usable directly for copy/paste.

               Corresponding command: echo()

       -e, --eval COMMANDS
               Runs the given strings as commands, as if given from a command file.

               Corresponding command: eval(commands)

       -f, --file FILE
               Reads the file and runs commands found in them, using the ctioga language.

                 ctioga2 -f my_file.ct2 If the /log is on, then all messages  are  written  to  a
               -log.txt file instead of to the terminal.

               Optional arguments: log
               Corresponding command: include(file,option=...)

       -h, --help
               Prints  helps  about  short  and long options available when run from the command-
               line.

               Optional arguments: pager
               Corresponding command: command-line-help(,option=...)

       --help-on TEXT
               Prints help about the given command

               Corresponding command: help-on(text)

       --[no-]pause
               When this is on, the program will ask  for  confirmation  before  finishing,  when
               errors  or warnings have been shown. This is especially useful on windows or other
               environments where the terminal shuts down as soon as ctioga2 has finished.

               Corresponding command: pause(boolean)

       --print-instructions
               Writes the list of all the instructions run so far.

               This is not very helpful for now, possibly.

               Corresponding command: print-instructions()

       --ruby-run FILE
               Reads the file and runs the Ruby code found inside, a bit like Ruby would do  with
               the  require  command, excepted that ctioga2 does not follow Ruby's file searching
               rules: you have to specify the full path.

               Corresponding command: ruby-run(file)

       --set TEXT TEXT
               Sets the value of the variable (first argument) to the given second  argument.  No
               parsing is done.

               Corresponding command: set(text,text)

       -v, --verbose
               With this on, ctioga2 outputs quite a fair amount of informative messages.

               Corresponding command: verbose()

       -V, --version
               Prints the version of ctioga in use

               Corresponding command: version()

TYPES

       Most  of  the  commands accept one or more arguments, which have different types. Here are
       the meanings of those types.

       aligned-point
               A point together with alignment specifications, used to place some  elements  such
               as legends for instance, that require alignment information.

               The first two letters represent the alignment:

                 * t for top

                 * b for bottom

                 * c for center

                 * l for left and

                 * r for right

               These  letters  can  optionally  be followed by the exact location of the point in
               frame coordinates. If not provided, a reasonable default value is chosen.

               Examples:

                 * tl is a point at the top left of the frame aligned to the top    and left;

                 * cl:0.1,0.6 is vertically centered and aligned to the left,  and     positioned
                   10% from the left and 60% from the bottom.

       alignment
               Vertical aligment for text. Can be one of:

                 * t or top

                 * c, center, m or midheight (vertically centered)

                 * B, Baseline or baseline to align at the baseline

                 * b or bottom

       aspect-ratio
               How the draw-image command respects the original image aspect ratio:

                 * ignore (the default) ignores the original aspect ratio

                 * expand expand the original box to respect aspect ratio

                 * contract contract the original box to respect aspect ratio

       average-mode
               How the avg-dup-last command :

                 * naive  or  average (the default) treats all columns (values and    error bars)
                   the same way, and average everythin

                 * stddev ignores the original errors, and sets the new errors to the    standard
                   deviation of the values

       axis    The name of the axis of a plot. It can be:

                 * left, top, bottom or right;

                 * x,  xaxis,  y,  yaxis,  which  return  one  of  the  above depending    on the
                   preferences of the current plot (see xaxis and    yaxis to change them);

                 * one of the named axes, such as the ones created by    new-zaxis.

       axis-decoration
               Kinds of decoration on a axis line, such as nothing, lines,  ticks,  tick  labels.
               Possible values:

                 * hidden, off, no, none: no axis at all

                 * line: only a line

                 * ticks: only ticks

                 * major: only major ticks

                 * major-num: major ticks along with their labels

                 * full: major ticks and labels + minor ticks

       axis-or-auto
               Same thing as axis, or auto to let the style factory handle automatically.

       bijection
               A  pair  of  functions  of  x specifying a bidirectional coordinate transformation
               separated by a double colon (::), in the order from::to.

               Each of the functions must be valid Ruby code - it  is  not  exactly  mathematical
               functions,  in  particular  Ruby  does not like floats which are missing digits on
               either side of the dot : for instance, .3 and 1. are not valid. Sorry.

               In most of the usual cases, the coordinate transform is  an  involution,  that  is
               from and to is the same function (this is the case for a/x). In this case, you can
               omit the second function.

       boolean Yes or no.

       boolean-or-auto
               Same thing as boolean, or auto to let the style factory handle automatically.

       box     The specification for a box, such as an inset. It can  be  a  grid  specification,
               such  as  grid:0,1. For this to work, a grid must have been setup beforehand using
               setup-grid.

               It can also be an aligned-point together with a width and optionally a  height  in
               frame coordinates, such as:

                 * cc:0.3: a box in the center of size 30% width and 30% height;

                 * bl:0.1,0.2:0.7,0.2  a  box starting from the point at 10% from the left    and
                   20% from the bottom, with a width of 70% and a height of 20%.

       box-shape
               The shape of a box. It can be:

                 * square for a plain square box

                 * round for a rounded box

       color   A color. It can take three forms:

                 * a                     named                     color,                     see
                   http://tioga.rubyforge.org/doc/classes/Tioga/ColorConstants.html  for the list
                   of color names.

                 * an HTML color: for instance, #f00 or #ff0000 is red;

                 * a list of three numbers between 0 and 1: 1,0,0 is red too.

       color-or-auto
               Same thing as color, or auto to let the style factory handle automatically.

       color-or-false
               A color, or none to say that nothing should be drawn.

       color-or-false-or-auto
               Same  thing  as  color-or-false,  or  auto  to  let  the  style   factory   handle
               automatically.

       color-or-false-set
               Sets of color-or-false

       color-set
               Sets of color

       colormap
               A  Z  color  map.  It  takes  the  form  Color1--Color2--Color3.... All colors can
               optionally be followed by a number. For instance, for Red--Blue--Pink--Green,  the
               colors  are  evenly spaced. In the case Red--Blue(0.1)--Pink(0.2)--Green, the Blue
               to Pink strech is located between Z values 0.1 and 0.2.

               If a prefix hls: or wheel: is present, then linear interpolation is  done  in  the
               HLS colorspace instead of the RGB one (the default).

               If  a  suffix  :sym:_value_ is present, then the colormap is symmetric around that
               value.

               It is also possible to directly use a color-set, in which case eveything works  as
               if the colors of the color-set had been given directly, without Z values.

       colormap-or-auto
               Same thing as colormap, or auto to let the style factory handle automatically.

       commands
               ctioga2 commands, such as the ones that could be found in command files.

       compute-dx
               This controls how the histograms treats unevenly spaced X values:

                 * none: ignores the problem, and treats the points as if they were all    evenly
                   spaced

                 * min, mindx: considers  that  all  slots  have  the  size  of  the     smallest
                   variation of X values

       cumulative-histograms
               How to specify that histograms should be stacked. Can be:

                 * a  positive number, in which case the following histograms    will be added to
                   the numbered one (0 is the first)

                 * no/false, in which case the following histograms are not stacked

                 * next, in which case the following histograms get stacked on a new slot

       data-point
               A point from an already-loaded Dataset. You have two ways to choose the point:

                 * @13 takes the 13th point in the last dataset;

                 * 0.2 takes the point the closest to 20% of the dataset.

               If you need another dataset than the last one, give its  number  or  named  within
               brackets: {-2}0.2 is the point closest to the 20% of the one-before-last dataset.

       dataset One expandable dataset.

       dimension
               A  dimension, in absolute units, or in units of text height, figure, frame or page
               coordinates. It is in the form value unit where value is a number and unit can  be
               one  of pt, bp, in, cm (absolute units, same meaning as in TeX), dy (1.0 dy is the
               height of a text line), figure or f (for figure coordinates, i.e. the  coordinates
               of  the  plot), frame or F (1.0 frame is the full size of the current subplot) and
               page or p (1.0 page is the whole height/width of the output file).

               It can also be auto, which is 1.0 in frame units (ie the width or  the  height  of
               the current plot).

       dimension-or-no
               A dimension, or no or none.

       drawing-spec
               A ctioga 1 --draw specification.

       file    A file name.

       fill-pattern
               A fill pattern, one of:

                 * lines:_angle_,_distance_,_width_

                 * vlines:_distance_,_width_

                 * hlines:_distance_,_width_

                 * xlines:_distance_,_width_,_angle_

                 * solid or plain

               The first three are lines, of arbitrary orientation for lines, vertical for vlines
               and horizontal for hlines. xlines correspond to crossed perpendicular  lines  (the
               _angle_  is  45  by default). For these styles, the _distance_ and _width_ are all
               optional and correspond respectively to the distance between  the  lines  and  the
               line width.

               solid or plain correspond to solid fill (i.e. not patterned).

       fill-pattern-or-auto
               Same thing as fill-pattern, or auto to let the style factory handle automatically.

       fill-until
               How to close the path of a curve to fill it. Can be:

                 * bottom, top, left, right to fill until the named side of the    plot

                 * axis or xaxis to fill until the X axis (ie y = 0)

                 * yaxis to fill until the Y axis (ie x = 0)

                 * x:value or x=value to fill until the given X value

                 * y:value or y=value to fill until the given Y value

                 * close for just closing the path (doesn't look good in general)

                 * none for no fill

       fill-until-or-auto
               Same thing as fill-until, or auto to let the style factory handle automatically.

       fill-until-set
               Sets of fill-until

       float   A floating-point number.

       float-list
               A list of space-separated or comma-separated floating point numbers.

       float-or-auto
               Same thing as float, or auto to let the style factory handle automatically.

       float-or-false
               A floating-point number, or none.

       float-or-false-or-auto
               Same   thing   as  float-or-false,  or  auto  to  let  the  style  factory  handle
               automatically.

       float-range
               A beginning:end range.

       float-set
               Sets of float

       frame-margins
               Margins around a plot,  ie  the  distance  from  the  side  of  the  plot  to  the
               corresponding side of the container (most likely the whole PDF). It can take three
               forms:

                 * dimension (applies to all sides)

                 * left_right, top_bottom

                 * left, right, top, bottom

               Each of these elements is a valid dimension.

               It can also be auto, in which  case  the  position  of  the  margins  is  computed
               automatically to accomodate the various labels/ticks.

       integer An integer.

       integer-list
               A list of space-separated or comma-separated integers

       integer-or-auto
               Same thing as integer, or auto to let the style factory handle automatically.

       internal-format
               Output format for internals.

       justification
               Horizontal aligment of the (with respect to its location). Can be one of:

                 * l or left

                 * c, center

                 * r, right

       label   The name of an label. It can be:

                 * title to mean the current plot's title.

                 * axis_tick  or  axis_ticks  or simply axis, where axis is a a valid    axis. It
                   designates the ticks of the named axis.

                 * axis_label, same as above but targets the label of the named axis.

       latex-font
               A LaTeX font.

               @todo document !

       level   A level on a XYZ map (that is, just a Z value).

       line-cap
               A line cap style, i.e. how the line  extends  beyond  its  last  point.  Available
               choices:

                 * round (extends as a half circle default)

                 * butt (does not extend at all)

                 * square (extends as a half square)

       line-cap-or-auto
               Same thing as line-cap, or auto to let the style factory handle automatically.

       line-style
               A  line style, which is one of solid, dots, dashes, small_dots, a series of comma-
               separated numbers which are the length of the strokes and gaps, or no, none or off
               to mean no line.

       line-style-or-auto
               Same thing as line-style, or auto to let the style factory handle automatically.

       line-style-set
               Sets of line-style

       location
               A position on the plot, referenced with respect to the sides. Can be:

                 * left

                 * right

                 * top

                 * bottom

                 * x0, for the x = 0 position

                 * y0, for the y = 0 position

               In addition, there will one day be the possibility to specify an offset from these
               locations. But that is still something to do.

       marker  A    Tioga    Marker,    ie    either    a    name    from     the     list     at
               http://tioga.rubyforge.org/doc/Tioga/MarkerConstants.html,   such  as  Box,  Star,
               Spade or two or three  comma-separated  numbers,  _font_,  _number_  and  _width_.
               _font_ defines the font (standard PDF fonts, from 1 to 14), _number_ the number of
               the character within the font (between 0 and 255), and if  _width_  is  specified,
               the  marker  is  stroked  and not filled, and the number is the line width for the
               stroke.

       marker-or-auto
               Same thing as marker, or auto to let the style factory handle automatically.

       marker-set
               Sets of marker

       object  A named object (whose name was given using the  /id=  option  to  the  appropriate
               command).

       objects A list of comma-separated objects, or a class specification starting with a .

       partial-float-range
               A beginning:end range, where either of the endpoints can be ommitted.

       pdf-font
               A  number  between 1 and 14 that designates one of the 14 standard PDF fonts. (see
               for instance http://tioga.rubyforge.org/doc/classes/Tioga/MarkerConstants.html for
               more information).

       point   A given point on a figure.

       regexp  A plain string or a regular expression (the latter being enclosed within /.../).

       region-side
               Within a region, designates the position of the curve with respect to the region:

                 * above

                 * below

                 * ignore if this curve is not to be taken into account

       region-side-or-auto
               Same thing as region-side, or auto to let the style factory handle automatically.

       region-side-set
               Sets of region-side

       stored-dataset
               A dataset that has already been loaded. It is either:

                 * A  number,  in which case it specifies the index inside the stack. 0    is the
                   first on that was pushed onto the stack (the oldest    dataset), 1 the second,
                   -1  the last one, -2 the one before the last    and so on. (it works just like
                   Ruby's arrays).

                 * The name of a named dataset.

                 * # followed by the id of a plot element

       style-aspect
               This type designs which aspect of the style of a xy-parametric plot is  controlled
               by a certain Z value. It can take the following values:

                 * marker_color: the color for the markers

                 * marker_size/marker_scale: the size of the markers

       text    Plain text.

       text-adjust-mode
               Mode for text size adjustment

                 * old for the old style heuristics

                 * both  for  both the old style heuristics and the measures, taking    whichever
                   of those is the biggest

                 * measure for only measured text size (but watch out for axis ticks !)

       text-align
               Horizontal aligment for text within its box. Only of use for texts  with  a  given
               text width. Can be one of:

                 * l or left

                 * c, center

                 * r, right

                 * no  or  none to not issue aligning commands, in which case you get full LaTeX-
                   justified paragraphs (probably with a lot of hyphens).

       text-list
               A list of comma-separated texts. If you must include a  comma  inside  the  texts,
               then use || as a separator.

       text-or-auto
               Same thing as text, or auto to let the style factory handle automatically.

       text-set
               Sets of text

       ticks-side
               On what side of an axis line are the ticks positioned:

                 * inside: on the inside

                 * outside: on the outside

                 * both: on both the inside and the outside

ENVIRONMENT VARIABLES

       If  the  environment  variables  CTIOGA2_PRE  or CTIOGA2_POST are set, they are split into
       words according to shell rules (see  the  Shellwords.shellwords  ruby  function  for  more
       information) and prepended or appended to the command-line arguments. They don't leave any
       trace in the actual command-line (so, for instance, --echo won't be aware of them).

AUTHOR

       ctioga2 was written by Vincent Fourmond.  Tioga was written by Bill Paxton.

BUGS

       ctioga2 is most certainly not bug-free. You can  use  the  facility  at  rubyforge.org  to
       report  any bug you notice: http://rubyforge.org/tracker/?group_id=8218.  You can also use
       the same facility for feature requests and to provide use with patches.

       Alternatively, you can use the forums at http://rubyforge.org/forum/?group_id=8218 or  the
       ctioga2-users@rubyforge.org mailing list to report any kind of problems or suggestions.

SEE ALSO

       xpdf(1), pdflatex(1), open(1), gnuplot(1), ctioga(1) (the original ctioga)

       The  original  tarball includes an examples/ with various examples demonstrating different
       features of ctioga2, and in particular the different  ways  to  use  it:  command-line  or
       command-file.

       It  also  includes  a tests/ directory containing test shell scripts. Runnning these shell
       scripts should give you a decent idea of ctioga2's possibilities while  assuring  that  it
       did install properly.

       Useful  information,  documentation  and  most  up-to-date  news can be found at ctioga2's
       website, at http://ctioga2.rubyforge.org/.

       More  information  about  Tioga   and   its   rdoc   documentation   can   be   found   at
       http://www.kitp.ucsb.edu/~paxton/tioga.html.