28.05.2007 – 10:43 am

GIS Manager

GIS Manager has the same functionality, as in previous, Tcl/Tk-based GU.
In GIS Manager, you can start all GRASS modules (nearly 350 now days),
either from the menu on the top of the window, or using command line at
the bottom of the window. You can also manage the content of your
graphic displays, using the toolbar.

When you launched the wxGRASS interface, apart from the GIS Manager
window, first map display window appeared. Na rozdíl of
Tcl/Tk-based gis.m, no Output window appeared —
the output from GRASS modules is displayed in Command output
tab of the GIS Manager — you can switch it at it’s bottom.

Adding new layers to Map Display

New layer (raster, vector, RGB or HIS layer, command or map decoration)
can be added using appropriate button at the Tool bar of GIS

When you now click on the Add raster map layer button (second
button from left), you can choose between different types of raster

  • Raster map layer — single GRASS raster map
  • RGB layer — combination three GRASS raster maps, used
    in the red-green-blue color model.
  • HIS layer — combination of at least two GRASS raster
    maps, used in the hue-intensity-saturation color model.

Select Raster map layer and new form window will appear.
This type of window is used for every GRASS command, which is launched
from menu or via command line at the bottom of GIS Manager.

The module options (in this case d.rast) are organized
into various tabs, based on parameters type. In the d.rast
module, you have to select at least name of displayed raster file. You
can use pull-down menu or write name of the map directly. It is always
good to add name of the related mapset, e.g.
elevation.dem@PERMANENT. In other tabs, various display
options can be set (non-NULL values only, background color, …).


When you have set everything according to your needs, you can click on
the OK button and new item in the layer tree of GIS
is set. In GIS Manager, layer opacity
(transparency) can be tuned too.

Now, you have to click at the Redraw button of related Map
Display and new map will appear. You have always to click on this
button, in order to take effect of some change, you made in the GIS
Manager’s layer tree.

After that, you can add new vector layer, using appropriate button
on the GIS Manager’ tool bar. Display settings form
(d.vect module) is a bit more complicated, that it was
for raster layers, but the principle is the same.

After you finish the vector settings and click on the
Redraw button of the Map display, new layer will appear
upon the previous selected raster layer. You can see, that the order
of layers in layer tree is corresponding with the order of layers in
the map display — layer on the top of layer tree is covering other
layers under it.

Now you can just drag the layers with mouse to place the at the
right position in the display order. You can also add special
Folder layer and organize real map layers into trees.


Any setting can be later changed, if you double click on layer name
in GIS Manager window.

Speaking about the toolbar, here is a short list of buttons which
are available at the GIS Manager’s toolbar:

  • Start new display — Starts new map display and ads
    new display tab to GIS Manager.
  • Add raster map layer — Add new raster, RGB or HIS
    layer to Map Display’s layer tree.
  • Add vector map layer — Add new vector, thematic or
    chart layer do Map Display’s layer tree.
  • Add command layer — Add new command layer (e.g.
  • Add layer group — Add new folder layer for better
    organization of displayed maps.
  • Add grid or vector labels overlay — Add geographical
    grid or vector labels to Map Display.
  • Delete selected layer — Click at this, if you want to
    remove the layer from displayed layer tree — the map will of course
    remain at your hard disc.
  • Show attribute table — Show and manipulate attribute
    table of selected vector map.

Module forms

If you run some GRASS module from the command input at the bottom
of GIS Manager or you just select it from the menu, new wxGRASS
module form will appear.


Various options are organized in to tabs.
Last but one tab contains output from the module —
various messages reporting the approach of the calculation or resulting

Last tab contains complete GRASS Manual page of related module.
This is very useful, if you do not exactly know the meaning of some
parameters. New dialogs for selecting fonts or colors are introduced as

Map Displays

Old GRASS X-Driver architecture makes it possible to use only 7
GRASS monitors. WxGRASS enables you to have infinity
number of map displays. You can add new display by clicking at the
Start new display (first button) at the GIS Manager’s
toolbar. You can switch between displays using tabs in GIS Manager
or by selecting desired Map display by mouse.


Map Display is here to display map and for all interactive
operations, like profile definition or data querying. The order of
displayed maps is set in GIS Manager window.

Several buttons are available at each Map Display’s toolbar:

  • Display map — Displays map from layer tree in GIS
  • Re-render map — Redraws content of the map
  • Erase display — Erase display’s content
  • Pointer — Mouse pointer
  • Query — Mouse query of selected raster or vector map

  • Pan — Pan the map
  • Zoom in — Zoom in the map by selecting bounding box
  • Zoom out — Zoom out the map by selecting bounding box
  • Return to previous zoom — browse back in used zoom
  • Zoom options — Zoom to selected map, computed region,
    to pre-saved region, and other options
  • Analyze — Measure distance, define raster profile,
    compute map’s histogram.
  • Add overlay — Add scalebar, text or legend to map
  • Save display to PNG file — Saves current content of the
  • Print displays — Printing dialog pop ups: Setup the
    page, print preview and print the map.
  • Tools — Various other (digitizing,
    r.li, …) interactive tools or toolbars.

Not all tools are fully working yet. We will introduce some tools
more concretely in the future.

You can now try to zoom in, out or pan, you can also zoom to
selected map or return to previous zoom – in short – you can use
map display, how you would more or less expect.

For mouse query, you have to first click on desired layer tree in
GIS Manager. The query output is written into GIS Manager window,
in the Command output tab (look at the bottom of the

Share Button

Post a Comment