NOMBRE

g.region - Programa para manipular la región activa de GRASS.
 

USO

g.region
g.region help
g.region [-adgplmu] [region=name] [raster=name] [vector=name] [sites=name] [3dview=name] [n=value] [s=value] [e=value] [w=value] [res=value] [nsres=value] [ewres=value] [zoom=name] [align=name] [save=name]

DESCRIPCION

Permite al usuario manipular todas las variables que definen la región activa. Estos incluyen los límites Norte (n=), Sur(s=), Este(e=) y Oeste (w=) y el tamaño de pixel en latitud (nsres=), longitud (ewres=) o ambas (res=).Toda esta información puede almacenarse (save=) y reutilizarse posteriormente (region=). Puede tambien tomarse como parámetros de la región activa los de un mapa raster (raster=),  vectorial (vector=), de puntos (sites=), los de una visión 3D  (3dview=) o los de la región por defecto (opción -d).

Los parámetros save= y region= permiten almacenar diversos parámetros de región activa y utilizar el más conveniente en cada momento. Sin embaergo sólo puede utilizarse una región activa cada vez.

El parámetro zoom= establece la región como la ventana más pequeña que contiene todos los valores distintos de 0 en el mapa raster.
 

El parámetro align=name toma la resolucíón del mapa raster nombrado y alinea la región activa con el límite más cercano del mapa raster nombrado.

 

USO INTERACTIVO: MENU PRINCIPAL

El menu principal consiste en una primera sección en la que se informa al usuario de cual es la región activa, se ofrecen a continuación varias opciones que son similares a algunas de las opciones disponibles en linea de comandos: 
------------------------------------------------------------
|                    REGION FACILITY                       |
| LOCATION: sample                         MAPSET: grass   |
|                                                          |
| CURRENT REGION: N=5167600  S=5156755  RES=50  ROWS=216   |
|                 E=729314   W=705924   RES=50  COLS=467   |
| PROJECTION: 1 (UTM)                                      |
| ZONE: 13                                                 |
| DATUM: WGS84                                             |
|                                                          |
| Please select one of the following options               |
|                                                          |
|     Current Region              Region Database          |
|                                                          |
| 1 Modify current region     6 Save current region in     |
|   directly                    the database               |
|                                                          |
| 2 Set from default region   7 Create a new region        |
|                                                          |
| 3 Set from a database       8 Modify an existing region  |
|   region                                                 |
|                                                          |
| 4 Set from a raster map                                  |
|                                                          |
| 5 Set from a vector map                                  |
|                                                          |
| RETURN to quit                                           |
------------------------------------------------------------

DEFINICIONES

Region:
Area geográfica con límites (Norte, Sur, Este y Oeste) definidos basados en un determinado sistema de coordenadas y proyección. Cada región tiene asociados dos valores de resolución (Este-Oeste y Norte-Sur) que define el tamaño de celda en los mapas raster y no tienen por que ser iguales. Este tamaño afectará a todas las operaciones posteriores (importar, exportar, analizar, visualizar, almacenar, etc.)
Región por defecto:
En GRASS cada LOCATION tiene una región por defecto almacenada en el fichero DEFAULT_WIND del mapset PERMANENT. Se considera como región de partida.
Región activa:
Cada mapset tiene al mismo tiempo una región activa almacenada en el fichero WIND bajo dicho mapset. Define el area activa de cada usuario.
Conjunto de regiones predifinidas:
Cada MAPSET contiene un conjunto de regiones predefinidas almacenadas que pueden ser utilizadas como región activa mediante la opción region= de GRASS

PANTALLA DE EDICION DE REGION

El usuario puede modificar manualmente una región utilizando el menú predefinido que se muestra a continuación: 
---------------------------------------------------------------
|                         IDENTIFY REGION                     |
|                                                             |
|           ===========  DEFAULT REGION  ==========           |
|           |    Default North: 3402025.00        |           |
|           |                                     |           |
|           |          ===YOUR REGION===          |           |
|           |          |  NORTH EDGE   |          |           |
|           |          |  3402025.00_  |          |           |
|           |          |               |          |           |
| Def West: |WEST EDGE |               |EAST EDGE | Def.East: |
| 233975.00 |233975.00_|               |236025.00_| 236025.00 |
|           |          |  SOUTH EDGE   |          |           |
|           |          |  3399975.00_  |          |           |
|           |          =================          |           |
|           |                                     |           |
|           |    Default South: 3399975.00        |           |
|           =======================================           |
|                                                             |
|              Default   GRID RESOLUTION   Region             |
|               50.00   --- East-West ---  50.00__            |
|               50.00   -- North-South --  50.00__            |
|                                                             |
|                                                             |
|     AFTER COMPLETING ALL ANSWERS, HIT <ESC> TO CONTINUE     |
---------------------------------------------------------------
Los campos NORTH EDGE, SOUTH EDGE, WEST EDGE y EAST EDGE, son los límites de la región modificables por el usuario. Los campos Default North, Default South, Def West and Def East son los límites de la región por defecto que se muestran como referencia y que no pueden ser alterados. Los dos campos GRID RESOLUTION muestran el tamaño de pixel actual (modificable) y por defecto (no modificable).

