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