← Back to branch summary

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

« back to all changes in this revision

Viewing changes to gui/tcltk/d.m/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:
gui/tcltk/d.m/description.html
1
 
<h2>DESCRIPTION - GIS MANAGER</h2>
2
 
 
3
 
<P>
4
 
<BR>
5
 
 
6
 
<i><b>
7
 
The </b>d.m<b> Tcl/Tk GIS manager GUI has been replaced by </b>gis.m<b>.
8
 
The </b>d.m<b> code is now UNMAINTAINED and OBSOLETE and left here as a
9
 
courtesy to legacy users. The </b>gis.m<b> GUI is soon to be replaced by a
10
 
new wxPython based GUI.
11
 
</b></i>
12
 
 
13
 
<P>
14
 
<BR>
15
 
 
16
 
The <b>GRASS GIS Manager</b>
17
 
provides an interactive graphical interface to GRASS commands. By
18
 
default, it is started automatically with each GRASS session. The GIS
19
 
Manager can be quit by selecting the <em>'File-&gt;Exit</em><em>'</em>
20
 
menu item. The GIS Manager can be restarted from the GRASS command line
21
 
shell by typing "<i>d.m &amp;</i>".<br>
22
 
 
23
 
<br>
24
 
The GIS Manager includes a set of pull-down menus for many GIS
25
 
functions (analysis, file I/O, GIS configuration and management), two
26
 
rows of buttons that control display functions, an upper window in
27
 
which layers to display are organized, a row of display monitor control
28
 
buttons along the left side of the layer tree window, and a lower
29
 
window which contains options panels for layers in the layer tree. <br>
30
 
<br>
31
 
The top row of buttons control a series of display functions:
32
 
displaying or redisplaying all map layers in the default monitor
33
 
window, zooming and panning, simple queries, starting NVIZ
34
 
(n-dimensional visualization) or XGANIM (display animator) display
35
 
interfaces, and saving or opening group display file. The second row of
36
 
buttons add, copy, or remove map layers to be displayed, and activate
37
 
the raster and vector digitizing interfaces. <em><b>Mouse-over help</b></em>
38
 
is available for all buttons.<br>
39
 
<br>
40
 
Map layers are organized as a layer tree, in the window below the
41
 
buttons. Layers can include raster and vector maps, text, map
42
 
enhancements (scale and north arrow, grids, and frames), and commands
43
 
(where any GRASS command be written). Layers are displayed in the order
44
 
added to the layer tree: the first added (i.e., at the top of the tree)
45
 
is displayed first, followed by the next added, etc. This means that
46
 
the uppermost layer is 'on the bottom' and the lowermost is 'on top' if
47
 
layers are thought of as a series of stacked overlays. Any layer can be
48
 
renamed by double clicking on its name and typing a new name.<br>
49
 
<br>
50
 
The check box to the left of each layer makes it active for display.
51
 
Active layers are only displayed/redisplayed when the display button is
52
 
pressed. Layers can be organized into groups; entire groups can be
53
 
activated or deactivated for display. Groups can be saved to a file and
54
 
opened in subsequent sessions, restoring all layers and their display
55
 
options.<br>
56
 
<br>
57
 
When a layer is selected with the mouse, its options are shown in the
58
 
panel below the layer tree window. Help for each layer type can be
59
 
accessed by pressing the GRASS button in the option panel.<br>
60
 
<br>
61
 
The monitor buttons along the left side of the layer tree window open
62
 
or select (if already open) one of seven display monitors (named
63
 
x0-x6). Layers are be displayed in the currently selected monitor. If
64
 
no monitor is open and selected, map layers will be displayed in
65
 
monitor x0. <br>
66
 
 
67
 
<em></em>
68
 
 
69
 
<h2>BUTTON FUNCTIONS (top row)</h2>
70
 
 
71
 
 
72
 
 
73
 
<h3>Display active layers (current region)</h3>
74
 
Displays all active layers at current resolution and region extents.
75
 
Monitor x0 will be started automatically if a monitor is not already
76
 
open and selected.
77
 
 
78
 
<h3>Display active layers (default region)</h3>
79
 
Resets the region to the default resolution and extents, and displays all
80
 
active layers. See <tt><a href="g.region.html">g.region</a> -d</tt>.
81
 
 
82
 
<h3>Display active layers (saved region)</h3>
83
 
Opens a dialog to select a saved region setting. Resets the region to
84
 
the resolution and extents of the selected saved region, and displays
85
 
