muplot(1)
NAME
muplot - plot a multi-curve figure from multiple data by using Gnuplot
SYNOPSIS
muplot [OPTION]... [STYLE] [FILE] [AXES]
DESCRIPTION
Muplot is a simple, non-interactive gnuplot-wrapper to plot a
multi-curve figure from multiple data. It can produce PostScript, PDF,
PNG or JPEG output file formats.
OPTIONS
- --help|-H
- display help
- --version
- output version and license message
- -h display short help
- -V print program version number
- -s create PostScript file
- -S send PostScript output to STDOUT (the same as '-s -o -')
- -n create PNG file
- -j create JPEG file
- -p create PDF file (requires the gnuplot "pdfcairo" driver)
- -c <cmd>
- execute gnuplot command(s) (the default plot style is used)
- -m monochrome plot (valid only for PostScript)
- -l set plot size to 800x600 (valid for PNG and JPEG)
- -o base name of the output file
- -q quiet mode (all messages except errors to be suppressed)
- -i ignore local command file './.muplotset'
- Styles:
- l lines
- p points
- lp lines and points (default)
- pp circle points
- d dots
- b boxes
- g grid
- e errorbars - default used columns are 1:2:3 (x:y:yerror)
- a fields with arrows; The data file has a special format in this
case. Use 'prefield' to prepare such data files.
- dt=<fmt>
date/time series with the specified format; For example: dt="%H:%M.%S@%H:%M" where the first part, in front of "@", defines the data format, and the second part defines the format that will be used for tic labels. Here, hours and minutes are separated by `:', respectively minutes and seconds by `.' Another example could be a date: dt="%Y-%m-%d".
- u=<fmt>
user specified format as defined in Gnuplot
- Axes:
- x:y,x:y-z
columns in the file definig the x/y-axes of the curve(s);
Default are 1:2 or 1:2:3 for data with errors. In case that only one column is provided the default axes are 0:1 - the x-axis will be a simple index then. - File(s) could be a single file name whereas '-' means <stdin>, many files enclosed in '' or "" like "file1 file2 file3", or any valid shell pattern as for example "*.dat". The files '$HOME/.muplotset' and './.muplotset', if existing, will be included at the beginning of the gnuplot script. The command block between "#BEGIN" and "#END" in those files will be pasted to the end of the script. If you want that the global '$HOME/.muplotset' is ignored, create in your local directory a file named '.muplotset.noglobal'.
EXAMPLES
- 1) On X-terminal view a multi-curve plot of data files with extension
'dat'
- muplot l "*.dat"
- 2) Print a sinus curve as a black-and-white PostScript on a PS-printer
muplot -m -S -c "set title 'Funtion f(x)=sin(x)'; plot sin(x);" | lpr- 3) Plot data from file "example.dat" using columns 1:2, 3:4, and 3:5 as x/y-axes in the multi-curve plot; a PostScript file with the name "example.ps" is automatically created.
muplot -s lp example.dat 1:2,3:4-5- 4) View data where the third column is a date of the form 'yyyy-mm-dd'
cat example_counts_per_day.dat | muplot dt="%Y-%m-%d" - 3:1
REPORTING BUGS
Report bugs to <gnu@mirendom.net>
COPYRIGHT
Copyright (C) 1996-2009 Dimitar Ivanov
- License: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.