← Back to branch summary

~ubuntu-branches/ubuntu/vivid/grass/vivid-proposed

« back to all changes in this revision

Viewing changes to vector/v.external/v.external.html

  • Committer: Package Import Robot
  • Author(s): Bas Couwenberg
  • Date: 2015-02-20 23:12:08 UTC
  • mfrom: (8.2.6 experimental)
  • Revision ID: package-import@ubuntu.com-20150220231208-1u6qvqm84v430b10
Tags: 7.0.0-1~exp1
* New upstream release.
* Update python-ctypes-ternary.patch to use if/else instead of and/or.
* Drop check4dev patch, rely on upstream check.
* Add build dependency on libpq-dev to grass-dev for libpq-fe.h.
* Drop patches applied upstream, refresh remaining patches.
* Update symlinks for images switched from jpg to png.

Show diffs side-by-side

added added

removed removed

Lines of Context:
vector/v.external/v.external.html
 
1
<h2>DESCRIPTION</h2>
 
2
 
 
3
<em>v.external</em> creates new vector map as a link to external OGR
 
4
layer or PostGIS feature table. OGR (Simple Features Library) is part
 
5
of the
 
6
<a href="http://www.gdal.org">GDAL</a> library, so you need to install
 
7
GDAL to use <em>v.external</em> for external OGR layers. Note that a
 
8
PostGIS feature table can be linked also using built-in <em>GRASS-PostGIS
 
9
data driver</em> (requires GRASS to be built with PostgreSQL support).
 
10
 
 
11
<h3>Supported OGR vector formats</h3>
 
12
 
 
13
To list supported OGR formats, type
 
14
 
 
15
<div class="code"><pre>
 
16
v.external -f
 
17
</pre></div>
 
18
 
 
19
For details see
 
20
<a href="http://www.gdal.org/ogr/ogr_formats.html">OGR web site</a>.
 
21
 
 
22
<h2>EXAMPLES</h2>
 
23
 
 
24
<h3>ESRI Shapefile</h3>
 
25
 
 
26
Assuming that 'test_shape.shp' is located in directory
 
27
'/home/user/shape_data'.
 
28
 
 
29
<div class="code"><pre>
 
30
v.external input=/home/user/shape_data layer=test_shape output=grass_map 
 
31
</pre></div>
 
32
 
 
33
<h3>MapInfo files</h3>
 
34
 
 
35
<div class="code"><pre>
 
36
v.external input=./ layer=mapinfo_test output=grass_map
 
37
</pre></div>
 
38
 
 
39
<h3>SDTS files</h3>
 
40
 
 
41
Note: you have to select the CATD file
 
42
 
 
43
<div class="code"><pre>
 
44
v.external input=CITXCATD.DDF output=cities
 
45
</pre></div>
 
46
 
 
47
<h3>TIGER files</h3>
 
48
 
 
49
<div class="code"><pre>
 
50
v.external input=input/2000/56015/ layer=CompleteChain,PIP output=t56015_all
 
51
</pre></div>
 
52
 
 
53
<h3>PostGIS layers</h3>
 
54
 
 
55
PostGIS links are by default created by built-in PostGIS support,
 
56
ie. using <em>GRASS-PostGIS data driver</em>. If the environment
 
57
variable <tt>GRASS_VECTOR_OGR</tt> exists, or GRASS is compiled
 
58
without PostgreSQL support then GRASS will use OGR-PostgreSQL driver
 
59
for creating a link.
 
60
 
 
61
<div class="code"><pre>
 
62
v.external input="PG:host=localhost user=postgres dbname=postgis" layer=polymap
 
63
</pre></div>
 
64
 
 
65
<h2>NOTES</h2>
 
66
 
 
67
The simple feature data model used by OGR (or PostGIS) is very
 
68
different from the topological format used by GRASS. Instead of true
 
69
topology, so called 'pseudo topology' is created for data linked by
 
70
<em>v.external</em>. User should learn the difference between those
 
71
two formats, because some modules working correctly with GRASS native
 
72
data, can produce wrong results with input vector maps created
 
73
by <em>v.external</em>.
 
74
 
 
75
<p>See <em><a href="v.db.connect.html">v.db.connect</a></em> for an example of
 
76
maintaining attributes in external DBMS in also writable mode.
 
77
 
 
78
<h2>REFERENCES</h2>
 
79
 
 
80
<a href="http://www.gdal.org/ogr/ogr__api_8h.html">OGR vector library C API</a> documentation
 
81
 
 
82
<h2>SEE ALSO</h2>
 
83
 
 
84
<em>
 
85
  <a href="v.external.out.html">v.external.out</a>,
 
86
  <a href="v.clean.html">v.clean</a>,
 
87
  <a href="v.db.connect.html">v.db.connect</a>,
 
88
  <a href="v.in.db.html">v.in.db</a>,
 
89
  <a href="v.in.ogr.html">v.in.ogr</a>,
 
90
  <a href="v.out.ogr.html">v.out.ogr</a>
 
91
</em>
 
92
 
 
93
<p>
 
94
<a href="http://www.gdal.org/ogr/">OGR Library</a>
 
95
<br>
 
96
<a href="http://postgis.org/">PostGIS</a>
 
97
 
 
98
<p>
 
99
See
 
100
also GRASS <a href="http://grasswiki.osgeo.org/wiki/Working_with_external_data_in_GRASS_7">user wiki page</a> for more examples.
 
101
 
 
102
<h2>AUTHORS</h2>
 
103
 
 
104
Radim Blazek, ITC-Irst, Trento, Italy
 
105
<br>
 
106
PostGIS support by Martin Landa, Czech Technical University in Prague, Czech Republic
 
107
 
 
108
<p>
 
109
<i>Last changed: $Date: 2014-11-26 18:33:23 +0100 (Wed, 26 Nov 2014) $</i>