Provided by: ctioga2_0.8-2_all 
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 clipped color color-map contour-conrec
contour-minor-number contour-minor-scale contour-minor-style contour-number depth
error-bar-color fill fill-color fill-transparency ignore_hooks legend line-style
line-width marker marker-color marker-color-map 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: clipped color color-map contour-conrec contour-minor-number
contour-minor-scale contour-minor-style contour-number depth error-bar-color fill
fill-color fill-transparency legend line-style line-width marker marker-color
marker-color-map 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)
--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-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-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-color COLOR-OR-AUTO
Sets the marker color for subsequent curves, until cancelled with auto as
argument.
Corresponding command: marker-color(color-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-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-set)
--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)
--[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: dy frame_color frame_fill_color 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: 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 justification position scale shift
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: dy frame_color frame_fill_color 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: 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: 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
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.
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.
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: base-style clipped color depth head_angle head_color
head_marker head_scale 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: base-style clipped color depth fill-color fill-transparency
fill_color fill_transparency radius shape style width
Corresponding command: draw-box(point,point,option=...)
--draw-contour LEVEL
Directly draws contour on the current plot
Optional arguments: clipped closed color depth style width
Corresponding command: draw-contour(level,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: base-style clipped color depth line_style line_width style
width
Corresponding command: draw-line(point,point,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 base-style clipped color depth fill_color
horizontal_scale justification scale stroke_color vertical_scale
Corresponding command: draw-marker(point,marker,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 base-style clipped color depth fill_color font
horizontal_scale justification scale stroke_color vertical_scale
Corresponding command: draw-string-marker(point,text,option=...)
--draw-tangent DATA-POINT
Directly draws tangent on the current plot
Optional arguments: clipped color depth head_color head_marker head_scale
line_style line_width nbavg tail_color tail_marker tail_scale 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 base-style clipped color depth font
justification position scale shift
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 '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.
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.
Corresponding command: frame-margins(frame-margins)
--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.
Corresponding command: gradient(color,color)
--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.
Corresponding command: inset(box)
--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.
Corresponding command: next-inset(box)
--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: color reversed_color reversed_transparency transparency
Corresponding command: region(,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=...)
--zoom-inset BOX
Zooms are currently not implemented yet.
Corresponding command: zoom-inset(box)
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_justification axis_label_loc axis_label_position
axis_label_scale axis_label_shift axis_label_text background_lines_color
background_lines_style background_lines_width decoration 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_justification tick_label_position tick_label_scale tick_label_shift
ticks_format ticks_format_last ticks_labels ticks_major ticks_minor ticks_side
transform
Corresponding command: axis-style(axis,option=...)
--background-lines AXIS COLOR-OR-FALSE
Sets the color of the background lines for the given axis.
Optional arguments: 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_justification axis_label_loc axis_label_position axis_label_scale
axis_label_shift axis_label_text background_lines_color background_lines_style
background_lines_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_justification tick_label_position
tick_label_scale tick_label_shift ticks_format ticks_format_last ticks_labels
ticks_major ticks_minor ticks_side transform
Corresponding command: bottom(axis-decoration,option=...)
--clear-axes
Removes all the axes and their associated labels
Corresponding command: clear-axes()
--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 justification loc position scale
shift text
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_justification axis_label_loc axis_label_position axis_label_scale
axis_label_shift axis_label_text background_lines_color background_lines_style
background_lines_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_justification tick_label_position
tick_label_scale tick_label_shift ticks_format ticks_format_last ticks_labels
ticks_major ticks_minor 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_justification axis_label_loc axis_label_position axis_label_scale
axis_label_shift axis_label_text background_lines_color background_lines_style
background_lines_width bar_shift bar_size bounds decoration 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_justification tick_label_position tick_label_scale tick_label_shift
ticks_format ticks_format_last ticks_labels ticks_major ticks_minor 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_justification axis_label_loc axis_label_position axis_label_scale
axis_label_shift axis_label_text background_lines_color background_lines_style
background_lines_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_justification tick_label_position
tick_label_scale tick_label_shift ticks_format ticks_format_last ticks_labels
ticks_major ticks_minor 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 minor
Corresponding command: ticks(axis,option=...)
-t, --title TEXT
Sets the title of the current plot.
Optional arguments: align alignment angle color justification loc position scale
shift
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_justification axis_label_loc axis_label_position axis_label_scale
axis_label_shift axis_label_text background_lines_color background_lines_style
background_lines_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_justification tick_label_position
tick_label_scale tick_label_shift ticks_format ticks_format_last ticks_labels
ticks_major ticks_minor 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 justification loc position scale
shift
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 justification loc position scale
shift
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 vertical_scale
Corresponding command: watermark(text,option=...)
Default styles
Commands for defining default styles.
All commands take the name of the style to redefine. Different styles live in a different
name space, so there is no risk naming an axis and a text style with the same name. All
styles for a given type inherit from the style name base.
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.
ctioga2 may support at a later time loading style files, but that is not the case for now.
--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: 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_justification axis_label_loc axis_label_position axis_label_scale
axis_label_shift axis_label_text background_lines_color background_lines_style
background_lines_width decoration 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_justification tick_label_position
tick_label_scale tick_label_shift ticks_format ticks_format_last ticks_labels
ticks_major ticks_minor 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_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: color fill_color fill_transparency radius shape style width
Corresponding command: define-box-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 base /color=Pink makes all lines pink (unless overriden by
the /color option to draw-line), while
--define-line-style line-pink /color=Pink only affect those to which the /base-
style=line-pink style option was given.
Optional arguments: 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 vertical_scale
Corresponding command: define-marker-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 justification position scale shift
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 justification loc position scale shift
text
Corresponding command: define-title-style(text,option=...)
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-]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 scale
Corresponding command: png(resolution,option=...)
--[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
--apply-formula TEXT
Applies a formula to the last dataset (or the named one)
Optional arguments: name which
Corresponding command: apply-formula(text,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.
This can be used to build 3D datasets for xyz-map or xy-parametric.
Optional arguments: number 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-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 identical X values when they are not successive in the dataset,
you might want to hand it over to sort-last first.
Corresponding command: avg-dup-last()
--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-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.
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.
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=...)
-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.
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
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 or off: 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. Specifications vary for now...
@todo to be written later on.
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
odo document !
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.
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 a Dataset.
odo document ;-)...
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).
drawing-spec
A ctioga 1 --draw specification.
file A file name.
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-or-auto
Same thing as integer, or auto to let the style factory handle automatically.
internal-format
Output format for internals.
justification
Horizontal aligment for text. 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.
odo document !
level A level on a XYZ map (that is, just a Z value).
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
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
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.
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-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.