123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432 |
- <h2>DESCRIPTION</h2>
- The <b>GRASS GIS Manager</b>
- provides an interactive graphical interface to GRASS commands. By
- default, it is started automatically with each GRASS session. The GIS
- Manager can be quit by selecting the <em>'File->Exit</em><em>'</em>
- menu item. The GIS Manager can be restarted from the GRASS command line
- shell by typing "<i>gis.m</i>".<br>
- <br>
- The GIS Manager includes a set of pull-down menus for all GRASS GIS
- functions (analysis, file I/O, GIS configuration and management), two
- rows of buttons that manage display layers, an upper window in
- which layers to display are organized, and a lower
- window which contains options panels for layers in the layer tree.
- <br><br>
- <center>
- <img src="gm_gismgr.jpg" alt="GIS Manager window" height="551" width="480">
- </center>
- <br>
- <br>
- The top left button opens a new map display window. Each map display
- has a unique set of layers to display and region setting (zoom). Other
- buttons add layers of different types for display in the selected map
- display window. There are additional buttons for saving or opening
- group display file, starting XGANIM (display animator) display
- interfaces (requires motif), and digitizing.
- <i>Mouse-over help</i> is available for all buttons.
- <P>
- Map layers are listed in the window below the
- buttons. Layers can include raster and vector maps, text, map
- enhancements (scale and north arrow, and grids), and commands
- (where any GRASS command be written). Layers are displayed in as
- arranged in the layer tree: the bottom layer
- is displayed first and the top is displayed last, as if
- layers are a series of stacked overlays. Any layer can be
- renamed by double clicking on its name and typing a new name.
- <P>
- The check box to the left of each layer makes it active or inactive for
- display.
- Only active layers are displayed/redisplayed when the display button is
- pressed. Layers can be organized into groups; entire groups can be
- activated or deactivated for display. Groups can be saved to a file and
- opened in subsequent sessions, restoring all layers and their display
- options.
- <P>
- When a layer is selected with the mouse, its options are shown in the
- panel below the layer tree window. Help for each layer type can be
- accessed by pressing the GRASS button in the option panel.<br>
- <P>
- Each map display has a unique layer tree and region setting (zoom).
- Buttons on each map display manage the map in the display (zoom and
- pan), provide tools for query and distance measurement, and exporting
- or printing the display. The geographic coordinates under the cursor
- are displayed in the indicator window (lower right window frame). It is
- important to note that zooming in any display will have NO effect on
- the 'computational region' setting (set with g.region). Only by selecting
- the "Set current region to match display" item in the zoom menu (in the
- map display tool bar) will the current display extents be copied to
- the computational region extents.
- <br><br>
- <center>
- <img src="gm_mapdisp.jpg" alt="Map Display window" height="422" width="480">
- </center>
- <br><br>
- A separate console window shows all commands issued and all command
- output (upper window). GRASS commands (and any other unix/linux
- commands) can be run from the console (lower window).<br>
- <br>
- <center>
- <img src="gm_gronsole.png" alt="Output and command console window" height="231" width="480">
- </center>
- <br>
- <h2>GIS MANAGER BUTTON FUNCTIONS</h2>
- <img src="gm_gismgrtools.png" alt="GIS Manager Toolbar">
- <H3><u>Top Row</u></H3>
- <DL>
- <DT><img src="icons/grass/gui-startmon.gif"> Open new map display</DT>
- <DD>Opens a new map display and resets layer tree.</DD>
- <DT><img src="icons/grass/element-cell.gif"> Add raster layer</DT>
- <DD>Adds a raster map to the layer tree. Raster display options include:
- displaying a selected subset of raster cells, defined by their cat
- values; draping (or "fusing") a second map over the base map;
- and displaying legends for the base map and draped map.
- <i>See <a href="d.rast.html">d.rast</a> and <a href="d.his.html">d.his</a>
- (for draping/fusing).</i>
- </DD>
- <DT><img src="icons/grass/channel-rgb.gif"> Add RGB or HIS raster layer</DT>
- <DD>Combines and displays three raster maps defined as red, green, and blue
- channels; or combines and displays two or three raster maps defined as
- hue, intensity, and (optionally) saturation channels.
- <i>See <a href="d.rgb.html">d.rgb</a> and <a href="d.his.html">d.his</a>.</i>
- </DD>
- <DT><img src="icons/grass/module-d.histogram.gif"> Add histogram layer</DT>
- <DD>Adds a layer to display histogram of a raster map or image.
- <i>See <a href="d.histogram.html">d.histogram</a>.</i>
- </DD>
- <DT><img src="icons/grass/module-d.rast.num.gif"> Add cell values layer</DT>
- <DD>Adds map of raster cells with cell values printed inside.
- Only works when <10,000 cells are displayed.
- <i>See <a href="d.rast.num.html">d.rast.num</a>.</i>
- </DD>
- <DT><img src="icons/grass/module-d.rast.arrow.gif"> Add raster arrows layer</DT>
- <DD>Adds map of raster cells with directional arrows drawn.
- Arrow direction and length are determined by separate aspect/directional map
- and (optional) slope/intensity map.
- <i>See <a href="d.rast.arrow.html">d.rast.arrow</a>.</i>
- </DD>
- <DT><img src="icons/grass/module-d.legend.gif"> Add raster legend</DT>
- <DD>Adds a legend for a single raster map to the layer tree.
- Multiple options for formatting the legend are available.
- <i>See <a href="d.legend.html">d.legend</a>.</i>
- </DD>
- <DT><img src="icons/grass/element-vector.gif"> Add vector layer</DT>
- <DD>Adds a vector map to the layer tree. A large number of options are
- available for displaying the vector map, including: outline and fill
- color, icon type and size for points, line widths for all vector types,
- automatic labeling using an attribute column, querying cats or
- attributes to limit vectors displayed, and restricting vector display
- depending on region size.
- <i>See <a href="d.vect.html">d.vect</a>.</i>
- </DD>
- <DT><img src="icons/grass/module-d.vect.thematic.gif"> Add thematic map layer
- (for all vector types)</DT>
- <DD>Adds layer for thematic display values from a numeric attribute column
- associated with a vector map. Options include: thematic display type
- (graduated colors or point sizes), methods for creating display
- intervals, SQL query of attribute column to limit vector objects to
- display, control of point icon types and sizes, control of thematic
- color schemes, creation of legend for thematic map, and saving the
- results of thematic mapping to a ps.map instructions file for later
- printing.
- <i>See <a href="d.vect.thematic.html">d.vect.thematic</a>.</i>
- </DD>
- <DT><img src="icons/grass/module-d.vect.chart.gif"> Add thematic charts layer
- (for vector points)</DT>
- <DD>Adds layer in which pie or bar charts can be automatically created at
- vector point locations. Charts display values from selected columns in the
- associated attribute table. Options include: chart type, layer and
- attributes to chart, chart colors, and chart size (fixed or based on
- attribute column).
- <i>See <a href="d.vect.chart.html">d.vect.chart</a>.</i>
- </DD>
- <DT><img src="icons/grass/module-d.labels.gif"> Add raster labels layer for vector
- objects (from existing labels file)</DT>
- <DD>Add raster text layer from a labels file for vector objects created with
- the <em><a href="v.label.html">v.label</a></em> module (accessed from button
- in options panel). A labels file can also be created with a text editor.
- <i>See <a href="d.labels.html">d.labels</a>.</i>
- </DD>
- <DT><img src="icons/grass/module-d.text.gif"> Add text layer</DT>
- <DD>Adds layer to display a line of text using default GRASS font
- (selected with <em><a href="d.font.html">d.font</a></em>).
- Options include: text placement (screen coordinates); and text size,
- bolding, and color.
- <i>See <a href="d.text.html">d.text</a>.</i>
- </DD>
- <DT><img src="icons/grass/gui-maptext.gif"> Add PostScript labels layer for vector
- objects (from existing labels file)</DT>
- <DD>Add PostScript text layer from a labels file for vector objects created
- with the <em><a href="v.label.html">v.label</a></em> module (accessed from
- button in options panel). A labels file can also be created with a text editor.
- <i>See <a href="d.labels.html">d.labels</a>.</i>
- </DD>
- <DT><img src="icons/grass/gui-maplabels.gif"> Add PostScript text layer</DT>
- <DD>Adds layer to display a line of PostScript text. Options include: text
- placement by coordinates (geographic or screen); text
- alignment, font and line spacing; and text size, bolding, and color.
- </DL>
- <BR><BR>
- <H3><u>Bottom Row</u></H3>
- <DL>
- <DT><img src="icons/grass/module-d.barscale.gif"> Add scalebar and north arrow layer</DT>
- <DD>Adds layer to display a combined scalebar and north arrow. Options
- include scalebar placement (using screen coordinates or a mouse),
- scalebar format, and scalebar colors.
- <i>See <a href="d.barscale.html">d.barscale</a>.</i>
- </DD>
- <DT><img src="icons/grass/module-d.grid.gif"> Overlay grids and lines</DT>
- <DD>Adds layer to display regular grid (for all locations), or geodesic and
- rhumblines (for latitude/longitude locations only). Grid options
- include: grid and border colors, grid origin, and grid line spacing.
- Geodesic and rhumbline options include: line color, and xy coordinates
- (geographic) of line endpoints.
- <i>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>.</i>
- </DD>
- <DT><img src="icons/grass/gui-cmd.gif"> Add command layer</DT>
- <DD>Adds a layer in which a GRASS GIS command or command list can be entered.
- For a command list use the pipe symbol as "|" as separator.
- For example:
- <div class="code"><pre>
- d.rast soils | d.rast -o roads | d.vect streams col=blue
- </pre></div>
- Note that when an option of the command contains spaces, you need to
- escape them with the backslash ('\') character, for example:<BR>
- <tt>d.text text=Population\ density</tt>
- </DD>
- <DT><img src="icons/grass/gui-group.gif"> Add group</DT>
- <DD>Adds an empty layer group. Layers can then be added to the group.</DD>
- <DT><img src="icons/grass/edit-copy.gif"> Duplicate selected layer or group</DT>
- <DD>Adds a new layer that duplicates the selected layer.</DD>
- <DT><img src="icons/grass/edit-cut.gif"> Cut selected layer or group</DT>
- <DD>Deletes the selected group or layer.</DD>
- <DT><img src="icons/grass/file-new.gif"> Erase all layers and create a new group</DT>
- <DD>Removes all layers in the layer tree and creates a new, empty group to
- which new layers can be added.<br></DD>
- <DT><img src="icons/grass/file-open.gif"> Open an existing group file</DT>
- <DD>Opens an previously saved group file, containing a set of display
- layers and their option settings.</DD>
- <DT><img src="icons/grass/file-save.gif"> Save layers to group file</DT>
- <DD>Saves current set of layers and their options to a group file.</DD>
- <DT><img src="icons/grass/module-xganim.gif"> Animate raster map series</DT>
- <DD>Starts the interactive Animation Tool interface to display a series
- of raster maps as an animation.
- <i>See the <a href="gm_animate.html">Animation Tool help page</a></i>.
- </DD>
- <DT><img src="icons/grass/module-v.digit.gif"> Digitize raster or vector maps</DT>
- <DD>Starts the raster digitizing or vector digitizing module, depending on
- whether a raster or vector map is selected. Raster digitizing always
- creates a new map. Vector digitizing will either edit an existing map
- (if an existing vector map is selected in the layer tree) or create a
- new vector map (if the name of the new vector to be created is entered
- in the 'vector name' field of the options panel for a vector map
- layer).
- <i>See <a href="r.digit.html">r.digit</a> and <a href="v.digit.html">v.digit</a></i>.
- </DD>
- </DL>
- <BR><BR>
- <h2>MAP DISPLAY BUTTON FUNCTIONS</h2>
- <img src="gm_mapdisptools.png" alt="Map display toolbar">
- <DL>
- <DT><img src="icons/grass/gui-display.gif"> Display active layers (current region)</DT>
- <DD>Displays all active layers at current resolution and region extents for
- that map display window.</DD>
- <DT><img src="icons/grass/gui-zoom_current.gif"> Re-render and display all active
- layers and zoom to current region</DT>
- <DD>Resets the region to the resolution and extents to the values set with
- <em>g.region</em>; forces re-display and re-rendering all active layers.
- <i>See <a href="g.region.html">g.region</a>.</i></DD>
- <DT><img src="icons/grass/module-nviz.gif"> NVIZ</DT>
- <DD>Starts NVIZ, the <i>n</i>-dimensional visualization module and interactive
- graphical interface. All active raster and vector layers in the layer
- tree will be displayed in NVIZ.
- <i>See the <a href="nviz.html">nviz</a> manual.</i></DD>
- <DT><img src="icons/grass/module-d.nviz.gif"> Create fly through path for NVIZ</DT>
- <DD>Starts a GRASS module for interactive creation of a fly-through path to
- be animated in NVIZ.
- <i>See <a href="d.nviz.html">d.nviz</a></i>.</DD>
- <DT><img src="icons/grass/gui-erase.gif"> Erase to white</DT>
- <DD>Erases the currently selected monitor to a white background; also
- removes all frames.
- <i>See <a href="d.erase.html">d.erase</a> and
- <a href="d.frame.html">d.frame -e</a>.</i></DD>
- <DT><img src="icons/grass/gui-pointer.gif"> Arrow cursor</DT>
- <DD>Select arrow cursor for map display.</DD>
- <DT><img src="icons/grass/gui-zoom_in.gif"> Zoom in</DT>
- <DD>Interactive zooming with the mouse in the active display monitor.
- Drawing a box with the mouse (left button) and zoom-in cursor causes
- the display to zoom in so that the area defined by the box fills the
- display. The map resolution is not changed. Clicking with the zoom-in
- cursor causes the display to zoom in by 30%, centered on the point
- where the mouse is clicked. Zooming resets the display region extents
- (both size and location of area displayed). It does NOT affect the
- computational region for other GIS processes.
- <i>See <a href="g.region.html">g.region</a>.</i></DD>
- <DT><img src="icons/grass/gui-zoom_out.gif"> Zoom out</DT>
- <DD>Interactive zooming with the mouse in the active display monitor.
- Drawing a box with the mouse (left button) and zoom-out cursor causes
- the display to zoom in so that the area displayed shrinks to fill the
- area defined by the box. The map resolution is not changed. Clicking
- with the zoom-out cursor causes the display to zoom out by 30%, centered
- on the point where the mouse is clicked. Zooming resets the display
- region extents (both size and location of area displayed). It does NOT
- affect the computational region for other GIS processes.
- <i>See <a href="g.region.html">g.region</a>.</i></DD>
- <DT><img src="icons/grass/gui-pan.gif"> Pan</DT>
- <DD>Interactive selection of a new center of view in the active display
- monitor. Drag the pan cursor while pressing the left mouse button to pan.
- Panning changes the location of the region displayed but not the size of
- the area displayed or the resolution. Panning does NOT affect the
- computational region for other GIS processes.
- <i>See <a href="g.region.html">g.region</a>.</i></DD>
- <DT><img src="icons/grass/gui-zoom_back.gif"> Revert zoom</DT>
- <DD>Returns to the previous zoom. Up to 5 levels of zoom back are maintained.
- <i>See <a href="g.region.html">g.region</a>.</i></DD>
- <DT><img src="icons/grass/gui-mapzoom.gif"> Zoom menu</DT>
- <DD>Automatic zoom settings menu. Zoom to match the extents of a selected
- map or to match the extents of a saved region; save the current extents
- to a named region file; zoom to match the computational region (set with
- <em>g.region</em>) or to match the default region; set computational region
- (the mapset's <tt>WIND</tt> file) to match the current display extents
- (does not change the resolution).
- <i>See <a href="g.region.html">g.region</a>.</i></DD>
- <DT><img src="icons/grass/gui-query.gif"> Query tool (select a map first)</DT>
- <DD>Query selected raster (only the base map of a draped map will be
- queried), RGB raster map (all three map channels will be queried), or
- vector map using the mouse. A map must be selected before query.
- Vector charts and thematic vector maps cannot be queried. The
- results of the query will be displayed in the console window.
- <i>See <a href="r.what.html">r.what</a> and <a href="v.what.html">v.what</a></i>.
- </DD>
- <DT><img src="icons/grass/gui-measure.gif"> Distance measurement tool</DT>
- <DD>Interactive measurement of lengths defined with the mouse. The length
- of each segment and the cumulative length of all segments measuered is
- displayed in the console window. Lengths are measured in the current
- measurement unit.
- <i>See also <a href="d.measure.html">d.measure</a>.</i></DD>
- <DT><img src="icons/grass/gui-profile.gif"> Profile tool</DT>
- <DD>Interactively create profile of a raster map. Profile transect
- is drawn with the mouse in map display. The profile may be of the
- displayed map or a different map.<i>
- See the <a href="gm_profile.html">Profile Tool help page</a>.</i></DD>
- <DT><img src="icons/grass/file-print.gif"> Print map</DT>
- <DD>Prints map on the UNIX <i>lpr</i> printer or PostScript device;
- saves visible map display (including PostScript text and labels) to PDF
- or EPS file. Requires <tt>ghostscript</tt> for all output except EPS.</DD>
- <DT><img src="icons/grass/file-save.gif"> Export map display</DT>
- <DD>Exports visible map display to different raster graphic formats.
- Exported map does not include PostScript text or PostScript labels.</DD>
- <DT><img src="icons/grass/drawmode-strict.gif"> Strict draw mode</DT>
- <DD>Selects strict draw mode. In strict mode the aspect ratio and resolution
- from the last zoom are used when drawing the maps. The map will show only
- the area and resolution selected. It will not usually fill the screen.
- Strict mode only shows what is asked for.</DD>
- <DT><img src="icons/grass/drawmode-explore.gif"> Explore draw mode</DT>
- <DD>Selects explore draw mode. In explore mode the region from the last zoom
- is expanded to fill the entire screen. The resolution is adjusted to match
- the screen resolution. Explore mode shows as much as possible.</DD>
- </DL>
- <h2>CONFIGURATION</h2>
- <h3>Changing fonts</h3>
- Fonts used in <em>gis.m</em> can be changed as follows:
- <ul>
- <li>Runtime: edit file '<tt>$GISBASE/etc/gtcltk/options.tcl</tt>'</li>
- <li>Source code: edit file '<tt>lib/gtcltk/options.tcl</tt>' and recompile gtcltk</li>
- </ul>
- <h2>SEE ALSO</h2>
- The <em>gis.m</em> <a href="gm_animate.html">ANIMATION TOOL</a><br>
- The <em>gis.m</em> <a href="gm_georect.html">GEORECTIFY TOOL</a><br>
- The <em>gis.m</em> <a href="gm_profile.html">PROFILE TOOL</a><br>
- <P>
- <em><a href="g.gui.html">g.gui</a></em>: Starts the default GUI<BR>
- <a href="d.m.html"><em>d.m</em> GUI</a>: The old display manager GUI<BR>
- <a href="wxGUI.html">wxPython GUI</a>:
- The next generation GUI, currently under development<BR>
- <h2>AUTHORS</h2>
- Michael Barton, Arizona State University, Tempe, Arizona, USA<br>
- Cedric Shock, USA
- <p>
- <i>Last changed: $Date$</i>
|