NOMBRE

d.what.v.pg - Consulta interactiva mediante un monitor gafico de los valores de una base de datos asociados con los polígonos de un mapa vectorial.

USO

d.what.v.pg
d.what.v.pg help
d.what.v.pg [-f] tab=name col=name map=name [color=name] [fillcolor=name] [hv=h/v]

ALTERNATIVO

d.what.v.pg -s help
d.what.v.pg -s [-f] sql=filename map=name

DESCRIPCION

Obtiene los valores asociados al polígono en el que se encuentra el punto que se pincha con el ratón (o a la linea más cercana en su caso) en el monitor gráfico. La base de datos es la que se ha seleccionado previamente con g.select.pg . Esta orden tiene dos modos de uso:
 

Opciones:

-s
Utilizar la opción fichero SQL
-f
Rellenar los polígonos con el color indicado

Sin fichero SQL(opción -s desactivada):


El usuario debe introducir la columna (parámetro col=), y la tabla (parámetro tab=)a la que pertenece, cuyos valores coinciden con los identificadores de los objetos en el mapa (parámetro map=). El parámetro color= indica el color con el que van a dibujarse los bordes de los polígonos o las lineas, el parámetro fillcolor= indica que color se utilizará para rellenar los polígonos si la opción -f está activada. Si no se indican valores para color y fillcolor se utilizarán los valores por defecto. Las opciones posibles en ambos casos son: red,orange,yellow,green,blue,indigo,white,black,brown, magenta,aqua,gray,grey.

Por defecto color=red y fillcolor=grey.

Finalmente, hv= indica si la salida se hará como una tabla de dos columnas (v) o de dos filas (h).

Esta opción produce el mismo resultado que la llamada SQL
 

select * from tab where col=?


Es preferible utilizar la opción -s ya que proporciona mucha mayor flexibilidad.
 

Con fichero SQL (opción -s activada):


Si la consulta requiere la unión de una o más tablas, debe utilizarse la opción  -s para leer un fichero con una consulta previamente preparada. En este caso el usuario debe especificar el nombre del mapa vectorial que se va a enlazar. Los identificadores de los objetos en dicho mapa deben corresponder de manera biunívoca con, al menos, una columna de una de las tablas en la base de datos enlazada. Debe además indicarse el fichero que contien la orden SQL que se va a pasar a la base de datos (opción sql=). En dicha orden el identificador del objeto sobre el que se ha pinchado se simboliza con el signo de interrogación (?). Los parámetros color, fillcolor y hv tiene el mismo significado que en la opción aterior salvo que ahora la opción por defecto para color es yellow.
 

EJEMPLO
 

d.what.v.pg -s sql=consulta.sql map=termuni


consulta.sql:
select resumen.* where resumen.ident=?

Resultado: Obtiene todos los atributos de la tabla resumen asociadas con el objeto (punto, linea o polígono) más cercano al punto donde se ha pinchado. Los valores de la columna ident en la tabla resumen coinciden con los identificadores de los objetos en el mapa.
 

EJEMPLO

d.what.v.pg -s sql=consulta.sql map=termuni

consulta.sql:
select resumen.*, inmigracion.* where resumen.ident=? and resumen.ident=inmigracion.ident

Resultado: Obtiene todos los atributos de las tablas resumen e inmigracion asociadas con el objeto (punto, linea o polígono) más cercano al punto donde se ha pinchado.
 
 

NOTA

Requiere Postgres como gestor de bases de datos.
La versión original de esta página de manual contiene algunos fallos ya que procede de una versión anterior para un gestor de base de datos diferentes

VER

g.column.pg, g.select.pg, g.stats.pg, g.table.pg, d.rast.pg, d.site.pg, d.vect.pg, d.what.r.pg, d.what.s.pg, r.reclass.pg, r.rescale.pg, v.reclass.pg

AUTOR

Original Informix SQL-tools: James A. Farley, Wang Song, and W. Fredrick Limp University of Arkansas, CAST

Postgres modifications: Janne Soimasuo, Faculty of Forestry, University of Joensuu, Finland.

Updated to GRASS 5 by Alex Shevlakov (sixote@yahoo.com)