all active layers. See <tt><a href="g.region.html">g.region</a></tt>.
86
 
 
87
 
<h3>Erase to white</h3>
88
 
Erases the currently selected monitor to a white background; also removes all frames. <span style="font-style: italic;">See <a href="d.erase.html">d.erase</a> and <a href="d.frame.html">d.frame</a> -e.</span>
89
 
<h3>NVIZ</h3>
90
 
Starts the NVIZ, n-dimensional visualization module and interactive graphical interface. <span style="font-style: italic;">See <a href="nviz.html">nviz</a></span><a href="nviz.html">.</a>
91
 
<h3>Fly through path for NVIZ</h3>
92
 
Starts a GRASS module for interactive creation of a fly-through path to be animated in NVIZ. <span style="font-style: italic;">See <a href="d.nviz.html">d.nviz</a></span>.
93
 
<h3>Animate raster map series<br>
94
 
</h3>
95
 
Starts the XGANIM interactive interface to display a series of raster maps as an animation. <span style="font-style: italic;">See <a href="xganim.html">xganim</a></span><a href="xganim.html">.</a>
96
 
<h3>Zoom</h3>
97
 
Interactive zooming with the mouse in the active display monitor.
98
 
Zooming resets the region extents (both size and location of area
99
 
displayed). A set of prompts for using the mouse for zooming will
100
 
appear in a separate x-terminal. A simple (i.e., non-draped) raster map
101
 
or vector map must be active and displayed in the current monitor. If
102
 
no map is currently active and displayed, a dialog will appear in which
103
 
a map can be chosen. <span style="font-style: italic;">See <a href="d.zoom.html">d.zoom</a>.</span><span style="font-weight: bold;"><br>
104
 
</span>
105
 
<h3><span style="font-weight: bold;">Return to previous zoom</span></h3>
106
 
<span style="font-weight: bold;"></span>Resets the region to the layer extents in effect prior to zooming.<span style="font-weight: bold;"></span>
107
 
<h3><span style="font-weight: bold;">Pan and recenter</span></h3>
108
 
<span style="font-weight: bold;"></span>Interactive selection of a new
109
 
center of view in the active display monitor. Panning changes the
110
 
location of the region extents but not the size of the area displayed.
111
 
A simple (i.e., non-draped) raster map or vector map must be active and
112
 
displayed in the current monitor for panning to function. <span style="font-style: italic;">See&nbsp;</span><span style="font-style: italic;"><a href="d.zoom.html">d.zoom</a> -p</span>.<br>
113
 
<span style="font-weight: bold;"></span>
114
 
<h3>Query map (select map first)</h3>
115
 
Query selected raster (only the base map of a draped map will be
116
 
queried), RGB raster map (all three map channels will be queried), or
117
 
vector map using the mouse. A map has to be
118
 
selected before query.
119
 
&nbsp;Vector charts and thematic vector maps cannot be queried. The
120
 
results of a raster map query will be displayed in a new x-terminal.
121
 
Depending on the setting in the vector panel, the results of a vector
122
 
map query will be displayed in&nbsp;graphical form window or in a new
123
 
x-terminal.<br>
124
 
<br>
125
 
 
126
 
 
127
 
The default display mode for vector map queries can also be set with the GRASS environment variable DM_FORM_MODE.
128
 
 
129
 
<br>
130
 
 
131
 
<div style="margin-left: 40px;"><tt>g.gisenv set=DM_FORM_MODE=txt</tt> for displaying vector query results in an x-terminal
132
 
<br>
133
 
<tt>g.gisenv set=DM_FORM_MODE=gui </tt>for displaying vector query results in a graphical form window<br>
134
 
<br>
135
 
</div>
136
 
<span style="font-style: italic;">See <a href="d.what.rast.html">d.what.rast</a> and <a href="d.what.vect.html">d.what.vect</a></span>.<br>
137
 
 
138
 
<h3>Measure lengths and areas</h3>
139
 
Interactive measurement of lengths and/or areas defined with the mouse.
140
 
An x-terminal will open with prompts for using the mouse to measure
141
 
lengths and areas, and display the results of measurement. Lengths are
142
 
measured in meters; areas are measured in hectares, square miles, and
143
 
square meters. A display monitor must be open and selected, but it is
144
 
not necessary to select or display a map in order to measure lengths
145
 
and areas. <span style="font-style: italic;">See d.measure.</span><br>
146
 
<h3>Geographical position</h3>
147
 
 
148
 
 
149
 
 
150
 
