1d.linegraph(1) Grass User's Manual d.linegraph(1)
2
6 d.linegraph - Generates and displays simple line graphs in the active
7 graphics monitor display frame.
8
10 display
11
13 d.linegraph
14 d.linegraph help
15 d.linegraph x_file=string y_file=string[,string,...] [direc‐
16 tory=string] [y_color=string[,string,...]] [title_color=string]
17 [x_title=string] [y_title=string] [title=string]
18 Parameters:
20 x_file=string
21 Name of data file for X axis of graph
22 y_file=string[,string,...]
24 Name of data file(s) for Y axis of graph
25 directory=string
27 Path to file location Default: .
28 y_color=string[,string,...]
30 Color for Y data Options: red,orange,yellow,green,blue,indigo,vio‐
31 let,white,black,gray,brown,magenta,aqua,grey,cyan,purple
32 title_color=string
34 Color for axis, tics, numbers, and title Options: red,orange,yel‐
35 low,green,blue,indigo,vio‐
36 let,white,black,gray,brown,magenta,aqua,grey,cyan,purple Default:
37 black
38 x_title=string
40 Title for X data Default:
41 y_title=string
43 Title for Y data Default:
44 title=string
46 Title for Graph Default:
47
49 d.linegraph is a primitive program to draw simple x,y line graphs based
50 on numerical data contained in separate files.
51 Data file format
53 The X and Y data files for the graph are essentially a column of num‐
54 bers in each file, with one input number per line. The program expects
55 that each X value will have a corresponding Y value, therefore the num‐
56 ber of lines in each data input file should be the same. Essentially,
57 the X data becomes the X axis reference to which the Y data is plotted
58 as a line. Therefore, the X data should be a monotonically increasing
59 progression of numbers (i.e. "1,2,3,..."; "0, 10, 100, 1000,...";
60 "...-5,-1,0,1,5..."). If multiple Y data files are used, the Y axis
61 scale will be based on the range of minimum and maximum values from all
62 Y files, then all Y data given will be graphed according to that Y
63 scale. Therefore, if multiple Y data inputs are used with dissimilar
64 units, the graph produced comparing the two will be deceptive.
65 directoryname
67 Path to the directory where the input files are located. If this
68 option is not used, the d.linegraph looks for files in the cur‐
69 rent directory. Example format: directory/usr/grass/data/graph
70 ycoloroption[,option,...]]
72 Color to be used for drawing the lines in the graph. If multiple
73 Y data files are used, an equal number of colors may be used to
74 control the colors of the lines. Colors will be assigned to Y
75 data in respect to the sequence of instantiation on the command
76 line. Options are listed below. By default, a series of colors
77 will be chosen by the program if none are provided upon invoca‐
78 tion. Order of default colors: yellow, red, green, violet,
79 blue, orange, gray, brown, magenta, white, indigo).
80 titlecoloroption
82 The color to be used for titles, axis lines, tics, and scale
83 numbers. Default: "white" Color options: red, orange, yellow,
84 green, blue, indigo, violet, magenta, brown, gray, white, and
85 black.
86 xtitlevalue
88 Title to describe X data. Will be centered beneath the graph.
89 Default is no title unless the need for a unit descriptor is
90 computed by the program (i.e. X: title in hundreds). Also, see
91 NOTES section (below) for a format caveat for multi-word titles.
92 ytitlevalue
94 Title to describe Y data. Will be centered beneath the X data
95 title. Default is no title unless the need for a unit descrip‐
96 tor is computed by the program (i.e. Y: ttiittllee in thou‐
97 sands). Also, see NOTES section (below) for a format caveat for
98 multi-word titles. In the case of graphs with multiple lines,
99 one may wish to use more specific title placement by using the
100 d.text or v.label programs.
101 titlevalue
103 Title to describe the graph. Will be centered over the top of
104 graph. Default is no title. See NOTES section (below) for a
105 format caveat for multi-word titles.
106
108 Since the command line parser is not amiable to multiple word inputs,
109 to input titles of more than one word, use the underscore character
110 ("") to represent spaces (" ").
111 Example: "titleCensusdata1990" would be printed over the graph as "Cen‐
113 sus data 1990".
114 The way the program locates and labels tic marks is less than perfect:
116 1) although distances between Y tics is proportional to the value, they
117 are not proportional on the X axis; 2) decimal values between -1 and 1
118 can be printed on the X axis, but not on Y. (With respect to the later,
119 the input for Y values can all be multiplied by a factor of 10 before
120 graphing).
121
123 Unknown
124
126 d.frame, d.text, v.label
127
129 Chris Rewerts, Agricultural Engineering, Purdue University
130 Last changed: $Date: 2006/04/20 21:31:23 $
132 Full index
134GRASS 6.2.2 d.linegraph(1)