mirror of
https://github.com/dkogan/feedgnuplot.git
synced 2025-09-18 19:18:06 +08:00
Compare commits
2 Commits
debian/1.5
...
cpanindexi
| Author | SHA1 | Date | |
|---|---|---|---|
|
cae085ae49 | ||
|
|
d9e2c3c93a |
193
Changes
193
Changes
@@ -1,196 +1,3 @@
|
||||
feedgnuplot (1.52)
|
||||
|
||||
* Added --squarexy and --square-xy as synonyms to --square_xy
|
||||
|
||||
-- Dima Kogan <dima@secretsauce.net> Sun, 25 Aug 2019 15:32:37 -0700
|
||||
|
||||
feedgnuplot (1.51)
|
||||
|
||||
* Added .gp "terminal" to create self-plotting gnuplot files
|
||||
|
||||
-- Dima Kogan <dima@secretsauce.net> Sat, 29 Sep 2018 10:56:30 -0700
|
||||
|
||||
feedgnuplot (1.50)
|
||||
|
||||
* Script waits for the plot window to close before exiting
|
||||
Instead of sleeping forever. This is really nice! I no longer need
|
||||
to quit the plot window AND then C-c. Quitting the plot window is
|
||||
now sufficient
|
||||
* by default --image sets range noextend
|
||||
* tab-completion knows about the fnormal distribution
|
||||
|
||||
-- Dima Kogan <dkogan@debian.org> Fri, 24 Aug 2018 13:11:05 -0700
|
||||
|
||||
feedgnuplot (1.49)
|
||||
|
||||
* --vnl now works with plots that have rangesize > 1
|
||||
* zsh completion: --xlen argument isn't optional
|
||||
|
||||
-- Dima Kogan <dima@secretsauce.net> Fri, 16 Mar 2018 13:52:28 -0700
|
||||
|
||||
feedgnuplot (1.48)
|
||||
|
||||
* --vnlog works properly with --domain
|
||||
|
||||
-- Dima Kogan <dima@secretsauce.net> Sat, 24 Feb 2018 12:33:50 -0800
|
||||
|
||||
feedgnuplot (1.47)
|
||||
|
||||
* Fixed typo. Everything is un-broken now
|
||||
|
||||
-- Dima Kogan <dima@secretsauce.net> Fri, 23 Feb 2018 10:21:13 -0800
|
||||
|
||||
feedgnuplot (1.46)
|
||||
|
||||
* Added --tuplesize and --tuplesizeall as alternatives to --rangesize
|
||||
and --rangesizeall. Both forms are supported.
|
||||
* Vnlog integration
|
||||
|
||||
-- Dima Kogan <dima@secretsauce.net> Thu, 22 Feb 2018 23:37:54 -0800
|
||||
|
||||
feedgnuplot (1.45)
|
||||
|
||||
* zsh completion: --hardcopy, --image suggest filenames
|
||||
* --image now produces a nicer legend: just the filename
|
||||
* --curvestyle now overrides --curvestyleall
|
||||
- This is a bug fix
|
||||
* The version is now treated as a string not as a number
|
||||
- So "1.40" is distinct from "1.4"
|
||||
|
||||
-- Dima Kogan <dima@secretsauce.net> Sun, 29 Oct 2017 13:56:28 -0700
|
||||
|
||||
feedgnuplot (1.44)
|
||||
|
||||
* --image draws its output beneath everything else
|
||||
|
||||
-- Dima Kogan <dima@secretsauce.net> Tue, 20 Jun 2017 16:44:30 -0700
|
||||
|
||||
feedgnuplot (1.43)
|
||||
|
||||
* Added --image
|
||||
|
||||
-- Dima Kogan <dima@secretsauce.net> Mon, 19 Jun 2017 13:12:38 -0700
|
||||
|
||||
feedgnuplot (1.42)
|
||||
|
||||
* Data can now come from STDIN or files on the cmdline.
|
||||
This fixes a regression. Self-plotting data files work again
|
||||
|
||||
-- Dima Kogan <dima@secretsauce.net> Fri, 31 Mar 2017 15:38:47 -0700
|
||||
|
||||
feedgnuplot (1.41)
|
||||
|
||||
* Histograms: --xlen can coexist with --xmin/--xmax
|
||||
* Histograms: work as expected with --xlen and --monotonic
|
||||
* Histograms: better sanity checking of options
|
||||
|
||||
-- Dima Kogan <dima@secretsauce.net> Fri, 24 Feb 2017 23:42:28 -0800
|
||||
|
||||
feedgnuplot (1.40)
|
||||
|
||||
* If the options couldn't be parsed I don't dump the whole manpage
|
||||
* --style and --rangesize can now take a comma-separated list of IDs
|
||||
* 'any' is from List::MoreUtils, not List::Util
|
||||
* the sleep-forever delay at end is now > 1000 days
|
||||
|
||||
-- Dima Kogan <dima@secretsauce.net> Fri, 25 Nov 2016 14:45:06 -0800
|
||||
|
||||
feedgnuplot (1.39)
|
||||
|
||||
* by default, histograms are plotted in expected ways
|
||||
|
||||
-- Dima Kogan <dima@secretsauce.net> Sat, 15 Oct 2016 20:45:15 -0700
|
||||
|
||||
feedgnuplot (1.38)
|
||||
|
||||
* hardcopy defaults:
|
||||
- no enhanced text mode
|
||||
- larger font size
|
||||
|
||||
-- Dima Kogan <dima@secretsauce.net> Wed, 27 Jul 2016 22:15:11 -0700
|
||||
|
||||
feedgnuplot (1.37)
|
||||
|
||||
* At the end of a streaming plot, include the last chunk of data
|
||||
* Added --equation to the completions
|
||||
|
||||
-- Dima Kogan <dima@secretsauce.net> Fri, 01 Jan 2016 08:09:43 -0800
|
||||
|
||||
feedgnuplot (1.36)
|
||||
|
||||
* Added --equation to plot symbolic equations
|
||||
|
||||
-- Dima Kogan <dima@secretsauce.net> Fri, 13 Nov 2015 11:08:26 -0800
|
||||
|
||||
feedgnuplot (1.35)
|
||||
|
||||
* replaced a 'say' with 'print'. Should work better with ancient perls
|
||||
* an "exit" command now has effect even with triggered-only replotting
|
||||
|
||||
* More sophisticated handling of termination conditions:
|
||||
- Without --exit, we always end up with an interactive plot when the
|
||||
input data is exhausted or when the user sends a ^C to the pipeline
|
||||
- When streaming, the first ^C does not kill feedgnuplot
|
||||
|
||||
* Removed threading
|
||||
|
||||
-- Dima Kogan <dima@secretsauce.net> Sun, 01 Nov 2015 12:50:33 -0800
|
||||
|
||||
feedgnuplot (1.34)
|
||||
|
||||
* Fix for "Use of implicit split to @_ is deprecated". Thanks to Corey
|
||||
Putkunz
|
||||
|
||||
* Declaring feedgnuplot as a package to let MetaCPAN index this
|
||||
distribution
|
||||
|
||||
-- Dima Kogan <dima@secretsauce.net> Wed, 14 May 2014 00:45:24 -0700
|
||||
|
||||
feedgnuplot (1.33)
|
||||
|
||||
* fixed incorrect plotting of --timefmt --rangesize plots
|
||||
|
||||
-- Dima Kogan <dima@secretsauce.net> Thu, 06 Feb 2014 23:17:21 -0800
|
||||
|
||||
feedgnuplot (1.32)
|
||||
|
||||
* Added --rangesize and --rangesizeall. Different curves can now plot
|
||||
different-size tuples
|
||||
|
||||
-- Dima Kogan <dima@secretsauce.net> Wed, 05 Feb 2014 13:57:58 -0800
|
||||
|
||||
feedgnuplot (1.31)
|
||||
|
||||
* Test suite requires gawk to get strftime()
|
||||
|
||||
-- Dima Kogan <dima@secretsauce.net> Sat, 25 Jan 2014 20:49:38 -0800
|
||||
|
||||
feedgnuplot (1.30)
|
||||
|
||||
* Added --with, --set, --unset, --style, --styleall
|
||||
|
||||
-- Dima Kogan <dima@secretsauce.net> Fri, 24 Jan 2014 15:38:07 -0800
|
||||
|
||||
feedgnuplot (1.29)
|
||||
|
||||
* added CPAN meta-data to require IPC::Run at build time
|
||||
|
||||
-- Dima Kogan <dima@secretsauce.net> Wed, 04 Dec 2013 21:12:40 -0800
|
||||
|
||||
feedgnuplot (1.28)
|
||||
|
||||
* Minor POD update
|
||||
|
||||
-- Dima Kogan <dima@secretsauce.net> Wed, 04 Dec 2013 02:01:05 -0800
|
||||
|
||||
feedgnuplot (1.27)
|
||||
|
||||
* Disabled tests that can fail on some arches (can be re-enabled with
|
||||
environment variable)
|
||||
* Removed sample debianization; this program is now in Debian proper
|
||||
|
||||
-- Dima Kogan <dima@secretsauce.net> Tue, 03 Dec 2013 23:37:40 -0800
|
||||
|
||||
feedgnuplot (1.26)
|
||||
|
||||
* Minor POD fixes
|
||||
|
||||
21
INSTALL
21
INSTALL
@@ -1,20 +1,21 @@
|
||||
If running on a Debian-based OS (this includes Ubuntu), it is highly recommended
|
||||
to install this program as a package. In Debian and Ubuntu, feedgnuplot is in
|
||||
the official repos, so all you need to do is
|
||||
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
|
||||
dpkg-buildpackage -us -uc -b
|
||||
sudo dpkg -i ../feedgnuplot*.deb
|
||||
|
||||
This builds a debian package and installs it.
|
||||
|
||||
Without a package, an installation can be done with
|
||||
|
||||
perl Makefile.PL prefix=/usr/local
|
||||
make
|
||||
make install
|
||||
|
||||
This installs feedgnuplot to /usr/local. Adjust the paths as required.
|
||||
|
||||
Also, note that this is a self-contained utility. Usually running from the tree
|
||||
works just fine:
|
||||
|
||||
git clone https://github.com/dkogan/feedgnuplot.git
|
||||
cd feedgnuplot/bin
|
||||
./feedgnuplot ...
|
||||
This installs feedgnuplot to /usr/local. Adjust the paths as required
|
||||
|
||||
1
MANIFEST
1
MANIFEST
@@ -1,6 +1,7 @@
|
||||
Makefile.PL
|
||||
MANIFEST
|
||||
bin/feedgnuplot
|
||||
lib/App/feedgnuplot.pm
|
||||
t/manifest.t
|
||||
t/plots.t
|
||||
Changes
|
||||
|
||||
28
Makefile.PL
28
Makefile.PL
@@ -20,9 +20,9 @@ sub parseversion
|
||||
|
||||
while(<PL>)
|
||||
{
|
||||
if( /VERSION = '([0-9\.]+)'/ )
|
||||
if( /VERSION = ([0-9\.]+)/ )
|
||||
{
|
||||
if ( $1 ne $version )
|
||||
if ( $1 != $version )
|
||||
{
|
||||
die "Version mismatch. Changes says version is '$version', but 'bin/feedgnuplot' says it is '$1'";
|
||||
}
|
||||
@@ -42,14 +42,30 @@ sub MY::libscan
|
||||
# Don't install any symlinks (i.e. README.pod)
|
||||
return undef if -l $file;
|
||||
|
||||
# Don't install any feedgnuplot.pm. This exists only to make CPAN index this
|
||||
# distribution
|
||||
return undef if $file =~ /feedgnuplot.pm/;
|
||||
|
||||
return $self->SUPER::libscan ($file);
|
||||
}
|
||||
|
||||
# I want my manpage to go into the man section '1', NOT '1p'. Here I add a
|
||||
# snippet to the end of the generated Makefile to force this
|
||||
#
|
||||
# I also generate the feedgnuplot.pm. This exists only to make CPAN index this
|
||||
# distribution
|
||||
sub MY::postamble
|
||||
{
|
||||
return "MAN1EXT := 1\n";
|
||||
return <<'EOF'
|
||||
MAN1EXT := 1
|
||||
lib/App/feedgnuplot.pm: bin/feedgnuplot
|
||||
mkdir -p lib/App
|
||||
echo 'package App::feedgnuplot;' > $@
|
||||
cat $^ >> $@
|
||||
echo '1;' >> $@
|
||||
|
||||
dist: lib/App/feedgnuplot.pm
|
||||
EOF
|
||||
}
|
||||
|
||||
|
||||
@@ -63,9 +79,7 @@ WriteMakefile
|
||||
: ()),
|
||||
PL_FILES => {},
|
||||
EXE_FILES => [ 'bin/feedgnuplot' ],
|
||||
BUILD_REQUIRES => { 'String::ShellQuote' => 0,
|
||||
'List::MoreUtils' => 0,
|
||||
'IPC::Run' => 0},
|
||||
BUILD_REQUIRES => { 'String::ShellQuote' => 0},
|
||||
dist => { COMPRESS => 'gzip -9f', SUFFIX => 'gz', },
|
||||
clean => { FILES => 'feedgnuplot-*' },
|
||||
clean => { FILES => 'feedgnuplot-* lib' },
|
||||
);
|
||||
|
||||
987
README.pod
987
README.pod
@@ -1,987 +0,0 @@
|
||||
=head1 TALK
|
||||
|
||||
I just gave a talk about this at L<SCaLE
|
||||
17x|https://www.socallinuxexpo.org/scale/17x>. Presentation lives
|
||||
L<here|https://github.com/dkogan/talk-feedgnuplot-vnlog/blob/master/feedgnuplot-vnlog.org>.
|
||||
|
||||
=head1 NAME
|
||||
|
||||
feedgnuplot - General purpose pipe-oriented plotting tool
|
||||
|
||||
=head1 SYNOPSIS
|
||||
|
||||
Simple plotting of piped 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
|
||||
--unset grid --terminal 'dumb 80,40' --exit
|
||||
|
||||
Test plot
|
||||
|
||||
10 +-----------------------------------------------------------------+ 25
|
||||
| + + + + + + + *##|
|
||||
| data 0 ***A*#* |
|
||||
| ** # |
|
||||
9 |-+ ** ## |
|
||||
| ** # |
|
||||
| ** # |
|
||||
| ** ## +-| 20
|
||||
8 |-+ A # |
|
||||
| ** # |
|
||||
| ** ## |
|
||||
| ** # |
|
||||
| ** B |
|
||||
7 |-+ ** ## |
|
||||
| ** ## +-| 15
|
||||
| ** # |
|
||||
| ** ## |
|
||||
6 |-+ *A ## |
|
||||
| ** ## |
|
||||
| ** # |
|
||||
| ** ## +-| 10
|
||||
5 |-+ ** ## |
|
||||
| ** #B |
|
||||
| ** ## |
|
||||
| ** ## |
|
||||
4 |-+ A ### |
|
||||
| ** ## |
|
||||
| ** ## +-| 5
|
||||
| ** ## |
|
||||
| ** ##B# |
|
||||
3 |-+ ** #### |
|
||||
| **#### |
|
||||
| #### |
|
||||
|## + + + + + + + |
|
||||
2 +-----------------------------------------------------------------+ 0
|
||||
1 1.5 2 2.5 3 3.5 4 4.5 5
|
||||
|
||||
|
||||
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 options such as
|
||||
C<--set>, C<--extracmds> C<--style>, etc. Arbitrary gnuplot commands can be
|
||||
passed in with C<--extracmds>. For example, to turn off the grid, you can pass
|
||||
in C<--extracmds 'unset grid'>. Commands C<--set> and C<--unset> exists to
|
||||
provide nicer syntax, so this is equivalent to passing C<--unset grid>. As many
|
||||
of these options as needed can be passed in. To add arbitrary curve styles, use
|
||||
C<--style 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<--style>,
|
||||
pass in C<--styleall extrastyle>. In the most common case, the extra style is
|
||||
C<with something>. To support this more simply, you can pass in C<--with
|
||||
something> instead of C<--styleall 'with something'>. C<--styleall> and
|
||||
C<--with> are mutually exclusive. Furthermore any curve-specific C<--style>
|
||||
overrides the global C<--styleall> or C<--with> setting.
|
||||
|
||||
=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 C<--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
|
||||
|
||||
We index the curves in one of 3 ways: sequentially, explicitly with a
|
||||
C<--dataid> or by C<--vnlog> headers.
|
||||
|
||||
By default, each column represents a separate curve. The first column (after any
|
||||
domain) is curve C<0>. The next one is curve C<1> and so on. 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.
|
||||
|
||||
If we're plotting C<vnlog> data (L<https://www.github.com/dkogan/vnlog>) then we
|
||||
can get the curve IDs from the vnlog header. Vnlog is a trivial data format
|
||||
where lines starting with C<#> are comments and the first comment contains
|
||||
column labels. If we have such data, C<feedgnuplot --vnlog> can interpret these
|
||||
column labels if the C<vnlog> perl modules are available.
|
||||
|
||||
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> or C<--vnlog>.
|
||||
|
||||
=head3 Multi-value style support
|
||||
|
||||
Depending on how gnuplot is plotting the data, more than one value may be needed
|
||||
to represent the range of a single point. Basic 2D plots have 2 numbers
|
||||
representing each point: 1 domain and 1 range. But if plotting with
|
||||
C<--circles>, for instance, then there's an extra range value: the radius. Many
|
||||
other gnuplot styles require more data: errorbars, variable colors (C<with
|
||||
points palette>), variable sizes (C<with points ps variable>), labels and so on.
|
||||
The feedgnuplot tool itself does not know about all these intricacies, but they
|
||||
can still be used, by specifying the specific style with C<--style>, and
|
||||
specifying how many values are needed for each point with any of
|
||||
C<--rangesizeall>, C<--tuplesizeall>, C<--rangesize>, C<--tuplesize>. These
|
||||
options are required I<only> for styles not explicitly supported by feedgnuplot;
|
||||
supported styles do the right thing automatically.
|
||||
|
||||
Specific example: if making a 2d plot of y error bars, the exact format can be
|
||||
queried by running C<gnuplot> and invoking C<help yerrorbars>. This tells us
|
||||
that there's a 3-column form: C<x y ydelta> and a 4-column form: C<x y ylow
|
||||
yhigh>. With 2d plots feedgnuplot will always output the 1-value domain C<x>, so
|
||||
the rangesize is 2 and 3 respectively. Thus the following are equivalent:
|
||||
|
||||
$ echo '1 2 0.3
|
||||
2 3 0.4
|
||||
3 4 0.5' | feedgnuplot --domain --rangesizeall 2 --with 'yerrorbars'
|
||||
|
||||
$ echo '1 2 0.3
|
||||
2 3 0.4
|
||||
3 4 0.5' | feedgnuplot --domain --tuplesizeall 3 --with 'yerrorbars'
|
||||
|
||||
$ echo '1 2 1.7 2.3
|
||||
2 3 2.6 3.4
|
||||
3 4 3.5 4.5' | feedgnuplot --domain --rangesizeall 3 --with 'yerrorbars'
|
||||
|
||||
=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 Time/date data
|
||||
|
||||
If the input data domain is a time/date, this can be interpreted with
|
||||
C<--timefmt>. This option takes a single argument: the format to use to parse
|
||||
the data. The format is documented in 'set timefmt' in gnuplot, although the
|
||||
common flags that C<strftime> understands are generally supported. The backslash
|
||||
sequences in the format are I<not> supported, so if you want a tab, put in a tab
|
||||
instead of \t. Whitespace in the format I<is> supported. When this flag is
|
||||
given, some other options act a little bit differently:
|
||||
|
||||
=over
|
||||
|
||||
=item
|
||||
|
||||
C<--xlen> is an I<integer> in seconds
|
||||
|
||||
=item
|
||||
|
||||
C<--xmin> and C<--xmax> I<must> use the format passed in to C<--timefmt>
|
||||
|
||||
=back
|
||||
|
||||
Using this option changes both the way the input is parsed I<and> the way the
|
||||
x-axis tics are labelled. Gnuplot tries to be intelligent in this labelling, but
|
||||
it doesn't always do what the user wants. The labelling can be controlled with
|
||||
the gnuplot C<set format> command, which takes the same type of format string as
|
||||
C<--timefmt>. Example:
|
||||
|
||||
$ sar 1 -1 |
|
||||
awk '$1 ~ /..:..:../ && $8 ~/^[0-9\.]*$/ {print $1,$8; fflush()}' |
|
||||
feedgnuplot --stream --domain
|
||||
--lines --timefmt '%H:%M:%S'
|
||||
--set 'format x "%H:%M:%S"'
|
||||
|
||||
This plots the 'idle' CPU consumption against time.
|
||||
|
||||
Note that while gnuplot supports the time/date on any axis, I<feedgnuplot>
|
||||
currently supports it I<only> as the x-axis domain. This may change in the
|
||||
future.
|
||||
|
||||
=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. Look in
|
||||
L</"Special data commands"> for more information.
|
||||
|
||||
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). If the domain is a time/date via C<--timefmt>, then
|
||||
C<windowsize> is and I<integer> in seconds. If we're plotting a histogram, then
|
||||
C<--xlen> causes a histogram over a moving window to be computed. The subtlely
|
||||
here is that with a histogram you don't actually I<see> the domain since only
|
||||
the range is analyzed. But the domain is still there, and can be utilized with
|
||||
C<--xlen>. With C<--xlen> we can plot I<only> histograms or I<only>
|
||||
I<non>-histograms.
|
||||
|
||||
=head3 Special data commands
|
||||
|
||||
If we are reading streaming data, the input stream can contain special commands
|
||||
in addition to the raw data. Feedgnuplot looks for these at the start of every
|
||||
input line. If a command is detected, the rest of the line is discarded. These
|
||||
commands are
|
||||
|
||||
=over
|
||||
|
||||
=item C<replot>
|
||||
|
||||
This command refreshes the plot right now, instead of waiting for the next
|
||||
refresh time indicated by the timer. This command works in addition to the timed
|
||||
refresh, as indicated by C<--stream [refreshperiod]>.
|
||||
|
||||
=item C<clear>
|
||||
|
||||
This command clears out the current data in the plot. The plotting process
|
||||
continues, however, to any data following the C<clear>.
|
||||
|
||||
=item C<exit>
|
||||
|
||||
This command causes feedgnuplot to exit.
|
||||
|
||||
=back
|
||||
|
||||
=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>, B<.png> or B<.gp> is requested. If any other file type is requested,
|
||||
C<--terminal> I<must> be passed in to tell gnuplot how to make the plot. If
|
||||
C<--terminal> is passed in, then the C<--hardcopy> argument only provides the
|
||||
output filename.
|
||||
|
||||
The B<.gp> output is special. Instead of asking gnuplot to plot to a particular
|
||||
terminal, writing to a B<.gp> simply dumps a self-executable gnuplot script into
|
||||
the given file. This is similar to what C<--dump> does, but writes to a file,
|
||||
and makes sure that the file can be self-executing.
|
||||
|
||||
=head2 Self-plotting data files
|
||||
|
||||
This script can be used to enable self-plotting data files. There are several
|
||||
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
|
||||
characters 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 gnuplot
|
||||
|
||||
Running C<feedgnuplot --hardcopy plotdata.gp ....> will create a self-executable
|
||||
gnuplot script in C<plotdata.gp>
|
||||
|
||||
=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
|
||||
|
||||
=over
|
||||
|
||||
=item
|
||||
|
||||
--C<[no]domain>
|
||||
|
||||
If enabled, the first element of each line is the domain variable. If not, the
|
||||
point index is used
|
||||
|
||||
=item
|
||||
|
||||
--C<[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" then
|
||||
|
||||
=over
|
||||
|
||||
=item
|
||||
|
||||
C<--nodomain --nodataid> would parse the 4 numbers as points in 4 different
|
||||
curves at x=3
|
||||
|
||||
=item
|
||||
|
||||
C<--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
|
||||
|
||||
=item
|
||||
|
||||
C<--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
|
||||
|
||||
=item
|
||||
|
||||
C<--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
|
||||
|
||||
=back
|
||||
|
||||
=item
|
||||
|
||||
C<--vnlog>
|
||||
|
||||
Vnlog is a trivial data format where lines starting with C<#> are comments and
|
||||
the first comment contains column labels. Some tools for working with such data
|
||||
are available from the C<vnlog> project: L<https://www.github.com/dkogan/vnlog>.
|
||||
With the C<vnlog> perl modules installed, we can read the vnlog column headers
|
||||
with C<feedgnuplot --vnlog>. This replaces C<--dataid>, and we can do all the
|
||||
normal things with these headers. For instance C<feedgnuplot --vnlog
|
||||
--autolegend> will generate plot legends for each column in the vnlog, using the
|
||||
vnlog column label in the legend.
|
||||
|
||||
=item
|
||||
|
||||
C<--[no]3d>
|
||||
|
||||
Do [not] plot in 3D. This only makes sense with C<--domain>. Each domain here is
|
||||
an (x,y) tuple
|
||||
|
||||
=item
|
||||
|
||||
--C<timefmt [format]>
|
||||
|
||||
Interpret the X data as a time/date, parsed with the given format
|
||||
|
||||
=item
|
||||
|
||||
C<--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 sets the
|
||||
C<--rangesize>/C<--tuplesize>.
|
||||
|
||||
=item
|
||||
|
||||
C<--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 I<only> when the incoming data dictates this. See the
|
||||
L</"Real-time streaming data"> section of the man page.
|
||||
|
||||
=item
|
||||
|
||||
C<--[no]lines>
|
||||
|
||||
Do [not] draw lines to connect consecutive points
|
||||
|
||||
=item
|
||||
|
||||
C<--[no]points>
|
||||
|
||||
Do [not] draw points
|
||||
|
||||
=item
|
||||
|
||||
C<--circles>
|
||||
|
||||
Plot with circles. This requires a radius be specified for each point.
|
||||
Automatically sets the C<--rangesize>/C<--tuplesize>. C<Not> supported for 3d
|
||||
plots.
|
||||
|
||||
=item
|
||||
|
||||
C<--title xxx>
|
||||
|
||||
Set the title of the plot
|
||||
|
||||
=item
|
||||
|
||||
C<--legend curveID legend>
|
||||
|
||||
Set the label for a curve plot. Use this option multiple times for multiple
|
||||
curves. With C<--dataid>, curveID is the ID. Otherwise, it's the index of the
|
||||
curve, starting at 0
|
||||
|
||||
=item
|
||||
|
||||
C<--autolegend>
|
||||
|
||||
Use the curve IDs for the legend. Titles given with C<--legend> override these
|
||||
|
||||
=item
|
||||
|
||||
C<--xlen xxx>
|
||||
|
||||
When using C<--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
|
||||
C<--monotonic>. If we're plotting a histogram, then C<--xlen> causes a histogram
|
||||
over a moving window to be computed. The subtlely here is that with a histogram
|
||||
you don't actually I<see> the domain since only the range is analyzed. But the
|
||||
domain is still there, and can be utilized with C<--xlen>. With C<--xlen> we can
|
||||
plot I<only> histograms or I<only> I<non>-histograms.
|
||||
|
||||
|
||||
=item
|
||||
|
||||
C<--xmin/xmax/ymin/ymax/y2min/y2max/zmin/zmax xxx>
|
||||
|
||||
Set the range for the given axis. These x-axis bounds are ignored in a streaming
|
||||
plot. The y2-axis bound do not apply in 3d plots. The z-axis bounds apply
|
||||
I<only> to 3d plots or colormaps. Note that there is no C<--xrange> to set both
|
||||
sides at once or C<--xinv> to flip the axis around: anything more than the
|
||||
basics supported in this option is clearly obtainable by talking to gnuplot, for
|
||||
instance C<--set 'xrange [20:10]'> to set the given inverted bounds.
|
||||
|
||||
=item
|
||||
|
||||
C<--xlabel/ylabel/y2label/zlabel xxx>
|
||||
|
||||
Label the given axis. The y2-axis label does not apply to 3d plots while the
|
||||
z-axis label applies I<only> to 3d plots.
|
||||
|
||||
=item
|
||||
|
||||
C<--y2 xxx>
|
||||
|
||||
Plot the data specified by this curve ID on the y2 axis. Without C<--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. By default the y2-axis
|
||||
curves look the same as the y-axis ones. I.e. the viewer of the resulting plot
|
||||
has to be told which is which via an axes label, legend, etc. Prior to version
|
||||
1.25 of feedgnuplot the curves plotted on the y2 axis were drawn with a thicker
|
||||
line. This is no longer the case, but that behavior can be brought back by
|
||||
passing something like
|
||||
|
||||
--y2 curveid --style curveid 'linewidth 3'
|
||||
|
||||
=item
|
||||
|
||||
C<--histogram curveID>
|
||||
|
||||
Set up a this specific curve to plot a histogram. The bin width is given with
|
||||
the C<--binwidth> option (assumed 1.0 if omitted). If a drawing style is not
|
||||
specified for this curve (C<--curvestyle>) or all curves (C<--with>,
|
||||
C<--curvestyleall>) then the default histogram style is set: filled boxes with
|
||||
borders. This is what the user generally wants. This works with C<--domain>
|
||||
and/or C<--stream>, but in those cases the x-value is used I<only> to cull old
|
||||
data because of C<--xlen> or C<--monotonic>. I.e. the domain values are I<not>
|
||||
drawn in any way. Can be passed multiple times, or passed a comma- separated
|
||||
list
|
||||
|
||||
=item
|
||||
|
||||
C<--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.
|
||||
|
||||
=item
|
||||
|
||||
C<--histstyle style>
|
||||
|
||||
Normally, histograms are generated with the 'smooth frequency' gnuplot style.
|
||||
C<--histstyle> can be used to select different C<smooth> settings (see the
|
||||
gnuplot C<help smooth> page for more info). Allowed values are 'frequency' (the
|
||||
default), 'fnormal' (available in very recent gnuplots), 'unique', 'cumulative'
|
||||
and 'cnormal'. 'fnormal' is a normalized histogram. '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 'frequency' histogram.
|
||||
'cnormal' is like 'cumulative', but rescaled to end up at 1.0.
|
||||
|
||||
=item
|
||||
|
||||
C<--style curveID style>
|
||||
|
||||
Additional styles per curve. With C<--dataid>, curveID is the ID. Otherwise,
|
||||
it's the index of the curve, starting at 0. curveID can be a comma-separated
|
||||
list of IDs to which the given style should apply. Use this option multiple
|
||||
times for multiple curves. C<--styleall> does I<not> apply to curves that have a
|
||||
C<--style>.
|
||||
|
||||
=item
|
||||
|
||||
C<--curvestyle curveID>
|
||||
|
||||
Synonym for C<--style>
|
||||
|
||||
=item
|
||||
|
||||
C<--styleall xxx>
|
||||
|
||||
Additional styles for all curves that have no C<--style>. This is overridden by
|
||||
any applicable C<--style>. Exclusive with C<--with>.
|
||||
|
||||
=item
|
||||
|
||||
C<--curvestyleall xxx>
|
||||
|
||||
Synonym for C<--styleall>
|
||||
|
||||
=item
|
||||
|
||||
C<--with xxx>
|
||||
|
||||
Same as C<--styleall>, but prefixed with "with". Thus
|
||||
|
||||
--with boxes
|
||||
|
||||
is equivalent to
|
||||
|
||||
--styleall 'with boxes'
|
||||
|
||||
Exclusive with C<--styleall>.
|
||||
|
||||
=item
|
||||
|
||||
C<--extracmds xxx>
|
||||
|
||||
Additional commands to pass on to gnuplot verbatim. These could contain extra
|
||||
global styles for instance. Can be passed multiple times.
|
||||
|
||||
=item
|
||||
|
||||
C<--set xxx>
|
||||
|
||||
Additional 'set' commands to pass on to gnuplot verbatim. C<--set 'a b c'> will
|
||||
result in gnuplot seeing a C<set a b c> command. Can be passed multiple times.
|
||||
|
||||
=item
|
||||
|
||||
C<--unset xxx>
|
||||
|
||||
Additional 'unset' commands to pass on to gnuplot verbatim. C<--unset 'a b c'>
|
||||
will result in gnuplot seeing a C<unset a b c> command. Can be passed multiple
|
||||
times.
|
||||
|
||||
=item
|
||||
|
||||
C<--image filename>
|
||||
|
||||
Overlays the data on top of a raster image given in C<filename>. This is passed
|
||||
through to gnuplot via C<--equation>, and is not interpreted by C<feedgnuplot>
|
||||
other than checking for existence. Usually images have their origin at the
|
||||
top-left corner, while plots have it in the bottom-left corner instead. Thus if
|
||||
the y-axis extents are not specified (C<--ymin>, C<--ymax>, C<--set 'yrange
|
||||
...'>) this option will also flip around the y axis to make the image appear
|
||||
properly. Since this option is just a passthrough to gnuplot, finer control can
|
||||
be achieved by passing in C<--equation> and C<--set yrange ...> directly.
|
||||
|
||||
C<--equation xxx>
|
||||
|
||||
Gnuplot can plot both data and symbolic equations. C<feedgnuplot> generally
|
||||
plots data, but with this option can plot symbolic equations I<also>. This is
|
||||
generally intended to augment data plots, since for equation-only plots you
|
||||
don't need C<feedgnuplot>. C<--equation> can be passed multiple times for
|
||||
multiple equations. The given strings are passed to gnuplot directly without
|
||||
anything added or removed, so styling and such should be applied in the string.
|
||||
A basic example:
|
||||
|
||||
seq 100 | awk '{print $1/10, $1/100}' |
|
||||
feedgnuplot --with 'lines lw 3' --domain --ymax 1
|
||||
--equation 'sin(x)/x' --equation 'cos(x)/x with lines lw 4'
|
||||
|
||||
Here I plot the incoming data (points along a line) with the given style (a line
|
||||
with thickness 3), I<and> I plot two damped sinusoids on the same plot. The
|
||||
sinusoids are not affected by C<feedgnuplot> styling, so their styles are set
|
||||
separately, as in this example. More complicated example:
|
||||
|
||||
seq 360 | perl -nE '$th=$_/360 * 3.14*2; $c=cos($th); $s=sin($th); say "$c $s"' |
|
||||
feedgnuplot --domain --square
|
||||
--set parametric --set "trange [0:2*3.14]" --equation "sin(t),cos(t)"
|
||||
|
||||
Here the data I generate is points along the unit circle. I plot these as
|
||||
points, and I I<also> plot a true circle as a parametric equation.
|
||||
|
||||
=item
|
||||
|
||||
C<--square>
|
||||
|
||||
Plot data with aspect ratio 1. For 3D plots, this controls the aspect ratio for
|
||||
all 3 axes
|
||||
|
||||
=item
|
||||
|
||||
C<--square-xy>
|
||||
|
||||
For 3D plots, set square aspect ratio for ONLY the x,y axes
|
||||
|
||||
=item
|
||||
|
||||
C<--hardcopy xxx>
|
||||
|
||||
If not streaming, output to a file specified here. Format inferred from
|
||||
filename, unless specified by C<--terminal>. If C<--terminal> is given,
|
||||
C<--hardcopy> sets I<only> the output filename.
|
||||
|
||||
=item
|
||||
|
||||
C<--terminal xxx>
|
||||
|
||||
String passed to 'set terminal'. No attempts are made to validate this.
|
||||
C<--hardcopy> sets this to some sensible defaults if C<--hardcopy> is set to a
|
||||
filename ending in C<.png>, C<.pdf>, C<.ps>, C<.eps> or C<.svg>. If any other
|
||||
file type is desired, use both C<--hardcopy> and C<--terminal>
|
||||
|
||||
=item
|
||||
|
||||
C<--maxcurves N>
|
||||
|
||||
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
|
||||
|
||||
=item
|
||||
|
||||
C<--monotonic>
|
||||
|
||||
If C<--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 C<--monotonic>, all data is
|
||||
kept. Does not make sense with 3d plots. No C<--monotonic> by default. The data
|
||||
is replotted before being purged. This is useful in streaming plots where the
|
||||
incoming data represents multiple iterations of the same process (repeated
|
||||
simulations of the same period in time, for instance).
|
||||
|
||||
=item
|
||||
|
||||
C<--rangesize curveID N>
|
||||
|
||||
The options C<--rangesizeall> and C<--rangesize> set the number of values are
|
||||
needed to represent each point being plotted (see L</"Multi-value style
|
||||
support"> above). These options are I<only> needed if unknown styles are used,
|
||||
with C<--styleall> or C<--with> for instance.
|
||||
|
||||
C<--rangesize> is used to set how many values are needed to represent the range
|
||||
of a point for a particular curve. This overrides any defaults that may exist
|
||||
for this curve only.
|
||||
|
||||
With C<--dataid>, curveID is the ID. Otherwise, it's the index of the curve,
|
||||
starting at 0. curveID can be a comma-separated list of IDs to which the given
|
||||
rangesize should apply.
|
||||
|
||||
=item
|
||||
|
||||
C<--tuplesize curveID N>
|
||||
|
||||
Very similar to C<--rangesize>, but instead of specifying the I<range> only,
|
||||
this specifies the whole tuple. For instance if we're plotting circles, the
|
||||
tuplesize is 3: C<x,y,radius>. In a 2D plot there's a 1-dimensional domain:
|
||||
C<x>, so the rangesize is 2: C<y,radius>. This dimensionality can be given
|
||||
either way.
|
||||
|
||||
=item
|
||||
|
||||
C<--rangesizeall N>
|
||||
|
||||
Like C<--rangesize>, but applies to I<all> the curves.
|
||||
|
||||
=item
|
||||
|
||||
C<--tuplesizeall N>
|
||||
|
||||
Like C<--tuplesize>, but applies to I<all> the curves.
|
||||
|
||||
=item
|
||||
|
||||
C<--dump>
|
||||
|
||||
Instead of printing to gnuplot, print to STDOUT. Very useful for debugging. It
|
||||
is possible to send the output produced this way to gnuplot directly.
|
||||
|
||||
=item
|
||||
|
||||
C<--exit>
|
||||
|
||||
This controls what happens when the input data is exhausted, or when some part
|
||||
of the C<feedgnuplot> pipeline is killed. This option does different things
|
||||
depending on whether C<--stream> is active, so read this closely.
|
||||
|
||||
With interactive gnuplot terminals (qt, x11, wxt), the plot windows live in a
|
||||
separate process from the main C<gnuplot> process. It is thus possible for the
|
||||
main C<gnuplot> process to exit, while leaving the plot windows up (a caveat is
|
||||
that such decapitated windows aren't interactive). There are 3 possible states
|
||||
of the polotting pipeline:
|
||||
|
||||
=over
|
||||
|
||||
=item Alive: C<feedgnuplot>, C<gnuplot> alive, plot window process alive, no
|
||||
shell prompt (shell busy with C<feedgnuplot>)
|
||||
|
||||
=item Half-alive: C<feedgnuplot>, C<gnuplot> dead, plot window process alive
|
||||
(but non-interactive), shell prompt available
|
||||
|
||||
=item Dead: C<feedgnuplot>, C<gnuplot> dead, plot window process dead, shell
|
||||
prompt available
|
||||
|
||||
=back
|
||||
|
||||
The possibilities are:
|
||||
|
||||
=over
|
||||
|
||||
=item No C<--stream>, all data read in
|
||||
|
||||
=over
|
||||
|
||||
=item no C<--exit> (default)
|
||||
|
||||
Alive. Need to Ctrl-C to get back into the shell
|
||||
|
||||
=item C<--exit>
|
||||
|
||||
Half-alive. Non-interactive prompt up, and the shell accepts new commands.
|
||||
Without C<--stream> the goal is to show a plot, so a Dead state would not be
|
||||
useful.
|
||||
|
||||
=back
|
||||
|
||||
=item C<--stream>, all data read in or the C<feedgnuplot> process terminated
|
||||
|
||||
=over
|
||||
|
||||
=item no C<--exit> (default)
|
||||
|
||||
Alive. Need to Ctrl-C to get back into the shell. This means that when making
|
||||
live plots, the first Ctrl-C kills the data feeding process, but leaves the
|
||||
final plot up for inspection. A second Ctrl-C kills feedgnuplot as well.
|
||||
|
||||
=item C<--exit>
|
||||
|
||||
Dead. No plot is shown, and the shell accepts new commands. With C<--stream> the
|
||||
goal is to show a plot as the data comes in, which we have been doing. Now that
|
||||
we're done, we can clean up everything.
|
||||
|
||||
=back
|
||||
|
||||
=back
|
||||
|
||||
Note that one usually invokes C<feedgnuplot> as a part of a shell pipeline:
|
||||
|
||||
$ write_data | feedgnuplot
|
||||
|
||||
If the user terminates this pipeline with ^C, then I<all> the processes in the
|
||||
pipeline receive SIGINT. This normally kills C<feedgnuplot> and all its
|
||||
C<gnuplot> children, and we let this happen unless C<--stream> and no C<--exit>.
|
||||
If C<--stream> and no C<--exit>, then we ignore the first ^C. The data feeder
|
||||
dies, and we behave as if the input data was exhausted. A second ^C kills us
|
||||
also.
|
||||
|
||||
=item
|
||||
|
||||
C<--geometry>
|
||||
|
||||
If using X11, specifies the size, position of the plot window
|
||||
|
||||
=item
|
||||
|
||||
C<--version>
|
||||
|
||||
Print the version and exit
|
||||
|
||||
=back
|
||||
|
||||
=head1 RECIPES
|
||||
|
||||
=head2 Basic plotting of piped 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
|
||||
|
||||
=head2 Realtime plot of network throughput
|
||||
|
||||
Looks at wlan0 on 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
|
||||
|
||||
=head2 Realtime plot of battery charge in respect to time
|
||||
|
||||
Uses the result of the C<acpi> command.
|
||||
|
||||
$ while true; do acpi; sleep 15; done |
|
||||
perl -nE 'BEGIN{ $| = 1; } /([0-9]*)%/; say join(" ", time(), $1);' |
|
||||
feedgnuplot --stream --ymin 0 --ymax 100 --lines --domain --xlabel 'Time' --timefmt '%s' --ylabel "Battery charge (%)"
|
||||
|
||||
=head2 Realtime plot of temperatures in an IBM Thinkpad
|
||||
|
||||
Uses C</proc/acpi/ibm/thermal>, which reports temperatures at various locations
|
||||
in a Thinkpad.
|
||||
|
||||
$ while true; do cat /proc/acpi/ibm/thermal | awk '{$1=""; print}' ; sleep 1; done |
|
||||
feedgnuplot --stream --xlen 100 --lines --autolegend --ymax 100 --ymin 20 --ylabel 'Temperature (deg C)'
|
||||
|
||||
=head2 Plotting a histogram of file sizes in a directory, granular to 10MB
|
||||
|
||||
$ ls -l | awk '{print $5/1e6}' |
|
||||
feedgnuplot --histogram 0
|
||||
--binwidth 10
|
||||
--ymin 0 --xlabel 'File size (MB)' --ylabel Frequency
|
||||
|
||||
=head2 Plotting a live histogram of the ping round-trip times for the past 20 seconds
|
||||
|
||||
$ ping -A -D 8.8.8.8 |
|
||||
perl -anE 'BEGIN { $| = 1; }
|
||||
$F[0] =~ s/[\[\]]//g or next;
|
||||
$F[7] =~ s/.*=//g or next;
|
||||
say "$F[0] $F[7]"' |
|
||||
feedgnuplot --stream --domain --histogram 0 --binwidth 10 \
|
||||
--xlabel 'Ping round-trip time (s)' \
|
||||
--ylabel Frequency --xlen 20
|
||||
|
||||
=head2 Plotting points on top of an existing image
|
||||
|
||||
This can be done with C<--image>:
|
||||
|
||||
$ < features_xy.data
|
||||
feedgnuplot --points --domain --image "image.png"
|
||||
|
||||
or with C<--equation>:
|
||||
|
||||
$ < features_xy.data
|
||||
feedgnuplot --points --domain
|
||||
--equation '"image.png" binary filetype=auto flipy with rgbimage'
|
||||
--set 'yrange [:] reverse'
|
||||
|
||||
The C<--image> invocation is a convenience wrapper for the C<--equation>
|
||||
version. Finer control is available with C<--equation>.
|
||||
|
||||
|
||||
Here an existing image is given to gnuplot verbatim, and data to plot on top of
|
||||
it is interpreted by feedgnuplot as usual. C<flipy> is useful here because
|
||||
usually the y axis points up, but when looking at images, this is usually
|
||||
reversed: the origin is the top-left pixel.
|
||||
|
||||
=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
README.pod
Symbolic link
1
README.pod
Symbolic link
@@ -0,0 +1 @@
|
||||
bin/feedgnuplot
|
||||
1452
bin/feedgnuplot
1452
bin/feedgnuplot
File diff suppressed because it is too large
Load Diff
@@ -7,21 +7,12 @@ complete -W \
|
||||
--colormap \
|
||||
--curvestyle \
|
||||
--curvestyleall \
|
||||
--style \
|
||||
--styleall \
|
||||
--with \
|
||||
--dataid \
|
||||
--domain \
|
||||
--dump \
|
||||
--exit \
|
||||
--extraValuesPerPoint \
|
||||
--rangesizeall \
|
||||
--rangesize \
|
||||
--extracmds \
|
||||
--set \
|
||||
--unset \
|
||||
--equation \
|
||||
--image \
|
||||
--geometry \
|
||||
--hardcopy \
|
||||
--help \
|
||||
@@ -33,7 +24,7 @@ complete -W \
|
||||
--monotonic \
|
||||
--points \
|
||||
--square \
|
||||
--square-xy \
|
||||
--square_xy \
|
||||
--stream \
|
||||
--terminal \
|
||||
--timefmt \
|
||||
|
||||
@@ -16,7 +16,7 @@ _arguments -S
|
||||
'--zlabel:Z-axis label:' \
|
||||
'--title:Plot title:' \
|
||||
'--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:' \
|
||||
'(--xlen)--xmin:min X:' \
|
||||
'(--xlen)--xmax:max X:' \
|
||||
'--ymin:min Y:' \
|
||||
@@ -26,29 +26,20 @@ _arguments -S
|
||||
'--zmin:min Z:' \
|
||||
'--zmax:max Z:' \
|
||||
'*--y2:plot to place on the Y2 axis:' \
|
||||
'(--with)--curvestyleall[Additional styles for ALL curves]:style' \
|
||||
'(--with)--styleall[Additional styles for ALL curves]:style' \
|
||||
'(--curvestyleall)--with[Additional styles for ALL curves]:style' \
|
||||
'--curvestyleall[Additional styles for ALL curves]:style' \
|
||||
'*--extracmds[Additional gnuplot commands]:command' \
|
||||
'*--set[Additional 'set' gnuplot commands]:set-option' \
|
||||
'*--unset[Additional 'unset' gnuplot commands]:unset-option' \
|
||||
'*--equation[Raw symbolic equation]:equation' \
|
||||
'--image[Image file to render beneath the data]:image:_files -g "(#i)*.(jpg|jpeg|png|gif)"' \
|
||||
'--square[Plot data with square aspect ratio]' \
|
||||
'--square-xy[For 3D plots, set square aspect ratio for ONLY the x,y axes]' \
|
||||
'--hardcopy[Plot to a file]:new image filename:_files -g "(#i)*.(jpg|jpeg|png|gif)"' \
|
||||
'--square_xy[For 3D plots, set square aspect ratio for ONLY the x,y axes]' \
|
||||
'--hardcopy[Plot to a file]:filename' \
|
||||
'--maxcurves[The maximum allowed number of curves]:number of curves' \
|
||||
'(--3d)--monotonic[Resets plot if an X in the past is seen]' \
|
||||
'(--rangesizeall)--extraValuesPerPoint[How many extra values are given for each data range]:N'\
|
||||
'(--extraValuesPerPoint)--rangesizeall[How many values are given for each data range]:N'\
|
||||
'*--rangesize[How many values comprise a data range in this curve]:curve id: :N:' \
|
||||
'--extraValuesPerPoint[How many extra values are given for each data point]:N'\
|
||||
'--dump[Instead of printing to gnuplot, print to STDOUT]' \
|
||||
'--geometry[The X11 geometry string]:geometry string:' \
|
||||
'*--curvestyle[Additional styles for a curve]:curve id: :style:' \
|
||||
'*--style[Additional styles for a curve]:curve id: :style:' \
|
||||
'(--3d)*--histogram:plot to treat as a histogram:' \
|
||||
'--binwidth:Histogram bin width:' \
|
||||
'--histstyle:Style of histogram:(frequency fnormal unique cumulative cnormal)' \
|
||||
'--histstyle:Style of histogram:(frequency unique cumulative cnormal)' \
|
||||
'--terminal:Terminal options to set with "set terminal":' \
|
||||
'*--legend[Legend for a curve]:curve id: :legend:' \
|
||||
'--exit[Exit gnuplot after making the plot]' \
|
||||
|
||||
183
debian/changelog
vendored
183
debian/changelog
vendored
@@ -1,179 +1,11 @@
|
||||
feedgnuplot (1.52-1) unstable; urgency=medium
|
||||
|
||||
[ Jelmer Vernooij ]
|
||||
* Use secure copyright file specification URI.
|
||||
* Trim trailing whitespace.
|
||||
|
||||
[ Dima Kogan ]
|
||||
* New upstream release
|
||||
- --square-xy and --squarexy as synonyms for --square_xy
|
||||
|
||||
-- Dima Kogan <dkogan@debian.org> Sun, 25 Aug 2019 15:34:56 -0700
|
||||
|
||||
feedgnuplot (1.51-1) unstable; urgency=medium
|
||||
|
||||
* Added .gp "terminal" to create self-plotting gnuplot files
|
||||
|
||||
-- Dima Kogan <dkogan@debian.org> Sat, 29 Sep 2018 11:00:40 -0700
|
||||
|
||||
feedgnuplot (1.50-1) unstable; urgency=medium
|
||||
|
||||
* Script waits for the plot window to close before exiting
|
||||
Instead of sleeping forever. This is really nice! I no longer need
|
||||
to quit the plot window AND then C-c. Quitting the plot window is
|
||||
now sufficient
|
||||
* by default --image sets range noextend
|
||||
* tab-completion knows about the fnormal distribution
|
||||
|
||||
-- Dima Kogan <dkogan@debian.org> Fri, 24 Aug 2018 13:16:35 -0700
|
||||
|
||||
feedgnuplot (1.49-2) unstable; urgency=medium
|
||||
|
||||
* Updated Vcs-... tags to salsa
|
||||
|
||||
-- Dima Kogan <dkogan@debian.org> Sun, 17 Jun 2018 22:18:18 -0700
|
||||
|
||||
feedgnuplot (1.49-1) unstable; urgency=medium
|
||||
|
||||
* --vnl now works with plots that have rangesize > 1
|
||||
* zsh completion: --xlen argument isn't optional
|
||||
|
||||
-- Dima Kogan <dkogan@debian.org> Fri, 16 Mar 2018 13:56:27 -0700
|
||||
|
||||
feedgnuplot (1.48-1) unstable; urgency=medium
|
||||
|
||||
* Added --tuplesize and --tuplesizeall
|
||||
* vnlog integration
|
||||
|
||||
-- Dima Kogan <dkogan@debian.org> Sat, 24 Feb 2018 12:56:05 -0800
|
||||
|
||||
feedgnuplot (1.45-1) unstable; urgency=medium
|
||||
|
||||
* zsh completion: --hardcopy, --image suggest filenames
|
||||
* --image now produces a nicer legend: just the filename
|
||||
* --curvestyle now overrides --curvestyleall
|
||||
- This is a bug fix
|
||||
* The version is now treated as a string not as a number
|
||||
- So "1.40" is distinct from "1.4"
|
||||
|
||||
-- Dima Kogan <dkogan@debian.org> Sun, 29 Oct 2017 14:06:26 -0700
|
||||
|
||||
feedgnuplot (1.44-1) unstable; urgency=medium
|
||||
|
||||
* --image always goes on the FRONT of the equation list
|
||||
|
||||
-- Dima Kogan <dkogan@debian.org> Tue, 20 Jun 2017 16:45:42 -0700
|
||||
|
||||
feedgnuplot (1.43-1) unstable; urgency=medium
|
||||
|
||||
* added --image as a convenience wrapper for --equation
|
||||
|
||||
-- Dima Kogan <dkogan@debian.org> Mon, 19 Jun 2017 13:16:18 -0700
|
||||
|
||||
feedgnuplot (1.42-1) unstable; urgency=medium
|
||||
|
||||
* Upstream update:
|
||||
- Fixed regression: data can now come from STDIN or files on the
|
||||
cmdline
|
||||
- reworded manpage of --exit
|
||||
|
||||
-- Dima Kogan <dkogan@debian.org> Tue, 25 Apr 2017 11:02:18 -0700
|
||||
|
||||
feedgnuplot (1.41-1) unstable; urgency=medium
|
||||
|
||||
* Upstream update:
|
||||
- Histograms: --xlen can coexist with --xmin/--xmax
|
||||
- Histograms: work as expected with --xlen and --monotonic
|
||||
- Histograms: better sanity checking of options
|
||||
|
||||
-- Dima Kogan <dkogan@debian.org> Fri, 24 Feb 2017 23:53:27 -0800
|
||||
|
||||
feedgnuplot (1.40-1) unstable; urgency=medium
|
||||
|
||||
* Upstream update:
|
||||
- If the options couldn't be parsed I don't dump the whole manpage
|
||||
- --style and --rangesize can now take a comma-separated list of IDs
|
||||
- 'any' is from List::MoreUtils, not List::Util
|
||||
- the sleep-forever delay at end is now > 1000 days
|
||||
|
||||
-- Dima Kogan <dkogan@debian.org> Fri, 25 Nov 2016 14:49:36 -0800
|
||||
|
||||
feedgnuplot (1.39-1) unstable; urgency=medium
|
||||
|
||||
* Upstream update:
|
||||
- by default, histograms are plotted in expected ways
|
||||
- No enhanced text mode in hardcopies, slightly larger font size
|
||||
|
||||
-- Dima Kogan <dkogan@debian.org> Sat, 15 Oct 2016 20:45:15 -0700
|
||||
|
||||
feedgnuplot (1.37-1) unstable; urgency=medium
|
||||
|
||||
* Upstream update: At the end of a streaming plot, include the last
|
||||
chunk of data
|
||||
|
||||
-- Dima Kogan <dima@secretsauce.net> Fri, 01 Jan 2016 08:14:23 -0800
|
||||
|
||||
feedgnuplot (1.36-1) unstable; urgency=medium
|
||||
|
||||
* Upstream update: added --equation to plot symbolic equations
|
||||
|
||||
-- Dima Kogan <dima@secretsauce.net> Fri, 13 Nov 2015 11:14:30 -0800
|
||||
|
||||
feedgnuplot (1.35-1) unstable; urgency=medium
|
||||
|
||||
* Upstream update: fancier handling of termination conditions, no more
|
||||
threading code
|
||||
|
||||
-- Dima Kogan <dima@secretsauce.net> Mon, 02 Nov 2015 13:55:32 -0800
|
||||
|
||||
feedgnuplot (1.34-2) unstable; urgency=medium
|
||||
|
||||
* Depends now works with the 'gnuplot5' packages
|
||||
|
||||
-- Dima Kogan <dima@secretsauce.net> Fri, 10 Oct 2014 14:05:17 -0700
|
||||
|
||||
feedgnuplot (1.34-1) unstable; urgency=medium
|
||||
|
||||
* Very minor upstream update
|
||||
* gnuplot-nox can no satisfy the gnuplot dependency for feedgnuplot
|
||||
|
||||
-- Dima Kogan <dima@secretsauce.net> Wed, 06 Aug 2014 15:19:56 -0700
|
||||
|
||||
feedgnuplot (1.33-1) unstable; urgency=low
|
||||
|
||||
* Upstream update: fixed incorrect plotting of --timefmt --rangesize
|
||||
plots
|
||||
|
||||
-- Dima Kogan <dima@secretsauce.net> Thu, 06 Feb 2014 23:19:02 -0800
|
||||
|
||||
feedgnuplot (1.32-1) unstable; urgency=low
|
||||
|
||||
* Added --rangesize and --rangesizeall. Different curves can now plot
|
||||
different-size tuples
|
||||
|
||||
-- Dima Kogan <dima@secretsauce.net> Wed, 05 Feb 2014 14:00:44 -0800
|
||||
|
||||
feedgnuplot (1.30-1) unstable; urgency=low
|
||||
|
||||
* made the VCS links canonical
|
||||
* added --set, --unset, --with, --style, --styleall
|
||||
|
||||
-- Dima Kogan <dima@secretsauce.net> Fri, 24 Jan 2014 15:50:03 -0800
|
||||
|
||||
feedgnuplot (1.28-1) unstable; urgency=low
|
||||
|
||||
* Upstream update:
|
||||
- Removed example debianization
|
||||
- Removed unreliable unit tests from automated testing (Closes: #731080)
|
||||
* gnuplot dependency now favors graphical gnuplot packages
|
||||
* Removed Anton Gladky from the Uploaders
|
||||
|
||||
-- Dima Kogan <dima@secretsauce.net> Wed, 04 Dec 2013 02:05:08 -0800
|
||||
|
||||
feedgnuplot (1.26-1) unstable; urgency=low
|
||||
|
||||
[ Dima Kogan ]
|
||||
* Minor POD update
|
||||
|
||||
-- Dima Kogan <dima@secretsauce.net> Sun, 20 Oct 2013 01:19:51 -0700
|
||||
|
||||
feedgnuplot (1.25-1) unstable; urgency=low
|
||||
|
||||
* Added test suite
|
||||
* Added initial support for --timefmt. Currently time/date data is
|
||||
supported only at the x-axis domain
|
||||
@@ -184,10 +16,7 @@ feedgnuplot (1.26-1) unstable; urgency=low
|
||||
* --hardcopy now handles piped output (gnuplot 'set output |process'
|
||||
syntax)
|
||||
|
||||
[ Anton Gladky ]
|
||||
* Add libipc-run-perl to Build-Depends to execute tests
|
||||
|
||||
-- Dima Kogan <dima@secretsauce.net> Sun, 20 Oct 2013 01:19:51 -0700
|
||||
-- Dima Kogan <dima@secretsauce.net> Sun, 20 Oct 2013 00:57:23 -0700
|
||||
|
||||
feedgnuplot (1.24-2) unstable; urgency=low
|
||||
|
||||
|
||||
13
debian/control
vendored
13
debian/control
vendored
@@ -1,20 +1,17 @@
|
||||
Source: feedgnuplot
|
||||
Section: science
|
||||
Priority: optional
|
||||
Build-Depends: debhelper (>= 9), libstring-shellquote-perl, perl, gawk, gnuplot, libipc-run-perl
|
||||
Build-Depends: debhelper (>= 9), libstring-shellquote-perl, perl, gawk, gnuplot
|
||||
Maintainer: Debian Science Maintainers <debian-science-maintainers@lists.alioth.debian.org>
|
||||
Uploaders: Dima Kogan <dkogan@debian.org>
|
||||
Uploaders: Dima Kogan <dima@secretsauce.net>, Anton Gladky <gladk@debian.org>
|
||||
Standards-Version: 3.9.4
|
||||
Homepage: https://github.com/dkogan/feedgnuplot
|
||||
Vcs-Browser: https://salsa.debian.org/science-team/feedgnuplot
|
||||
Vcs-Git: https://salsa.debian.org/science-team/feedgnuplot.git
|
||||
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},
|
||||
liblist-moreutils-perl,
|
||||
gnuplot-qt | gnuplot-x11 | gnuplot-nox | gnuplot5-qt | gnuplot5-x11 | gnuplot5-nox | gnuplot
|
||||
Suggests: vnlog
|
||||
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
|
||||
|
||||
2
debian/copyright
vendored
2
debian/copyright
vendored
@@ -1,4 +1,4 @@
|
||||
Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.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
|
||||
|
||||
2
debian/feedgnuplot.install
vendored
2
debian/feedgnuplot.install
vendored
@@ -1,2 +1,2 @@
|
||||
completions/bash/feedgnuplot /usr/share/bash-completion/completions/
|
||||
completions/bash/feedgnuplot /etc/bash_completion.d/
|
||||
completions/zsh/_feedgnuplot /usr/share/zsh/vendor-completions
|
||||
|
||||
@@ -1,58 +0,0 @@
|
||||
# Sample spec file for rpm-based systems. Debian-based systems already have this
|
||||
# packaged, so we do not ship those here
|
||||
|
||||
Name: feedgnuplot
|
||||
Version: 1.38
|
||||
Release: 1%{?dist}
|
||||
Summary: Pipe-oriented frontend to Gnuplot
|
||||
BuildArch: noarch
|
||||
|
||||
License: Artistic or GPL-1+
|
||||
URL: https://www.github.com/dkogan/feedgnuplot/
|
||||
Source0: https://www.github.com/dkogan/feedgnuplot/archive/v%{version}.tar.gz#/%{name}-%{version}.tar.gz
|
||||
|
||||
BuildRequires: /usr/bin/pod2html
|
||||
BuildRequires: perl-String-ShellQuote
|
||||
BuildRequires: perl-ExtUtils-MakeMaker
|
||||
BuildRequires: perl
|
||||
BuildRequires: gawk
|
||||
BuildRequires: gnuplot
|
||||
BuildRequires: perl-IPC-Run
|
||||
|
||||
Requires: gnuplot
|
||||
|
||||
%description
|
||||
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.
|
||||
|
||||
%prep
|
||||
%setup -q
|
||||
|
||||
%build
|
||||
perl Makefile.PL INSTALLDIRS=vendor
|
||||
make
|
||||
pod2html --title=feedgnuplot bin/feedgnuplot > feedgnuplot.html
|
||||
|
||||
%install
|
||||
make install DESTDIR=%{buildroot} PREFIX=/usr
|
||||
|
||||
mkdir -p %{buildroot}%{_defaultdocdir}/%{name}
|
||||
cp Changes LICENSE feedgnuplot.html %{buildroot}%{_defaultdocdir}/%{name}
|
||||
|
||||
mkdir -p %{buildroot}%{_datadir}/zsh/site-functions
|
||||
cp completions/zsh/* %{buildroot}%{_datadir}/zsh/site-functions
|
||||
|
||||
mkdir -p %{buildroot}%{_datadir}/bash-completion/completions
|
||||
cp completions/bash/* %{buildroot}%{_datadir}/bash-completion/completions
|
||||
|
||||
rm -rf %{buildroot}/usr/lib64
|
||||
|
||||
|
||||
%files
|
||||
%{_bindir}/*
|
||||
%{_datadir}/zsh/*
|
||||
%{_datadir}/bash-completion/*
|
||||
%doc %{_defaultdocdir}/%{name}/*
|
||||
%doc %{_mandir}
|
||||
111
package_definitions/debian/changelog
Normal file
111
package_definitions/debian/changelog
Normal file
@@ -0,0 +1,111 @@
|
||||
feedgnuplot (1.22) unstable; urgency=low
|
||||
|
||||
* removed --size option
|
||||
|
||||
-- Dima Kogan <dima@secretsauce.net> Mon, 03 Sep 2012 08:33:26 -0700
|
||||
|
||||
feedgnuplot (1.21) unstable; urgency=low
|
||||
|
||||
* removed the POD from the script to its own file
|
||||
* fixed regression to allow no given extracmds, histogram or y2
|
||||
options
|
||||
|
||||
-- Dima Kogan <dima@secretsauce.net> Sun, 02 Sep 2012 23:52:21 -0700
|
||||
|
||||
feedgnuplot (1.20) unstable; urgency=low
|
||||
|
||||
* no longer hardcoding 'x11' as the default terminal
|
||||
* added histogram support
|
||||
* generic terminals can now be requested
|
||||
* --extracmds, --histogram, --y2 can now take comma-separated lists
|
||||
|
||||
-- Dima Kogan <dima@secretsauce.net> Fri, 31 Aug 2012 01:35:50 -0700
|
||||
|
||||
feedgnuplot (1.19) unstable; urgency=low
|
||||
|
||||
* added --geometry option to specify plot dimensions
|
||||
|
||||
-- Dima Kogan <dima@secretsauce.net> Sat, 11 Feb 2012 21:04:42 -0800
|
||||
|
||||
feedgnuplot (1.18) unstable; urgency=low
|
||||
|
||||
* data-ids can now include characters such as -. Any non-whitespace
|
||||
works
|
||||
|
||||
-- Dima Kogan <dima@secretsauce.net> Tue, 27 Dec 2011 16:47:36 -0800
|
||||
|
||||
feedgnuplot (1.17) unstable; urgency=low
|
||||
|
||||
[ Dima Kogan ]
|
||||
* POD: removed -Winteractive, since this was apparently a mawk-ism
|
||||
* added zsh and bash completions to the package
|
||||
|
||||
[ Hermann Schwarting ]
|
||||
* add build dependency libtest-script-run-perl
|
||||
|
||||
-- Dima Kogan <dima@secretsauce.net> Sun, 20 Nov 2011 19:17:22 -0800
|
||||
|
||||
feedgnuplot (1.16) unstable; urgency=low
|
||||
|
||||
* deb version parser now works for any package name
|
||||
* Some POD fixes
|
||||
* now building a native package
|
||||
|
||||
-- Dima Kogan <dima@secretsauce.net> Fri, 11 Nov 2011 00:10:18 -0800
|
||||
|
||||
feedgnuplot (1.15-2) unstable; urgency=low
|
||||
|
||||
* added source format for the debianization
|
||||
* added configuration to let git-buildpackage build this package
|
||||
* standards bump to make lintian happier
|
||||
|
||||
-- Dima Kogan <dima@secretsauce.net> Sun, 23 Oct 2011 13:38:15 -0700
|
||||
|
||||
feedgnuplot (1.15-1) unstable; urgency=low
|
||||
|
||||
* Renamed main script from feedGnuplot to feedgnuplot
|
||||
* Slightly improved packaging, added instructions, etc
|
||||
|
||||
-- Dima Kogan <dima@secretsauce.net> Sun, 16 Oct 2011 11:58:15 -0700
|
||||
|
||||
feedgnuplot (1.14-1) unstable; urgency=low
|
||||
|
||||
* New upstream release (added 'clear' command, documented commands)
|
||||
|
||||
-- Dima Kogan <dima@secretsauce.net> Sun, 22 May 2011 15:25:28 -0700
|
||||
|
||||
feedgnuplot (1.13-1) unstable; urgency=low
|
||||
|
||||
* New upstream release (Better streaming plot control)
|
||||
|
||||
-- Dima Kogan <dima@secretsauce.net> Tue, 26 Apr 2011 14:24:09 -0700
|
||||
|
||||
feedgnuplot (1.12-1) unstable; urgency=low
|
||||
|
||||
* New upstream release
|
||||
|
||||
-- Dima Kogan <dima@secretsauce.net> Tue, 19 Apr 2011 11:02:23 -0700
|
||||
|
||||
feedgnuplot (1.11-1) unstable; urgency=low
|
||||
|
||||
* New upstream release
|
||||
|
||||
-- Dima Kogan <dima@secretsauce.net> Sat, 09 Apr 2011 14:10:21 -0700
|
||||
|
||||
feedgnuplot (1.10-1) unstable; urgency=low
|
||||
|
||||
* New upstream release
|
||||
|
||||
-- Dima Kogan <dima@secretsauce.net> Sat, 09 Apr 2011 14:08:06 -0700
|
||||
|
||||
feedgnuplot (1.09-1) unstable; urgency=low
|
||||
|
||||
* New upstream release
|
||||
|
||||
-- Dima Kogan <dima@secretsauce.net> Sun, 03 Apr 2011 17:23:38 -0700
|
||||
|
||||
feedgnuplot (1.08-1) unstable; urgency=low
|
||||
|
||||
* Initial debianized release.
|
||||
|
||||
-- Dima Kogan <dima@secretsauce.net> Sun, 6 Feb 2011 15:58:22 -0800
|
||||
1
package_definitions/debian/compat
Normal file
1
package_definitions/debian/compat
Normal file
@@ -0,0 +1 @@
|
||||
7
|
||||
20
package_definitions/debian/control
Normal file
20
package_definitions/debian/control
Normal file
@@ -0,0 +1,20 @@
|
||||
Source: feedgnuplot
|
||||
Section: science
|
||||
Priority: extra
|
||||
Build-Depends: debhelper (>= 7), libtest-script-run-perl, perl
|
||||
Maintainer: Dima Kogan <dima@secretsauce.net>
|
||||
Uploaders: Dima Kogan <dima@secretsauce.net>
|
||||
Standards-Version: 3.9.3
|
||||
Homepage: https://github.com/dkogan/feedgnuplot
|
||||
Vcs-Git: git://github.com/dkogan/feedgnuplot.git
|
||||
Vcs-Browser: https://github.com/dkogan/feedgnuplot
|
||||
DM-Upload-Allowed: yes
|
||||
|
||||
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
package_definitions/debian/copyright
Normal file
24
package_definitions/debian/copyright
Normal file
@@ -0,0 +1,24 @@
|
||||
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'.
|
||||
2
package_definitions/debian/feedgnuplot.install
Normal file
2
package_definitions/debian/feedgnuplot.install
Normal file
@@ -0,0 +1,2 @@
|
||||
completions/bash/feedgnuplot /etc/bash_completion.d/
|
||||
completions/zsh/_feedgnuplot /usr/share/zsh/vendor-completions
|
||||
5
package_definitions/debian/gbp.conf
Normal file
5
package_definitions/debian/gbp.conf
Normal file
@@ -0,0 +1,5 @@
|
||||
[DEFAULT]
|
||||
upstream-tree = branch
|
||||
upstream-branch = master
|
||||
debian-branch = master
|
||||
debian-tag = debian-%(version)s
|
||||
4
package_definitions/debian/rules
Executable file
4
package_definitions/debian/rules
Executable file
@@ -0,0 +1,4 @@
|
||||
#!/usr/bin/make -f
|
||||
|
||||
%:
|
||||
dh $@
|
||||
1
package_definitions/debian/source/format
Normal file
1
package_definitions/debian/source/format
Normal file
@@ -0,0 +1 @@
|
||||
3.0 (native)
|
||||
17
t/happy_cpantesters.t
Normal file
17
t/happy_cpantesters.t
Normal file
@@ -0,0 +1,17 @@
|
||||
#!perl
|
||||
|
||||
use strict;
|
||||
use Test::More tests => 1;
|
||||
|
||||
# Here I use my bogus package (which only exists for CPAN indexing), and make
|
||||
# sure it works. This test is needless too, it just exists to satisfy CPAN
|
||||
# checks
|
||||
|
||||
BEGIN{
|
||||
require_ok 'App::feedgnuplot';
|
||||
|
||||
}
|
||||
|
||||
diag("App::feedgnuplot/$App::feedgnuplot::VERSION");
|
||||
|
||||
__DATA__
|
||||
588
t/plots.t
588
t/plots.t
@@ -5,9 +5,7 @@
|
||||
# change the way the output looks will show up as test failures. Currently the
|
||||
# reference plots come from gnuplot 4.6.4, and I make sure this is the version
|
||||
# we're testing with
|
||||
#
|
||||
# Note that some tests are only executed when the RUN_ALL_TESTS environment
|
||||
# variable is set.
|
||||
|
||||
|
||||
# require a threaded perl for my tests. This block lifted verbatim from the cpantesters wiki
|
||||
BEGIN {
|
||||
@@ -17,20 +15,14 @@ BEGIN {
|
||||
exit(0);
|
||||
}
|
||||
|
||||
my $gawkversion = `gawk -V`;
|
||||
if( !$gawkversion || $@ )
|
||||
{
|
||||
print("1..0 # Skip: gawk is required for strftime() in the test suite. Skipping tests.\n");
|
||||
exit(0);
|
||||
}
|
||||
|
||||
my $gnuplotVersion = `gnuplot --version`;
|
||||
if( !$gnuplotVersion || $@)
|
||||
open(my $pipe, 'gnuplot --version |');
|
||||
if( !$pipe )
|
||||
{
|
||||
print("1..0 # Skip: gnuplot not installed. Tests require ver. 4.6.4; feedgnuplot works with any.\n");
|
||||
exit(0);
|
||||
}
|
||||
|
||||
my $gnuplotVersion = <$pipe>;
|
||||
chomp $gnuplotVersion;
|
||||
if ($gnuplotVersion ne "gnuplot 4.6 patchlevel 4")
|
||||
{
|
||||
@@ -39,7 +31,7 @@ BEGIN {
|
||||
}
|
||||
}
|
||||
|
||||
use Test::More tests => 58;
|
||||
use Test::More tests => 52;
|
||||
use File::Temp 'tempfile';
|
||||
use IPC::Run 'run';
|
||||
use String::ShellQuote;
|
||||
@@ -326,7 +318,7 @@ tryplot( testname => 'basic line plot with bounds, square aspect ratio',
|
||||
EOF
|
||||
|
||||
tryplot( testname => 'lines on both axes with labels, legends, titles',
|
||||
cmd => q{seq 5 | gawk '{print 2*$1, $1*$1}'},
|
||||
cmd => q{seq 5 | awk '{print 2*$1, $1*$1}'},
|
||||
options => [qw(--lines --points),
|
||||
'--legend', '0', 'data 0',
|
||||
'--title', "Test plot",
|
||||
@@ -375,7 +367,7 @@ tryplot( testname => 'lines on both axes with labels, legends, titles',
|
||||
EOF
|
||||
|
||||
tryplot( testname => 'lines on both axes with labels, legends, titles; different styles',
|
||||
cmd => q{seq 5 | gawk '{print 2*$1, $1*$1}'},
|
||||
cmd => q{seq 5 | awk '{print 2*$1, $1*$1}'},
|
||||
options => ['--legend', '0', 'data 0',
|
||||
'--title', "Test plot",
|
||||
qw(--y2 1 --y2label y2 --xlabel x --ylabel y --y2max 30),
|
||||
@@ -425,7 +417,7 @@ tryplot( testname => 'lines on both axes with labels, legends, titles; different
|
||||
EOF
|
||||
|
||||
tryplot( testname => 'domain plot',
|
||||
cmd => q{seq 5 | gawk '{print 2*$1, $1*$1}'},
|
||||
cmd => q{seq 5 | awk '{print 2*$1, $1*$1}'},
|
||||
options => [qw(--lines --points), '--domain'],
|
||||
refplot => <<'EOF' );
|
||||
|
||||
@@ -471,7 +463,7 @@ tryplot( testname => 'domain plot',
|
||||
EOF
|
||||
|
||||
tryplot( testname => 'dataid plot',
|
||||
cmd => q{seq 5 | gawk '{print 2*$1, $1*$1}'},
|
||||
cmd => q{seq 5 | awk '{print 2*$1, $1*$1}'},
|
||||
options => [qw(--lines --points),
|
||||
qw(--dataid --autolegend)],
|
||||
refplot => <<'EOF' );
|
||||
@@ -518,7 +510,7 @@ tryplot( testname => 'dataid plot',
|
||||
EOF
|
||||
|
||||
tryplot( testname => '3d spiral with bounds, labels',
|
||||
cmd => q{seq 50 | gawk '{print 2*cos($1/5), sin($1/5), $1}'},
|
||||
cmd => q{seq 50 | awk '{print 2*cos($1/5), sin($1/5), $1}'},
|
||||
options => [qw(--lines --points),
|
||||
qw(--3d --domain --zmin -5 --zmax 45 --zlabel z),
|
||||
'--extracmds', 'set view 60,30'],
|
||||
@@ -566,7 +558,7 @@ tryplot( testname => '3d spiral with bounds, labels',
|
||||
EOF
|
||||
|
||||
tryplot( testname => '3d spiral with bounds, labels, square xy aspect ratio',
|
||||
cmd => q{seq 50 | gawk '{print 2*cos($1/5), sin($1/5), $1}'},
|
||||
cmd => q{seq 50 | awk '{print 2*cos($1/5), sin($1/5), $1}'},
|
||||
options => [qw(--lines --points),
|
||||
qw(--3d --domain --zmin -5 --zmax 45 --zlabel z),
|
||||
'--extracmds', 'set view 60,30', '--square_xy'],
|
||||
@@ -611,10 +603,197 @@ tryplot( testname => '3d spiral with bounds, labels, square xy aspect ratio',
|
||||
|
||||
|
||||
|
||||
EOF
|
||||
|
||||
tryplot( testname => 'Histogram plot',
|
||||
cmd => q{seq 50 | awk '{print $1*$1}'},
|
||||
options => [qw(--lines --points),
|
||||
qw(--histo 0 --binwidth 50 --ymin 0 --curvestyleall), 'with boxes'],
|
||||
refplot => <<'EOF' );
|
||||
|
||||
|
||||
4 ++----------****----------+------------+-----------+------------+------------+-----------++
|
||||
+ *+** + + + + + +
|
||||
| * ** |
|
||||
| * ** |
|
||||
3.5 ++ * ** ++
|
||||
| * ** |
|
||||
| * ** |
|
||||
| * ** |
|
||||
| * ** |
|
||||
3 ++ * *** ++
|
||||
| * *** |
|
||||
| * *** |
|
||||
| * *** |
|
||||
2.5 ++ * *** ++
|
||||
| * *** |
|
||||
| * *** |
|
||||
| * *** |
|
||||
2 ++ * **** *** ++
|
||||
| * **** *** |
|
||||
| * **** *** |
|
||||
| * **** *** |
|
||||
| * **** *** |
|
||||
1.5 ++ * **** *** ++
|
||||
| * **** *** |
|
||||
| * **** *** |
|
||||
| * **** *** |
|
||||
1 ++ * ************************** ******** ************************** ** ++
|
||||
| * **** *** **** *** **** *** **** *** **** *** **** *** **** *** ** |
|
||||
| * **** *** **** *** **** *** **** *** **** *** **** *** **** *** ** |
|
||||
| * **** *** **** *** **** *** **** *** **** *** **** *** **** *** ** |
|
||||
| * **** *** **** *** **** *** **** *** **** *** **** *** **** *** ** |
|
||||
0.5 ++ * **** *** **** *** **** *** **** *** **** *** **** *** **** *** ** ++
|
||||
| * **** *** **** *** **** *** **** *** **** *** **** *** **** *** ** |
|
||||
| * **** *** **** *** **** *** **** *** **** *** **** *** **** *** ** |
|
||||
+ *+**** *** **** *** **** *** **** *** **** *** **** *** **** *** ** +
|
||||
0 ++----------****************************-********-**************************-**----------++
|
||||
-500 0 500 1000 1500 2000 2500 3000
|
||||
|
||||
EOF
|
||||
|
||||
tryplot( testname => 'Cumulative histogram',
|
||||
cmd => q{seq 50 | awk '{print $1*$1}'},
|
||||
options => [qw(--lines --points),
|
||||
qw(--histo 0 --histstyle cum --binwidth 50 --ymin 0 --curvestyleall), 'with boxes'],
|
||||
refplot => <<'EOF' );
|
||||
|
||||
|
||||
50 ++-----------+------------+------------+------------+------------+-----------***----------++
|
||||
+ + + + + + ** ***+* +
|
||||
| **** *** * |
|
||||
| *** **** *** * |
|
||||
| ** *** **** *** * |
|
||||
| ***** *** **** *** * |
|
||||
| **** *** *** **** *** * |
|
||||
40 ++ ** **** *** *** **** *** * ++
|
||||
| ****** **** *** *** **** *** * |
|
||||
| ***** *** **** *** *** **** *** * |
|
||||
| *** *** *** **** *** *** **** *** * |
|
||||
| ****** *** *** **** *** *** **** *** * |
|
||||
| ** **** *** *** **** *** *** **** *** * |
|
||||
| ****** **** *** *** **** *** *** **** *** * |
|
||||
30 ++ *** *** **** *** *** **** *** *** **** *** * ++
|
||||
| ****** *** **** *** *** **** *** *** **** *** * |
|
||||
| *** *** *** **** *** *** **** *** *** **** *** * |
|
||||
| ****** *** *** **** *** *** **** *** *** **** *** * |
|
||||
| ** **** *** *** **** *** *** **** *** *** **** *** * |
|
||||
| *** **** *** *** **** *** *** **** *** *** **** *** * |
|
||||
| ****** **** *** *** **** *** *** **** *** *** **** *** * |
|
||||
20 ++ *** *** **** *** *** **** *** *** **** *** *** **** *** * ++
|
||||
| ****** *** **** *** *** **** *** *** **** *** *** **** *** * |
|
||||
| ** *** *** **** *** *** **** *** *** **** *** *** **** *** * |
|
||||
| *** *** *** **** *** *** **** *** *** **** *** *** **** *** * |
|
||||
| **** *** *** **** *** *** **** *** *** **** *** *** **** *** * |
|
||||
| ****** *** *** **** *** *** **** *** *** **** *** *** **** *** * |
|
||||
| ** **** *** *** **** *** *** **** *** *** **** *** *** **** *** * |
|
||||
10 ++ ** **** *** *** **** *** *** **** *** *** **** *** *** **** *** * ++
|
||||
| *** **** *** *** **** *** *** **** *** *** **** *** *** **** *** * |
|
||||
| *** **** *** *** **** *** *** **** *** *** **** *** *** **** *** * |
|
||||
| *** **** *** *** **** *** *** **** *** *** **** *** *** **** *** * |
|
||||
| ***** **** *** *** **** *** *** **** *** *** **** *** *** **** *** * |
|
||||
| * *** **** *** *** **** *** *** **** *** *** **** *** *** **** *** * |
|
||||
+ *+*** **** ***+*** **** ***+*** **** ***+*** **** ***+*** **** ***+* +
|
||||
0 ++----------********************************************-********+***-****-*****----------++
|
||||
-500 0 500 1000 1500 2000 2500 3000
|
||||
|
||||
EOF
|
||||
|
||||
tryplot( testname => 'Circles',
|
||||
cmd => q{seq 5 | awk '{print $1,$1,$1/10}'},
|
||||
options => [qw(--circles --domain)],
|
||||
refplot => <<'EOF' );
|
||||
|
||||
|
||||
5 ++-------+--------+--------+--------+--------+--------+--------+--------*******************
|
||||
+ + + + + + + + * + *+
|
||||
| * * *|
|
||||
| ******** * *|
|
||||
4.5 ++ ** ** * *+
|
||||
| ** ** ** **|
|
||||
| ** ** ** ** |
|
||||
| * * ** ** |
|
||||
| * * ** ** |
|
||||
4 ++ * ** ********** ++
|
||||
| * * |
|
||||
| * * |
|
||||
| * * * |
|
||||
3.5 ++ ****** ** ** ++
|
||||
| * * ** ** |
|
||||
| * * ** ** |
|
||||
| * * ******** |
|
||||
3 ++ * ** ++
|
||||
| * * |
|
||||
| * * |
|
||||
| * * |
|
||||
| * * |
|
||||
2.5 ++ * ****** ++
|
||||
| ****** |
|
||||
| ** ** |
|
||||
| * * |
|
||||
2 ++ * ** ++
|
||||
| * ** |
|
||||
| * * |
|
||||
| ** ** |
|
||||
| ****** |
|
||||
1.5 ++ ++
|
||||
| |
|
||||
| * |
|
||||
+ **** + + + + + + + + +
|
||||
1 ++-----*-+**------+--------+--------+--------+--------+--------+--------+--------+-------++
|
||||
0.5 1 1.5 2 2.5 3 3.5 4 4.5 5 5.5
|
||||
|
||||
EOF
|
||||
|
||||
tryplot( testname => 'Error bars (using extraValuesPerPoint)',
|
||||
cmd => q{seq 5 | awk '{print $1,$1,$1/10}'},
|
||||
options => [qw(--domain),
|
||||
qw(--extraValuesPerPoint 1 --curvestyle 0), 'with errorbars'],
|
||||
refplot => <<'EOF' );
|
||||
|
||||
|
||||
5.5 ++---------+-----------+----------+----------+----------+-----------+----------+---------**
|
||||
+ + + + + + + + *
|
||||
| *
|
||||
5 ++ +A
|
||||
| *
|
||||
| *
|
||||
| *
|
||||
4.5 ++ **
|
||||
| *** |
|
||||
| * |
|
||||
4 ++ A ++
|
||||
| * |
|
||||
| * |
|
||||
| *** |
|
||||
3.5 ++ ++
|
||||
| *** |
|
||||
| * |
|
||||
3 ++ A ++
|
||||
| * |
|
||||
| * |
|
||||
| *** |
|
||||
2.5 ++ ++
|
||||
| |
|
||||
| *** |
|
||||
2 ++ A ++
|
||||
| * |
|
||||
| *** |
|
||||
| |
|
||||
1.5 ++ ++
|
||||
| |
|
||||
| |
|
||||
1 A* ++
|
||||
** |
|
||||
| |
|
||||
+ + + + + + + + +
|
||||
0.5 ++---------+-----------+----------+----------+----------+-----------+----------+---------++
|
||||
1 1.5 2 2.5 3 3.5 4 4.5 5
|
||||
|
||||
EOF
|
||||
|
||||
tryplot( testname => 'Monotonicity check',
|
||||
cmd => q{seq 10 | gawk '{print (NR-1)%5,NR}'},
|
||||
cmd => q{seq 10 | awk '{print (NR-1)%5,NR}'},
|
||||
options => [qw(--lines --points --domain --monotonic)],
|
||||
refplot => <<'EOF' );
|
||||
|
||||
@@ -661,7 +840,7 @@ EOF
|
||||
|
||||
|
||||
tryplot( testname => 'basic --timefmt plot',
|
||||
cmd => q{seq 5 | gawk '{print strftime("%d %b %Y %T",1382249107+$1,1),$1}'},
|
||||
cmd => q{seq 5 | awk '{print strftime("%d %b %Y %T",1382249107+$1,1),$1}'},
|
||||
options => ['--domain', '--timefmt', '%d %b %Y %H:%M:%S'],
|
||||
refplot => <<'EOF' );
|
||||
|
||||
@@ -707,7 +886,7 @@ tryplot( testname => 'basic --timefmt plot',
|
||||
EOF
|
||||
|
||||
tryplot( testname => '--timefmt plot with bounds',
|
||||
cmd => q{seq 5 | gawk '{print strftime("%d %b %Y %T",1382249107+$1,1),$1}'},
|
||||
cmd => q{seq 5 | awk '{print strftime("%d %b %Y %T",1382249107+$1,1),$1}'},
|
||||
options => ['--domain', '--timefmt', '%d %b %Y %H:%M:%S',
|
||||
'--xmin', '20 Oct 2013 06:05:00',
|
||||
'--xmax', '20 Oct 2013 06:05:20'],
|
||||
@@ -755,7 +934,7 @@ tryplot( testname => '--timefmt plot with bounds',
|
||||
EOF
|
||||
|
||||
tryplot( testname => '--timefmt plot with --monotonic',
|
||||
cmd => q{seq 10 | gawk '{x=(NR-1)%5; print strftime("%d %b %Y %T",1382249107+x,1),$1}'},
|
||||
cmd => q{seq 10 | awk '{x=(NR-1)%5; print strftime("%d %b %Y %T",1382249107+x,1),$1}'},
|
||||
options => ['--domain', '--timefmt', '%d %b %Y %H:%M:%S',
|
||||
'--monotonic'],
|
||||
refplot => <<'EOF' );
|
||||
@@ -801,354 +980,6 @@ tryplot( testname => '--timefmt plot with --monotonic',
|
||||
|
||||
EOF
|
||||
|
||||
tryplot( testname => '--timefmt with custom rangesize',
|
||||
cmd => q{seq 5 | gawk '{print strftime("%d %b %Y %T",1382249107+$1,1),$1,$1/10}'},
|
||||
options => ['--domain', '--timefmt', '%d %b %Y %H:%M:%S',
|
||||
qw(--with errorbars --rangesizeall 2)],
|
||||
refplot => <<'EOF' );
|
||||
|
||||
|
||||
5.5 ++---------+-----------+----------+----------+----------+-----------+----------+---------**
|
||||
+ + + + + + + + *
|
||||
| *
|
||||
5 ++ +A
|
||||
| *
|
||||
| *
|
||||
| *
|
||||
4.5 ++ **
|
||||
| *** |
|
||||
| * |
|
||||
4 ++ A ++
|
||||
| * |
|
||||
| * |
|
||||
| *** |
|
||||
3.5 ++ ++
|
||||
| *** |
|
||||
| * |
|
||||
3 ++ A ++
|
||||
| * |
|
||||
| * |
|
||||
| *** |
|
||||
2.5 ++ ++
|
||||
| |
|
||||
| *** |
|
||||
2 ++ A ++
|
||||
| * |
|
||||
| *** |
|
||||
| |
|
||||
1.5 ++ ++
|
||||
| |
|
||||
| |
|
||||
1 A* ++
|
||||
** |
|
||||
| |
|
||||
+ + + + + + + + +
|
||||
0.5 ++---------+-----------+----------+----------+----------+-----------+----------+---------++
|
||||
05:08 05:08 05:09 05:09 05:10 05:10 05:11 05:11 05:12
|
||||
|
||||
EOF
|
||||
|
||||
tryplot( testname => 'Error bars (using extraValuesPerPoint)',
|
||||
cmd => q{seq 5 | gawk '{print $1,$1,$1/10}'},
|
||||
options => [qw(--domain),
|
||||
qw(--extraValuesPerPoint 1 --with errorbars)],
|
||||
refplot => <<'EOF' );
|
||||
|
||||
|
||||
5.5 ++---------+-----------+----------+----------+----------+-----------+----------+---------**
|
||||
+ + + + + + + + *
|
||||
| *
|
||||
5 ++ +A
|
||||
| *
|
||||
| *
|
||||
| *
|
||||
4.5 ++ **
|
||||
| *** |
|
||||
| * |
|
||||
4 ++ A ++
|
||||
| * |
|
||||
| * |
|
||||
| *** |
|
||||
3.5 ++ ++
|
||||
| *** |
|
||||
| * |
|
||||
3 ++ A ++
|
||||
| * |
|
||||
| * |
|
||||
| *** |
|
||||
2.5 ++ ++
|
||||
| |
|
||||
| *** |
|
||||
2 ++ A ++
|
||||
| * |
|
||||
| *** |
|
||||
| |
|
||||
1.5 ++ ++
|
||||
| |
|
||||
| |
|
||||
1 A* ++
|
||||
** |
|
||||
| |
|
||||
+ + + + + + + + +
|
||||
0.5 ++---------+-----------+----------+----------+----------+-----------+----------+---------++
|
||||
1 1.5 2 2.5 3 3.5 4 4.5 5
|
||||
|
||||
EOF
|
||||
|
||||
|
||||
tryplot( testname => 'Error bars (using rangesizeall)',
|
||||
cmd => q{seq 5 | gawk '{print $1,$1,$1/10}'},
|
||||
options => [qw(--domain),
|
||||
qw(--rangesizeall 2 --with errorbars)],
|
||||
refplot => <<'EOF' );
|
||||
|
||||
|
||||
5.5 ++---------+-----------+----------+----------+----------+-----------+----------+---------**
|
||||
+ + + + + + + + *
|
||||
| *
|
||||
5 ++ +A
|
||||
| *
|
||||
| *
|
||||
| *
|
||||
4.5 ++ **
|
||||
| *** |
|
||||
| * |
|
||||
4 ++ A ++
|
||||
| * |
|
||||
| * |
|
||||
| *** |
|
||||
3.5 ++ ++
|
||||
| *** |
|
||||
| * |
|
||||
3 ++ A ++
|
||||
| * |
|
||||
| * |
|
||||
| *** |
|
||||
2.5 ++ ++
|
||||
| |
|
||||
| *** |
|
||||
2 ++ A ++
|
||||
| * |
|
||||
| *** |
|
||||
| |
|
||||
1.5 ++ ++
|
||||
| |
|
||||
| |
|
||||
1 A* ++
|
||||
** |
|
||||
| |
|
||||
+ + + + + + + + +
|
||||
0.5 ++---------+-----------+----------+----------+----------+-----------+----------+---------++
|
||||
1 1.5 2 2.5 3 3.5 4 4.5 5
|
||||
|
||||
EOF
|
||||
|
||||
|
||||
tryplot( testname => 'Error bars (using rangesize, rangesizeall)',
|
||||
cmd => q{seq 5 | gawk '{print $1,"vert",$1,$1/10,"horiz",5-$1,$1-$1/5,$1+$1/20}'},
|
||||
options => [qw(--domain --dataid),
|
||||
qw(--rangesize vert 2 --rangesizeall 3 --with xerrorbars --style vert), 'with errorbars',
|
||||
qw(--xmin 1 --xmax 5 --ymin 0.5 --ymax 5.5)],
|
||||
refplot => <<'EOF' );
|
||||
|
||||
|
||||
+-----------+----------+-----------+----------+-----------+----------+-----------+---------**
|
||||
+ + + + + + + + *
|
||||
| *
|
||||
5 ++ +A
|
||||
| *
|
||||
| *
|
||||
| *
|
||||
| **
|
||||
| *** |
|
||||
## * |
|
||||
4 B# A ++
|
||||
## * |
|
||||
| * |
|
||||
| *** |
|
||||
| |
|
||||
| *** |
|
||||
| # # * |
|
||||
3 ++ #########B## A ++
|
||||
| # # * |
|
||||
| * |
|
||||
| *** |
|
||||
| |
|
||||
| |
|
||||
| *** # # |
|
||||
2 ++ A ##############B### ++
|
||||
| * # # |
|
||||
| *** |
|
||||
| |
|
||||
| |
|
||||
| |
|
||||
| # # |
|
||||
1 A* ##################B##### ++
|
||||
** # # |
|
||||
| |
|
||||
+ + + + + + + + +
|
||||
+-----------+----------+-----------+----------+-----------+----------+-----------+----------+
|
||||
1 1.5 2 2.5 3 3.5 4 4.5 5
|
||||
|
||||
EOF
|
||||
|
||||
|
||||
SKIP:
|
||||
{
|
||||
|
||||
# Some tests aren't 100% reliable, so I do not include them in automated testing. These are
|
||||
#
|
||||
# - Histogram and circle-plotting tests: these have inconsistent round-off
|
||||
# behavior on different arches; specifically 32-bit and 64-bit x86. So both
|
||||
# plots look fine, but not identical, thus the tests fail
|
||||
#
|
||||
# - Streaming tests. These tests have a temporal component, so the loading of
|
||||
# the host machine can cause a test failure. It's fine pretty much all the
|
||||
# time on my not-too-new laptop, but this is bad for automated testing
|
||||
|
||||
skip "Skipping unreliable tests. Set RUN_ALL_TESTS environment variable to run them all", 18 unless $ENV{RUN_ALL_TESTS};
|
||||
|
||||
|
||||
tryplot( testname => 'Histogram plot',
|
||||
cmd => q{seq 50 | gawk '{print $1*$1}'},
|
||||
options => [qw(--lines --points),
|
||||
qw(--histo 0 --binwidth 50 --ymin 0 --curvestyleall), 'with boxes'],
|
||||
refplot => <<'EOF' );
|
||||
|
||||
|
||||
4 ++----------****----------+------------+-----------+------------+------------+-----------++
|
||||
+ *+** + + + + + +
|
||||
| * ** |
|
||||
| * ** |
|
||||
3.5 ++ * ** ++
|
||||
| * ** |
|
||||
| * ** |
|
||||
| * ** |
|
||||
| * ** |
|
||||
3 ++ * *** ++
|
||||
| * *** |
|
||||
| * *** |
|
||||
| * *** |
|
||||
2.5 ++ * *** ++
|
||||
| * *** |
|
||||
| * *** |
|
||||
| * *** |
|
||||
2 ++ * **** *** ++
|
||||
| * **** *** |
|
||||
| * **** *** |
|
||||
| * **** *** |
|
||||
| * **** *** |
|
||||
1.5 ++ * **** *** ++
|
||||
| * **** *** |
|
||||
| * **** *** |
|
||||
| * **** *** |
|
||||
1 ++ * ************************** ******** ************************** ** ++
|
||||
| * **** *** **** *** **** *** **** *** **** *** **** *** **** *** ** |
|
||||
| * **** *** **** *** **** *** **** *** **** *** **** *** **** *** ** |
|
||||
| * **** *** **** *** **** *** **** *** **** *** **** *** **** *** ** |
|
||||
| * **** *** **** *** **** *** **** *** **** *** **** *** **** *** ** |
|
||||
0.5 ++ * **** *** **** *** **** *** **** *** **** *** **** *** **** *** ** ++
|
||||
| * **** *** **** *** **** *** **** *** **** *** **** *** **** *** ** |
|
||||
| * **** *** **** *** **** *** **** *** **** *** **** *** **** *** ** |
|
||||
+ *+**** *** **** *** **** *** **** *** **** *** **** *** **** *** ** +
|
||||
0 ++----------****************************-********-**************************-**----------++
|
||||
-500 0 500 1000 1500 2000 2500 3000
|
||||
|
||||
EOF
|
||||
|
||||
tryplot( testname => 'Cumulative histogram',
|
||||
cmd => q{seq 50 | gawk '{print $1*$1}'},
|
||||
options => [qw(--lines --points),
|
||||
qw(--histo 0 --histstyle cum --binwidth 50 --ymin 0 --curvestyleall), 'with boxes'],
|
||||
refplot => <<'EOF' );
|
||||
|
||||
|
||||
50 ++-----------+------------+------------+------------+------------+-----------***----------++
|
||||
+ + + + + + ** ***+* +
|
||||
| **** *** * |
|
||||
| *** **** *** * |
|
||||
| ** *** **** *** * |
|
||||
| ***** *** **** *** * |
|
||||
| **** *** *** **** *** * |
|
||||
40 ++ ** **** *** *** **** *** * ++
|
||||
| ****** **** *** *** **** *** * |
|
||||
| ***** *** **** *** *** **** *** * |
|
||||
| *** *** *** **** *** *** **** *** * |
|
||||
| ****** *** *** **** *** *** **** *** * |
|
||||
| ** **** *** *** **** *** *** **** *** * |
|
||||
| ****** **** *** *** **** *** *** **** *** * |
|
||||
30 ++ *** *** **** *** *** **** *** *** **** *** * ++
|
||||
| ****** *** **** *** *** **** *** *** **** *** * |
|
||||
| *** *** *** **** *** *** **** *** *** **** *** * |
|
||||
| ****** *** *** **** *** *** **** *** *** **** *** * |
|
||||
| ** **** *** *** **** *** *** **** *** *** **** *** * |
|
||||
| *** **** *** *** **** *** *** **** *** *** **** *** * |
|
||||
| ****** **** *** *** **** *** *** **** *** *** **** *** * |
|
||||
20 ++ *** *** **** *** *** **** *** *** **** *** *** **** *** * ++
|
||||
| ****** *** **** *** *** **** *** *** **** *** *** **** *** * |
|
||||
| ** *** *** **** *** *** **** *** *** **** *** *** **** *** * |
|
||||
| *** *** *** **** *** *** **** *** *** **** *** *** **** *** * |
|
||||
| **** *** *** **** *** *** **** *** *** **** *** *** **** *** * |
|
||||
| ****** *** *** **** *** *** **** *** *** **** *** *** **** *** * |
|
||||
| ** **** *** *** **** *** *** **** *** *** **** *** *** **** *** * |
|
||||
10 ++ ** **** *** *** **** *** *** **** *** *** **** *** *** **** *** * ++
|
||||
| *** **** *** *** **** *** *** **** *** *** **** *** *** **** *** * |
|
||||
| *** **** *** *** **** *** *** **** *** *** **** *** *** **** *** * |
|
||||
| *** **** *** *** **** *** *** **** *** *** **** *** *** **** *** * |
|
||||
| ***** **** *** *** **** *** *** **** *** *** **** *** *** **** *** * |
|
||||
| * *** **** *** *** **** *** *** **** *** *** **** *** *** **** *** * |
|
||||
+ *+*** **** ***+*** **** ***+*** **** ***+*** **** ***+*** **** ***+* +
|
||||
0 ++----------********************************************-********+***-****-*****----------++
|
||||
-500 0 500 1000 1500 2000 2500 3000
|
||||
|
||||
EOF
|
||||
|
||||
tryplot( testname => 'Circles',
|
||||
cmd => q{seq 5 | gawk '{print $1,$1,$1/10}'},
|
||||
options => [qw(--circles --domain)],
|
||||
refplot => <<'EOF' );
|
||||
|
||||
|
||||
5 ++-------+--------+--------+--------+--------+--------+--------+--------*******************
|
||||
+ + + + + + + + * + *+
|
||||
| * * *|
|
||||
| ******** * *|
|
||||
4.5 ++ ** ** * *+
|
||||
| ** ** ** **|
|
||||
| ** ** ** ** |
|
||||
| * * ** ** |
|
||||
| * * ** ** |
|
||||
4 ++ * ** ********** ++
|
||||
| * * |
|
||||
| * * |
|
||||
| * * * |
|
||||
3.5 ++ ****** ** ** ++
|
||||
| * * ** ** |
|
||||
| * * ** ** |
|
||||
| * * ******** |
|
||||
3 ++ * ** ++
|
||||
| * * |
|
||||
| * * |
|
||||
| * * |
|
||||
| * * |
|
||||
2.5 ++ * ****** ++
|
||||
| ****** |
|
||||
| ** ** |
|
||||
| * * |
|
||||
2 ++ * ** ++
|
||||
| * ** |
|
||||
| * * |
|
||||
| ** ** |
|
||||
| ****** |
|
||||
1.5 ++ ++
|
||||
| |
|
||||
| * |
|
||||
+ **** + + + + + + + + +
|
||||
1 ++-----*-+**------+--------+--------+--------+--------+--------+--------+--------+-------++
|
||||
0.5 1 1.5 2 2.5 3 3.5 4 4.5 5 5.5
|
||||
|
||||
EOF
|
||||
|
||||
|
||||
|
||||
|
||||
@@ -1158,7 +989,7 @@ note( "Starting to run streaming tests. These will take several seconds each" );
|
||||
# points, and then "exit", so I should have two frames worth of data plotted. I
|
||||
# pre-send a 0 so that the gnuplot autoscaling is always well-defined
|
||||
tryplot( testname => 'basic streaming test',
|
||||
cmd => q{seq 500 | gawk 'BEGIN{ print 0; } {print (NR==3)? "exit" : $0; fflush(); system("sleep 1.2");}'},
|
||||
cmd => q{seq 500 | awk 'BEGIN{ print 0; } {print (NR==3)? "exit" : $0; fflush(); system("sleep 1.2");}'},
|
||||
options => [qw(--lines --points --stream)],
|
||||
refplot => <<'EOF' );
|
||||
|
||||
@@ -1244,7 +1075,7 @@ tryplot( testname => 'basic streaming test',
|
||||
EOF
|
||||
|
||||
tryplot( testname => 'basic streaming test, twice as fast',
|
||||
cmd => q{seq 500 | gawk 'BEGIN{ print 0; } {print (NR==3)? "exit" : $0; fflush(); system("sleep 0.6");}'},
|
||||
cmd => q{seq 500 | awk 'BEGIN{ print 0; } {print (NR==3)? "exit" : $0; fflush(); system("sleep 0.6");}'},
|
||||
options => [qw(--lines --points --stream 0.4)],
|
||||
refplot => <<'EOF' );
|
||||
|
||||
@@ -1331,7 +1162,7 @@ EOF
|
||||
|
||||
|
||||
tryplot( testname => 'streaming with --xlen',
|
||||
cmd => q{seq 500 | gawk 'BEGIN{ print 0; } {print (NR==3)? "exit" : $0; fflush(); system("sleep 0.6");}'},
|
||||
cmd => q{seq 500 | awk 'BEGIN{ print 0; } {print (NR==3)? "exit" : $0; fflush(); system("sleep 0.6");}'},
|
||||
options => [qw(--lines --points --stream 0.4 --xlen 1.1)],
|
||||
refplot => <<'EOF' );
|
||||
|
||||
@@ -1417,7 +1248,7 @@ tryplot( testname => 'streaming with --xlen',
|
||||
EOF
|
||||
|
||||
tryplot( testname => 'streaming with --monotonic',
|
||||
cmd => q{seq 500 | gawk '{if(NR==11) {print "exit";} else {x=(NR-1)%5; if(x==0) {print -1,-1;} print x,NR;}; fflush(); system("sleep 0.6");}'},
|
||||
cmd => q{seq 500 | awk '{if(NR==11) {print "exit";} else {x=(NR-1)%5; if(x==0) {print -1,-1;} print x,NR;}; fflush(); system("sleep 0.6");}'},
|
||||
options => [qw(--lines --points --stream 0.4 --domain --monotonic)],
|
||||
refplot => <<'EOF' );
|
||||
|
||||
@@ -1823,7 +1654,7 @@ tryplot( testname => 'streaming with --monotonic',
|
||||
EOF
|
||||
|
||||
tryplot( testname => '--timefmt streaming plot with --xlen',
|
||||
cmd => q{seq 5 | gawk 'BEGIN{ print strftime("%d %b %Y %T",1382249107-1,1),-4;} {if(NR==3) {print "exit";} else{ print strftime("%d %b %Y %T",1382249107+$1,1),$1;} fflush(); system("sleep 0.6")}'},
|
||||
cmd => q{seq 5 | awk 'BEGIN{ print strftime("%d %b %Y %T",1382249107-1,1),-4;} {if(NR==3) {print "exit";} else{ print strftime("%d %b %Y %T",1382249107+$1,1),$1;} fflush(); system("sleep 0.6")}'},
|
||||
options => ['--points', '--lines',
|
||||
'--domain', '--timefmt', '%d %b %Y %H:%M:%S',
|
||||
qw(--stream 0.4 --xlen 3)],
|
||||
@@ -1911,7 +1742,7 @@ tryplot( testname => '--timefmt streaming plot with --xlen',
|
||||
EOF
|
||||
|
||||
tryplot( testname => '--timefmt streaming plot with --monotonic',
|
||||
cmd => q{seq 10 | gawk '{x=(NR-1)%5; if(x==0) {print strftime("%d %b %Y %T",1382249107-1,-4),-4;} print strftime("%d %b %Y %T",1382249107+x,1),NR; fflush(); system("sleep 0.6")}'},
|
||||
cmd => q{seq 10 | awk '{x=(NR-1)%5; if(x==0) {print strftime("%d %b %Y %T",1382249107-1,-4),-4;} print strftime("%d %b %Y %T",1382249107+x,1),NR; fflush(); system("sleep 0.6")}'},
|
||||
options => ['--points', '--lines',
|
||||
'--domain', '--timefmt', '%d %b %Y %H:%M:%S',
|
||||
qw(--stream 0.4 --monotonic)],
|
||||
@@ -2318,7 +2149,6 @@ tryplot( testname => '--timefmt streaming plot with --monotonic',
|
||||
|
||||
EOF
|
||||
|
||||
}
|
||||
|
||||
|
||||
|
||||
@@ -2327,7 +2157,7 @@ sub tryplot
|
||||
my %args = @_;
|
||||
|
||||
my @options = ('--exit',
|
||||
qw(--unset grid),
|
||||
'--extracmds', 'unset grid',
|
||||
'--terminal', 'dumb 100,40');
|
||||
unshift @options, @{$args{options}};
|
||||
|
||||
|
||||
Reference in New Issue
Block a user