gis.m.html 18 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432
  1. <h2>DESCRIPTION</h2>
  2. The <b>GRASS GIS Manager</b>
  3. provides an interactive graphical interface to GRASS commands. By
  4. default, it is started automatically with each GRASS session. The GIS
  5. Manager can be quit by selecting the <em>'File-&gt;Exit</em><em>'</em>
  6. menu item. The GIS Manager can be restarted from the GRASS command line
  7. shell by typing "<i>gis.m</i>".<br>
  8. <br>
  9. The GIS Manager includes a set of pull-down menus for all GRASS GIS
  10. functions (analysis, file I/O, GIS configuration and management), two
  11. rows of buttons that manage display layers, an upper window in
  12. which layers to display are organized, and a lower
  13. window which contains options panels for layers in the layer tree.
  14. <br><br>
  15. <center>
  16. <img src="gm_gismgr.jpg" alt="GIS Manager window" height="551" width="480">
  17. </center>
  18. <br>
  19. <br>
  20. The top left button opens a new map display window. Each map display
  21. has a unique set of layers to display and region setting (zoom). Other
  22. buttons add layers of different types for display in the selected map
  23. display window. There are additional buttons for saving or opening
  24. group display file, starting XGANIM (display animator) display
  25. interfaces (requires motif), and digitizing.
  26. <i>Mouse-over help</i> is available for all buttons.
  27. <P>
  28. Map layers are listed in the window below the
  29. buttons. Layers can include raster and vector maps, text, map
  30. enhancements (scale and north arrow, and grids), and commands
  31. (where any GRASS command be written). Layers are displayed in as
  32. arranged in the layer tree: the bottom layer
  33. is displayed first and the top is displayed last, as if
  34. layers are a series of stacked overlays. Any layer can be
  35. renamed by double clicking on its name and typing a new name.
  36. <P>
  37. The check box to the left of each layer makes it active or inactive for
  38. display.
  39. Only active layers are displayed/redisplayed when the display button is
  40. pressed. Layers can be organized into groups; entire groups can be
  41. activated or deactivated for display. Groups can be saved to a file and
  42. opened in subsequent sessions, restoring all layers and their display
  43. options.
  44. <P>
  45. When a layer is selected with the mouse, its options are shown in the
  46. panel below the layer tree window. Help for each layer type can be
  47. accessed by pressing the GRASS button in the option panel.<br>
  48. <P>
  49. Each map display has a unique layer tree and region setting (zoom).
  50. Buttons on each map display manage the map in the display (zoom and
  51. pan), provide tools for query and distance measurement, and exporting
  52. or printing the display. The geographic coordinates under the cursor
  53. are displayed in the indicator window (lower right window frame). It is
  54. important to note that zooming in any display will have NO effect on
  55. the 'computational region' setting (set with g.region). Only by selecting
  56. the "Set current region to match display" item in the zoom menu (in the
  57. map display tool bar) will the current display extents be copied to
  58. the computational region extents.
  59. <br><br>
  60. <center>
  61. <img src="gm_mapdisp.jpg" alt="Map Display window" height="422" width="480">
  62. </center>
  63. <br><br>
  64. A separate console window shows all commands issued and all command
  65. output (upper window). GRASS commands (and any other unix/linux
  66. commands) can be run from the console (lower window).<br>
  67. <br>
  68. <center>
  69. <img src="gm_gronsole.png" alt="Output and command console window" height="231" width="480">
  70. </center>
  71. <br>
  72. <h2>GIS MANAGER BUTTON FUNCTIONS</h2>
  73. <img src="gm_gismgrtools.png" alt="GIS Manager Toolbar">
  74. <H3><u>Top Row</u></H3>
  75. <DL>
  76. <DT><img src="icons/grass/gui-startmon.gif"> Open new map display</DT>
  77. <DD>Opens a new map display and resets layer tree.</DD>
  78. <DT><img src="icons/grass/element-cell.gif"> Add raster layer</DT>
  79. <DD>Adds a raster map to the layer tree. Raster display options include:
  80. displaying a selected subset of raster cells, defined by their cat
  81. values; draping (or "fusing") a second map over the base map;
  82. and displaying legends for the base map and draped map.
  83. <i>See <a href="d.rast.html">d.rast</a> and <a href="d.his.html">d.his</a>
  84. (for draping/fusing).</i>
  85. </DD>
  86. <DT><img src="icons/grass/channel-rgb.gif"> Add RGB or HIS raster layer</DT>
  87. <DD>Combines and displays three raster maps defined as red, green, and blue
  88. channels; or combines and displays two or three raster maps defined as
  89. hue, intensity, and (optionally) saturation channels.
  90. <i>See <a href="d.rgb.html">d.rgb</a> and <a href="d.his.html">d.his</a>.</i>
  91. </DD>
  92. <DT><img src="icons/grass/module-d.histogram.gif"> Add histogram layer</DT>
  93. <DD>Adds a layer to display histogram of a raster map or image.
  94. <i>See <a href="d.histogram.html">d.histogram</a>.</i>
  95. </DD>
  96. <DT><img src="icons/grass/module-d.rast.num.gif"> Add cell values layer</DT>
  97. <DD>Adds map of raster cells with cell values printed inside.
  98. Only works when &lt;10,000 cells are displayed.
  99. <i>See <a href="d.rast.num.html">d.rast.num</a>.</i>
  100. </DD>
  101. <DT><img src="icons/grass/module-d.rast.arrow.gif"> Add raster arrows layer</DT>
  102. <DD>Adds map of raster cells with directional arrows drawn.
  103. Arrow direction and length are determined by separate aspect/directional map
  104. and (optional) slope/intensity map.
  105. <i>See <a href="d.rast.arrow.html">d.rast.arrow</a>.</i>
  106. </DD>
  107. <DT><img src="icons/grass/module-d.legend.gif"> Add raster legend</DT>
  108. <DD>Adds a legend for a single raster map to the layer tree.
  109. Multiple options for formatting the legend are available.
  110. <i>See <a href="d.legend.html">d.legend</a>.</i>
  111. </DD>
  112. <DT><img src="icons/grass/element-vector.gif"> Add vector layer</DT>
  113. <DD>Adds a vector map to the layer tree. A large number of options are
  114. available for displaying the vector map, including: outline and fill
  115. color, icon type and size for points, line widths for all vector types,
  116. automatic labeling using an attribute column, querying cats or
  117. attributes to limit vectors displayed, and restricting vector display
  118. depending on region size.
  119. <i>See <a href="d.vect.html">d.vect</a>.</i>
  120. </DD>
  121. <DT><img src="icons/grass/module-d.vect.thematic.gif"> Add thematic map layer
  122. (for all vector types)</DT>
  123. <DD>Adds layer for thematic display values from a numeric attribute column
  124. associated with a vector map. Options include: thematic display type
  125. (graduated colors or point sizes), methods for creating display
  126. intervals, SQL query of attribute column to limit vector objects to
  127. display, control of point icon types and sizes, control of thematic
  128. color schemes, creation of legend for thematic map, and saving the
  129. results of thematic mapping to a ps.map instructions file for later
  130. printing.
  131. <i>See <a href="d.vect.thematic.html">d.vect.thematic</a>.</i>
  132. </DD>
  133. <DT><img src="icons/grass/module-d.vect.chart.gif"> Add thematic charts layer
  134. (for vector points)</DT>
  135. <DD>Adds layer in which pie or bar charts can be automatically created at
  136. vector point locations. Charts display values from selected columns in the
  137. associated attribute table. Options include: chart type, layer and
  138. attributes to chart, chart colors, and chart size (fixed or based on
  139. attribute column).
  140. <i>See <a href="d.vect.chart.html">d.vect.chart</a>.</i>
  141. </DD>
  142. <DT><img src="icons/grass/module-d.labels.gif"> Add raster labels layer for vector
  143. objects (from existing labels file)</DT>
  144. <DD>Add raster text layer from a labels file for vector objects created with
  145. the <em><a href="v.label.html">v.label</a></em> module (accessed from button
  146. in options panel). A labels file can also be created with a text editor.
  147. <i>See <a href="d.labels.html">d.labels</a>.</i>
  148. </DD>
  149. <DT><img src="icons/grass/module-d.text.gif"> Add text layer</DT>
  150. <DD>Adds layer to display a line of text using default GRASS font
  151. (selected with <em><a href="d.font.html">d.font</a></em>).
  152. Options include: text placement (screen coordinates); and text size,
  153. bolding, and color.
  154. <i>See <a href="d.text.html">d.text</a>.</i>
  155. </DD>
  156. <DT><img src="icons/grass/gui-maptext.gif"> Add PostScript labels layer for vector
  157. objects (from existing labels file)</DT>
  158. <DD>Add PostScript text layer from a labels file for vector objects created
  159. with the <em><a href="v.label.html">v.label</a></em> module (accessed from
  160. button in options panel). A labels file can also be created with a text editor.
  161. <i>See <a href="d.labels.html">d.labels</a>.</i>
  162. </DD>
  163. <DT><img src="icons/grass/gui-maplabels.gif"> Add PostScript text layer</DT>
  164. <DD>Adds layer to display a line of PostScript text. Options include: text
  165. placement by coordinates (geographic or screen); text
  166. alignment, font and line spacing; and text size, bolding, and color.
  167. </DL>
  168. <BR><BR>
  169. <H3><u>Bottom Row</u></H3>
  170. <DL>
  171. <DT><img src="icons/grass/module-d.barscale.gif"> Add scalebar and north arrow layer</DT>
  172. <DD>Adds layer to display a combined scalebar and north arrow. Options
  173. include scalebar placement (using screen coordinates or a mouse),
  174. scalebar format, and scalebar colors.
  175. <i>See <a href="d.barscale.html">d.barscale</a>.</i>
  176. </DD>
  177. <DT><img src="icons/grass/module-d.grid.gif"> Overlay grids and lines</DT>
  178. <DD>Adds layer to display regular grid (for all locations), or geodesic and
  179. rhumblines (for latitude/longitude locations only). Grid options
  180. include: grid and border colors, grid origin, and grid line spacing.
  181. Geodesic and rhumbline options include: line color, and xy coordinates
  182. (geographic) of line endpoints.
  183. <i>See <a href="d.grid.html">d.grid</a>, <a href="d.geodesic.html">d.geodesic</a>,
  184. and <a href="d.rhumbline.html">d.rhumbline</a>.</i>
  185. </DD>
  186. <DT><img src="icons/grass/gui-cmd.gif"> Add command layer</DT>
  187. <DD>Adds a layer in which a GRASS GIS command or command list can be entered.
  188. For a command list use the pipe symbol as "|" as separator.
  189. For example:
  190. <div class="code"><pre>
  191. d.rast soils | d.rast -o roads | d.vect streams col=blue
  192. </pre></div>
  193. Note that when an option of the command contains spaces, you need to
  194. escape them with the backslash ('\') character, for example:<BR>
  195. <tt>d.text text=Population\ density</tt>
  196. </DD>
  197. <DT><img src="icons/grass/gui-group.gif"> Add group</DT>
  198. <DD>Adds an empty layer group. Layers can then be added to the group.</DD>
  199. <DT><img src="icons/grass/edit-copy.gif"> Duplicate selected layer or group</DT>
  200. <DD>Adds a new layer that duplicates the selected layer.</DD>
  201. <DT><img src="icons/grass/edit-cut.gif"> Cut selected layer or group</DT>
  202. <DD>Deletes the selected group or layer.</DD>
  203. <DT><img src="icons/grass/file-new.gif"> Erase all layers and create a new group</DT>
  204. <DD>Removes all layers in the layer tree and creates a new, empty group to
  205. which new layers can be added.<br></DD>
  206. <DT><img src="icons/grass/file-open.gif"> Open an existing group file</DT>
  207. <DD>Opens an previously saved group file, containing a set of display
  208. layers and their option settings.</DD>
  209. <DT><img src="icons/grass/file-save.gif"> Save layers to group file</DT>
  210. <DD>Saves current set of layers and their options to a group file.</DD>
  211. <DT><img src="icons/grass/module-xganim.gif"> Animate raster map series</DT>
  212. <DD>Starts the interactive Animation Tool interface to display a series
  213. of raster maps as an animation.
  214. <i>See the <a href="gm_animate.html">Animation Tool help page</a></i>.
  215. </DD>
  216. <DT><img src="icons/grass/module-v.digit.gif"> Digitize raster or vector maps</DT>
  217. <DD>Starts the raster digitizing or vector digitizing module, depending on
  218. whether a raster or vector map is selected. Raster digitizing always
  219. creates a new map. Vector digitizing will either edit an existing map
  220. (if an existing vector map is selected in the layer tree) or create a
  221. new vector map (if the name of the new vector to be created is entered
  222. in the 'vector name' field of the options panel for a vector map
  223. layer).
  224. <i>See <a href="r.digit.html">r.digit</a> and <a href="v.digit.html">v.digit</a></i>.
  225. </DD>
  226. </DL>
  227. <BR><BR>
  228. <h2>MAP DISPLAY BUTTON FUNCTIONS</h2>
  229. <img src="gm_mapdisptools.png" alt="Map display toolbar">
  230. <DL>
  231. <DT><img src="icons/grass/gui-display.gif"> Display active layers (current region)</DT>
  232. <DD>Displays all active layers at current resolution and region extents for
  233. that map display window.</DD>
  234. <DT><img src="icons/grass/gui-zoom_current.gif"> Re-render and display all active
  235. layers and zoom to current region</DT>
  236. <DD>Resets the region to the resolution and extents to the values set with
  237. <em>g.region</em>; forces re-display and re-rendering all active layers.
  238. <i>See <a href="g.region.html">g.region</a>.</i></DD>
  239. <DT><img src="icons/grass/module-nviz.gif"> NVIZ</DT>
  240. <DD>Starts NVIZ, the <i>n</i>-dimensional visualization module and interactive
  241. graphical interface. All active raster and vector layers in the layer
  242. tree will be displayed in NVIZ.
  243. <i>See the <a href="nviz.html">nviz</a> manual.</i></DD>
  244. <DT><img src="icons/grass/module-d.nviz.gif"> Create fly through path for NVIZ</DT>
  245. <DD>Starts a GRASS module for interactive creation of a fly-through path to
  246. be animated in NVIZ.
  247. <i>See <a href="d.nviz.html">d.nviz</a></i>.</DD>
  248. <DT><img src="icons/grass/gui-erase.gif"> Erase to white</DT>
  249. <DD>Erases the currently selected monitor to a white background; also
  250. removes all frames.
  251. <i>See <a href="d.erase.html">d.erase</a> and
  252. <a href="d.frame.html">d.frame -e</a>.</i></DD>
  253. <DT><img src="icons/grass/gui-pointer.gif"> Arrow cursor</DT>
  254. <DD>Select arrow cursor for map display.</DD>
  255. <DT><img src="icons/grass/gui-zoom_in.gif"> Zoom in</DT>
  256. <DD>Interactive zooming with the mouse in the active display monitor.
  257. Drawing a box with the mouse (left button) and zoom-in cursor causes
  258. the display to zoom in so that the area defined by the box fills the
  259. display. The map resolution is not changed. Clicking with the zoom-in
  260. cursor causes the display to zoom in by 30%, centered on the point
  261. where the mouse is clicked. Zooming resets the display region extents
  262. (both size and location of area displayed). It does NOT affect the
  263. computational region for other GIS processes.
  264. <i>See <a href="g.region.html">g.region</a>.</i></DD>
  265. <DT><img src="icons/grass/gui-zoom_out.gif"> Zoom out</DT>
  266. <DD>Interactive zooming with the mouse in the active display monitor.
  267. Drawing a box with the mouse (left button) and zoom-out cursor causes
  268. the display to zoom in so that the area displayed shrinks to fill the
  269. area defined by the box. The map resolution is not changed. Clicking
  270. with the zoom-out cursor causes the display to zoom out by 30%, centered
  271. on the point where the mouse is clicked. Zooming resets the display
  272. region extents (both size and location of area displayed). It does NOT
  273. affect the computational region for other GIS processes.
  274. <i>See <a href="g.region.html">g.region</a>.</i></DD>
  275. <DT><img src="icons/grass/gui-pan.gif"> Pan</DT>
  276. <DD>Interactive selection of a new center of view in the active display
  277. monitor. Drag the pan cursor while pressing the left mouse button to pan.
  278. Panning changes the location of the region displayed but not the size of
  279. the area displayed or the resolution. Panning does NOT affect the
  280. computational region for other GIS processes.
  281. <i>See <a href="g.region.html">g.region</a>.</i></DD>
  282. <DT><img src="icons/grass/gui-zoom_back.gif"> Revert zoom</DT>
  283. <DD>Returns to the previous zoom. Up to 5 levels of zoom back are maintained.
  284. <i>See <a href="g.region.html">g.region</a>.</i></DD>
  285. <DT><img src="icons/grass/gui-mapzoom.gif"> Zoom menu</DT>
  286. <DD>Automatic zoom settings menu. Zoom to match the extents of a selected
  287. map or to match the extents of a saved region; save the current extents
  288. to a named region file; zoom to match the computational region (set with
  289. <em>g.region</em>) or to match the default region; set computational region
  290. (the mapset's <tt>WIND</tt> file) to match the current display extents
  291. (does not change the resolution).
  292. <i>See <a href="g.region.html">g.region</a>.</i></DD>
  293. <DT><img src="icons/grass/gui-query.gif"> Query tool (select a map first)</DT>
  294. <DD>Query selected raster (only the base map of a draped map will be
  295. queried), RGB raster map (all three map channels will be queried), or
  296. vector map using the mouse. A map must be selected before query.
  297. Vector charts and thematic vector maps cannot be queried. The
  298. results of the query will be displayed in the console window.
  299. <i>See <a href="r.what.html">r.what</a> and <a href="v.what.html">v.what</a></i>.
  300. </DD>
  301. <DT><img src="icons/grass/gui-measure.gif"> Distance measurement tool</DT>
  302. <DD>Interactive measurement of lengths defined with the mouse. The length
  303. of each segment and the cumulative length of all segments measuered is
  304. displayed in the console window. Lengths are measured in the current
  305. measurement unit.
  306. <i>See also <a href="d.measure.html">d.measure</a>.</i></DD>
  307. <DT><img src="icons/grass/gui-profile.gif"> Profile tool</DT>
  308. <DD>Interactively create profile of a raster map. Profile transect
  309. is drawn with the mouse in map display. The profile may be of the
  310. displayed map or a different map.<i>
  311. See the <a href="gm_profile.html">Profile Tool help page</a>.</i></DD>
  312. <DT><img src="icons/grass/file-print.gif"> Print map</DT>
  313. <DD>Prints map on the UNIX <i>lpr</i> printer or PostScript device;
  314. saves visible map display (including PostScript text and labels) to PDF
  315. or EPS file. Requires <tt>ghostscript</tt> for all output except EPS.</DD>
  316. <DT><img src="icons/grass/file-save.gif"> Export map display</DT>
  317. <DD>Exports visible map display to different raster graphic formats.
  318. Exported map does not include PostScript text or PostScript labels.</DD>
  319. <DT><img src="icons/grass/drawmode-strict.gif"> Strict draw mode</DT>
  320. <DD>Selects strict draw mode. In strict mode the aspect ratio and resolution
  321. from the last zoom are used when drawing the maps. The map will show only
  322. the area and resolution selected. It will not usually fill the screen.
  323. Strict mode only shows what is asked for.</DD>
  324. <DT><img src="icons/grass/drawmode-explore.gif"> Explore draw mode</DT>
  325. <DD>Selects explore draw mode. In explore mode the region from the last zoom
  326. is expanded to fill the entire screen. The resolution is adjusted to match
  327. the screen resolution. Explore mode shows as much as possible.</DD>
  328. </DL>
  329. <h2>CONFIGURATION</h2>
  330. <h3>Changing fonts</h3>
  331. Fonts used in <em>gis.m</em> can be changed as follows:
  332. <ul>
  333. <li>Runtime: edit file '<tt>$GISBASE/etc/gtcltk/options.tcl</tt>'</li>
  334. <li>Source code: edit file '<tt>lib/gtcltk/options.tcl</tt>' and recompile gtcltk</li>
  335. </ul>
  336. <h2>SEE ALSO</h2>
  337. The <em>gis.m</em> <a href="gm_animate.html">ANIMATION TOOL</a><br>
  338. The <em>gis.m</em> <a href="gm_georect.html">GEORECTIFY TOOL</a><br>
  339. The <em>gis.m</em> <a href="gm_profile.html">PROFILE TOOL</a><br>
  340. <P>
  341. <em><a href="g.gui.html">g.gui</a></em>: Starts the default GUI<BR>
  342. <a href="d.m.html"><em>d.m</em> GUI</a>: The old display manager GUI<BR>
  343. <a href="wxGUI.html">wxPython GUI</a>:
  344. The next generation GUI, currently under development<BR>
  345. <h2>AUTHORS</h2>
  346. Michael Barton, Arizona State University, Tempe, Arizona, USA<br>
  347. Cedric Shock, USA
  348. <p>
  349. <i>Last changed: $Date$</i>