Chart::Graph::Gnuplot 3.2

Chart::Graph::Gnuplot is a function in module Chart::Graph that lets you generate graphs on the fly in perl.

SYNOPSIS

use Chart::Graph::Gnuplot qw(&gnuplot);



gnuplot(%global_options, [%data_set_options, @matrix],
[%data_set_options, @x_column, @y_column],
[%data_set_options, < filename >], ... );

It was written as a front-end application to gnuplot for hassle-free generation of graphs. gnuplot() can be supplied with many of the same options and arguments that can be given to gnuplot. For more information on gnuplot see the end of this section.

OPTIONS

gnuplot() has a very large number of options corresponding to options available with the gnuplot application itself. This Perl wrapper provides a large subset of the functionality of the application.

+----------------------------------------------------------------------------+
| GLOBAL OPTIONS: |
+----------------+-----------------------------+-----------------------------+
| NAME | OPTIONS | DEFAULT |
+----------------+-----------------------------+-----------------------------+
|title | set your own title | untitled |
|output type | pbm,gif,tgif,png, | png |
| | svg or "eps $epsoptions"| |
|output file | set your own output file, | untitled-gnuplot.png |
| | undef to output to STDOUT | |
|x-axis label | set your own label | x-axis |
|y-axis label | set your own label | y-axis |
|x2-axis label | set your own label | none |
|y2-axis label | set your own label | none |
|logscale x | 0 or 1 | 0 |
|logscale y | 0 or 1 | 0 |
|logscale x2 | 0 or 1 | 0 |
|logscale y2 | 0 or 1 | 0 |
| xtics | set your own tics on x-axis | none |
| | (see example below) | |
| x2tics | set your own tics on x2-axis| none |
| | (see example below) | |
| ytics | set your own tics on y-axis | none |
| | (see example below) | |
| y2tics | set your own tics on y2-axis| none |
| | (see example below) | |
| xrange | set xrange, accepts both | none |
| | string [$xmin:$xmax] | |
| | or arrayref [$xmin,$xmax] | |
| yrange | set yrange, see xrange | none |
| | | |
| uts | set your own range in unix | none |
| | timestamps, array ref: | |
| | [start_ts,end_ts, , | |
| | ] | |
| | see UNIX TIMESTAMPS example| |
| xdata | time to indicate that | none |
| | x-axis is date/time data | |
| ydata | time to indicate that | none |
| | y-axis is date/time data | |
| x2data | time to indicate that | none |
| | x2-axis is date/time data | |
| y2data | time to indicate that | none |
| | y2-axis is date/time data | |
| timefmt | "Input date/time string" | none |
| | see Gnuplot manual for info| |
| format | array ref: First element is | |
| | axis: x, y, x2, y2.| |
| | Second element is | |
| | output date/time string" | |
| | see Gnuplot manual for info| |
| extra_opts | set your own Gnuplot | none |
| | options, either an arrayref| |
| | or string ("n"-separated) | |
| size | scale the display size of | none |
| | the plot, arrayref [$x, $y]| |
+----------------+-----------------------------+-----------------------------+

+----------------------------------------------------------------------------+
| Data Set Options: |
+----------------+-----------------------------+-----------------------------+
| Name | Options | Default |
+----------------+-----------------------------+-----------------------------+
| type | matrix, columns, file,| none |
| | function, see examples | |
| | below | |
| title | set your own title | untitled data |
| style | points,lines,impulses | points |
| | errorbars, etc... | |
| | see ERRORBARS example | |
| axes | x1y1, x2y2, x1y2, etc.| x1y1 |
| using | map data to what will be | 1:2 |
| | plotted, see ERRORBARS | |
| | example | |
+----------------+-----------------------------+-----------------------------+