v.in.gbif

importing of GBIF species distribution data

v.in.gbif [-cr] input=name output=name [dir=name] [--overwrite] [--verbose] [--quiet] [--qq] [--ui]

Example:

v.in.gbif input=name output=name

grass.script.run_command("v.in.gbif", input, output, dir=None, flags=None, overwrite=False, verbose=False, quiet=False, superquiet=False)

Example:

gs.run_command("v.in.gbif", input="name", output="name")

Parameters

Command linePython (grass.script)

input=name [required]
    Name of input file
output=name [required]
    name of imported GBIF data set
dir=name
    Directory where the output will be found
-c
    Create GDAL VRT data set of GBIF data
-r
    Reproject data on-the-fly if no latlon (WGS84) location
--overwrite
    Allow output files to overwrite existing files
--help
    Print usage summary
--verbose
    Verbose module output
--quiet
    Quiet module output
--qq
    Very quiet module output
--ui
    Force launching GUI dialog

input : str, required
    Name of input file
    Used as: input, file, name
output : str, required
    name of imported GBIF data set
    Used as: output, vector, name
dir : str, optional
    Directory where the output will be found
    Used as: input, dir, name
flags : str, optional
    Allowed values: c, r
    c
        Create GDAL VRT data set of GBIF data
    r
        Reproject data on-the-fly if no latlon (WGS84) location
overwrite: bool, optional
    Allow output files to overwrite existing files
    Default: False
verbose: bool, optional
    Verbose module output
    Default: False
quiet: bool, optional
    Quiet module output
    Default: False
superquiet: bool, optional
    Very quiet module output
    Default: False

DESCRIPTION

v.in.gbif imports GBIF species distribution data. GBIF data is by definition in WGS84 geographic coordinates.

The species distribution data downloaded from GBIF hast to be unzipped before importing the csv file.

v.in.gbif saves the data to an intermediate GDAL VRT - Virtual Datasource which will be imported by v.in.ogr. The VRT data set can be copied to a user defined directory by -c flag and used in any GDAL aware software. As some column names in the original data set are similar to SQL reserverd key words, the columns will renamed with the prefix g_.

By the -r flag an on-the-fly reprojection of the data can be invoked using v.import, if the location is not in WGS84. Quality of on-the-fly reprojection is not garanteed. The traditional reprojection procedure in GRASS GIS can also be used instead.

EXAMPLE

  # import GBIF data
  v.in.gbif input=0004248-150811131857512.csv output=chondrilla

  # create GDAL VRT files based upon GBIF data in user defined directory by -c flag
  v.in.gbif -c input=0004248-150811131857512.csv /
  output=chondrilla dir=C:\data\

AUTHOR

Helmut Kudrnovsky

SOURCE CODE

Available at: v.in.gbif source code (history)
Latest change: Thursday Feb 20 13:02:26 2025 in commit 53de819