1
.\" -*- mode: nroff; -*-
2
.\" This is the template for the manual page of ctioga2
4
.\" Copyright 2009 by Vincent Fourmond
6
.\" This program is free software; you can redistribute it and/or modify
7
.\" it under the terms of the GNU General Public License as published by
8
.\" the Free Software Foundation; either version 2 of the License, or
9
.\" (at your option) any later version.
11
.\" This program is distributed in the hope that it will be useful,
12
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
13
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14
.\" GNU General Public License for more details (in the COPYING file).
18
.\" We want to use the .URL command
23
ctioga2 \- a command-line front-end for the Tioga plotting library
33
is a command-line front-end to the wonderful Tioga plotting
34
library. It aims at plotting quickly both data files and mathematical
35
functions, with however the possibility of a high control over the
38
The main feature that was introduced compared to the old
40
is that it is now possible to use command files for
42
every single command-line option corresponds to a command, whose name
43
is written. Just give the command the same arguments as to the
44
command-line option. To read a command file, feed it to the
50
Here are a few examples, both from command-line and using the
54
.BI ctioga2 \ File.dat
55
Produces a file \fIPlot.pdf\fR showing the second column of File.dat
56
as a function of the first.
59
The corresponding command file would be:
61
#!/usr/bin/env ctioga2 -f
74
Most of the commands accept one or more arguments, which have
75
different types. Here are the meanings of those types.
79
.SH ENVIRONMENT VARIABLES
81
If the environment variables
85
are set, they are split into words according to shell rules (see the
86
Shellwords.shellwords ruby function for more information) and
87
prepended or appended to the command-line arguments. They don't leave
88
any trace in the actual command-line (so, for instance,
90
won't be aware of them).
95
was written by Vincent Fourmond.
97
was written by Bill Paxton.
102
is most certainly not bug-free. You can use the facility at
104
to report any bug you notice:
105
.IR http://rubyforge.org/tracker/?group_id=8218 .
106
You can also use the same facility for feature requests and to provide
109
Alternatively, you can use the forums at
110
.I http://rubyforge.org/forum/?group_id=8218
112
.I ctioga2-users@rubyforge.org
113
mailing list to report any kind of problems or suggestions.
121
.BR ctioga "(1) (the original ctioga)"
123
The original tarball includes an
125
with various examples demonstrating different features of
127
and in particular the different ways to use it: command-line or
132
directory containing test shell scripts. Runnning these shell scripts
133
should give you a decent idea of
135
possibilities while assuring that it did install properly.
137
Useful information, documentation and most up-to-date news can be
141
.IR http://ctioga2.rubyforge.org/ .
143
More information about
145
and its rdoc documentation can be found at
146
.IR http://www.kitp.ucsb.edu/~paxton/tioga.html .