


CHART(1)                  User Commands                  CHART(1)


NAME
       chart,  xchart  -  svgalib  and  X11 programs to plot data
       charts

SYNOPSIS
       chart [ options ] datafile [ datafile...]

DESCRIPTION
       chart is a program to plot simple data charts non-interac-
       tively.  It was written for in-house use at the Settore di
       Geofisica, University of Bologna (Italy), where we  needed
       a  program to preview data files prior to further investi-
       gation.

       chart can be viewed as a companion program to  gnuplot(1):
       the  latter  is  much  more  powerful,  but it's mainly an
       interactive program. In some situations this is not desir-
       able,  as  when  one  has  to  plot a large number of data
       files. chart is a non-interactive program and can be  used
       for  a quick preview of many datafiles at once; an example
       of invocation is chart *dat.

       chart gets as input one or more files  that  must  contain
       pairs  of  numbers, finds the range of the data, and plots
       the chart(s) using defaults.  If the  file  contains  non-
       numeric strings, they will be ignored. For each data file,
       it  creates  an  accompanying  file  .cht  containing  the
       options; this option file can be edited to suit the user's
       needs.

.CHT FILE OPTIONS
       plot style:
            the first character of the line can be either  C,  D,
            O, S, or T. According to this option, each datum will
            be plotted as a cross, a diamond, a dot, a square, or
            a triangle. Default C.

       range and ticks:
            this  line  contains  the plot range for X and Y, and
            the corresponding ticks.  Edit these value with care.

       grid on/off:
            default Y.

       join data points:
            default N.

       draw regression line:
            whether  or  not  to  draw the regression line to the
            data and write it on the chart bottom. Default N.

       write X values:
            whether or not  to  write  the  X  values  below  the
            abscissa. Default Y.



Linux                      October 1997                         1





CHART(1)                  User Commands                  CHART(1)


       write Y values:
            whether  or  not to write the Y values at the left of
            the ordinate. Default Y.

       draw main X tick:
            default Y.

       draw secondary X tick:
            default Y.

       draw main Y tick:
            default Y.

       draw secondary Y tick:
            default Y.

       title:
            any string to be placed on the top of the screen.  By
            default, the file name.

       X axis title:
            by default, `X axis'.

       Y axis title:
            by default, `Y axis'.

       remark:
            insert here a remark string, or leave it blank.

COMMAND LINE OPTIONS

       -1   plot in SVGA mode, 800x600.

       -2   plot in SVGA mode, 1024x768.

       -S   save  a  PostScript file of the chart. If the current
            data file is named, say, mydata.dat,  the  PostScript
            file will be named mydata.ps.

       -n   don't  pause  between charts. Useful when you want to
            save many PostScript or pcx files.

       -r   force the `regression line' option for new charts.

       -s   save a monochrome pcx file of the chart. This  is  an
            old  graphic  format  for  MS-DOS, and it's supported
            because it produces very compact files. If  the  cur-
            rent  data  file  is  named, say, mydata.dat, the pcx
            file will be named mydata.pcx.  A  pcx  file  can  be
            converted to PostScript by pcx2ps (1).

       -v   output version number and exit.






Linux                      October 1997                         2





CHART(1)                  User Commands                  CHART(1)


EXAMPLES
       chart -r mydata.dat
       chart -1Snr data*.dat

BUGS
       If  you  modify  a data file and replot it, chart will use
       the old .cht file(s) which could now be wrong. Delete  the
       old .cht to fix this.

       If you find any other bug, please get in touch with me.

AUTHOR
       Guido Gonzato <guido@ibogfs.cineca.it>

SEE ALSO
       gnuplot (1).

IN MEMORIAM
       I  dedicate  this  program to Filippo Geremia (1968-1996),
       tragically killed in a car crash. For all those  who  knew
       you  it's  very  hard to accept that you left us so early,
       Filippo.



































Linux                      October 1997                         3


