1gis.m(1) Grass User's Manual gis.m(1)
2
6 gis.m
7
9 The GRASS GIS Manager provides an interactive graphical interface to
10 GRASS commands. By default, it is started automatically with each GRASS
11 session. The GIS Manager can be quit by selecting the 'File->Exit '
12 menu item. The GIS Manager can be restarted from the GRASS command line
13 shell by typing "gis.m &".
14 The GIS Manager includes a set of pull-down menus for many GIS func‐
15 tions (analysis, file I/O, GIS configuration and management), two rows
16 of buttons that manage display layers, an upper window in which layers
17 to display are organized, a row of display monitor control buttons
18 along the left side of the layer tree window, and a lower window which
19 contains options panels for layers in the layer tree.
20 The top left button opens a new map display window. Each map display
21 has a unique set of layers to display and region setting (zoom). Other
22 buttons add layers of different types for display in the selected map
23 display window. There are additional buttons for saving or opening
24 group display file, starting NVIZ (n-dimensional visualization) or
25 XGANIM (display animator) display interfaces, and digitizing. Mouse-
26 over help is available for all buttons.
27 Map layers are organized as a layer tree, in the window below the but‐
28 tons. Layers can include raster and vector maps, text, map enhancements
29 (scale and north arrow, grids, and frames), and commands (where any
30 GRASS command be written). Layers are displayed in as arranged in the
31 layer tree: the bottom layer is displayed first and the top is dis‐
32 played last, as if layers are a series of stacked overlays. Any layer
33 can be renamed by double clicking on its name and typing a new name.
34 The check box to the left of each layer makes it active for display.
35 Active layers are only displayed/redisplayed when the display button is
36 pressed. Layers can be organized into groups; entire groups can be
37 activated or deactivated for display. Groups can be saved to a file and
38 opened in subsequent sessions, restoring all layers and their display
39 options.
40 When a layer is selected with the mouse, its options are shown in the
41 panel below the layer tree window. Help for each layer type can be
42 accessed by pressing the GRASS button in the option panel.
43 Each map display has a unique layer tree and region setting (zoom).
44 Buttons on each map display manage the map in the display (zoom and
45 pan), provide tools for query and distance measurement, and exporting
46 or printing the display. The geographic coordinates under the cursor
47 are displayed in the indicator window (lower right window frame).
48 A separate console window shows all commands issued and all command
49 output (upper window). GRASS commands (and any other unix/linux com‐
50 mands) can be run from the console (lower window).
51
53 Top Row
54 Open new map display
56 Open a new map display and resets layer tree.
57 Add raster layer
59 Adds a raster map to the layer tree. Raster display options include:
60 displaying a selected subset of raster cells, defined by their cat val‐
61 ues; draping (or "fusing") a second map over the base map; and dis‐
62 playing legends for the base map and draped map. See d.his (for drap‐
63 ing/fusing).
64 Add RGB or HIS raster layer
66 Combines and displays three raster maps defined as red, green, and blue
67 channels; or combines and displays two or three raster maps defined as
68 hue, intensity, and (optionally) saturation channels. See .
69 Add histogram layer
71 Adds a layer to display histogram of a raster map or image. See d.his‐
72 togram.
73 Add cell values layer
75 Adds map of raster cells with cell values printed inside. Only works
76 when See d.rast.num.
77 Add raster arrows layer
79 Adds map of raster cells with directional arrows drawn. arrow direction
80 and length determined by separate aspect/directional map and
81 slope/intensity map. See d.rast.arrow.
82 Add raster legend
84 Adds a legend for a single raster map to the layer tree. Multiple
85 options for formatting the legend are available. See d.legend.
86 Add vector layer
88 Adds a vector map to the layer tree. A large number of options are
89 available for displaying the vector map, including: outline and fill
90 color, icon type and size for points, line widths for all vector types,
91 automatic labeling using an attribute column, querying cats or
92 attributes to limit vectors displayed, and restricting vector display
93 depending on region size. See d.vect.
94 Add thematic map layer (for all vector types)
96 Adds layer for thematic display values from a numeric attribute column
97 associated with a vector map. Options include: thematic display type
98 (graduated colors or point sizes), methods for creating display inter‐
99 vals, SQL query of attribute column to limit vector objects to display,
100 control of point icon types and sizes, control of thematic color
101 schemes, creation of legend for thematic map, and saving the results of
102 thematic mapping to a ps.map instructions file for later printing. See
103 d.vect.thematic.
104 Add thematic charts layer (for vector points)
106 Adds layer in which pie or bar charts can be automatically created at
107 vector point locations. Charts display values from selected columns in
108 the associated attribute table. Options include: chart type, layer and
109 attributes to chart, chart colors, and chart size (fixed or based on
110 attribute column). See d.vect.chart.
111 Add raster labels layer for vector objects (from existing labels file)
113 Add raster text layer from a labels file for vector objects created
114 with v.label command (accessed from button in options panel). A labels
115 file can also be created with a text editor. See d.labels.
116 Add postscript labels layer for vector objects (from existing labels file)
118 Add postscript text layer from a labels file for vector objects created
119 with v.label command (accessed from button in options panel). A labels
120 file can also be created with a text editor. See d.labels.
121 Add postscript text layer
123 Adds layer to display a line of postscript text. Options include: text
124 placement by coordinates (geographic or screen); text alignment, font
125 and line spacing; and text size, bolding, and color.
126 Add text layer
128 Adds layer to display a line of text using default GRASS font (selected
129 with d.text.
130 Bottom Row
132 Add scalebar and north arrow layer
133 Adds layer to display a combined scalebar and north arrow. Options
134 include scalebar placement (using screen coordinates or a mouse),
135 scalebar format, and scalebar colors. See d.barscale.
136 Overlay grids and lines
138 Adds layer to display regular grid (for all locations), or geodesic and
139 rhumblines (for latitude/longitude locations only). Grid options
140 include: grid and border colors, grid origin, and grid line spacing.
141 Geodesic and rhumbline options include: line color, and xy coordinates
142 (geographic) of line endpoints. See d.rhumbline.
143 Add command layer
145 Adds a layer defined by a GRASS GIS command or command list. For a com‐
146 mand list use the pipe symbol as "|" as separator.
147 E.g.: d.rast soils | d.rast -o roads | d.vect streams col=blue Note
149 that when an option of the command contains spaces, you need to escape
150 them with the backslash ('\') character, e.g.: d.text.freetype
151 text=Population\ density
152 Add group
154 Adds an empty layer group. Layers can then be added to the group.
155 Duplicate selected layer or group
157 Adds a new layer that duplicates the selected layer.
158 Cut selected layer or group
160 Deletes the selected group or layer.
161 Erase all layers and create a new group
163 Removes all layers in the layer tree and creates a new, empty group to
164 which new layers can be added.
165 Open an existing group file
167 Opens an previously saved group file, containing a set of display lay‐
168 ers and their option settings.
169 Save layers to group file
171 Saves current set of layers and their options to a group file.
172 NVIZ
174 Starts the NVIZ, n-dimensional visualization module and interactive
175 graphical interface. See .
176 Fly through path for NVIZ
178 Starts a GRASS module for interactive creation of a fly-through path to
179 be animated in NVIZ. See d.nviz.
180 Animate raster map series
182 Starts the XGANIM interactive interface to display a series of raster
183 maps as an animation. See .
184 Digitize raster or vector maps
186 Starts the raster digitizing or vector digitizing module, depending on
187 whether a raster or vector map is selected. Raster digitizing always
188 creates a new map. Vector digitizing will either edit an existing map
189 (if an existing vector map is selected in the layer tree) or create a
190 new vector map (if the name of the new vector to be created is entered
191 in the 'vector name' field of the options panel for a vector map
192 layer). See v.digit.
193
195 Display active layers (current region)
196 Displays all active layers at current resolution and region extents for
197 that map display window.
198 Redisplay all active layers and zoom to current region
200 Resets the region to the resolution and extents to the values set with
201 g.region; forces redisplay and re-rendering all active layers. See
202 g.region.
203 NVIZ
205 Starts the NVIZ, n-dimensional visualization module and interactive
206 graphical interface. All active raster and vector layers in the layer
207 tree will be displayed in NVIZ. See .
208 Erase to white
210 Arrow cursor
211 Zoom in
212 Interactive zooming with the mouse in the active display monitor.
213 Drawing a box with the mouse (left button) and zoom-in cursor causes
214 the display to zoom in so that the area defined by the box fills the
215 display. The map resolution is not changed. Clicking with the zoom-in
216 cursor causes the display to zoom in by 30%, centered on the point
217 where the mouse is clicked. Zooming resets the region extents (both
218 size and location of area displayed). See
219 Zoom out
221 Interactive zooming with the mouse in the active display monitor.
222 Drawing a box with the mouse (left button) and zoom-out cursor causes
223 the display to zoom in so that the area displayed shrinks to fill the
224 area defined by the box. The map resolution is not changed. Clicking
225 with the zoom-out cursor causes the display to zoom out by 30%, cen‐
226 tered on the point where the mouse is clicked. Zooming resets the
227 region extents (both size and location of area displayed). See
228 Pan
230 Interactive selection of a new center of view in the active display
231 monitor. Drag the pan cursor while pressing the left mouse button to
232 pan. Panning changes the location of the region extents but not the
233 size of the area displayed or the resolution. See g.region.
234 Query (select map first)
236 Query selected raster (only the base map of a draped map will be
237 queried), RGB raster map (all three map channels will be queried), or
238 vector map using the mouse. A map must be selected before query. Vec‐
239 tor charts and thematic vector maps cannot be queried. The results of
240 the query will be displayed in the console window. See v.what.
241 Measure lengths
243 Interactive measurement of lengths defined with the mouse. The length
244 of each segment and the cumulative length of all segments measuered is
245 displayed in the console window. Lengths are measured in the current
246 measurement unit. See also d.measure.
247 Return to previous zoom
249 Resets the region to the region extents in effect prior to zooming in
250 or out, or panning.
251 Display active layers (saved region)
253 Opens a dialog to select a saved region setting. Resets the region to
254 the resolution and extents of the selected saved region, and displays
255 all active layers. See g.region.
256 Display active layers (default region)
258 Resets the region to the default resolution and extents, and displays
259 all active layers. See g.region -d.
260 Print map
262 Prints map on lpr printer or postscript device; saves visible map dis‐
263 play (including postscript text and labels) to PDF or EPS file.
264 Requires ghostscript for all output except EPS.
265 Export map display
267 Exports visible map display to different raster file formats. Exported
268 map does not include postscript text or postscript labels.
269 Strict draw mode
271 Selects strict draw mode. In strict mode the aspect ratio and resolu‐
272 tion from the last zoom are used when drawing the maps. The map will
273 show only the area and resolution selected. It will not usually fill
274 the screen. Strict mode only shows what is asked for.
275 Explore draw mode
277 Selects explore draw mode. In explore mode the region from the last
278 zoom is expanded to fill the entire screen. The resolution is adjusted
279 to match the screen resolution. Explore mode shows as much as possible.
280
282 Fonts used in gis.m can be changed as follows:
283 Source code: edit file 'lib/gtcltk/options.tcl' and com‐
285 pile gtcltk
286 Runtime: edit file '$GISBASE/etc/gtcltk/options.tcl'
288
290 d.m
291
293 Michael Barton, Arizona State University, Tempe, Arizona, USA
294 Last changed: $Date: 2006/11/20 22:49:34 $
296 Full index
298GRASS 6.2.2 gis.m(1)