wxGUI.html 19 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481
  1. <h2>DESCRIPTION</h2>
  2. <b>wxGUI</b> is a new generation of the GUI for GRASS GIS. It's a successor
  3. of the <em>Tcl/Tk GUI</em> from GRASS 6.
  4. <p>
  5. If wxGUI is not your default GUI, you can define it as default by
  6. typing at GRASS command line prompt
  7. <div class="code"><pre>
  8. g.gui -u wxpython
  9. </pre></div>
  10. or define in your <tt>.grassrc7</tt> file 'GRASS_GUI' variable
  11. <div class="code"><pre>
  12. GRASS_GUI: gui
  13. </pre></div>
  14. The GUI can be quit by selecting the 'File->Exit' menu item. The GUI
  15. can be restarted from the GRASS command line prompt by typing
  16. <div class="code"><pre>
  17. g.gui
  18. </pre></div>
  19. or to restart with previously saved workspace type:
  20. <div class="code"><pre>
  21. g.gui workspace=file.gxw
  22. </pre></div>
  23. <p>
  24. You can also start GRASS from the shell command line with wxGUI
  25. defined by the <tt>-wxpython</tt> switch:
  26. <div class="code"><pre>
  27. grass70 -wxpython
  28. </pre></div>
  29. <p>
  30. The GUI is composed by <em>two</em> main components:
  31. <ul>
  32. <li><b>Layer Manager</b> which allows users to run different GRASS
  33. modules from menu, includes map layer management, integrated
  34. command-line prompt, and command output window tab.</li>
  35. <li><b>Map Display Window</b> which integrates basic tools for
  36. zooming, panning, data querying, decorations (north arrows,
  37. barscale, etc.). The user is allowed to start various map display
  38. instances during one session. The Layer Manager registers Map
  39. Display Windows using different tabs.</li>
  40. </ul>
  41. <h3>Layer Manager</h3>
  42. The <em>Layer Manager</em> provides an interactive graphical interface to GRASS
  43. commands. It includes a set of pull-down menus for all GRASS GIS
  44. functions (analysis, file I/O, GIS configuration and management), the
  45. toolbar to manage display map layers, a layer tree frame in which map layers
  46. to display are organized, command output window tab, and interactive
  47. command line prompt.
  48. <center>
  49. <br><img src="wxGUI_layer_manager.jpg" border="1"><br><br>
  50. </center>
  51. The top left button of the toolbar opens a new <em>Map Display
  52. Window</em>. Each map display has a unique set of layers to display
  53. and region settings. Other toolbar buttons add layers of different
  54. types for display in the selected map display window. There are
  55. additional buttons for saving or opening workspace file, and others.
  56. <p>
  57. Map layers are listed in the window frame below the toolbar. Layers can
  58. include raster and vector maps, text, map decorations (scale and
  59. north arrow, and grids), and commands (where any GRASS command can be
  60. written). Layers are displayed as arranged in the layer tree: the
  61. bottom layer is displayed first and the top layer is displayed last, as if
  62. the layers were a series of stacked overlays.
  63. <p>
  64. The check box to the left of each layer makes it active or inactive
  65. for display. Only active layers are displayed/redisplayed when the
  66. display button is pressed. Layers can be organized into groups; entire
  67. groups can be activated or deactivated for display. Layer tree
  68. composition can be saved to a workspace file and opened in subsequent
  69. sessions, restoring all layers and their display options.
  70. <p>
  71. Right mouse click on a layer opens a dropdown menu with options to
  72. remove or rename the layer (g.remove, g.rename),
  73. change its display properties (d.rast and d.vect options such as color, symbol, etc.),
  74. show its metadata (r.info, v.info) or attributes, if applicable.
  75. <p>
  76. Left mouse double click on a layer opens GUI for its display options (d.rast, d.vect).
  77. <h4>Layer Manager Toolbar</h4>
  78. New and old icons and explanation of their functionality:
  79. <dl>
  80. <dt><img src="icons/grass2/monitor-create.png">&nbsp;
  81. <em>Open new Map Display Window</em></dt>
  82. <dd>Opens a new map display and creates empty layer tree tab in Layer Manager.</dd>
  83. <dt><img src="icons/grass2/create.png">&nbsp;
  84. <em>Creates new workspace file</em></dt>
  85. <dd>Removes all layers in the layer tree and creates a new, empty tree
  86. where new layers can be added.</dd>
  87. <dt><img src="icons/grass2/layer-open.png">&nbsp;
  88. <em>Load map layers (raster, vector) into workspace</em></dt>
  89. <dd>Loads selected raster or vector maps into current layer tree.</dd>
  90. <dt><img src="icons/grass2/open.png">&nbsp;
  91. <em>Open an existing workspace file</em></dt>
  92. <dd>Opens an previously saved workspace file, containing a set of display
  93. layers and their option settings.</dd>
  94. <dt><img src="icons/grass2/save.png">&nbsp;
  95. <em>Save workspace file</em></dt>
  96. <dd>Saves current set of layers and their options to a workspace
  97. file.</dd>
  98. <dt><img src="icons/grass2/layer-raster-add.png">&nbsp;
  99. <em>Add raster map layer</em></dt>
  100. <dd>Adds raster map to layer tree, see <em><a href="d.rast.html">d.rast</a></em>.
  101. </dd>
  102. <dt><img src="icons/grass2/layer-shaded-relief-add.png">&nbsp;
  103. <em>Add various raster-based map layers</em></dt>
  104. <dd>opens a dropdown menu that allows user to select to:<br>
  105. <ul>
  106. <li><dt><img src="icons/grass2/layer-shaded-relief-add.png">&nbsp;
  107. <em>Add shaded relief raster map layer </em></dt>
  108. <dd>Adds shaded relief raster map layer,
  109. see <em><a href="d.shadedmap.html">d.shadedmap</a></em></li>
  110. <li><dt><img src="icons/grass2/layer-rgb-add.png">&nbsp;
  111. <em>Add RGB raster layer</em></dt>
  112. <dd>Combines and displays three raster maps defined as red, green, and blue
  113. channels, see <em><a href="d.rgb.html">d.rgb</a></em>.</dd></li>
  114. <li><dt><img src="icons/grass2/layer-his-add.png">&nbsp;
  115. <em>Add HIS raster layer</em></dt>
  116. <dd>Combines and displays two or three raster maps defined as hue,
  117. intensity, and (optionally) saturation channels,
  118. see <em><a href="d.his.html">d.his</a></em>.</dd></li>
  119. <li><dt><img src="icons/grass2/layer-cell-cats-add.png">&nbsp;
  120. <em>Add raster arrows layer</em></dt>
  121. <dd>Adds map of raster cells with directional arrows drawn. Arrow
  122. direction and length are determined by separate aspect/directional map
  123. and (optional) slope/intensity map,
  124. see <em><a href="d.rast.arrow.html">d.rast.arrow</a></em>.</dd></li>
  125. <li><dt><img src="icons/grass2/layer-cell-cats-add.png">&nbsp;
  126. <em>Add raster numbers layer</em></dt>
  127. <dd>Adds map of raster cells with numbers representing the cell values,
  128. see <em><a href="d.rast.num.html">d.rast.num</a></em>.</dd></li>
  129. </ul>
  130. <dt><img src="icons/grass2/layer-vector-add.png">&nbsp;
  131. <em>Add vector map layer</em></dt>
  132. <dd>Adds a vector map layer, see <em><a href="d.vect.html">d.vect</a></em>.
  133. </dd>
  134. <dt><img src="icons/grass2/layer-vector-thematic-add.png">&nbsp;
  135. <em>Add various vector-based map layers </em></dt>
  136. <dd>opens a dropdown menu that allows user to select to:<br>
  137. <ul>
  138. <li><dt><img src="icons/grass2/layer-vector-thematic-add.png">&nbsp;
  139. <em>Add thematic map layer
  140. (for all vector types)</em></dt>
  141. <dd>Adds layer for thematic display values from a numeric attribute
  142. column associated with a vector map. Options include: thematic display
  143. type (graduated colors or point sizes), methods for creating display
  144. intervals, SQL query of attribute column to limit vector objects to
  145. display, control of point icon types and sizes, control of thematic
  146. color schemes, creation of legend for thematic map, and saving the
  147. results of thematic mapping to a ps.map instructions file for later
  148. printing,
  149. see <em><a href="d.vect.thematic.html">d.vect.thematic</a></em>.</dd></li>
  150. <li><dt><img src="icons/grass2/layer-vector-chart-add.png">&nbsp;
  151. <em>Add thematic charts layer (for vector points)</em></dt>
  152. <dd>Adds layer in which pie or bar charts can be automatically created
  153. at vector point locations. Charts display values from selected columns
  154. in the associated attribute table. Options include: chart type, layer
  155. and attributes to chart, chart colors, and chart size (fixed or based
  156. on attribute column),
  157. see <em><a href="d.vect.chart.html">d.vect.chart</a></em>.</dd></li>
  158. </ul>
  159. <dt><img src="icons/grass2/layer-command-add.png">&nbsp;
  160. <em>Add command layer</em></dt>
  161. <dd>Adds a layer in which a GRASS GIS command or command list can be entered.
  162. For a command list use the semi-colon (";") symbol as a separator.
  163. For example:
  164. <div class="code"><pre>
  165. d.rast soils;d.rast -o roads;d.vect streams col=blue
  166. </pre></div>
  167. Note that when an option of the command contains spaces, you need to
  168. "escape" them with the backslash ('\') character, for example:
  169. <div class="code"><pre>
  170. d.text text=Population\ density
  171. </pre></div>
  172. </dd>
  173. <dt><img src="icons/grass2/layer-group-add.png">&nbsp;
  174. <em>Add layer group</em></dt>
  175. <dd>Adds an empty layer group. Layers can then be added to the group.</dd>
  176. <dt><img src="icons/grass2/layer-grid-add.png">&nbsp;
  177. <em>Add grid or vector labels overlay</em></dt>
  178. <dd>opens a dropdown menu that allows user to select to:<br>
  179. <ul>
  180. <li><dt><img src="icons/grass2/layer-grid-add.png">&nbsp;
  181. <em>Add overlay grids and lines</em></dt>
  182. <dd>Adds layer to display regular grid (for all locations)
  183. see <em><a href="d.grid.html">d.grid</a></em></dd></li>
  184. <li><dt><img src="icons/grass2/layer-label-add.png">&nbsp;
  185. <em>Add labels layer for vector objects (from existing labels file)</em></dt>
  186. <dd>Add raster text layer from a labels file for vector objects
  187. created with the <em><a href="v.label.html">v.label</a></em> module
  188. (accessed from button in options panel). A labels file can also be
  189. created with a text editor, see <em><a href="d.labels.html">d.labels</a></em>.</dd></li>
  190. <li><dt><img src="icons/grass2/layer-grid-add.png">&nbsp;
  191. <em>Add geodesic line layer</em></dt>
  192. <dd>Add layer to display geodesic line for latitude/longitude locations only,
  193. see <em><a href="d.geodesic.html">d.geodesic</a></em></dd></li>
  194. <li><dt><img src="icons/grass2/layer-grid-add.png">&nbsp;
  195. <em>Add rhumbline layer</em>
  196. <dd>Add layer to display rhumblines (for latitude/longitude locations only),
  197. see <em><a href="d.rhumbline.html">d.rhumbline</a></em>.</dd></li>
  198. </ul>
  199. <dt><img src="icons/grass2/layer-remove.png">&nbsp;
  200. <em>Delete selected layer</em></dt>
  201. <dd>Removes selected map layer or map layer group from layer tree.</dd>
  202. <dt><img src="icons/grass2/table.png">&nbsp;
  203. <em>Show <a href="wxGUI.Attribute_Table_Manager.html">Attribute Table Manager</a> for selected vector map</em></dt>
  204. <dd>Displays attribute data of selected vector map.</dd>
  205. </dl>
  206. <h4>Key shortcuts</h4>
  207. <b>Menu</b>
  208. <dl>
  209. <dt>Ctrl+N</dt>
  210. <dd>Create new workspace</dd>
  211. <dt>Ctrl+O</dt>
  212. <dd>Load workspace from file</dd>
  213. <dt>Ctrl+S</dt>
  214. <dd>Save workspace</dd>
  215. <dt>Ctrl+C</dt>
  216. <dd>Close workspace</dd>
  217. <dt>Ctrl+Q</dt>
  218. <dd>Quit GUI</dd>
  219. </dl>
  220. <b>Global</b>
  221. <dl>
  222. <dt>Alt+R</dt>
  223. <dd>Add raster map layer</dd>
  224. <dt>Alt+V</dt>
  225. <dd>Add vector map layer</dd>
  226. </dl>
  227. <h3>Map Display Window</h3>
  228. This component includes toolbar area (set of toolbars), map canvas
  229. where a map composition is displayed, and the statusbar.
  230. <center>
  231. <br><img src="wxGUI_map_display.jpg" alt="Map Display Window"><br><br>
  232. </center>
  233. Each Map Display Window has a unique layer tree and region
  234. setting. The window contains a toolbar with buttons to manage the map
  235. in the display (zoom and pan), providing tools for query and distance
  236. measurement, and exporting or printing the display.
  237. <p>
  238. In the statusbar can be displayed the geographic coordinates under the
  239. cursor, current geographical region extent, computational region
  240. (including graphical visualization in map display), map display
  241. geometry (number of rows, columns, resolution) and map scale.
  242. <p>
  243. It is important to note that zooming in any display will
  244. have <em>no</em> effect on the 'computational region' setting (set
  245. with <em><a href="g.region.html">g.region</a></em>). Only by selecting
  246. the 'Set current region to match display' item in the zoom menu (in
  247. the map display toolbar) will the current display extents be copied to
  248. the computational region extents.
  249. <h4>Map Display Toolbar</h4>
  250. <dl>
  251. <dt><img src="icons/grass2/show.png">&nbsp;
  252. <em>Display active layers (current region)</em></dt>
  253. <dd>Displays all active layers from layer tree at current resolution
  254. and region extents for that map display window.</dd>
  255. <dt><img src="icons/grass2/layer-redraw.png">&nbsp;
  256. <em>Re-render and display all active
  257. layers and zoom to current region</em></dt>
  258. <dd>Resets the region to the display resolution and extents and forces
  259. re-display and re-rendering all active layers.</dd>
  260. <dt><img src="icons/grass2/erase.png">&nbsp;
  261. <em>Erase display content</em></dt>
  262. <dd>Erases the currently selected map display to a white background;
  263. also removes all frames,
  264. see <em><a href="d.erase.html">d.erase</a>, <a href="d.frame.html">d.frame
  265. -e</a></em>.</dd>
  266. <dt><img src="icons/grass2/pointer.png">&nbsp;
  267. <em>Arrow cursor</em></dt>
  268. <dd>Select arrow cursor for map display.</dd>
  269. <dt><img src="icons/grass2/info.png">&nbsp;
  270. <em>Query tool (select a map first)</em></dt>
  271. <dd>Query selected raster, RGB raster (all three map channels will be
  272. queried), or vector map(s) using the mouse. Map(s) must be selected
  273. before query. Vector charts and thematic vector maps cannot be
  274. queried. The results of the query will be displayed in the console
  275. window,
  276. see <em><a href="r.what.html">r.what</a>, <a href="v.what.html">v.what</a></em>.</dd>
  277. <dt><img src="icons/grass2/pan.png">&nbsp;
  278. <em>Pan</em></dt>
  279. <dd>Interactive selection of a new center of view in the active
  280. display monitor. Drag the pan cursor while pressing the left mouse
  281. button to pan. Panning changes the location of the region displayed
  282. but not the size of the area displayed or the resolution. Panning
  283. does <em>not</em> affect the computational region for other GIS
  284. processes, see <em><a href="g.region.html">g.region</a></em>.</dd>
  285. <dt><img src="icons/grass2/zoom-in.png">&nbsp;
  286. <em>Zoom in</em></dt>
  287. <dd>Interactive zooming with the mouse in the active display monitor.
  288. Drawing a box or just click with the mouse (left button) and zoom-in
  289. cursor causes the display to zoom in so that the area defined by the
  290. box fills the display. The map resolution is not changed. Clicking
  291. with the zoom-in cursor causes the display to zoom in by 30%, centered
  292. on the point where the mouse is clicked. Zooming resets the display
  293. region extents (both size and location of area displayed). It
  294. does <em>not</em> affect the computational region for other GIS
  295. processes, see <em><a href="g.region.html">g.region</a></em>.</dd>
  296. <dt><img src="icons/grass2/zoom-out.png">&nbsp;
  297. <em>Zoom out</em></dt>
  298. <dd>Interactive zooming with the mouse in the active display monitor.
  299. Drawing a box or just click with the mouse (left button) and zoom-out
  300. cursor causes the display to zoom in so that the area displayed
  301. shrinks to fill the area defined by the box. The map resolution is not
  302. changed. Clicking with the zoom-out cursor causes the display to zoom
  303. out by 30%, centered on the point where the mouse is clicked. Zooming
  304. resets the display region extents (both size and location of area
  305. displayed). It does <em>not</em> affect the computational region for
  306. other GIS processes,
  307. see <em><a href="g.region.html">g.region</a></em>.</dd>
  308. <dt><img src="icons/grass2/zoom-last.png">&nbsp;
  309. <em>Revert zoom</em></dt>
  310. <dd>Returns to the previous zoom. Up to 10 levels of zoom back are
  311. maintained, see <em><a href="g.region.html">g.region</a></em>.</dd>
  312. <dt><img src="icons/grass2/zoom-more.png">&nbsp;
  313. <em>Zoom menu</em></dt>
  314. <dd>Automatic zoom settings menu. Zoom to match the extents of a selected
  315. map, zoom to match the computational region (set with
  316. <em>g.region</em>), zoom to match the extents of a saved region or
  317. save the current extents to a named region file, or to set
  318. computational region (the mapset's <tt>WIND</tt> file) to match the
  319. current display extents (does not change the resolution).
  320. See <em><a href="g.region.html">g.region</a></em>.</dd>
  321. <dt><img src="icons/grass2/layer-raster-analyze.png">&nbsp;
  322. <em>Analyze menu</em></dt>
  323. <dd>Contains functions for distance measurement, creating histogram or
  324. profile tool.</dd>
  325. <dt><img src="icons/grass2/measure-length.png">&nbsp;
  326. <em>Distance measurement tool</em></dt>
  327. <dd>Interactive measurement of lengths defined with the mouse. The
  328. length of each segment and the cumulative length of all segments
  329. measuered is displayed in the command output window frame. Lengths are
  330. measured in the current measurement unit,
  331. see <em><a href="d.measure.html">d.measure</a></em>.</dd>
  332. <dt><img src="icons/grass2/layer-raster-profile.png">&nbsp;
  333. <em>Profile tool</em></dt>
  334. <dd>Interactively create profile of a raster map. Profile transect is
  335. drawn with the mouse in map display. The profile may be of the
  336. displayed map or a different map,
  337. see <em><a href="gm_profile.html">Profile Tool help
  338. page</a></em>.</dd>
  339. <dt><img src="icons/grass2/layer-raster-histogram.png">&nbsp;
  340. Display histogram of selected raster map</dt>
  341. <dd>Displays histogram of selected raster map or image in new window,
  342. see <em><a href="d.histogram.html">d.histogram</a></em>.</dd>
  343. <dt><img src="icons/grass2/element-add.png">&nbsp;
  344. Add overlay</dt>
  345. <dd>Adds overlay to map display like barscale, north arrow, text.</dd>
  346. <dt><img src="icons/grass2/scalebar-add.png">&nbsp;
  347. <em>Add scalebar and north arrow</em></dt>
  348. <dd>Adds layer to display a combined scalebar and north arrow. Options
  349. include scalebar placement (using screen coordinates or a mouse),
  350. scalebar format, and scalebar colors,
  351. see <em><a href="d.barscale.html">d.barscale</a></em>.</dd>
  352. <dt><img src="icons/grass2/legend-add.png">&nbsp;
  353. <em>Add raster map legend</em></dt>
  354. <dd>Adds layer to display with legend of selected raster map,
  355. see <em><a href="d.legend.html">d.legend</a></em>.</dd>
  356. <dt><img src="icons/grass2/text-add.png">&nbsp;
  357. <em>Add text layer</em></dt>
  358. <dd>Adds layer to display a line of text using default GRASS font
  359. (selected with <em><a href="d.font.html">d.font</a></em>). Options
  360. include: text placement (screen coordinates); and text size, bolding,
  361. and color, see <em><a href="d.text.html">d.text</a></em>.</dd>
  362. <dt><img src="icons/grass2/map-export.png">&nbsp;
  363. <em>Export map display</em></dt>
  364. <dd>Exports visible map display to different raster graphic formats.</dd>
  365. <dt><img src="icons/grass2/print.png">&nbsp;
  366. <em>Print map</em></dt>
  367. <dd>Prints map on the UNIX <i>lpr</i> printer or PostScript device;
  368. saves visible map display (including PostScript text and labels) to PDF
  369. or EPS file. Requires <tt>ghostscript</tt> for all output except EPS.</dd>
  370. </dl>
  371. <h2>CONFIGURATION</h2>
  372. <em>User GIS settings</em> dialog ('Config->Preferences') enables
  373. configuration of various options.
  374. <p>
  375. For information about available <em>icon themes</em> see
  376. this <a href="wxGUI.Icons.html">page</a>.
  377. <h2>SEE ALSO</h2>
  378. <em>
  379. <a href="wxGUI.Vector_Digitizing_Tool.html">Vector digitizing tool</a>,
  380. <a href="wxGUI.Attribute_Table_Manager.html">Attribute Table Manager</a>,
  381. <a href="wxGUI.Nviz.html">Nviz extension</a>,
  382. <a href="wxGUI.Icons.html">Icon themes</a>
  383. </em>
  384. <p>
  385. See also <a href="http://grass.osgeo.org/wiki/WxGUI">Wiki</a> page.
  386. <h2>AUTHORS</h2>
  387. Head developer: Martin Landa, FBK-irst, Trento, Italy<br><br>
  388. Michael Barton,<br>
  389. Daniel Calvelo Aros,<br>
  390. Jachym Cepicky
  391. <p>
  392. <i>$Date$</i>