[GRASS-SVN] r39259 -
grass/branches/releasebranch_6_4/gui/wxpython/docs
svn_grass at osgeo.org
svn_grass at osgeo.org
Sat Sep 19 20:01:01 EDT 2009
Author: cmbarton
Date: 2009-09-19 20:01:00 -0400 (Sat, 19 Sep 2009)
New Revision: 39259
Modified:
grass/branches/releasebranch_6_4/gui/wxpython/docs/wxGUI.html
Log:
Updated docs for wxPython GUI. Backported from develbranch_6 r39243
Modified: grass/branches/releasebranch_6_4/gui/wxpython/docs/wxGUI.html
===================================================================
--- grass/branches/releasebranch_6_4/gui/wxpython/docs/wxGUI.html 2009-09-19 23:45:22 UTC (rev 39258)
+++ grass/branches/releasebranch_6_4/gui/wxpython/docs/wxGUI.html 2009-09-20 00:01:00 UTC (rev 39259)
@@ -8,7 +8,7 @@
<tt>wxpython</tt> switch
<div class="code"><pre>
- grass -wxpython
+ g.gui -u wxpython&
</pre></div>
or define in your <tt>.grassrc6</tt> file 'GRASS_GUI' variable
@@ -22,7 +22,7 @@
typing
<div class="code"><pre>
- g.gui wxpython
+ g.gui wxpython&
</pre></div>
or
@@ -37,24 +37,26 @@
The GUI is composed by <em>two</em> main components:
<ul>
- <li><b>Layer Manager</b> which allows users to run different GRASS
- modules from menu, includes map layer management, integrated
+ <li>The <b>Layer Manager</b> includes map layer management, integrated
command-line prompt, and command output window tab.</li>
- <li><b>Map Display Window</b> which integrates basic tools for
- zooming, panning, data querying, decorations (north arrows,
- barscale, etc.). The user is allowed to start various map display
- instances during one session. The Layer Manager registers Map
- Display Windows using different tabs.</li>
+ <li>The <b>Map Display Window</b> integrates basic tools for
+ zooming, panning, data querying, and map elements (north arrows,
+ barscale, etc.). Each display window is associated with its own
+ set of map layers in the layer manager. The user may start multiple map
+ displays during a session. The map layers for each display are grouped
+ under different tabs in the Layer Manager.</li>
</ul>
<h3>Layer Manager</h3>
-The <em>Layer Manager</em> provides an interactive graphical interface to GRASS
-commands. It includes a set of pull-down menus for all GRASS GIS
-functions (analysis, file I/O, GIS configuration and management), the
-toolbar to manage display map layers, a layer tree frame in which map layers
-to display are organized, command output window tab, and interactive
-command line prompt.
+The <em>Layer Manager</em> provides an interactive graphical interface for
+creating and managing GRASS displays. There is a toolbar to manage displayed
+map layers, a layer tree frame in which map layers for display are organized,
+a command output window tab, and interactive command line prompt. On Linux
+and Windows platforms, the layer manager also has a menu bar with a set of
+pull-down menus for all GRASS GIS functions (analysis, file I/O, GIS
+configuration and management); on a Mac, the GRASS functions menu is at the
+top of the screen.
<center>
<br><img src="wxGUI_layer_manager.jpg" border="1"><br><br>
@@ -68,11 +70,10 @@
<p>
Map layers are listed in the window frame below the toolbar. Layers can
-include raster and vector maps, text, map decorations (scale and
-north arrow, and grids), and commands (where any GRASS command can 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.
+include raster and vector maps, vector labels, and commands (where any
+GRASS command can be written). Layers are displayed as arranged in the layer
+tree: the bottom layer is displayed first and the top layer is displayed
+last, as if the layers were a series of stacked overlays.
<p>
The check box to the left of each layer makes it active or inactive
@@ -82,6 +83,18 @@
composition can be saved to a workspace file and opened in subsequent
sessions, restoring all layers and their display options.
+<p>
+A right mouse click on a layer or left clicking the button to the right of
+the layer opens a dropdown menu with options to remove or rename the layer
+(g.remove, g.rename), change its display properties (d.rast and d.vect
+options such as color, symbol, etc.), show its metadata (r.info, v.info) or
+attributes, if applicable.
+
+<p>
+A left mouse double click on a layer opens GUI for its display options
+These options are those for the d.* command for each layer type (d.rast,
+d.vect, or d.grid, for example).
+
<h4>Layer Manager Toolbar</h4>
<dl>
@@ -92,8 +105,7 @@
<dd>Opens a new map display and creates empty layer tree tab in Layer Manager.</dd>
<dt><img src="icons/grass2/create.png">
- <img src="icons/grass/file-new.gif">
- <img src="icons/silk/page_white.png"> <em>Creates new workspace file</em></dt>
+<em>Create new workspace file</em></dt>
<dd>Removes all layers in the layer tree and creates a new, empty tree
where new layers can be added.</dd>
@@ -121,17 +133,35 @@
<dd>Adds raster map to layer tree, see <em><a href="d.rast.html">d.rast</a></em>. Includes also shaded relief map, RGB or HIS map or raster flow arrows map.</dd>
<dt><img src="icons/grass2/layer-shaded-relief-add.png">
- <img src="icons/grass/module-d.shadedmap.gif">
- <img src="icons/silk/picture_empty.png"> <em>Add shaded relief map layer</em></dt>
-<dd>Adds shaded relief raster map layer,
-see <em><a href="d.shadedmap.html">d.shadedmap</a></em>.</dd>
+<em>Add various raster-based map layers</em></dt>
+<dd>Opens a dropdown menu that allows user to select to:<br>
+ <ul>
+ <li><dt><img src="icons/grass2/layer-shaded-relief-add.png">
+ <em>Add shaded relief raster map layer </em></dt>
+ <dd>Adds shaded relief raster map layer,
+ see <em><a href="d.shadedmap.html">d.shadedmap</a></em></li>
+ <li><dt><img src="icons/grass2/layer-rgb-add.png">
+ <em>Add RGB raster layer</em></dt>
+ <dd>Combines and displays three raster maps defined as red, green,
+ and blue channels to create an RGB color map,
+ see <em><a href="d.rgb.html">d.rgb</a></em>.</dd></li>
+ <li><dt><img src="icons/grass2/layer-his-add.png">
+ <em>Add HIS raster layer</em></dt>
+ <dd>Combines and displays two or three raster maps defined as hue,
+ intensity, and (optionally) saturation channels to create a color map,
+ see <em><a href="d.his.html">d.his</a></em>.</dd></li>
+ <li><dt><img src="icons/grass2/layer-cell-cats-add.png">
+ <em>Add raster arrows layer</em></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,
+ see <em><a href="d.rast.arrow.html">d.rast.arrow</a></em>.</dd></li>
+ <li><dt><img src="icons/grass2/layer-cell-cats-add.png">
+ <em>Add raster numbers layer</em></dt>
+ <dd>Adds map of raster cells with numbers representing the cell values,
+ see <em><a href="d.rast.num.html">d.rast.num</a></em>.</dd></li>
+ </ul>
-<dt><img src="icons/grass2/layer-rgb-add.png">
- <img src="icons/grass/channel-rgb.gif">
- <img src="icons/silk/rgb.png"> <em>Add RGB raster layer</em></dt>
-<dd>Combines and displays three raster maps defined as red, green, and blue
-channels, see <em><a href="d.rgb.html">d.rgb</a></em>.</dd>
-
<dt><img src="icons/grass2/layer-his-add.png">
<img src="icons/grass/channel-his.gif">
<img src="icons/silk/his.png"> <em>Add HIS raster layer</em></dt>
@@ -153,18 +183,8 @@
<dd>Adds a vector map layer, see <em><a href="d.vect.html">d.vect</a></em>. Includes also thematic vector map or thematic charts layer.</dd>
<dt><img src="icons/grass2/layer-vector-thematic-add.png">
- <img src="icons/grass/module-d.vect.thematic.gif">
- <img src="icons/silk/thematic.png"> <em>Add thematic map layer
- (for all vector types)</em></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,
-see <em><a href="d.vect.thematic.html">d.vect.thematic</a></em>.</dd>
+<em>Add various vector-based map layers </em></dt>
+<dd>Opens a dropdown menu that allows user to select to:<br>
<dt><img src="icons/grass2/layer-vector-chart-add.png">
<img src="icons/grass/module-d.vect.chart.gif">
@@ -201,10 +221,8 @@
<dd>Adds an empty layer group. Layers can then be added to the group.</dd>
<dt><img src="icons/grass2/layer-grid-add.png">
- <img src="icons/grass/module-d.grid.gif">
- <img src="icons/silk/images.png"> <em>Add overlay grids and lines</em></dt>
-<dd>Adds layer to display regular grid (for all locations), or geodesic and
-rhumblines (for latitude/longitude locations only), see <em><a href="d.grid.html">d.grid</a>, <a href="d.geodesic.html">d.geodesic</a>, <a href="d.rhumbline.html">d.rhumbline</a></em>.</dd>
+ <em>Add grid or vector labels overlay</em></dt>
+<dd>Opens a dropdown menu that allows user to select to:<br>
<dt><img src="icons/grass2/layer-label-add.png">
<img src="icons/grass/module-d.labels.gif">
@@ -216,6 +234,24 @@
created with a text editor,
see <em><a href="d.labels.html">d.labels</a></em>.</dd>
+ <li><dt><img src="icons/grass2/layer-label-add.png">
+ <em>Add labels layer for vector objects (from existing labels file)</em></dt>
+ <dd>Add a layer of text from a labels file for vector objects
+ created with the <em><a href="v.label.html">v.label</a></em> module.
+ A labels file can also be created with a text editor,
+ see <em><a href="d.labels.html">d.labels</a></em>.</dd></li>
+
+ <li><dt><img src="icons/grass/module-d.geodesic.gif">
+ <em>Add geodesic line layer</em></dt>
+ <dd>Add layer to display geodesic line for latitude/longitude locations only,
+ see <em><a href="d.geodesic.html">d.geodesic</a></em></dd></li>
+
+ <li><dt><img src="icons/grass/module-d.geodesic.gif">
+ <em>Add rhumbline layer</em>
+ <dd>Add layer to display rhumblines (for latitude/longitude locations only),
+ see <em><a href="d.rhumbline.html">d.rhumbline</a></em>.</dd></li>
+ </ul>
+
<dt><img src="icons/grass2/layer-remove.png">
<img src="icons/grass/edit-cut.gif">
<img src="icons/silk/bin_closed.png"> <em>Remove map layer from layer tree</em></dt>
@@ -230,23 +266,30 @@
<h3>Map Display Window</h3>
-This component includes toolbar area (set of toolbars), map canvas
-where a map composition is displayed, and the statusbar.
+The map display window includes toolbar that can be docked and undocked from
+the window, a map canvas where a map composition of one or more layers is
+displayed, and a statusbar with information about the geographic region of
+the maps displayed.
<center>
<br><img src="wxGUI_map_display.jpg" alt="Map Display Window"/><br><br>
</center>
-Each Map Display Window has a unique layer tree and region
-setting. The window contains a toolbar with buttons to manage the map
-in the display (zoom and pan), providing tools for query and distance
-measurement, and exporting or printing the display.
+Each Map Display Window has a unique layer tree (in the layer manager)
+and geographic <em>region</em> setting. At the top of the window is a
+toolbar with buttons to manage the map in the display (render, erase, zoom
+and pan), for query and and analysis (distance measurement, profile,
+and histogram creation), to overlay map elements onto the display (scale,
+north arrow, legend, and custom text), and to export or print the display.
<p>
-In the statusbar can be displayed the geographic coordinates under the
-cursor, current geographical region extent, computational region
-(including graphical visualization in map display), map display
-geometry (number of rows, columns, resolution) and map scale.
+In the statusbar, the user can choose to display the geographic coordinates
+under the cursor, current geographical region extent, computational region
+(including graphical visualization in map display), map display geometry
+(number of rows, columns, resolution) and map scale. Checking the
+<em>render</em> button in the statusbar will cause the map display to update
+automatically any time a map is added to, removed from, or changed in its
+layer tree.
<p>
It is important to note that zooming in any display will
@@ -263,21 +306,19 @@
<dt><img src="icons/grass2/show.png">
<img src="icons/grass/gui-display.gif">
<img src="icons/silk/map_go.png"> <em>Display active layers (current region)</em></dt>
-<dd>Displays all active layers from layer tree at current resolution
-and region extents for that map display window.</dd>
+<dd>Displays all active layers from layer tree and re-renders for display
+any layers that have changed since the last time the display was updated,
+including layers added or removed.</dd>
<dt><img src="icons/grass2/layer-redraw.png">
- <img src="icons/grass/gui-redraw.gif">
- <img src="icons/silk/arrow_refresh.png"> <em>Re-render and display all active
-layers and zoom to current region</em></dt>
-<dd>Resets the region to the display resolution and extents and forces
-re-display and re-rendering all active layers.</dd>
+ <em>Re-render map</em></dt>
+<dd>Re-renders all active layers regardless of whether they have changed
+or not.</dd>
<dt><img src="icons/grass2/erase.png">
<img src="icons/grass/gui-erase.gif">
<img src="icons/silk/cross.png"> <em>Erase display content</em></dt>
-<dd>Erases the currently selected map display to a white background;
-also removes all frames,
+<dd>Erases the currently selected map display to a white background.
see <em><a href="d.erase.html">d.erase</a>, <a href="d.frame.html">d.frame
-e</a></em>.</dd>
@@ -287,14 +328,19 @@
<dd>Select arrow cursor for map display.</dd>
<dt><img src="icons/grass2/info.png">
- <img src="icons/grass/gui-query.gif">
- <img src="icons/silk/information.png"> <em>Query tool (select a map first)</em></dt>
-<dd>Query selected raster, RGB raster (all three map channels will be
+
+ <em>Query raster/vector maps</em></dt>
+<dd>Opens a dropdown menu that allows user to select to:<br>
+ <ul>
+ <li><dd>Query selected raster, RGB raster (all three map channels will be
queried), or vector map(s) using the mouse. Map(s) 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,
-see <em><a href="r.what.html">r.what</a>, <a href="v.what.html">v.what</a></em>.</dd>
+queried. The results of the query will be displayed in the console window,
+see <em><a href="r.what.html">r.what</a>, <a href="v.what.html">v.what</a></em>.</dd></li>
+ <li><dd>Query selected vector map in edit mode. The results of the query
+ will be displayed in a form that permits editing of the queried vector
+ attributes.</dd></li>
+ </ul>
<dt><img src="icons/grass2/pan.png">
<img src="icons/grass/gui-pan.gif">
@@ -340,21 +386,22 @@
maintained, see <em><a href="g.region.html">g.region</a></em>.</dd>
<dt><img src="icons/grass2/zoom-more.png">
- <img src="icons/grass/gui-mapzoom.gif">
- <img src="icons/silk/zoom.png"> <em>Zoom menu</em></dt>
-<dd>Automatic zoom settings menu. Zoom to match the extents of a selected
-map, zoom to match the computational region (set with
-<em>g.region</em>), zoom to match the extents of a saved region or
-save the current extents to a named region file, or to set
-computational region (the mapset's <tt>WIND</tt> file) to match the
-current display extents (does not change the resolution).
-See <em><a href="g.region.html">g.region</a></em>.</dd>
+ <em>Zoom options</em></dt>
+<dd>Opens a dropdown menu that allows user to:<br>
+ <ul>
+ <li>Zoom to match the extents of a selected map</li>
+ <li>Zoom to match the computational region (set with <em>g.region</em>)</li>
+ <li>Zoom to match the extents of the default region</li>
+ <li>Zoom to match the extents of a saved region</li>
+ <li>Set computational region (the mapset's <tt>WIND</tt> file) to match the
+ current display extents (does not change the resolution),
+ see <em><a href="g.region.html">g.region</a></em>.</dd>
+ <li>Save display geometry (current extents) to a named region file</li>
+ </ul>
<dt><img src="icons/grass2/layer-raster-analyze.png">
- <img src="icons/grass/gui-rastanalyze.gif">
- <img src="icons/silk/application_lightning.png"> <em>Analyze menu</em></dt>
-<dd>Contains functions for distance measurement, creating histogram or
-profile tool.</dd>
+ <em>Analyze menu</em></dt>
+<dd>Opens a dropdown menu with:<br>
<dt><img src="icons/grass2/measure-length.png">
<img src="icons/grass/gui-measure.gif">
@@ -364,23 +411,21 @@
measuered is displayed in the command output window frame. Lengths are
measured in the current measurement unit,
see <em><a href="d.measure.html">d.measure</a></em>.</dd>
+ <li><dt><img src="icons/grass2/layer-raster-profile.png">
+ <em>Profile tool</em></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. Up to three maps can be profiled
+ simultaneously,
+ see <em><a href="gm_profile.html">Profile Tool help page</a></em>.</dd></li>
-<dt><img src="icons/grass2/layer-raster-profile.png">
- <img src="icons/grass/gui-profile.gif">
- <img src="icons/silk/wand.png"> <em>Profile tool</em></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,
-see <em><a href="gm_profile.html">Profile Tool help
-page</a></em>.</dd>
-
<dt><img src="icons/grass2/layer-raster-histogram.png">
<img src="icons/silk/chart_bar.png">
<img src="icons/grass/module-d.histogram.gif"> Display histogram of selected raster map</dt>
<dd>Displays histogram of selected raster map or image in new window,
see <em><a href="d.histogram.html">d.histogram</a></em>.</dd>
-<dt><img src="icons/grass2/element-add.png">
+<dt><img src="icons/grass2/overlay-add.png">
<img src="icons/silk/overlays.png">
<img src="icons/grass/gui-rastanalyze.gif"> Add overlay</dt>
<dd>Adds overlay to map display like barscale, north arrow, text.</dd>
@@ -408,17 +453,37 @@
and color, see <em><a href="d.text.html">d.text</a></em>.</dd>
<dt><img src="icons/grass2/map-export.png">
- <img src="icons/grass/file-save.gif">
- <img src="icons/silk/picture_save.png"> <em>Export map display</em></dt>
-<dd>Exports visible map display to different raster graphic formats.</dd>
+ <em>Save display to graphic file</em></dt>
+<dd>Save the visible image in map display to different raster graphic formats.</dd>
<dt><img src="icons/grass2/print.png">
<img src="icons/grass/file-print.gif">
<img src="icons/silk/printer.png"> <em>Print map</em></dt>
-<dd>Prints map on the UNIX <i>lpr</i> printer or PostScript device;
+<dd>Prints map on system native 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>
+or EPS file.</dd>
+<br>
+<dt><em>Map display mode</em></dt>
+<dd>Opens a dropdown menu for selecting different display mode<br>
+ <ul>
+ <li><dt><em>2D view mode</em></dt>
+ <dd>Normal GIS display. All active layers are composited and displayed
+ in 2D mode.</dd></li>
+
+ <li><dt><em>3D view mode</em></dt>
+ <dd>Experimental replacement for NVIZ. Displays all active layers in
+ 3D perspective using OpenGL. A new control panel opens to manage the
+ 3D view. 3D view can be zoomed, panned, rotated, and tilted. The
+ vertical exaggeration of rasters and 3D vectors can be set. Various
+ color and lighten settings are possible. Not yet functional for
+ Windows platforms</dd></li>
+
+ <li><dt><em>Digitize mode</em></dt>
+ <dd>Puts display into vector digitizing mode and opens a new digitizing
+ toolbar. The user can digitize a new map or edit an existing
+ map. Not yet functional for Windows platforms</dd></li>
+ </ul>
</dl>
<h2>CONFIGURATION</h2>
@@ -457,9 +522,8 @@
<h2>AUTHORS</h2>
-Head developer: Martin Landa, FBK-irst, Trento, Italy<br><br>
-
-Michael Barton,<br>
+Michael Barton, Arizona State University, USA<br>
+Martin Landa, FBK-irst, Trento, Italy<br>
Daniel Calvelo Aros,<br>
Jachym Cepicky
More information about the grass-commit
mailing list