mirror of
https://github.com/dkogan/feedgnuplot.git
synced 2025-09-19 03:38:08 +08:00
Compare commits
51 Commits
debian/1.2
...
v1.26
Author | SHA1 | Date | |
---|---|---|---|
![]() |
1dad122cb9 | ||
![]() |
ee6b339978 | ||
![]() |
0270ec7679 | ||
![]() |
46123fc308 | ||
![]() |
f342a42cf9 | ||
![]() |
d55e54c095 | ||
![]() |
0ca3482607 | ||
![]() |
48254eefa8 | ||
![]() |
54862ec2fd | ||
![]() |
74e95d8e6f | ||
![]() |
6f23f89c28 | ||
![]() |
0f4fc69835 | ||
![]() |
f83d8db27a | ||
![]() |
59625675f7 | ||
![]() |
0863998848 | ||
![]() |
f2fa0bf14c | ||
![]() |
ffd19b9b87 | ||
![]() |
669fb8dee6 | ||
![]() |
deaa85dbd3 | ||
![]() |
99369d1542 | ||
![]() |
f4976bd0f7 | ||
![]() |
acd6de507c | ||
![]() |
faaeac7990 | ||
![]() |
1acb30c3cd | ||
![]() |
1252315598 | ||
![]() |
fad78b60b0 | ||
![]() |
809442e2dc | ||
![]() |
f022590344 | ||
![]() |
3c0743c192 | ||
![]() |
c615c8d65e | ||
![]() |
c169330fca | ||
![]() |
d76f163be4 | ||
![]() |
386c5f6d41 | ||
![]() |
720c332dd9 | ||
![]() |
4e823e7de5 | ||
![]() |
3badf920b6 | ||
![]() |
756d934058 | ||
![]() |
b43c9b985f | ||
![]() |
2f5e9d95ca | ||
![]() |
08d2f79fba | ||
![]() |
ef2bff2af6 | ||
![]() |
70b7c98124 | ||
![]() |
3146dbdfe7 | ||
![]() |
707196580a | ||
![]() |
103b47454c | ||
![]() |
ef3272eb6d | ||
![]() |
ef5a158144 | ||
![]() |
28742230b6 | ||
![]() |
24a56fd617 | ||
![]() |
e8e92082a1 | ||
![]() |
751d902844 |
29
Changes
29
Changes
@@ -1,3 +1,32 @@
|
|||||||
|
feedgnuplot (1.26)
|
||||||
|
|
||||||
|
* Minor POD fixes
|
||||||
|
|
||||||
|
-- Dima Kogan <dima@secretsauce.net> Sun, 20 Oct 2013 01:17:57 -0700
|
||||||
|
|
||||||
|
feedgnuplot (1.25)
|
||||||
|
|
||||||
|
* Added test suite
|
||||||
|
* Added initial support for --timefmt. Currently time/date data is
|
||||||
|
supported only at the x-axis domain
|
||||||
|
* Added --exit option for force feedgnuplot to return even if gnuplot
|
||||||
|
may not yet be done rendering (patch by Eric Schulte)
|
||||||
|
* Reformatted the documentation
|
||||||
|
* y2-axis curves no longer have a thicker line by default
|
||||||
|
* --hardcopy now handles piped output (gnuplot 'set output |process'
|
||||||
|
syntax)
|
||||||
|
|
||||||
|
-- Dima Kogan <dima@secretsauce.net> Sun, 20 Oct 2013 00:09:36 -0700
|
||||||
|
|
||||||
|
feedgnuplot (1.24)
|
||||||
|
|
||||||
|
* Fixed regression in --monotonic. This works again now
|
||||||
|
* moved POD back into the main source file. This fixes the broken usage
|
||||||
|
messages
|
||||||
|
* added --version
|
||||||
|
|
||||||
|
-- Dima Kogan <dima@secretsauce.net> Fri, 08 Feb 2013 01:53:47 -0800
|
||||||
|
|
||||||
feedgnuplot (1.23)
|
feedgnuplot (1.23)
|
||||||
|
|
||||||
* --extracmds no longer accepts comma-separated lists
|
* --extracmds no longer accepts comma-separated lists
|
||||||
|
7
INSTALL
7
INSTALL
@@ -1,5 +1,10 @@
|
|||||||
If running on a Debian-based OS (this includes Ubuntu), it is highly recommended
|
If running on a Debian-based OS (this includes Ubuntu), it is highly recommended
|
||||||
to install this program as a package by doing
|
to install this program as a package. In debian/unstable feedgnuplot is in the
|
||||||
|
official repos, so all you need to do is
|
||||||
|
|
||||||
|
sudo apt-get install feedgnuplot
|
||||||
|
|
||||||
|
Otherwise a package can be built with
|
||||||
|
|
||||||
ln -fs package_definitions/debian debian
|
ln -fs package_definitions/debian debian
|
||||||
dpkg-buildpackage -us -uc -b
|
dpkg-buildpackage -us -uc -b
|
||||||
|
3
MANIFEST
3
MANIFEST
@@ -1,8 +1,7 @@
|
|||||||
Makefile.PL
|
Makefile.PL
|
||||||
MANIFEST
|
MANIFEST
|
||||||
bin/feedgnuplot
|
bin/feedgnuplot
|
||||||
bin/feedgnuplot.pod
|
|
||||||
t/00-load.t
|
|
||||||
t/manifest.t
|
t/manifest.t
|
||||||
|
t/plots.t
|
||||||
Changes
|
Changes
|
||||||
LICENSE
|
LICENSE
|
||||||
|
24
Makefile.PL
24
Makefile.PL
@@ -9,12 +9,28 @@ sub parseversion
|
|||||||
# libpackage-perl (0.02)
|
# libpackage-perl (0.02)
|
||||||
#
|
#
|
||||||
# I parse out the 0.02 part
|
# I parse out the 0.02 part
|
||||||
open DCH, 'Changes' or die "Couldn't open 'Changes'";
|
open DCH, '<', 'Changes' or die "Couldn't open 'Changes'";
|
||||||
my ($version) = <DCH> =~ /^\S+ \s* \( ([0-9\.]+) \)/x
|
my ($version) = <DCH> =~ /^\S+ \s* \( ([0-9\.]+) \)/x
|
||||||
or die "Couldn't parse version from 'Changes'";
|
or die "Couldn't parse version from 'Changes'";
|
||||||
close DCH;
|
close DCH;
|
||||||
|
|
||||||
return $version;
|
# The version is also stored in the script itself. Here I extract that version
|
||||||
|
# number and make sure the two match
|
||||||
|
open PL, '<', 'bin/feedgnuplot' or die "Couldn't open 'bin/feedgnuplot'";
|
||||||
|
|
||||||
|
while(<PL>)
|
||||||
|
{
|
||||||
|
if( /VERSION = ([0-9\.]+)/ )
|
||||||
|
{
|
||||||
|
if ( $1 != $version )
|
||||||
|
{
|
||||||
|
die "Version mismatch. Changes says version is '$version', but 'bin/feedgnuplot' says it is '$1'";
|
||||||
|
}
|
||||||
|
|
||||||
|
return $version;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
die "Couldn't parse version from 'bin/feedgnuplot'";
|
||||||
}
|
}
|
||||||
|
|
||||||
sub MY::libscan
|
sub MY::libscan
|
||||||
@@ -42,14 +58,12 @@ WriteMakefile
|
|||||||
NAME => 'feedgnuplot',
|
NAME => 'feedgnuplot',
|
||||||
AUTHOR => q{Dima Kogan <dima@secretsauce.net>},
|
AUTHOR => q{Dima Kogan <dima@secretsauce.net>},
|
||||||
VERSION => parseversion(),
|
VERSION => parseversion(),
|
||||||
ABSTRACT_FROM => 'bin/feedgnuplot.pod',
|
|
||||||
($ExtUtils::MakeMaker::VERSION >= 6.3002
|
($ExtUtils::MakeMaker::VERSION >= 6.3002
|
||||||
? ('LICENSE' => 'perl')
|
? ('LICENSE' => 'perl')
|
||||||
: ()),
|
: ()),
|
||||||
PL_FILES => {},
|
PL_FILES => {},
|
||||||
EXE_FILES => [ 'bin/feedgnuplot' ],
|
EXE_FILES => [ 'bin/feedgnuplot' ],
|
||||||
MAN1PODS => { 'bin/feedgnuplot.pod' => 'blib/man1/feedgnuplot.1' },
|
BUILD_REQUIRES => { 'String::ShellQuote' => 0},
|
||||||
PREREQ_PM => { 'Test::Script::Run' => 0},
|
|
||||||
dist => { COMPRESS => 'gzip -9f', SUFFIX => 'gz', },
|
dist => { COMPRESS => 'gzip -9f', SUFFIX => 'gz', },
|
||||||
clean => { FILES => 'feedgnuplot-*' },
|
clean => { FILES => 'feedgnuplot-*' },
|
||||||
);
|
);
|
||||||
|
@@ -1 +1 @@
|
|||||||
bin/feedgnuplot.pod
|
bin/feedgnuplot
|
1221
bin/feedgnuplot
1221
bin/feedgnuplot
File diff suppressed because it is too large
Load Diff
@@ -1,396 +0,0 @@
|
|||||||
=head1 NAME
|
|
||||||
|
|
||||||
feedgnuplot - Pipe-oriented frontend to Gnuplot
|
|
||||||
|
|
||||||
=head1 SYNOPSIS
|
|
||||||
|
|
||||||
Simple plotting of stored data:
|
|
||||||
|
|
||||||
$ seq 5 | awk '{print 2*$1, $1*$1}'
|
|
||||||
2 1
|
|
||||||
4 4
|
|
||||||
6 9
|
|
||||||
8 16
|
|
||||||
10 25
|
|
||||||
|
|
||||||
$ seq 5 | awk '{print 2*$1, $1*$1}' |
|
|
||||||
feedgnuplot --lines --points --legend 0 "data 0" --title "Test plot" --y2 1
|
|
||||||
|
|
||||||
Simple real-time plotting example: plot how much data is received on the wlan0
|
|
||||||
network interface in bytes/second (uses bash, awk and Linux):
|
|
||||||
|
|
||||||
$ while true; do sleep 1; cat /proc/net/dev; done |
|
|
||||||
gawk '/wlan0/ {if(b) {print $2-b; fflush()} b=$2}' |
|
|
||||||
feedgnuplot --lines --stream --xlen 10 --ylabel 'Bytes/sec' --xlabel seconds
|
|
||||||
|
|
||||||
=head1 DESCRIPTION
|
|
||||||
|
|
||||||
This is a flexible, command-line-oriented frontend to Gnuplot. It creates
|
|
||||||
plots from data coming in on STDIN or given in a filename passed on the
|
|
||||||
commandline. Various data representations are supported, as is hardcopy
|
|
||||||
output and streaming display of live data. A simple example:
|
|
||||||
|
|
||||||
$ seq 5 | awk '{print 2*$1, $1*$1}' | feedgnuplot
|
|
||||||
|
|
||||||
You should see a plot with two curves. The C<awk> command generates some data to
|
|
||||||
plot and the C<feedgnuplot> reads it in from STDIN and generates the plot. The
|
|
||||||
C<awk> invocation is just an example; more interesting things would be plotted
|
|
||||||
in normal usage. No commandline-options are required for the most basic
|
|
||||||
plotting. Input parsing is flexible; every line need not have the same number of
|
|
||||||
points. New curves will be created as needed.
|
|
||||||
|
|
||||||
The most commonly used functionality of gnuplot is supported directly by the
|
|
||||||
script. Anything not directly supported can still be done with the
|
|
||||||
C<--extracmds> and C<--curvestyle> options. Arbitrary gnuplot commands can be
|
|
||||||
passed in with C<--extracmds>. For example, to turn off the grid, pass in
|
|
||||||
C<--extracmds 'unset grid'>. As many of these options as needed can be passed
|
|
||||||
in. To add arbitrary curve styles, use C<--curvestyle curveID extrastyle>. Pass
|
|
||||||
these more than once to affect more than one curve. To apply an extra style to
|
|
||||||
I<all> the curves that lack an explicit C<--curvestyle>, pass in
|
|
||||||
C<--curvestyleall extrastyle>.
|
|
||||||
|
|
||||||
=head2 Data formats
|
|
||||||
|
|
||||||
By default, each value present in the incoming data represents a distinct data
|
|
||||||
point, as demonstrated in the original example above (we had 10 numbers in the
|
|
||||||
input and 10 points in the plot). If requested, the script supports more
|
|
||||||
sophisticated interpretation of input data
|
|
||||||
|
|
||||||
=head3 Domain selection
|
|
||||||
|
|
||||||
If C<--domain> is passed in, the first value on each line of input is
|
|
||||||
interpreted as the I<X>-value for the rest of the data on that line. Without
|
|
||||||
C<--domain> the I<X>-value is the line number, and the first value on a line is
|
|
||||||
a plain data point like the others. Default is C<--nodomain>. Thus the original
|
|
||||||
example above produces 2 curves, with B<1,2,3,4,5> as the I<X>-values. If we run
|
|
||||||
the same command with --domain:
|
|
||||||
|
|
||||||
$ seq 5 | awk '{print 2*$1, $1*$1}' | feedgnuplot --domain
|
|
||||||
|
|
||||||
we get only 1 curve, with B<2,4,6,8,10> as the I<X>-values. As many points as
|
|
||||||
desired can appear on a single line, but all points on a line are associated
|
|
||||||
with the I<X>-value at the start of that line.
|
|
||||||
|
|
||||||
=head3 Curve indexing
|
|
||||||
|
|
||||||
By default, each column represents a separate curve. This is fine unless sparse
|
|
||||||
data is to be plotted. With the C<--dataid> option, each point is represented by
|
|
||||||
2 values: a string identifying the curve, and the value itself. If we add
|
|
||||||
C<--dataid> to the original example:
|
|
||||||
|
|
||||||
$ seq 5 | awk '{print 2*$1, $1*$1}' | feedgnuplot --dataid --autolegend
|
|
||||||
|
|
||||||
we get 5 different curves with one point in each. The first column, as produced
|
|
||||||
by C<awk>, is B<2,4,6,8,10>. These are interpreted as the IDs of the curves to
|
|
||||||
be plotted. The C<--autolegend> option adds a legend using the given IDs to
|
|
||||||
label the curves. The IDs need not be numbers; generic strings are accepted. As
|
|
||||||
many points as desired can appear on a single line. C<--domain> can be used in
|
|
||||||
conjunction with C<--dataid>.
|
|
||||||
|
|
||||||
=head3 Multi-value style support
|
|
||||||
|
|
||||||
Depending on how gnuplot is plotting the data, more than one value may be needed
|
|
||||||
to represent a single point. For example, the script has support to plot all the
|
|
||||||
data with C<--circles>. This requires a radius to be specified for each point in
|
|
||||||
addition to the position of the point. Thus, when plotting with C<--circles>, 2
|
|
||||||
numbers are read for each data point instead of 1. A similar situation exists
|
|
||||||
with C<--colormap> where each point contains the position I<and> the
|
|
||||||
color. There are other gnuplot styles that require more data (such as error
|
|
||||||
bars), but none of these are directly supported by the script. They can still be
|
|
||||||
used, though, by specifying the specific style with C<--curvestyle>, and
|
|
||||||
specifying how many extra values are needed for each point with
|
|
||||||
C<--extraValuesPerPoint extra>. C<--extraValuesPerPoint> is ONLY needed for the
|
|
||||||
styles not explicitly supported; supported styles set that variable
|
|
||||||
automatically.
|
|
||||||
|
|
||||||
=head3 3D data
|
|
||||||
|
|
||||||
To plot 3D data, pass in C<--3d>. C<--domain> MUST be given when plotting 3D
|
|
||||||
data to avoid domain ambiguity. If 3D data is being plotted, there are by
|
|
||||||
definition 2 domain values instead of one (I<Z> as a function of I<X> and I<Y>
|
|
||||||
instead of I<Y> as a function of I<X>). Thus the first 2 values on each line are
|
|
||||||
interpreted as the domain instead of just 1. The rest of the processing happens
|
|
||||||
the same way as before.
|
|
||||||
|
|
||||||
=head3 Special data commands
|
|
||||||
|
|
||||||
Other than the raw data, 2 special commands are interpreted if they appear in
|
|
||||||
the input. These are C<replot> and C<clear>. If a line of data begins with
|
|
||||||
C<replot> and we're plotting in realtime with C<--stream>, the plot will be
|
|
||||||
refreshed immediately. If a line of data begins with C<clear>, the plot is
|
|
||||||
cleared, to be re-filled with any data following the C<clear>.
|
|
||||||
|
|
||||||
=head2 Real-time streaming data
|
|
||||||
|
|
||||||
To plot real-time data, pass in the C<--stream [refreshperiod]> option. Data
|
|
||||||
will then be plotted as it is received. The plot will be updated every
|
|
||||||
C<refreshperiod> seconds. If the period isn't specified, a 1Hz refresh rate is
|
|
||||||
used. To refresh at specific intervals indicated by the data, set the
|
|
||||||
refreshperiod to 0 or to 'trigger'. The plot will then I<only> be refreshed when
|
|
||||||
a data line 'replot' is received. This 'replot' command works in both triggered
|
|
||||||
and timed modes, but in triggered mode, it's the only way to replot.
|
|
||||||
|
|
||||||
To plot only the most recent data (instead of I<all> the data), C<--xlen
|
|
||||||
windowsize> can be given. This will create an constantly-updating, scrolling
|
|
||||||
view of the recent past. C<windowsize> should be replaced by the desired length
|
|
||||||
of the domain window to plot, in domain units (passed-in values if C<--domain>
|
|
||||||
or line numbers otherwise).
|
|
||||||
|
|
||||||
=head2 Hardcopy output
|
|
||||||
|
|
||||||
The script is able to produce hardcopy output with C<--hardcopy outputfile>. The
|
|
||||||
output type can be inferred from the filename, if B<.ps>, B<.eps>, B<.pdf>,
|
|
||||||
B<.svg> or B<.png> is requested. If any other file type is requested,
|
|
||||||
C<--terminal> I<must> be passed in to tell gnuplot how to make the plot.
|
|
||||||
|
|
||||||
=head2 Self-plotting data files
|
|
||||||
|
|
||||||
This script can be used to enable self-plotting data files. There are 2 ways of
|
|
||||||
doing this: with a shebang (#!) or with inline perl data.
|
|
||||||
|
|
||||||
=head3 Self-plotting data with a #!
|
|
||||||
|
|
||||||
A self-plotting, executable data file C<data> is formatted as
|
|
||||||
|
|
||||||
$ cat data
|
|
||||||
#!/usr/bin/feedgnuplot --lines --points
|
|
||||||
2 1
|
|
||||||
4 4
|
|
||||||
6 9
|
|
||||||
8 16
|
|
||||||
10 25
|
|
||||||
12 36
|
|
||||||
14 49
|
|
||||||
16 64
|
|
||||||
18 81
|
|
||||||
20 100
|
|
||||||
22 121
|
|
||||||
24 144
|
|
||||||
26 169
|
|
||||||
28 196
|
|
||||||
30 225
|
|
||||||
|
|
||||||
This is the shebang (#!) line followed by the data, formatted as before. The
|
|
||||||
data file can be plotted simply with
|
|
||||||
|
|
||||||
$ ./data
|
|
||||||
|
|
||||||
The caveats here are that on Linux the whole #! line is limited to 127 charaters
|
|
||||||
and that the full path to feedgnuplot must be given. The 127 character limit is
|
|
||||||
a serious limitation, but this can likely be resolved with a kernel patch. I
|
|
||||||
have only tried on Linux 2.6.
|
|
||||||
|
|
||||||
=head3 Self-plotting data with perl inline data
|
|
||||||
|
|
||||||
Perl supports storing data and code in the same file. This can also be used to
|
|
||||||
create self-plotting files:
|
|
||||||
|
|
||||||
$ cat plotdata.pl
|
|
||||||
#!/usr/bin/perl
|
|
||||||
use strict;
|
|
||||||
use warnings;
|
|
||||||
|
|
||||||
open PLOT, "| feedgnuplot --lines --points" or die "Couldn't open plotting pipe";
|
|
||||||
while( <DATA> )
|
|
||||||
{
|
|
||||||
my @xy = split;
|
|
||||||
print PLOT "@xy\n";
|
|
||||||
}
|
|
||||||
__DATA__
|
|
||||||
2 1
|
|
||||||
4 4
|
|
||||||
6 9
|
|
||||||
8 16
|
|
||||||
10 25
|
|
||||||
12 36
|
|
||||||
14 49
|
|
||||||
16 64
|
|
||||||
18 81
|
|
||||||
20 100
|
|
||||||
22 121
|
|
||||||
24 144
|
|
||||||
26 169
|
|
||||||
28 196
|
|
||||||
30 225
|
|
||||||
|
|
||||||
This is especially useful if the logged data is not in a format directly
|
|
||||||
supported by feedgnuplot. Raw data can be stored after the __DATA__ directive,
|
|
||||||
with a small perl script to manipulate the data into a useable format and send
|
|
||||||
it to the plotter.
|
|
||||||
|
|
||||||
=head1 ARGUMENTS
|
|
||||||
|
|
||||||
--[no]domain If enabled, the first element of each line is the
|
|
||||||
domain variable. If not, the point index is used
|
|
||||||
|
|
||||||
--[no]dataid If enabled, each data point is preceded by the ID
|
|
||||||
of the data set that point corresponds to. This ID is
|
|
||||||
interpreted as a string, NOT as just a number. If not
|
|
||||||
enabled, the order of the point is used.
|
|
||||||
|
|
||||||
As an example, if line 3 of the input is "0 9 1 20"
|
|
||||||
'--nodomain --nodataid' would parse the 4 numbers as points in 4
|
|
||||||
different curves at x=3
|
|
||||||
|
|
||||||
'--domain --nodataid' would parse the 4 numbers as points in 3 different
|
|
||||||
curves at x=0. Here, 0 is the x-variable and 9,1,20 are the data values
|
|
||||||
|
|
||||||
'--nodomain --dataid' would parse the 4 numbers as points in 2 different
|
|
||||||
curves at x=3. Here 0 and 1 are the data IDs and 9 and 20 are the
|
|
||||||
data values
|
|
||||||
|
|
||||||
'--domain --dataid' would parse the 4 numbers as a single point at
|
|
||||||
x=0. Here 9 is the data ID and 1 is the data value. 20 is an extra
|
|
||||||
value, so it is ignored. If another value followed 20, we'd get another
|
|
||||||
point in curve ID 20
|
|
||||||
|
|
||||||
--[no]3d Do [not] plot in 3D. This only makes sense with --domain.
|
|
||||||
Each domain here is an (x,y) tuple
|
|
||||||
|
|
||||||
--colormap Show a colormapped xy plot. Requires extra data for the color.
|
|
||||||
zmin/zmax can be used to set the extents of the colors.
|
|
||||||
Automatically increments extraValuesPerPoint
|
|
||||||
|
|
||||||
--stream [period] Plot the data as it comes in, in realtime. If period is given,
|
|
||||||
replot every period seconds. If no period is given, replot at
|
|
||||||
1Hz. If the period is given as 0 or 'trigger', replot ONLY when
|
|
||||||
the incoming data dictates this . See the "Real-time streaming
|
|
||||||
data" section of the man page.
|
|
||||||
|
|
||||||
--[no]lines Do [not] draw lines to connect consecutive points
|
|
||||||
--[no]points Do [not] draw points
|
|
||||||
--circles Plot with circles. This requires a radius be specified for
|
|
||||||
each point. Automatically increments extraValuesPerPoint
|
|
||||||
|
|
||||||
--xlabel xxx Set x-axis label
|
|
||||||
--ylabel xxx Set y-axis label
|
|
||||||
--y2label xxx Set y2-axis label. Does not apply to 3d plots
|
|
||||||
--zlabel xxx Set y-axis label. Only applies to 3d plots
|
|
||||||
|
|
||||||
--title xxx Set the title of the plot
|
|
||||||
|
|
||||||
--legend curveID legend
|
|
||||||
Set the label for a curve plot. Use this option multiple times
|
|
||||||
for multiple curves. With --dataid, curveID is the ID. Otherwise,
|
|
||||||
it's the index of the curve, starting at 0
|
|
||||||
|
|
||||||
--autolegend Use the curve IDs for the legend. Titles given with --legend
|
|
||||||
override these
|
|
||||||
|
|
||||||
--xlen xxx When using --stream, sets the size of the x-window to plot.
|
|
||||||
Omit this or set it to 0 to plot ALL the data. Does not
|
|
||||||
make sense with 3d plots. Implies --monotonic
|
|
||||||
|
|
||||||
--xmin xxx Set the range for the x axis. These are ignored in a
|
|
||||||
streaming plot
|
|
||||||
--xmax xxx Set the range for the x axis. These are ignored in a
|
|
||||||
streaming plot
|
|
||||||
--ymin xxx Set the range for the y axis.
|
|
||||||
--ymax xxx Set the range for the y axis.
|
|
||||||
--y2min xxx Set the range for the y2 axis. Does not apply to 3d plots.
|
|
||||||
--y2max xxx Set the range for the y2 axis. Does not apply to 3d plots.
|
|
||||||
--zmin xxx Set the range for the z axis. Only applies to 3d plots or colormaps.
|
|
||||||
--zmax xxx Set the range for the z axis. Only applies to 3d plots or colormaps.
|
|
||||||
|
|
||||||
--y2 xxx Plot the data specified by this curve ID on the y2 axis.
|
|
||||||
Without --dataid, the ID is just an ordered 0-based index.
|
|
||||||
Does not apply to 3d plots. Can be passed multiple times, or passed a
|
|
||||||
comma-separated list
|
|
||||||
|
|
||||||
--histogram curveID
|
|
||||||
Set up a this specific curve to plot a histogram. The bin
|
|
||||||
width is given with the --binwidth option (assumed 1.0 if
|
|
||||||
omitted). --histogram does NOT touch the drawing style.
|
|
||||||
It is often desired to plot these with boxes, and this
|
|
||||||
MUST be explicitly requested with --curvestyleall 'with
|
|
||||||
boxes'. This works with --domain and/or --stream, but in
|
|
||||||
those cases the x-value is used ONLY to cull old data
|
|
||||||
because of --xlen or --monotonic. I.e. the x-values are
|
|
||||||
NOT drawn in any way. Can be passed multiple times, or passed a comma-
|
|
||||||
separated list
|
|
||||||
--binwidth width The width of bins when making histograms. This setting applies to ALL
|
|
||||||
histograms in the plot. Defaults to 1.0 if not given.
|
|
||||||
--histstyle style Normally, histograms are generated with the 'smooth freq'
|
|
||||||
gnuplot style. --histstyle can be used to select
|
|
||||||
different 'smooth' settings. Allowed are 'unique',
|
|
||||||
'cumulative' and 'cnormal'. 'unique' indicates whether a
|
|
||||||
bin has at least one item in it: instead of counting the
|
|
||||||
items, it'll always report 0 or 1. 'cumulative' is the
|
|
||||||
integral of the "normal" histogram. 'cnormal' is like
|
|
||||||
'cumulative', but rescaled to end up at 1.0.
|
|
||||||
|
|
||||||
--curvestyle curveID style
|
|
||||||
Additional styles per curve. With --dataid, curveID is
|
|
||||||
the ID. Otherwise, it's the index of the curve, starting
|
|
||||||
at 0. Use this option multiple times for multiple curves.
|
|
||||||
--curvestylall does NOT apply to curves that have a
|
|
||||||
--curvestyle
|
|
||||||
|
|
||||||
--curvestyleall xxx Additional styles for all curves that have no --curvestyle
|
|
||||||
|
|
||||||
--extracmds xxx Additional commands. These could contain extra global styles
|
|
||||||
for instance. Can be passed multiple times.
|
|
||||||
|
|
||||||
--square Plot data with aspect ratio 1. For 3D plots, this controls the
|
|
||||||
aspect ratio for all 3 axes
|
|
||||||
|
|
||||||
--square_xy For 3D plots, set square aspect ratio for ONLY the x,y axes
|
|
||||||
|
|
||||||
--hardcopy xxx If not streaming, output to a file specified here. Format
|
|
||||||
inferred from filename, unless specified by --terminal
|
|
||||||
--terminal xxx String passed to 'set terminal'. No attempts are made to
|
|
||||||
validate this. --hardcopy sets this to some sensible
|
|
||||||
defaults if --hardcopy is given .png, .pdf, .ps, .eps or
|
|
||||||
.svg. If any other file type is desired, use both
|
|
||||||
--hardcopy and --terminal
|
|
||||||
|
|
||||||
--maxcurves xxx The maximum allowed number of curves. This is 100 by default,
|
|
||||||
but can be reset with this option. This exists purely to
|
|
||||||
prevent perl from allocating all of the system's memory when
|
|
||||||
reading bogus data
|
|
||||||
|
|
||||||
--monotonic If --domain is given, checks to make sure that the x-
|
|
||||||
coordinate in the input data is monotonically increasing.
|
|
||||||
If a given x-variable is in the past, all data currently
|
|
||||||
cached for this curve is purged. Without --monotonic, all
|
|
||||||
data is kept. Does not make sense with 3d plots.
|
|
||||||
No --monotonic by default.
|
|
||||||
|
|
||||||
--extraValuesPerPoint xxx
|
|
||||||
How many extra values are given for each data point. Normally this
|
|
||||||
is 0, and does not need to be specified, but sometimes we want
|
|
||||||
extra data, like for colors or point sizes or error bars, etc.
|
|
||||||
feedgnuplot options that require this (colormap, circles)
|
|
||||||
automatically set it. This option is ONLY needed if unknown styles are
|
|
||||||
used, with --curvestyleall for instance
|
|
||||||
|
|
||||||
--dump Instead of printing to gnuplot, print to STDOUT. For
|
|
||||||
debugging.
|
|
||||||
|
|
||||||
--geometry If using X11, specifies the size, position of the plot window
|
|
||||||
|
|
||||||
=head1 ACKNOWLEDGEMENT
|
|
||||||
|
|
||||||
This program is originally based on the driveGnuPlots.pl script from
|
|
||||||
Thanassis Tsiodras. It is available from his site at
|
|
||||||
L<http://users.softlab.ece.ntua.gr/~ttsiod/gnuplotStreaming.html>
|
|
||||||
|
|
||||||
=head1 REPOSITORY
|
|
||||||
|
|
||||||
L<https://github.com/dkogan/feedgnuplot>
|
|
||||||
|
|
||||||
=head1 AUTHOR
|
|
||||||
|
|
||||||
Dima Kogan, C<< <dima@secretsauce.net> >>
|
|
||||||
|
|
||||||
=head1 LICENSE AND COPYRIGHT
|
|
||||||
|
|
||||||
Copyright 2011-2012 Dima Kogan.
|
|
||||||
|
|
||||||
This program is free software; you can redistribute it and/or modify it
|
|
||||||
under the terms of either: the GNU General Public License as published
|
|
||||||
by the Free Software Foundation; or the Artistic License.
|
|
||||||
|
|
||||||
See http://dev.perl.org/licenses/ for more information.
|
|
||||||
|
|
||||||
=cut
|
|
@@ -1,43 +1,46 @@
|
|||||||
complete -W \
|
complete -W \
|
||||||
' \
|
' \
|
||||||
--domain \
|
--3d \
|
||||||
--dataid \
|
--autolegend \
|
||||||
--3d \
|
--binwidth \
|
||||||
--colormap \
|
--circles \
|
||||||
--stream \
|
--colormap \
|
||||||
--lines \
|
--curvestyle \
|
||||||
--points \
|
--curvestyleall \
|
||||||
--circles \
|
--dataid \
|
||||||
--xlabel \
|
--domain \
|
||||||
--ylabel \
|
--dump \
|
||||||
--y2label \
|
--exit \
|
||||||
--zlabel \
|
--extraValuesPerPoint \
|
||||||
--zlabel \
|
--extracmds \
|
||||||
--title \
|
--geometry \
|
||||||
--autolegend \
|
--hardcopy \
|
||||||
--xlen \
|
--help \
|
||||||
--xmin \
|
--histogram \
|
||||||
--xmax \
|
--histstyle \
|
||||||
--ymin \
|
--legend \
|
||||||
--ymax \
|
--lines \
|
||||||
--y2min \
|
--maxcurves \
|
||||||
--y2max \
|
--monotonic \
|
||||||
--zmin \
|
--points \
|
||||||
--zmax \
|
--square \
|
||||||
--y2 \
|
--square_xy \
|
||||||
--curvestyleall \
|
--stream \
|
||||||
--extracmds \
|
--terminal \
|
||||||
--square \
|
--timefmt \
|
||||||
--square_xy \
|
--title \
|
||||||
--hardcopy \
|
--version \
|
||||||
--maxcurves \
|
--xlabel \
|
||||||
--monotonic \
|
--xlen \
|
||||||
--extraValuesPerPoint \
|
--xmax \
|
||||||
--dump \
|
--xmin \
|
||||||
--geometry \
|
--y2 \
|
||||||
--curvestyle \
|
--y2label \
|
||||||
--histogram \
|
--y2max \
|
||||||
--binwidth \
|
--y2min \
|
||||||
--histstyle \
|
--ylabel \
|
||||||
--terminal \
|
--ymax \
|
||||||
--legend' feedgnuplot
|
--ymin \
|
||||||
|
--zlabel \
|
||||||
|
--zmax \
|
||||||
|
--zmin' feedgnuplot
|
||||||
|
@@ -1,44 +1,48 @@
|
|||||||
#compdef feedgnuplot
|
#compdef feedgnuplot
|
||||||
|
|
||||||
_arguments -S \
|
_arguments -S \
|
||||||
'()--domain[first element of each line is the domain variable]' \
|
'()--domain[first element of each line is the domain variable]' \
|
||||||
'--dataid[each data point is preceded by the corresponding ID]' \
|
'--dataid[each data point is preceded by the corresponding ID]' \
|
||||||
'(--monotonic --xlen --histogram)--3d' \
|
'(--monotonic --xlen --histogram)--3d' \
|
||||||
'--colormap[show a colormapped xy plot]' \
|
'--colormap[show a colormapped xy plot]' \
|
||||||
'--stream[Plot the data in realtime]::period in s:' \
|
'--stream[Plot the data in realtime]::period in s:' \
|
||||||
'--lines' \
|
'--lines' \
|
||||||
'--points' \
|
'--points' \
|
||||||
'--circles' \
|
'--circles' \
|
||||||
'--xlabel:X-axis label:' \
|
'--xlabel:X-axis label:' \
|
||||||
'--ylabel:Y-axis label:' \
|
'--ylabel:Y-axis label:' \
|
||||||
'--y2label:Y2-axis label:' \
|
'--y2label:Y2-axis label:' \
|
||||||
'--zlabel:Z-axis label:' \
|
'--zlabel:Z-axis label:' \
|
||||||
'--zlabel:Z-axis label:' \
|
'--zlabel:Z-axis label:' \
|
||||||
'--title:Plot title:' \
|
'--title:Plot title:' \
|
||||||
'--autolegend[Label each plot with its data ID]' \
|
'--autolegend[Label each plot with its data ID]' \
|
||||||
'(--3d)--xlen[the size of the x-window to plot]::window size:' \
|
'(--3d)--xlen[the size of the x-window to plot]::window size:' \
|
||||||
'--xmin:min X:' \
|
'(--xlen)--xmin:min X:' \
|
||||||
'--xmax:max X:' \
|
'(--xlen)--xmax:max X:' \
|
||||||
'--ymin:min Y:' \
|
'--ymin:min Y:' \
|
||||||
'--ymax:max Y:' \
|
'--ymax:max Y:' \
|
||||||
'--y2min:min Y2:' \
|
'--y2min:min Y2:' \
|
||||||
'--y2max:max Y2:' \
|
'--y2max:max Y2:' \
|
||||||
'--zmin:min Z:' \
|
'--zmin:min Z:' \
|
||||||
'--zmax:max Z:' \
|
'--zmax:max Z:' \
|
||||||
'*--y2:plot to place on the Y2 axis:' \
|
'*--y2:plot to place on the Y2 axis:' \
|
||||||
'--curvestyleall[Additional styles for ALL curves]:' \
|
'--curvestyleall[Additional styles for ALL curves]:style' \
|
||||||
'*--extracmds[Additional gnuplot commands]:' \
|
'*--extracmds[Additional gnuplot commands]:command' \
|
||||||
'--square[Plot data with square aspect ratio]' \
|
'--square[Plot data with square aspect ratio]' \
|
||||||
'--square_xy[For 3D plots, set square aspect ratio for ONLY the x,y axes]' \
|
'--square_xy[For 3D plots, set square aspect ratio for ONLY the x,y axes]' \
|
||||||
'--hardcopy[Plot to a file]:' \
|
'--hardcopy[Plot to a file]:filename' \
|
||||||
'--maxcurves[The maximum allowed number of curves]:' \
|
'--maxcurves[The maximum allowed number of curves]:number of curves' \
|
||||||
'(--3d)--monotonic[Resets plot if an X in the past is seen]' \
|
'(--3d)--monotonic[Resets plot if an X in the past is seen]' \
|
||||||
'--extraValuesPerPoint[How many extra values are given for each data point]:' \
|
'--extraValuesPerPoint[How many extra values are given for each data point]:N'\
|
||||||
'--dump[Instead of printing to gnuplot, print to STDOUT]' \
|
'--dump[Instead of printing to gnuplot, print to STDOUT]' \
|
||||||
'--geometry[The X11 geometry string]:geometry string:' \
|
'--geometry[The X11 geometry string]:geometry string:' \
|
||||||
'*--curvestyle[Additional styles for a curve]:curve id: :style:' \
|
'*--curvestyle[Additional styles for a curve]:curve id: :style:' \
|
||||||
'(--3d)*--histogram:plot to treat as a histogram:' \
|
'(--3d)*--histogram:plot to treat as a histogram:' \
|
||||||
'--binwidth:Histogram bin width:' \
|
'--binwidth:Histogram bin width:' \
|
||||||
'--histstyle:Style of histogram:(frequency unique cumulative cnormal)' \
|
'--histstyle:Style of histogram:(frequency unique cumulative cnormal)' \
|
||||||
'--terminal:Terminal options to set with "set terminal":' \
|
'--terminal:Terminal options to set with "set terminal":' \
|
||||||
'*--legend[Legend for a curve]:curve id: :legend:'
|
'*--legend[Legend for a curve]:curve id: :legend:' \
|
||||||
|
'--exit[Exit gnuplot after making the plot]' \
|
||||||
|
'--version' \
|
||||||
|
'--help' \
|
||||||
|
'--timefmt[Format for time/date data]:time format'
|
||||||
|
5
debian/changelog
vendored
5
debian/changelog
vendored
@@ -1,5 +0,0 @@
|
|||||||
feedgnuplot (1.23-2) unstable; urgency=low
|
|
||||||
|
|
||||||
* Initial Debian release (Closes: #686413)
|
|
||||||
|
|
||||||
-- Dima Kogan <dima@secretsauce.net> Tue, 30 Oct 2012 11:14:01 -0700
|
|
1
debian/compat
vendored
1
debian/compat
vendored
@@ -1 +0,0 @@
|
|||||||
9
|
|
19
debian/control
vendored
19
debian/control
vendored
@@ -1,19 +0,0 @@
|
|||||||
Source: feedgnuplot
|
|
||||||
Section: science
|
|
||||||
Priority: extra
|
|
||||||
Build-Depends: debhelper (>= 9), libtest-script-run-perl, perl
|
|
||||||
Maintainer: Debian Science Maintainers <debian-science-maintainers@lists.alioth.debian.org>
|
|
||||||
Uploaders: Dima Kogan <dima@secretsauce.net>, Anton Gladky <gladky.anton@gmail.com>
|
|
||||||
Standards-Version: 3.9.4
|
|
||||||
Homepage: https://github.com/dkogan/feedgnuplot
|
|
||||||
Vcs-Git: git://git.debian.org/git/debian-science/packages/feedgnuplot.git
|
|
||||||
Vcs-Browser: http://git.debian.org/?p=debian-science/packages/feedgnuplot.git
|
|
||||||
|
|
||||||
Package: feedgnuplot
|
|
||||||
Architecture: all
|
|
||||||
Depends: ${misc:Depends}, ${perl:Depends}, gnuplot
|
|
||||||
Description: Pipe-oriented frontend to Gnuplot
|
|
||||||
Flexible, command-line-oriented frontend to Gnuplot. Creates plots from data
|
|
||||||
coming in on STDIN or given in a filename passed on the commandline. Various
|
|
||||||
data representations are supported, as is hardcopy output and streaming display
|
|
||||||
of live data.
|
|
24
debian/copyright
vendored
24
debian/copyright
vendored
@@ -1,24 +0,0 @@
|
|||||||
Format: http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
|
|
||||||
Source: https://github.com/dkogan/feedgnuplot
|
|
||||||
Upstream-Contact: Dima Kogan, <dima@secretsauce.net>
|
|
||||||
Upstream-Name: feedgnuplot
|
|
||||||
|
|
||||||
Files: *
|
|
||||||
Copyright: 2011, Dima Kogan <dima@secretsauce.net>
|
|
||||||
License: Artistic or GPL-1+
|
|
||||||
|
|
||||||
License: Artistic
|
|
||||||
This program is free software; you can redistribute it and/or modify
|
|
||||||
it under the terms of the Artistic License, which comes with Perl.
|
|
||||||
.
|
|
||||||
On Debian GNU/Linux systems, the complete text of the Artistic License
|
|
||||||
can be found in `/usr/share/common-licenses/Artistic'.
|
|
||||||
|
|
||||||
License: GPL-1+
|
|
||||||
This program is free software; you can redistribute it and/or modify
|
|
||||||
it under the terms of the GNU General Public License as published by
|
|
||||||
the Free Software Foundation; either version 1, or (at your option)
|
|
||||||
any later version.
|
|
||||||
.
|
|
||||||
On Debian GNU/Linux systems, the complete text of version 1 of the
|
|
||||||
General Public License can be found in `/usr/share/common-licenses/GPL-1'.
|
|
9
debian/feedgnuplot.doc-base
vendored
9
debian/feedgnuplot.doc-base
vendored
@@ -1,9 +0,0 @@
|
|||||||
Document: feedgnuplot
|
|
||||||
Title: Feedgnuplot Manual
|
|
||||||
Author: Dima Kogan
|
|
||||||
Abstract: Formatted manpage for feedgnuplot
|
|
||||||
Section: Science/Data Analysis
|
|
||||||
|
|
||||||
Format: HTML
|
|
||||||
Index: /usr/share/doc/feedgnuplot/feedgnuplot.html
|
|
||||||
Files: /usr/share/doc/feedgnuplot/feedgnuplot.html
|
|
1
debian/feedgnuplot.docs
vendored
1
debian/feedgnuplot.docs
vendored
@@ -1 +0,0 @@
|
|||||||
feedgnuplot.html
|
|
2
debian/feedgnuplot.install
vendored
2
debian/feedgnuplot.install
vendored
@@ -1,2 +0,0 @@
|
|||||||
completions/bash/feedgnuplot /etc/bash_completion.d/
|
|
||||||
completions/zsh/_feedgnuplot /usr/share/zsh/vendor-completions
|
|
8
debian/gbp.conf
vendored
8
debian/gbp.conf
vendored
@@ -1,8 +0,0 @@
|
|||||||
[DEFAULT]
|
|
||||||
debian-branch = debian
|
|
||||||
upstream-tree = tag
|
|
||||||
debian-tag = debian/%(version)s
|
|
||||||
upstream-tag = v%(version)s
|
|
||||||
pristine-tar = False
|
|
||||||
sign-tags = True
|
|
||||||
sign-changelog = True
|
|
12
debian/rules
vendored
12
debian/rules
vendored
@@ -1,12 +0,0 @@
|
|||||||
#!/usr/bin/make -f
|
|
||||||
|
|
||||||
%:
|
|
||||||
dh $@
|
|
||||||
|
|
||||||
override_dh_auto_build:
|
|
||||||
dh_auto_build
|
|
||||||
pod2html --title=feedgnuplot bin/feedgnuplot.pod > feedgnuplot.html
|
|
||||||
|
|
||||||
override_dh_auto_clean:
|
|
||||||
rm -rf feedgnuplot.html pod2htm*
|
|
||||||
dh_auto_clean
|
|
1
debian/source/format
vendored
1
debian/source/format
vendored
@@ -1 +0,0 @@
|
|||||||
3.0 (quilt)
|
|
2
debian/watch
vendored
2
debian/watch
vendored
@@ -1,2 +0,0 @@
|
|||||||
version = 3
|
|
||||||
https://github.com/dkogan/feedgnuplot/tags .*/tarball/v(\d[\d\.]+)
|
|
16
t/00-load.t
16
t/00-load.t
@@ -1,16 +0,0 @@
|
|||||||
#!/usr/bin/perl
|
|
||||||
|
|
||||||
# require a threaded perl for my tests. This block lifted verbatim from the cpantesters wiki
|
|
||||||
BEGIN {
|
|
||||||
use Config;
|
|
||||||
if (! $Config{'useithreads'}) {
|
|
||||||
print("1..0 # Skip: Perl not compiled with 'useithreads'\n");
|
|
||||||
exit(0);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
use Test::More tests => 1;
|
|
||||||
use Test::Script::Run;
|
|
||||||
|
|
||||||
run_ok( 'feedgnuplot', ['--help'], 'feedgnuplot can run');
|
|
||||||
|
|
Reference in New Issue
Block a user