NAME

d.what.rast - Permite la consulta interactiva de los valores y categorías, en uno o varios mapas raster, pinchando con el ratón en el monitor gráfico activo.
(GRASS Display Program)

USO

d.what.rast
d.what.rast help
d.what.rast [-1tc] [map=nombre[,nombre,...]] [fs=nombre]

DESCRIPCION

Si no se especifica los nombres de los mapas, se extraen los valores de los mapas que han sido dibujados en el monitor gráfico con d.rast.
Para salir del comando, sbe pinchase en el monitor gráfico con el botón derecho del ratón, de no hacerlo así el monitor gráfico quedaría colgado dando problemas en su uso posterior.
 

OPCIONES

Flags:

-1
Identifica sólo un punto.
-t
             Simplifica la salida
-c
Obtiene los valores de fila y columna en lugar de latitud y longitud.

Parámetros:

map=nombre

                Hasta 15 mapas raster
fs=nombre
  Separador de campos cuando la opción -t está activada

 
Por defecto, la salida que produce son las coordenadas UTM del punto seleccionado, el valor de la categoría y la etiqueta.
 

EJEMPLO

It is helpful, but not necessary, to first display a map to be used for reference in the active display frame before running d.what.rast. For example, the user might type the following series of commands and receive the output below.
d.rast map=soils
To first display the soils map in the active frame.
d.what.rast map=soils,aspect
User then moves the mouse to desired location on the displayed soils map layer, and presses the left mouse button to query the category contents of the soils and aspect maps at this geographic location. The program then outputs the below information to the user's terminal.
617112(E) 3732014(N) 
soils in PERMANENT (44)Nunn clay loam, NdC 
aspect in PERMANENT (20)15 degrees north of west
The first line of output gives the easting (E) and northing (N) coordinates of the geographic location at which the user clicked the mouse. The subsequent two lines give the map name and mapset, map category value (within parentheses), and map category label corresponding to this user-selected map location, for each of the maps queried by the user.

The query may be repeated as often as desired using the left mouse button. The right button on the mouse is used to quit the d.what.rast session.

Users can set the -t flag to obtain a terse output from d.what.rast. This is useful when the user wishes output to be parsed by another program (like awk). If the -t flag is set, users can also select the field separator used (with the fs=name option), or elect to use the default : field separator. In this case, the command

d.what.rast -t map=soils,aspect
produces output in the form shown below. The first line of output gives the easting, northing, and the mouse button return value (see NOTES, below). Each subsequent line gives the map name and its mapset, the category value, and category label of the point specified on the user-named raster map layers. The default output field separator, a colon, is used since none was specified on the command line.
617112:3732014:1 
soils@PERMANENT:44:Nunn clay loam, NdC 
aspect@PERMANENT:20:15 degrees north of west
Users can also use this program inside of shell scripts that require as input a map category value and a mouse button depressed. Users can choose an option to run d.what.rast only once, and return only the map category value found and the number of the mouse button depressed.

NOTES

Mouse button return values are as follows: 0 indicates no button was pressed, 1 indicates that the left mouse button was pressed, 2 indicates the middle button was pressed, and 3 indicates that the right mouse button was pressed.

d.what.rast will always print its output to the terminal screen. d.what.rast output can be redirected into a file; however, if it is, the output will go both to the screen and to the file. For example:

d.what.rast map=soils,aspect > what.out
will both send d.what.rast output to the screen and capture its output in the file named what.out.
 

VER

d.rast
d.what.vect
d.where
g.region
parser

AUTOR

Michael Shapiro, U.S. Army Construction Engineering Research Laboratory