d.linegraph(1)	       Grass User's Manual	   d.linegraph(1)



NNAAMMEE
       dd..lliinneeggrraapphh - Generates and displays simple line graphs in
       the active graphics monitor display frame.

       (GRASS Display Program)

SSYYNNOOPPSSIISS
       dd..lliinneeggrraapphh

       dd..lliinneeggrraapphh hheellpp

       dd..lliinneeggrraapphh xxffiilleennaammee yyffiilleennaammee[[,,nnaammee,,......]] [[ddiirreeccttoorryynnaammee]]
       [[yyccoolloorrooppttiioonn[[,,ooppttiioonn,,......]]]]   [[xxttiittlleevvaalluuee]]  [[yyttiittlleevvaalluuee]]
       [[ttiittlleevvaalluuee]] [[ttiittlleeccoolloorrooppttiioonn]]

DDEESSCCRRIIPPTTIIOONN
       _d_._l_i_n_e_g_r_a_p_h is a primitive program to draw simple x,y line
       graphs  based  on  numerical  data  contained  in separate
       files.

   PPaarraammeetteerrss::
       xxffiilleennaammee
	      Name of file with data for the X axis of graph.

       yyffiilleennaammee[[,,nnaammee,,......]]
	      Name of file(s) with data for the Y axis of  graph.
	      Up to ten Y inputs can be used.

       Data file format

       The  X  and  Y  data files for the graph are essentially a
       column of numbers in each file, with one input number  per
       line.   The  program expects that each X value will have a
       corresponding Y value, therefore the number  of	lines  in
       each data input file should be the same.  Essentially, the
       X data becomes the X axis reference to which the Y data is
       plotted as a line. Therefore, the X data should be a mono-
       tonically  increasing  progression   of	  numbers   (i.e.
       "1,2,3,..."; "0, 10, 100, 1000,..."; "...-5,-1,0,1,5...").
       If multiple Y data files are used, the Y axis  scale  will
       be  based  on the range of minimum and maximum values from
       all Y files, then all Y data given will be graphed accord-
       ing  to that Y scale. Therefore, if multiple Y data inputs
       are used with dissimilar units, the graph produced compar-
       ing the two will be deceptive.



       ddiirreeccttoorryynnaammee
	      Path  to	the  directory	where the input files are
	      located. If this option is not  used,  the  _d_._l_i_n_e_-
	      _g_r_a_p_h  looks  for  files	in the current directory.
	      Example format: directory/usr/grass/data/graph

       yyccoolloorrooppttiioonn[[,,ooppttiioonn,,......]]]]
	      Color to be used	for  drawing  the  lines  in  the
	      graph.  If multiple Y data files are used, an equal
	      number of colors may be used to control the  colors
	      of  the lines. Colors will be assigned to Y data in
	      respect to the sequence  of  instantiation  on  the
	      command	line.	Options  are  listed  below.   By
	      default, a series of colors will be chosen  by  the
	      program  if  none  are  provided	upon  invocation.
	      Order of default colors: yellow, red,  green,  vio-
	      let,  blue,  orange,  gray,  brown, magenta, white,
	      indigo).

       ttiittlleeccoolloorrooppttiioonn
	      The color to be used for titles, axis lines,  tics,
	      and scale numbers.  Default: "white" Color options:
	      red, orange, yellow, green, blue,  indigo,  violet,
	      magenta, brown, gray, white, and black.

       xxttiittlleevvaalluuee
	      Title  to describe X data. Will be centered beneath
	      the graph. Default is no title unless the need  for
	      a  unit descriptor is computed by the program (i.e.
	      X: title in hundreds).   Also,  see  NOTES  section
	      (below)  for a format caveat for multi-word titles.

       yyttiittlleevvaalluuee
	      Title to describe Y data. Will be centered  beneath
	      the  X  data title.  Default is no title unless the
	      need for a unit descriptor is computed by the  pro-
	      gram  (i.e.  Y: ttiittllee in thousands). Also, see
	      NOTES section  (below)  for  a  format  caveat  for
	      multi-word  titles. In the case of graphs with mul-
	      tiple lines, one may  wish  to  use  more  specific
	      title placement by using the _d_._t_e_x_t or _d_._l_a_b_e_l pro-
	      grams.

       ttiittlleevvaalluuee
	      Title to describe the graph. Will be centered  over
	      the  top	of graph.  Default is no title. See NOTES
	      section (below) for a format caveat for  multi-word
	      titles.


NNOOTTEESS
       Since  the  command line parser is not amiable to multiple
       word inputs, to input titles of more than  one  word,  use
       the underscore character ("") to represent spaces (" ").


       Example:  "titleCensusdata1990"	would be printed over the
       graph as "Census data 1990".


       The way the program locates and labels tic marks  is  less
       than perfect: 1) although distances between Y tics is pro-
       portional to the value, they are not proportional on the X
       axis; 2) decimal values between -1 and 1 can be printed on
       the X axis, but not on Y. (With respect to the later,  the
       input for Y values can all be multiplied by a factor of 10
       before graphing).

BBUUGGSS
       Unknown

SSEEEE AALLSSOO
       _p_a_r_s_e_r

AAUUTTHHOORR
       Chris Rewerts, Agricultural Engineering, Purdue University

       _L_a_s_t _c_h_a_n_g_e_d_: _$_D_a_t_e_: _2_0_0_2_/_0_1_/_2_5 _0_5_:_4_5_:_3_3 _$



GRASS 5.0					   d.linegraph(1)
