.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.45.1. .TH MUPLOT "1" "July 2014" "muplot 5.6.2" "User Commands" .SH NAME muplot \- plot a multi\-curve figure from multiple data by using Gnuplot .SH SYNOPSIS .B muplot [\fI\,OPTION\/\fR]... [\fI\,STYLE\/\fR] [\fI\,FILE\/\fR] [\fI\,AXES\/\fR] [\fI\,FILE\/\fR] [\fI\,AXES\/\fR] ... .SH DESCRIPTION Muplot is a simple, non\-interactive gnuplot\-wrapper to plot a multi\-curve figure from multiple data (files). It can produce PostScript, PDF, PNG or JPEG output file formats. .SH OPTIONS .TP \fB\-\-help\fR|\-H display help .TP \fB\-h\fR display short help .TP \fB\-V\fR print program version number .TP \fB\-s\fR create PostScript\-file .TP \fB\-S\fR send PostScript output to STDOUT (the same as '\-s \-o\fR \-') .TP \fB\-n\fR create PNG\-file .TP \fB\-j\fR create JPEG\-file .TP \fB\-p\fR create PDF\-file (requires the gnuplot "pdfcairo" driver) .TP \fB\-X\fR don't set the terminal to 'x11' (use gnuplot's default instead) .TP \fB\-r0\fR reload data files continuously (default 8640:10) .TP \fB\-r\fR reload data files continuously by the specified config values .TP \fB\-c\fR execute gnuplot command(s) (using the default plot style) .TP \fB\-m\fR monochrome plot (valid for PostScript or PDF) .TP \fB\-l\fR set plot size to 800x600 (valid for PNG and JPEG) .TP \fB\-o\fR base name of the output file .TP \fB\-q\fR quiet mode (all messages except errors to be suppressed) .TP \fB\-F\fR input\-data field separator (default is a single space character) .TP \fB\-i\fR ignore local command file './.muplotset' .TP \fB\-I\fR specify an alternative command file instead of './.muplotset' .TP \fB\-U\fR do not sort the file list .TP \fB\-T\fR use this directory for temporary/working output files .SS "Styles/Settings:" .TP lp lines and points .TP l lines .TP p points .TP pp circle points .TP nn various points (types) .TP d dots .TP b boxes .TP g grid .TP nk do not plot keys (skip file names lables) .TP e errorbars \- default used columns are 1:2:3 (x:y:yerror) .TP a fields with arrows; The data file has a special format in this case. Use 'prefield' to prepare such data files. .TP dt= 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 is date and time stamp: dt="%Y\-%m\-%d %H:%M:%S" .TP 3d plot 3\-d data using 1:2:3 .TP u= user specified plot style format (as defined in Gnuplot); For example: u="points pointtype 2 pointsize 3"; To see the present terminal and palette capabilities of gnuplot use the command 'muplot \-c\fR test'. .TP s= user specified setting (as defined in Gnuplot); For example: s="logscale x" .SS "Axes:" .TP x:y,x:y\-z columns in the file defining 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. .PP File(s) could be a single file name whereas '\-' means , 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'. In case you want to view the output, define the env variable MUPLOT_VIEWER and export it, for example: .IP MUPLOT_VIEWER="xpdf \-z\fR page"; export MUPLOT_VIEWER .PP Then the program will prompt you to view the plot, and after confirmation the viewer will present the graphics. If the postscript file format is chosen ('\-s' option), and MUPLOT_VIEWER is not defined, the viewer is preset to 'gv', and per default you are prompted to view the output. To disable this behavior use the command "unset MUPLOT_VIEWER". .SH EXAMPLES 1) On X\-terminal view a multi\-curve plot of all data\-files with extension 'dat' .IP muplot "*.dat" .PP 2) Print a sinus curve in black\-and\-white color on a PostScript\-printer .IP muplot \-m \-S \-c "set title 'Function f(x)=sin(x)'; plot sin(x);" | lpr .PP 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. .IP muplot \-s example.dat 1:2,3:4\-5 .PP 4) Create graphics in PDF\-format reading data from file "example.1.dat" (columns 1:2), and from file "example.2.dat" (columns 3:4) .IP muplot \-p lp example.1.dat 1:2 example.2.dat 3:4 .PP 5) View file where the first column is data, and the third and forth columns are date of the form 'yyyy\-mm\-dd' and time in the form 'hh:mm:ss' .IP cat example_counts_per_second.dat | muplot dt="%Y\-%m\-%d %H:%M:%S" \- 3:1 .PP 6) Plot 3\-dimensional data from file "example_3d.dat" using the 1,3, and 5\-th data columns with dots\-plot\-style, enabling grid, setting the xrange to [0:10], disabling keys and defining a plot\-title .IP muplot nk g d 3d s="xrange [0:10]" s="title 'This is a 3\-d plot'" example_3d.dat 1:3:5 .PP 7) Replot data 1000 times every 5 seconds and write temporary created files in the '/tmp' directory; This scenario is useful in case of growing or otherwise changing over time data\-file .IP muplot \-T /tmp \-r 1000:5 example.dat .SH "REPORTING BUGS" Report bugs to .SH COPYRIGHT Copyright \(co 1996\-2009, 2011\-2014 Dimitar Ivanov .PP License: GNU GPL version 3 or later .br This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.