← Back to branch summary

~ubuntu-branches/ubuntu/vivid/grass/vivid-proposed

« back to all changes in this revision

Viewing changes to display/d.linegraph/description.html

  • Committer: Package Import Robot
  • Author(s): Bas Couwenberg
  • Date: 2015-02-20 23:12:08 UTC
  • mfrom: (8.2.6 experimental)
  • Revision ID: package-import@ubuntu.com-20150220231208-1u6qvqm84v430b10
Tags: 7.0.0-1~exp1
* New upstream release.
* Update python-ctypes-ternary.patch to use if/else instead of and/or.
* Drop check4dev patch, rely on upstream check.
* Add build dependency on libpq-dev to grass-dev for libpq-fe.h.
* Drop patches applied upstream, refresh remaining patches.
* Update symlinks for images switched from jpg to png.

Show diffs side-by-side

added added

removed removed

Lines of Context:
display/d.linegraph/description.html
1
 
<h2>DESCRIPTION</h2>
2
 
 
3
 
<em>d.linegraph</em> is a primitive program to draw simple x,y line graphs
4
 
based on numerical data contained in separate files.
5
 
<p>
6
 
Data file format<br>
7
 
The X and Y data files for the graph are essentially a column of numbers in
8
 
each file, with one input number per line.  The program expects that each X
9
 
value will have a corresponding Y value, therefore the number of lines in
10
 
each data input file should be the same.  Essentially, the X data becomes
11
 
the X axis reference to which the Y data is plotted as a line. Therefore,
12
 
the X data should be a monotonically increasing progression of numbers (i.e.
13
 
"1,2,3,..."; "0, 10, 100, 1000,..."; "...-5,-1,0,1,5...").  If multiple Y
14
 
data files are used, the Y axis scale will be based on the range of minimum
15
 
and maximum values from all Y files, then all Y data given will be graphed
16
 
according to that Y scale. Therefore, if multiple Y data inputs are used
17
 
with dissimilar units, the graph produced comparing the two will be
18
 
deceptive.
19
 
 
20
 
<p>
21
 
<dl>
22
 
<dt><b>directoryname</b>
23
 
<dd>Path to the directory where the input files are located. If this option
24
 
is not used, the <em>d.linegraph</em> looks for files in the current directory.
25
 
<dd>Example format: directory/usr/grass/data/graph
26
 
 
27
 
<dt><b>ycoloroption[,option,...]]</b>
28
 
<dd>Color to be used for drawing the lines in the graph. If multiple Y data
29
 
files are used, an equal number of colors may be used to control the colors
30
 
of the lines. Colors will be assigned to Y data in respect to the sequence
31
 
of instantiation on the command  line.  Options are listed below.  By
32
 
default, a series of colors will be chosen by the program if none are
33
 
provided upon invocation.
34
 
<dd>Order of default colors: yellow, red, green, violet, blue, orange, gray,
35
 
brown, magenta, white, indigo).
36
 
 
37
 
<dt><b>titlecoloroption</b>
38
 
<dd>The color to be used for titles, axis lines, tics, and scale numbers.  
39
 
<dd>Default: "white"
40
 
<dd>Color options: red, orange, yellow, green, blue, indigo, violet,
41
 
magenta, brown, gray, white, and black.
42
 
 
43
 
<dt><b>xtitlevalue</b>
44
 
<dd>Title to describe X data. Will be centered beneath the graph. Default
45
 
is no title unless the need for a unit descriptor is computed by the program
46
 
(i.e. X: title in hundreds).  Also, see NOTES section (below) for a format
47
 
caveat for multi-word titles.
48
 
 
49
 
<dt><b>ytitlevalue</b>
50
 
<dd>Title to describe Y data. Will be centered beneath the X data title.
51
 
Default is no title unless the need for a unit descriptor is computed by
52
 
the program (i.e. Y: ttiittllee in thousands). Also, see NOTES section
53
 
(below) for a format caveat for multi-word titles. In the case of graphs
54
 
with multiple lines, one may wish to use more specific title placement by
55
 
using the <em>d.text</em> or <em>v.label</em> programs.
56
 
 
57
 
<dt><b>titlevalue</b>
58
 
<dd>Title to describe the graph. Will be centered over the top of graph.
59
 
Default is no title. See NOTES section (below) for a format caveat for
60
 
multi-word titles.
61
 
</dl>
62
 
 
63
 
<h2>NOTES</h2>
64
 
Since the command line parser is not amiable to multiple word inputs, to
65
 
input titles of more than one word, use the underscore character ("") to
66
 
represent spaces (" ").
67
 
<p>
68
 
Example: "titleCensusdata1990" would be printed over the graph as "Census
69
 
data 1990".
70
 
<p>
71
 
The way the program locates and labels tic marks is less than perfect: 1)
72
 
although distances between Y tics is proportional to the value, they are
73
 
not proportional on the X axis; 2) decimal values between -1 and 1 can be
74
 
printed on the X axis, but not on Y. (With respect to the later, the input
75
 
for Y values can all be multiplied by a factor of 10 before graphing).
76
 
 
77
 
<p>
78
 
It might be easier to use a 3rd party tool such as xgraph or GNUplot instead
79
 
of <em>d.linegraph</em>.
80
 
.
81
 
(You can make GNUplot output pretty by using its SVG or PostScript output
82
 
driver and converting that back into a rasterized image in a paint program)
83
 
 
84
 
<h2>SEE ALSO</h2>
85
 
<em>
86
 
<a href="d.frame.html">d.frame</a>,
87
 
<a href="d.text.html">d.text</a>,
88
 
<a href="v.label.html">v.label</a>
89
 
</em>
90
 
 
91
 
<h2>AUTHOR</h2>
92
 
Chris Rewerts, Agricultural Engineering, Purdue University
93
 
 
94
 
<p>
95
 
<i>Last changed: $Date: 2011-11-08 12:29:50 +0100 (Tue, 08 Nov 2011) $</i>