Interactive identification of geographical position in the coordinate
151
 
system of the current location.&nbsp;An x-terminal will open with
152
 
prompts for using the mouse and display the xy coordinates of at each
153
 
mouse click location.&nbsp;<span style="font-style: italic;">See <a href="d.where.html">d.where</a></span>. 
154
 
<h3>Erase all layers and create a new group</h3>
155
 
Removes all layers in the layer tree and creates a new, empty group to which new layers can be added.<br>
156
 
 
157
 
 
158
 
<h3>Open an existing group file</h3>
159
 
Opens an previously saved group file, containing a set of display layers and their option settings.
160
 
<h3>Save layers to group file</h3>
161
 
Saves current set of layers and their options to a group file. 
162
 
 
163
 
<h3>Print map</h3>
164
 
Uses ps.map to print simple raster, vector, and text layers. Currently supported output formats are Postscript, PDF and PNG. <span style="font-style: italic;">See <a href="ps.map.html">ps.map</a></span>.<span style="font-weight: bold;"><br>
165
 
</span>
166
 
<h2>BUTTON FUNCTIONS (bottom row)</h2>
167
 
 
168
 
 
169
 
 
170
 
<h3>Add raster layer</h3>
171
 
Adds a raster map to the layer tree. Raster display options include:
172
 
displaying a selected subset of raster cells, defined by their cat
173
 
values; &nbsp;draping (or "fusing") a second map over the base map; and
174
 
displaying legends for the base map and draped map.&nbsp;<span style="font-style: italic;">See <a href="d.rast.html">d.rast</a> and <a href="d.his.html">d.his</a> (for draping/fusing).</span>
175
 
<h3>Add RGB or HIS raster layer</h3>
176
 
Combines and displays three raster maps defined as red, green, and blue
177
 
channels; or combines and displays two or three raster maps defined as
178
 
hue, intensity, and (optionally) saturation channels. <span style="font-style: italic;">See <a href="d.rgb.html">d.rgb</a> and&nbsp;</span><span style="font-style: italic;"><a href="d.his.html">d.his</a></span><span style="font-style: italic;">.</span>
179
 
<h3>Add raster legend</h3>
180
 
Adds a legend for a single raster map to the layer tree. Multiple options for formatting the legend are available. <span style="font-style: italic;">See <a href="d.legend.html">d.legend</a>.</span>
181
 
<h3>Add vector layer</h3>
182
 
Adds a vector map to the layer tree. A large number of options are
183
 
available for displaying the vector map, including: outline and fill
184
 
color, icon type and size for points, line widths for all vector types,
185
 
automatic labeling using an attribute column, querying cats or
186
 
attributes to limit vectors displayed, and restricting vector display
187
 
depending on region size. <span style="font-style: italic;">See <a href="d.vect.html">d.vect</a>.</span><br>
188
 
<h3>Add thematic charts layer (for vector points)</h3>
189
 
Adds layer in which pie or bar charts can be automatically created at
190
 
vector point locations. Charts display values from&nbsp;selected
191
 
columns in the associated attribute table. Options include: chart type,
192
 
layer and attributes to chart, chart colors, and chart size (fixed or
193
 
based on attribute column). <span style="font-style: italic;">See <a href="d.vect.chart.html">d.vect.chart</a>.</span>
194
 
<h3>Add thematic map layer (for all vector types) </h3>
195
 
 
196
 
 
197
 
 
198
 
Adds layer for thematic display values from a numeric attribute column
199
 
associated with a vector map. Options include: thematic display type
200
 
(graduated colors or point sizes), methods for creating display
201
 
intervals, SQL query of attribute column to limit vector objects to
202
 
display, control of point icon types and sizes, control of thematic
203
 
color schemes, creation of legend for thematic map, and saving the
204
 
results of thematic mapping to a ps.map instructions file for later
205
 
printing. <span style="font-style: italic;">See <a href="d.vect.thematic.html">d.vect.thematic</a>.</span><br>
206
 
<h3>Add vector labels layer (from existing labels file)</h3>
207
 
Add text layer from a labels file for vector objects created with <a href="v.label.html">v.label</a>
208
 