OPCIONES DE GESTION DE REGIONES

El menu interactivo de g.region permite las siguientes opciones:
  1. 1 Modificar la región activa a mano, introduciendo directamente los valores.
  2. 2 Utilizar la región por defecto.
  3. 3 Utilizar una región almacenada previamente como un fichero en el mapset actual o en otros situados en la LOCATION de trabajo.
  4. 4 Utilizar como región activa los límites y resolución de un mapa raster.
  5. 5 Utilizar como región activa los límites de un fichero vectorial
  6. 6 Almacenar la región activa en un fichero de región
  7. 7 Crea una nueva región con el menu de editar regiones. Tras introducir los valores el programa pregunta al usuario si debe usar la región creada como región activa.
  8. 8 Modifica una región previamente guardada con el menu de editar regiones. Tras realizar los cambios el programa pregunta al usuario si debe usar la región modificada como región activa.

USO NO-INTERACTIVO

En linea de comandos, el usuario puede modificar la región activa pasando una serie de opciones y parámetros. Los parámetros ya se presentaron al comienzo de esta página.

Opciones:

-a
Alinea la region a la resolución establecida por el usuario. Por defecto se alinea cono los límites de la región.
-d
Iguala los valores de la región activa a los de la región por defecto.
-g
Presenta los valores de la región activa en estilo shell script de forma que puedan reintroducirse a g.region en linea de comandos.
-p
Presenta los valores de la región activa
-l
Presenta los valores de la región activa en coordenadas lat/long.
-m
Presenta la resolución en metros (utilizando lineasgeodesica). Si no se especifica otra opción el resultado se da en estilo shell script .
-u
No actualiza la región activa con los valores establecidos por las otras opciones. Esta opción es útil cuando sólo se quiere grabar o presentar en pantalla una región.

EJEMPLOS

g.region n=7360100 e=699000
Modifica los límites Norte y Este, dejan los demas valores como estaban.
g.region -dp s=698000
Copia los valores de la región por defectoa la región actual, posteriormente modifica  el límite meridional y a continuación presenta la región resultante.
g.region n=n+1000 w=w-500
Los nuevos valores pueden también establecerse como función de los anteriores.
g.region n=s+1000 e=w+1000
En este caso los nuevos valores se establecen coomo función de los anteriores valores de otros parámetros.Esto permite generar regiones de un tamaño predeterminado a partir de un punto que se toma como esquina de la región.

 
g.region raster=soils
Hace que la región activa sea equivalente a los límites y resolución del mapa raster soils.
g.region raster=soils zoom=soils
En primer lugar se determinan los límites y resolución del mapa raster soils, posteriormente la opción zoom establece la región activa cómo la ventana mima que contiene todos los valores distintos de 0 en el mapa  soils.
g.region -up raster=soils
Se establece una región cono los valores del mapa raster soils. La opción -u evita su utilización como región activa. Sin embargo la opción -p hace que el programa presente en pantalla las especificaciones de la región definida.
g.region -u raster=soils zoom=soils save=soils
Establece una región como la ventana más pequeña que contiene todos los valores diferentes de 0 en le mapa raster soils, la almacena en un fichero de región que se llama también soils. Sin embargo estas especificaciones no se usan para modificar la región activa (opción -u).
g.region -p
Escribirá los parámetros de la región activa con el formato:
projection:     1 (UTM)
zone:   15
datum:  WGS84
north:  4294050.00
south:  4249950.00
east:   526050.00
west:   500950.00
nsres:  100.00
ewres:  100.00
rows:   441
cols:   251
g.region -pm
Escribirá los parámetros de la región activa como:
projection: 3 (Latitude-Longitude)
zone:       0
ellipsoid:  wgs84
north:      90N
south:      40N
west:       20W
east:       20E
nsres:      928.73944902
ewres:      352.74269109
rows:       6000
cols:       4800
La resolución se muestra en metros no en grados decimales.
g.region -g
La opción -g escribe la región con el formato:
n=4294050.00
s=4249950.00
e=526050.00
w=500950.00
nsres=100.00
       ewres=100.00
que no incluye número de filas y columnas, pero permite reintroducirlo en  g.region mediante la linea de comandos.
La opción -p (o -g) se ejecuta al final de forma que todos los ajustes se hacen antes de imprimir.

NOTA

Tras actualizar los valores, se procede a un reajuste de los mismos para asegurar que la distancia entre los límites Norte y Sur es múltiplo de la resolución Norte-Sur y que la distancia entre los límites Este y Oeste es múltipl de la resolución Este-Oeste.

Con la opción -a los valores se ajustan para tener un número par de filas y columnas.

La opción  -m dará la resolución en metrosflag will report the region resolution in meters. The resolution is calculated by averaging the resolution at the region boundaries. This resolution is calculated by dividing the geodesic distance in meters at the boundary by the number of rows or columns. For example the east / west resolution (ewres) is determined from an average of the geodesic distances at the North and South boundaries divided by the number of columns.

En versiones de GRASS anteriores a la 5.beta.11 es necesario borrar el monitor gráfico  d.erase  para que los ca,bios en la región activa afecten a la visualización de mapas.

VER

d.display
d.zoom
g.access
g.mapsets

AUTOR

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