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