Provided by: quickplot_1.0.1~rc-1build3_amd64 bug

NAME

       quickplot - a fast interactive 2D plotter

SYNOPSIS

       quickplot [OPTIONS]

DESCRIPTION

       Quickplot is an interactive 2D plotter.  It's primary focus is to interactively display 2D
       plots.  It can generate PNG image files.  Quickplot has a graphical user  interface,  lots
       of  command  line options, and a command line shell interface as well.  Quickplot can load
       ASCII text files and many sound file formats using the libsndfile library.  Quickplot  can
       read standard input as a pipe or regular file.

       The  full  documentation  for  Quickplot  is maintained as a HTML document in a file named
       help.html.        You       can       get       the        latest        version        at
       <http://quickplot.sourceforge.net/help.html>.   The  options  part  in  this  man  page is
       generated from the same source as the options part of the HTML document.

       The order of argument options matters.  Options take effect in the  order  that  they  are
       given  with  later  options  overriding earlier ones.  The options that cause actions like
       graph "something" must come after  the  option  that  says  to  read  the  file  that  has
       "something"  in  it.   In  general, the order of argument options gives the order in which
       things happen as Quickplot starts up.

OPTIONS

       FILE   read data from file FILE.  If FILE is - (dash) then standard input  will  be  read.
              This is the same as the --file option.  See also --pipe.

       --about or -a
              display introductory information about Quickplot in a browser and exit

       --auto-scale or -A
              automatically  select  the X and Y scales for graphs containing more than one plot.
              This  is  the  default.   See  also  --same-x-scale,  --same-y-scale,  --same-scale
              --different-scale.

       --background-color RGBA or -C RGBA
              set  the color of the graph background.  RGBA may be any string that GTK+ can parse
              into a RGB or RGBA color.  For examples --background-color='rgba(0,0,255,0.5)' will
              make translucent blue, and -C '#050' will make a dark green.

       --border or -b
              add a border to main window.  This is the default.  See also --no-border.

       --buttons
              show  the  button  bar  in  the  main  window.   This  is  the  default.   See also
              --no-buttons.

       --cairo-draw or -c
              draw graphs using the Cairo  API.   Cairo  drawing  may  be  slower,  but  you  get
              translucent colors and anti-aliasing in all aspects of the graph and in saved image
              files.  See also --x11-draw.

       --default-graph or -D
              create the default graph for the current file and turn default graphing for  future
              files  read.   If  you  give  a  --graph or --graph-file after this option you will
              generate an additional graph.  A default graph will be made each time  this  option
              is  encountered,  so  this  can be used to control when, in the sequence of command
              line options, graphs are made.  See also --no-default-graph.

       --different-scale or -d
              graphs with more than one plot will have different scales if the extreme values  in
              each  plot  are  not  all  the  same.   See  also  --same-scale, --same-x-scale and
              --same-y-scale.

       --file FILE or -f FILE
              read data from file FILE.  If FILE is - (dash) then standard input  will  be  read.
              See also --pipe.

       --fullscreen or -F
              make the main window fullscreen.  See also --no-fullscreen and --maximize.

       --gaps interpret  NAN,  -NAN, INF, -INF, and double overflow numbers as a gap in the plot,
              and don't draw a connecting line to adjacent non-gap points.  This is the  default.
              See also --no-gaps.

       --geometry GEO
              specify  the position and size of the main window.  To set the geometry back to the
              default just set GEO to NONE.  Example --geometry=1000x300-0+30

       --graph LIST or -g LIST
              make a graph with plots LIST.  The LIST is of the form "x0 y0 x1  y1  x2  y2  ...".
              For  example:  --graph  "0  1  3  4"  will make two plots in a graph.  It will plot
              channel 1 vs channel 0 and channel 4 vs channel 3 in the same graph.  Data channels
              are  numbered, starting at 0, in the order that they are created as files are read.
              A separate graph tab will be created for each --graph option given.   This  --graph
              option  must be after the file loading options that load the channels that it lists
              to plot.  See also --graph-file.

       --graph-file LIST or -G LIST
              make a graph with plots LIST.  The LIST is of the form "x0 y0 x1  y1  x2  y2  ...".
              Example:  --graph-file  "0  1  3  4"  will make two plots in a graph.  It will plot
              channel 1 vs channel 0 and channel 4 vs channel 3 in the same  graph.   A  separate
              graph  tab  will  be  created for each --graph-file option given.  This is like the
              --graph option except that the channel numbers start at  zero  for  the  last  file
              read.  They are relative channel numbers.  So channel numbers for ---graph-file may
              be negative to refer to channels that came from files before the last  file.   This
              is  handy  if  you  load  a  lots of files and lose count of the number of channels
              loaded in each file.

       --grid draw a grid with the graph.  This is the default.  See also --no-grid.

       --grid-font FONT or -T FONT
              set the font used to in the grid label numbers.   Example:  --grid-font='Sans  Bold
              12'.  The default grid font is "Sans 10".

       --grid-line-color RGBA
              set  the graph grid lines color.  RGBA may be any string that GTK+ can parse into a
              RGB or RGBA color.  For example --grid_line_color='rgba(255,0,0,0.5)' will  make  a
              translucent red.

       --grid-line-width PIXELS or -W PIXELS
              set the width of the grid lines if there are any

       --grid-numbers
              show  grid  numbers.   This  is the default.  The grid must be showing to show grid
              numbers too.  See also --no-grid-numbers.

       --grid-text-color RGBA
              set the graph grid text color.  RGBA may be any string that GTK+ can parse  into  a
              RGB  or  RGBA  color.   For example --grid_text_color='rgba(0,255,0,0.5)' will make
              translucent green.

       --grid-x-space PIXELS or -X PIXELS
              set the maximum x space between vertical grid lines. The minimum will be about half
              this.   This  distance  varies  as the scale changes due to zooming.  This distance
              cannot be fixed due to the way  Quickplot  scales  your  graphs  and  always  picks
              reasonable grid line spacing.  See also --grid-x-space.

       --grid-y-space PIXELS or -Y PIXELS
              set  the  maximum  y  space between horizontal grid lines.  See also --grid-x-space
              above.

       --gtk-version
              print the version of GTK+ that Quickplot was built with and then exit

       --gui  show the menu bar, button bar, tabs bar, and the status bar.  This is the  default.
              See also --no-gui.

       --help or -h
              display help in a browser and exit

       --label-separator STR or -p STR
              specifies  the  label  separator string STR if labels are read in from the top of a
              text data plot file.  The default value of STR  is  "  "  (a  single  space).   See
              option: --labels.

       --labels or -L
              read  labels  from  the  first  line of a text file that is not skipped.  See also:
              --skip-lines, --label-separator and --no-labels.

       --libsndfile-version
              print the version of libsndfile that Quickplot was built with and then exit

       --line-width PIXELS or -I PIXELS
              specify the plot line widths in pixels.  May be set to AUTO to let Quickplot select
              the line width based on the plot point density.  AUTO is the default.

       --linear-channel [OPTS] or -l [OPTS]
              OPTS  are  START|[STEP].   This option prepends a linear series channel to the file
              being read.

              START  set the first value in the sequence to START.  The default START value is 0.

              STEP  set the sequence step size to STEP.  The default STEP is 1.  There must be  a
              START  before  STEP.   For  example:  --linear-channel='100 0.2' will make a linear
              channel that starts at 100 and steps 0.2.  Sound files will always  have  a  linear
              channel  that  contains  the  time  prepended.  Using this option with a sound file
              would prepend an additional channel.  Any file loaded that contains just  a  single
              channel  will  automatically  have  a  channel prepended.  Using this option with a
              single channel file will not prepend an additional channel, but will  let  you  set
              the   start   and   step   values   for   that   prepended   channel.    See   also
              --no-linear-channel.

       --lines Y|N|A or -j Y|N|A

              Y  yes show lines.

              N  no don't show lines. Same as --no-lines.

              A  auto, be smart about it.  This is the default.

       --local-menubars
              disable that darn Ubuntu Unity globel menu  bar.   This  will  do  nothing  if  not
              running with Unity.

       --maximize or -m
              maximize the main window.  See also --no-maximize and --fullscreen.

       --menubar
              show  the  menu  bar.   This  is the default.  See also --no-menubar.  This will do
              nothing if not running with the Ubuntu Unity window manager.

       --new-window or -w
              make a new main window for each graph

       --no-border or -B
              display graphs main windows with no borders

       --no-buttons
              hide the button bar in the main window.  See also --buttons.

       --no-default-graph or -U
              stop making the default graph for each file loaded.  See also --default-graph.

       --no-fullscreen
              don't  make  the  main  window  fullscreen.   This  is  the  default.    See   also
              --fullscreen.

       --no-gaps or -J
              draw  a  line  across NAN (-NAN, INF, -INF and overflow double) values if there are
              finite values on both sides.  See also --gaps.

       --no-grid or -H
              don't draw graph grid lines in the graph.  See also --grid.

       --no-grid-numbers
              don't show grid numbers.  See also --grid-numbers.

       --no-gui or -z
              don't show the menu bar, button bar, tabs bar, and status bar.  See also --gui.

       --no-labels or -Q
              don't read channel labels from the file.  This is the default.  See also --labels.

       --no-linear-channel or -k
              turn off adding a linear channel for up coming files.  See also --linear-channel.

       --no-lines or -i
              plot without drawing lines in the graph.  See also --lines.

       --no-maximize
              don't maximize the main window.  This is the default.  See also --maximize.

       --no-menubar or -M
              don't display the menu bar in the main window.  See also --menubar.  This  will  do
              nothing if not running with the Ubuntu Unity window manager.

       --no-new-window or -Z
              don't  make  a  new  main  window  for  the  graph.  This is the default.  See also
              --new-window.

       --no-pipe or -N
              don't read data in from standard input even if there is input to  read.   See  also
              --pipe.

       --no-points or -o
              plot without drawing points in the graph.  See also --points.

       --no-readline
              don't use GNU readline with the Quickplot command shell if you run with the --shell
              option.  This will disable the use of line editing, shell history, and tab  command
              completion.  This option has no effect if Quickplot is not built with GNU readline.

       --no-shape
              turn off the use of the X11 shape extension.  See also --shape.

       --no-statusbar
              hide the status bar in the main window.  See also --statusbar.

       --no-tabs
              don't show the graph tabs in the main window.  See also --tabs.

       --number-of-plots NUM or -n NUM
              set the default maximum number of plots for each graph to NUM

       --pipe or -P
              read  graph  data  from  standard  input.  By default Quickplot looks for data from
              standard input and stops looking if no data is found in some short amount of  time.
              This  option  will cause Quickplot to wait for standard input indefinitely.  If you
              would like to type data in from the terminal use --pipe.  This option is  the  same
              as --file=-.

       --point-size PIXELS or -O PIXELS
              start  Quickplot  using  plot point size PIXELS wide in pixels.  This may be set to
              AUTO to have quickplot automatically set the point  size  depending  on  the  point
              density that is in graph.  AUTO is the default.

       --points
              show points in the plots in the graph.  This is the default.

       --print-about
              prints  the About document to standard output andthen exits.  Use option --about to
              display an HTML version of the Quickplot About information.

       --print-help
              prints this Help document as ASCII text to standard output  and  then  exits.   Use
              option --help for displaying an HTML version of this help.

       --read-pipe-here or -R
              this  is  a  place  holder that tells Quickplot when to read the data from standard
              input.  This is intended to give the option  of  telling  Quickplot  when  to  read
              standard  input  when  Quickplot  automatically determines whether to read standard
              input or not.  See options --file, --pipe and --no-pipe.

       --same-scale or -s
              plot all plots in the same graph scale.  See also --different-scale, --same-x-scale
              and --same-y-scale.

       --same-x-scale Y|N|A or -x Y|N|A
              use  in  place  of  --same-scale  or  --auto-scale for finer control over how the x
              values of the plots are scaled when you have more than one plot on a graph

              Y  yes same x scale

              N  no different x scales

              A  auto, be smart about it.  This is the default.  See also --same-y-scale.

       --same-y-scale Y|N|A or -y Y|N|A
              use in place of --same-scale or --auto-scale for  finer  control  over  how  the  x
              values of the plots are scaled when you have more than one plot on a graph

              Y  yes same y scale

              N  no different y scales

              A  auto, be smart about it.  This is the default.  See also --same-x-scale.

       --shape
              make  graphs see through.  It uses the X11 shape extension which was made famous by
              xeyes.  The X11 shape extension may be a little flashy on some systems.  Try  using
              --shape  with  the  --no-gui, --no-grid, and --no-border options to make a floating
              graph on your display.  The use of the X11 shape extension is  a  property  of  the
              main  window,  not  each  graph tab.  This option may not work well with fullscreen
              view.  This will slow down graph drawing considerably.  You can toggle this on  and
              off with the x key.  See option --no-shape.

       --shell or -e
              run  a  Quickplot  command shell that reads commands from standard input and writes
              out to standard output.  The default is no shell and standard input will be read as
              graph  data.   If  Quickplot is reading standard input for plot data Quickplot will
              read shell commands from the controlling terminal (/dev/tty) after all the standard
              input  has been read.  You may use --no-pipe to stop standard input from being read
              as graph data.  The shell can do most all the things that command-line options  can
              do  and  a  lot  more.  Run an interactive shell with quickplot --shell and use the
              help and tab completion to see how it works.  You  can  also  connect  a  Quickplot
              command shell to a running Quickplot program with the program quickplot_shell.

       --signal PID
              signal SIGUSR1 to process PID after Quickplot is running.

       --silent
              don't  spew  even  on  error.   The --silent option will override the effect of the
              --verbose option.

       --skip-lines NUM or -S NUM
              skip the first NUM lines when reading the file.  This applies of all types of files
              that quickplot can read.  Set NUM to zero to stop skipping lines.

       --statusbar
              show   the   status   bar  below  the  graph.   This  is  the  default.   See  also
              --no-statusbar.

       --tabs show the graph tabs.  This is the default.  See also --no-tabs.

       --verbose or -v
              spew more to standard output.  See also --silent.

       --version or -V
              print the Quickplot version number and then exit returning 0 exit status

       --x11-draw or -q
              draw points and lines using the X11 API.  This is the default.  Drawing may be much
              faster   than  with  Cairo,  but  there  will  be  no  translucent  colors  and  no
              anti-aliasing in  the  drawing  of  the  plot  lines  and  points.  There  will  be
              translucent  colors  and  anti-aliasing  in  the  background and grid.  Also, saved
              images will not have translucent colors like they do with the Cairo draw mode.  You
              can  start  drawing with X11 and switch to drawing with Cairo when you want to save
              an image.  Use the r key or the View menu to switch back and forth between  drawing
              with X11 and Cairo.  See also --cairo-draw.

SEE ALSO

       quickplot_shell(1)

COPYRIGHT

       Copyright (C) 1998-2011  Lance Arsenault

       Quickplot  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 3 of the License, or (at your option) any later version.

       Quickplot  is  distributed  in  the hope that it will be useful, but WITHOUT ANY WARRANTY;
       without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR  PURPOSE.
       See the GNU General Public License for more details.

       You  should  have  received a copy of the GNU General Public License along with Quickplot.
       If not, see <http://www.gnu.org/licenses/>.

AUTHOR

       Lance Arsenault <lanceman@users.sourceforge.net>
       Send bug reports or comments to the above address.
       For more information, see the Quickplot homepage at
       <http://quickplot.sourceforge.net/>.

                       Quickplot Version 1.0.1rc: 10 Jan 2016 04:50:02 UTC           QUICKPLOT(1)