command (accessed from the "vector-&gt;develop map-&gt;create text
209
 
label file for vector features" menu item). A labels file can also be
210
 
created with a text editor.
211
 
See <a href=d.labels.html>d.labels</a>. 
212
 
 
213
 
 
214
 
<h3>Add freetype text layer</h3>
215
 
Adds layer to display a line of freetype text. Options include: text
216
 
placement by coordinates (geographic or screen) or mouse; text
217
 
alignment and rotation, font and line spacing; and text size, bolding,
218
 
and color. <span style="font-style: italic;">See <a href="d.text.freetype.html">d.text.freetype</a>.</span>
219
 
<h3>Add text layer</h3>
220
 
Adds layer to display a line of text using default GRASS font (selected with <a href="d.font.html" target="_blank">d.font</a>). Options include: text placement (screen coordinates); and text size, bolding, and color. <span style="font-style: italic;">See <a href="d.text.html">d.text</a>.</span>
221
 
<h3>Add scalebar and north arrow layer</h3>
222
 
Adds layer to display a combined scalebar and north arrow. Options
223
 
include scalebar placement (using screen coordinates or a mouse),
224
 
scalebar format, and scalebar colors. <span style="font-style: italic;">See <a href="d.barscale.html">d.barscale</a>.</span>
225
 
<h3>Overlay grids and lines</h3>
226
 
Adds layer to display regular grid (for all locations), or geodesic and
227
 
rhumblines (for latitude/longitude locations only). Grid options
228
 
include: grid and border colors, grid origin, and grid line spacing.
229
 
Geodesic and rhumbline options include: line color, and xy coordinates
230
 
(geographic) of line endpoints. <span style="font-style: italic;">See <a href="d.grid.html">d.grid</a>, <a href="d.geodesic.html">d.geodesic</a>, and <a href="d.rhumbline.html">d.rhumbline</a>.</span>
231
 
<h3>Create or select display frames</h3>
232
 
Adds a layer to define (or select predefined) display frame. A display
233
 
frame is a rectangular subarea of a display monitor, within which maps
234
 
can be displayed. All layers following a frame layer will be displayed
235
 
within the frame defined in the frame layer&mdash;until a new frame
236
 
layer is added and new frame defined/selected. This allows a single
237
 
monitor window to be subdivided into multiple frames, each of which can
238
 
display different maps, legends, scalebars and north arrows, or other
239
 
layers. For example, the monitor could display a detail map and a small
240
 
frame could display an inset map. <span style="font-style: italic;">See <a href="d.frame.html">d.frame</a>.</span>
241
 
<h3>Add command layer</h3>
242
 
Adds a layer defined by a GRASS GIS command or command list. For a command list use the pipe symbol as
243
 
"|" as separator.
244
 
 
245
 
<p>
246
 
 
247
 
E.g.:  <em>d.rast soils | d.rast -o roads | d.vect streams col=blue</em>
248
 
 
249
 
</p>
250
 
<h3>Add group</h3>
251
 
Adds an empty layer group. Layers can then be added to the group.<br>
252
 
<h3>Duplicate selected layer or group</h3>
253
 
Adds a new layer that duplicates the selected layer.
254
 
<h3>Cut selected layer or group</h3>
255
 
Deletes the selected group or layer.
256
 
<h3>Digitize raster or vector maps</h3>
257
 
Starts the raster digitizing or vector digitizing module, depending on
258
 
whether a raster or vector map is selected. Raster digitizing always
259
 
creates a new map. Vector digitizing will either edit an existing map
260
 
(if an existing vector map is selected in the layer tree) or create a
261
 
new vector map (if the name of the new vector to be created is entered
262
 
in the 'vector name' field of the options panel for a vector map
263
 
layer). <span style="font-style: italic;">See <a href="r.digit.html">r.digit</a> and <a href="v.digit.html">v.digit</a></span>.<br>
264
 
<br>
265
 
 
266
 
 
267
 
<h2>SEE ALSO</h2>
268
 
 
269
 
<EM>
270
 
<a href="d.mon.html">d.mon</a><BR>
271
 
<a href="g.gui.html">g.gui</a><BR>
272
 
<a href="gis.m.html">gis.m</a><BR><BR>
273
 
<a href="wxGUI.html">wxGUI</a><BR>
274
 
</EM>
275
 
 
276
 
 
277
 
<h2>AUTHORS</h2>
278
 
 
279
 
Radim Blazek, ITC-Irst, Trento, Italy<br>
280
 
Michael Barton, Arizona State University, Tempe, Arizona, USA
281
 
 
282
 
<p>
283
 
<i>Last changed: $Date: 2008-03-04 06:20:36 +0100 (Tue, 04 Mar 2008) $</i></p>
284