NAME¶
tablix2_plot - Tablix data plotter
SYNOPSIS¶
tablix2_plot command [ options ]
DESCRIPTION¶
Tablix is a powerful free software kernel for solving general timetabling
problems. It uses a coarse-grained parallel genetic algorithm in combination
with other techniques to construct sensible timetables from XML formatted
problem descriptions. Tablix can run on a single host as well as on a
heterogeneous parallel virtual machine using PVM3.
tablix2_plot can be used to plot various types of population convergence
graphs using data in files usually named
conv0.txt ,
conv1.txt ,
... Tablix will save convergence data into these files if it was compiled with
the
--enable-conv option.
These graphs can be useful for example to get a rough estimate of time required
to solve a particular problem (note that
tablix2_plot can be safely
used with files that are still written to by a running Tablix session).
Graphs are plotted with
gnuplot using the default output terminal (which
is in most cases a X11 display). Encapsulated postscript files can be obtained
by setting
EPSOUTPUT environment variable. Scalable vector graphics
files can be obtained by setting
SVGOUTPUT environment variable. The
contents of these variables are used by
tablix2_plot as a file name to
write to.
OPTIONS¶
- tablix2_plot --conv-fitness [ --scale SCALE ] [ PREFIX ] ...
- Plot population convergence graph using convergence data in files
conv*.txt in the current directory. One line is drawn for each
computing node. It shows the fitness value of the best timetable versus
generation count.
Use the PREFIX option, if you used the -o option with Tablix.
You can use more than one PREFIX option to plot multiple
convergence graphs in one window.
Use the SCALE option to adjust the vertical scale.
- tablix2_plot --fit-fitness [ --scale SCALE ] [ PREFIX ] ...
- Same as --conv-fitness above, except that an exponential function
is also drawn on the graph using least squares fitting. This can be used
to get a rough estimate of the time required to find a solution.
The SCALE parameter is used to adjust the horizontal scale in this
case.
- tablix2_plot --functions [ --scale SCALE ] CONVFILE
- Plot the return value of each fitness function versus generation count.
Return values of mandatory fitness functions are plotted with thicker
lines.
CONVFILE must be a file with Tablix population convergence data
(usually named conv*.txt ).
Use the SCALE option to adjust the vertical scale.
EXAMPLES¶
If Tablix was started with the following command:
tablix2 -o u1_ sample.xml
then the following command plots the population convergence graph:
tablix2_plot --conv-fitness u1_
Encapsulated postscript version of the same graph can be obtained with the
following command in
bash shell:
EPSOUTPUT="graph.eps" tablix2_plot --conv-fitness u1_
To see which mandatory restriction is preventing Tablix from finding the
solution, use the per module plot, possibly with a small vertical scale:
tablix2_plot --functions --scale 100 u1_conv0.txt
BUGS¶
In addition to gnuplot
tablix2_plot utility depends on a number of common
UNIX programs (mktemp, grep, sed, awk, ...) that may not be available on all
systems. The script is not currently capable of properly detecting if any
required programs are missing.
AUTHOR¶
Tomaz Solc (tomaz.solc@tablix.org)
SEE ALSO¶
tablix2(1), Tablix User's Manual, Tablix modules HOWTO, Tablix on Morphix
HOWTO