.makeGVector

Create a <code>GVector</code> from a vector existing in the current GRASS session.

internal

Processing of large-in-memory/large-on disk rasters and spatial
vectors using 'GRASS' <https://grass.osgeo.org/>. Most functions in the
'terra' package are	recreated. Processing of medium-sized and smaller
spatial objects will nearly always be faster using 'terra' or 'sf', but
for large-in-memory/large-on-disk objects, 'fasterRaster' may be faster.
To use most of the functions, you must have the stand-alone version (not
the 'OSGeoW4' installer version) of 'GRASS' 8.0 or higher.

Adam B. Smith

fasterRaster

Faster Raster and Spatial Vector Processing Using 'GRASS'

.makeGVector function

<dl><dt>src</dt>
<dd>Character: The name of the vector in GRASS.</dd>
<dt>table</dt>
<dd>A <code>data.table</code>, <code>data.frame</code>, <code>GVector</code> with a table, or character. This can be <code>data.table(NULL)</code> or <code>data.frame(NULL)</code> if there is no table associated with the vector. If a character, this is interpreted as the name of the table in GRASS.</dd>
<dt>build</dt>
<dd>Logical: If <code>TRUE</code> (default), build topology using GRASS tool <code>v.build</code>.</dd>
<dt>extensive</dt>
<dd>Logical: If <code>TRUE</code>, do extensive topological checks using <code>v.build</code>. The default is <code>FALSE</code>.</dd>
<dt>cats</dt>
<dd><code>NULL</code> (default) or an integer vector: Values of the "cats" (categories) of the vector in GRASS. This is useful only for speeding up the <code>GVector</code> creation process when the "cats" have already been ascertained.</dd>
<dt>fail</dt>
<dd>Logical: If <code>TRUE</code> (default), and the vector either has a 0 east-west or north-south extent, then exit the function with an error. If <code>fail</code> is <code>FALSE</code>, then display a warning and return <code>NULL</code>.</dd></dl>

Arguments

Create a GVector — .makeGVector

<dl>

<dt>src</dt>
<dd>Character: The name of the vector in GRASS.</dd>


<dt>table</dt>
<dd>A <code>data.table</code>, <code>data.frame</code>, <code>GVector</code> with a table, or character. This can be <code>data.table(NULL)</code> or <code>data.frame(NULL)</code> if there is no table associated with the vector. If a character, this is interpreted as the name of the table in GRASS.</dd>


<dt>build</dt>
<dd>Logical: If <code>TRUE</code> (default), build topology using GRASS tool <code>v.build</code>.</dd>


<dt>extensive</dt>
<dd>Logical: If <code>TRUE</code>, do extensive topological checks using <code>v.build</code>. The default is <code>FALSE</code>.</dd>


<dt>cats</dt>
<dd><code>NULL</code> (default) or an integer vector: Values of the "cats" (categories) of the vector in GRASS. This is useful only for speeding up the <code>GVector</code> creation process when the "cats" have already been ascertained.</dd>


<dt>fail</dt>
<dd>Logical: If <code>TRUE</code> (default), and the vector either has a 0 east-west or north-south extent, then exit the function with an error. If <code>fail</code> is <code>FALSE</code>, then display a warning and return <code>NULL</code>.</dd>

</dl>

.makeGVector: Create a GVector

Description

Usage

Value

Arguments

See Also