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]]  [[yyccoolloorroopp--
       ttiioonn[[,,ooppttiioonn,,......]]]]  [[xxttiittlleevvaalluuee]] [[yyttiittlleevvaalluuee]] [[ttiittlleevvaalluuee]] [[ttiittlleeccooll--
       oorrooppttiioonn]]

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  num-
       bers in each file, with one input number per line.  The program expects
       that each X value will have a corresponding Y value, therefore the num-
       ber  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 monotonically 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 according to that Y
       scale. Therefore, if multiple Y data inputs are	used  with  dissimilar
       units, the graph produced comparing 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  cur-
	      rent 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  invoca-
	      tion.   Order  of  default  colors:  yellow, red, green, violet,
	      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  descrip-
	      tor  is  computed  by  the  program (i.e. Y: ttiittllee in thou-
	      sands). Also, see NOTES section (below) for a format caveat  for
	      multi-word  titles.  In  the case of graphs with multiple 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 programs.

       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 "Cen-
       sus data 1990".


       The way the program locates and labels tic marks is less than  perfect:
       1) although distances between Y tics is proportional 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)
