.TH gis.m 1grass "" "GRASS 6.4.2" "Grass User's Manual"
.SH NAME
\fI\fBgis.m\fR\fR  - GIS manager for GRASS
.SH KEYWORDS
.SH SYNOPSIS
\fBgis.m\fR
.br
\fBgis.m help\fR
.br
\fBgis.m\fR  [\fBdmrc\fR=\fIstring\fR]   [--\fBverbose\fR]  [--\fBquiet\fR] 
.SS Parameters:
.IP "\fBdmrc\fR=\fIstring\fR" 4m
.br
Name of GIS manager settings file (.grc)
.PP
.SH DESCRIPTION
The \fBGRASS GIS Manager\fR
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 \fI'File->Exit '\fR
menu item. The GIS Manager can be restarted from the GRASS command line
shell by typing "\fIgis.m\fR".
.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
.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.
\fIMouse-over help\fR is available for all buttons.
.PP
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.
.PP
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.
.PP
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
.PP
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
A separate console window shows all commands issued and all command
output (upper window). GRASS commands (and any other UNIX/Linux/DOS
commands) can be entered into and run from the console (lower window).
If any of the arguments contain a space then the entire option must
be quoted in Tcl/Tk style, e.g.:
\fC
.DS
.br
 v.db.select roads "where=label ~ 'highway'"
.br
  or
.br
 v.db.select roads {where=label ~ 'highway'}
.br
  or
.br
 v.db.select roads where=label\(rs ~\(rs 'highway'
.br
.DE
\fR
.br
.br
.br
.SH GIS MANAGER BUTTON FUNCTIONS
.SS Top Row
.IP "
.br
Opens a new map display and resets layer tree.
.IP "
.br
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.
\fISee d.his
(for draping/fusing).\fR
.IP "
.br
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.
\fISee d.his.\fR
.IP "
.br
Adds a layer to display histogram of a raster map or image.
\fISee d.histogram.\fR
.IP "
.br
Adds map of raster cells with cell values printed inside.
Only works when <10,000 cells are displayed.
\fISee d.rast.num.\fR
.IP "
.br
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.
\fISee d.rast.arrow.\fR
.IP "
.br
Adds a legend for a single raster map to the layer tree.
Multiple options for formatting the legend are available.
\fISee d.legend.\fR
.IP "
.br
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.
\fISee d.vect.\fR
.IP " Add thematic map layer
(for all vector types)" 4m
.br
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.
\fISee d.vect.thematic.\fR
.IP " Add thematic charts layer
(for vector points)" 4m
.br
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).
\fISee d.vect.chart.\fR
.IP " Add raster labels layer for vector
objects (from existing labels file)" 4m
.br
Add raster text layer from a labels file for vector objects created with
the \fIv.label\fR module (accessed from button
in options panel). A labels file can also be created with a text editor.
\fISee d.labels.\fR
.IP "
.br
Adds layer to display a line of text using default GRASS font
(selected with \fId.font\fR).
Options include: text placement (screen coordinates); and text size,
bolding, and color.
\fISee d.text.\fR
.IP " Add PostScript labels layer for vector
objects (from existing labels file)" 4m
.br
Add PostScript text layer from a labels file for vector objects created
with the \fIv.label\fR module (accessed from
button in options panel). A labels file can also be created with a text editor.
\fISee d.labels.\fR
.IP "
.br
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.
.PP
.br
.SS Bottom Row
.IP "
.br
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.
\fISee d.barscale.\fR
.IP "
.br
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.
\fISee d.geodesic,
and d.rhumbline.\fR
.IP "
.br
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:
\fC
.DS
.br
  d.rast soils | d.rast -o roads | d.vect streams col=blue
.br
.DE
\fR
Note that when an option of the command contains spaces, you need to
escape them with the backslash ('\(rs') character, for example:
.br
d.text.freetype text=Population\(rs density
.IP "
.br
Adds an empty layer group. Layers can then be added to the group.
.IP "
.br
Adds a new layer that duplicates the selected layer.
.IP "
.br
Deletes the selected group or layer.
.IP "
.br
Removes all layers in the layer tree and creates a new, empty group to
which new layers can be added.
.br
.IP "
.br
Opens an previously saved group file, containing a set of display
layers and their option settings.
.IP "
.br
Saves current set of layers and their options to a group file.
.IP "
.br
Starts the interactive Animation Tool interface to display a series
of raster maps as an animation.
\fISee the Animation Tool help page\fR.
.IP "
.br
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).
\fISee v.digit\fR.
.PP
.br
.SH MAP DISPLAY BUTTON FUNCTIONS
.IP "
.br
Displays all active layers at current resolution and region extents for
that map display window.
.IP " Re-render and display all active
layers and zoom to current region" 4m
.br
Resets the region to the resolution and extents to the values set with
\fIg.region\fR; forces re-display and re-rendering all active layers.
\fISee g.region.\fR
.IP "
.br
Starts NVIZ, the \fIn\fR-dimensional visualization module and interactive
graphical interface. All active raster and vector layers in the layer
tree will be displayed in NVIZ.
\fISee the nviz manual.\fR
.IP "
.br
Starts a GRASS module for interactive creation of a fly-through path to
be animated in NVIZ.
\fISee d.nviz\fR.
.IP "
.br
Erases the currently selected monitor to a white background; also
removes all frames.
\fISee d.erase and
d.frame -e.\fR
.IP "
.br
Select arrow cursor for map display.
.IP "
.br
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.
\fISee g.region.\fR
.IP "
.br
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.
\fISee g.region.\fR
.IP "
.br
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.
\fISee g.region.\fR
.IP "
.br
Returns to the previous zoom. Up to 5 levels of zoom back are maintained.
\fISee g.region.\fR
.IP "
.br
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
\fIg.region\fR) or to match the default region; set computational region
(the mapset's WIND file) to match the current display extents
(does not change the resolution).
\fISee g.region.\fR
.IP "
.br
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.
\fISee v.what\fR.
.IP "
.br
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.
\fISee also d.measure.\fR
.IP "
.br
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.\fI
See the Profile Tool help page.\fR
.IP "
.br
Prints map on the UNIX \fIlpr\fR printer or PostScript device;
saves visible map display (including PostScript text and labels) to PDF
or EPS file. Requires ghostscript for all output except EPS.
.IP "
.br
Exports visible map display to different raster graphic formats.
Exported map does not include PostScript text or PostScript labels.
.IP "
.br
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.
.IP "
.br
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.
.PP
.SH CONFIGURATION
.SS Changing fonts
Fonts used in \fIgis.m\fR can be changed as follows:
.RS
.IP
Runtime: edit file '$GISBASE/etc/gtcltk/options.tcl'
.IP
Source code: edit file 'lib/gtcltk/options.tcl' and recompile gtcltk
.RE
.SH SEE ALSO
The \fIgis.m\fR ANIMATION TOOL
.br
The \fIgis.m\fR GEORECTIFY TOOL
.br
The \fIgis.m\fR PROFILE TOOL
.br
.PP
\fIg.gui\fR: Starts the default GUI
.br
\fId.m\fR GUI: The old display manager GUI
.br
wxPython GUI:
The next generation GUI, currently under development
.br
.SH AUTHORS
Michael Barton, Arizona State University, Tempe, Arizona, USA
.br
Cedric Shock, USA
.PP
\fILast changed: $Date: 2011-04-18 12:10:50 +0200 (Mon, 18 Apr 2011) $\fR
.PP
Full index
.PP
© 2003-2011 GRASS Development Team
