v.out.ogr

Langue: en

Autres versions - même langue

Version: 370932 (fedora - 01/12/10)

Section: 1 (Commandes utilisateur)

NAME

v.out.ogr - Converts to one of the supported OGR vector formats.

KEYWORDS

vector, export

SYNOPSIS

v.out.ogr
v.out.ogr help
v.out.ogr [-cep] input=name [type=string[,string,...]] dsn=string [olayer=string] [layer=integer] [format=string] [dsco=string[,string,...]] [lco=string[,string,...]] [--verbose] [--quiet]

Flags:

-c

Export features with category (labeled) only. Otherwise all features are exported
-e

Use ESRI-style .prj file format (applies to Shapefile output only)
-p

Export lines as polygons
--verbose

Verbose module output
--quiet

Quiet module output

Parameters:

input=name

Name of input vector map
type=string[,string,...]

Type
Feature type. Combination of types is not supported by all formats.
Options: point,kernel,centroid,line,boundary,area,face
Default: line,boundary
dsn=string

OGR output datasource name
For example: ESRI Shapefile: filename or directory for storage
olayer=string

OGR layer name. If not specified, input name is used.
For example: ESRI Shapefile: shapefile name
layer=integer

Layer number
A single vector map can be connected to multiple database tables. This number determines which table to use.
Default: 1
format=string

OGR format
Options: ESRI_Shapefile,MapInfo_File,TIGER,S57,DGN,Memory,BNA,CSV,GML,GPX,KML,GeoJSON,Interlis_1,Interlis_2,GMT,SQLite,ODBC,PostgreSQL,MySQL,DXF,Geoconcept,GeoRSS,GPSTrackMaker,
Default: ESRI_Shapefile
dsco=string[,string,...]

OGR dataset creation option (format specific, NAME=VALUE)
Default:
lco=string[,string,...]

OGR layer creation option (format specific, NAME=VALUE)
Default:

DESCRIPTION

v.out.ogr converts GRASS vector data to OGR format. OGR (Simple Features Library) is part of the GDAL library, so you need to install gdal to use v.out.ogr.

Supported OGR Vector Formats

ESRI Shapefile
CSV
GML
KML
Mapinfo File
PostgreSQL/PostGIS
TIGER

For further available drivers go here.

NOTES

To export areas with holes into, e.g., a Shapefile, while keeping the holes as holes, the flag -c has to be used.

EXAMPLES

Export to Shapefile

Export lines from GRASS vector map to Shapefile format (generates /tmp/testogr.shp and related files):
v.out.ogr input=multi type=line dsn=/tmp olayer=testogr
Export areas from GRASS vector map to Shapefile format (generates /tmp/testogr.shp and related files):
v.out.ogr input=multi type=area dsn=/tmp olayer=testogr
Export 3D lines from GRASS vector map to Shapefile format:
v.out.ogr input=lines_3d type=line dsn=/tmp olayer=testogr lco="SHPT=ARCZ"

Export to GML

Export lines from GRASS vector map to GML format (generates /tmp/testogr.gml file with layer 'testogr'):
v.out.ogr input=multi type=line dsn=/tmp/testogr.gml olayer=testogr format=GML

Export to PostgreSQL/PostGIS

Export areas from GRASS vector map directly to PostGIS:
v.out.ogr input=polygons type=area rs

          dsn="PG:host=localhost dbname=postgis user=postgres" rs

          olayer=polymap format=PostgreSQL

Export to KML (Google Earth)

Export faces (3D vectors) from GRASS vector map in KML format for Google Earth:
v.out.ogr in=buildings_3d dsn=buildings_3d.kml olayer=buildings_3d format=KML type=face

REFERENCES

OGR vector library
OGR vector library C API documentation

SEE ALSO

v.external, v.in.ogr

AUTHORS

Radim Blazek, ITC-Irst, Trento, Italy
Some contributions: Markus Neteler, Martin Landa

Last changed: $Date: 2007-09-12 13:34:50 +0200 (Wed, 12 Sep 2007) $

Full index

© 2003-2008 GRASS Development Team