v.check.federal_state - GRASS manual

NAME

v.check.federal_state - Checks in which German federal state an area of interest is located.

KEYWORDS

vector, import, federal state, administrative boundaries, open-geodata-germany

SYNOPSIS

v.check.federal_state

v.check.federal_state --help

v.check.federal_state [-g] aoi=name [federal_states=name] [output=name] [federal_state_file=name] [--overwrite] [--help] [--verbose] [--quiet] [--ui]

Flags:

-g: Print the stats in shell script style
--overwrite: Allow output files to overwrite existing files
--help: Print usage summary
--verbose: Verbose module output
--quiet: Quiet module output
--ui: Force launching GUI dialog

Parameters:

aoi=name [required]: Name of input vector map; Area of interest (vector map in GRASS DB) to check federal state for.
federal_states=name: Name of input vector map; Federal states as vector map in GRASS DB. Can be generated by running module once with output option.
output=name: Name for output vector map of federal state boundaries (if saving desired)
federal_state_file=name: The path for the output file for saving federal states overlapping with the AOI

DESCRIPTION
EXAMPLE
SEE ALSO
AUTHORS

DESCRIPTION

v.check.federal_state checks in which German federal state an area of interest is located. The vector map aoi (area of interest) has to be given in the GRASS DB. The data for the federal states boundaries are downloaded from the BKG. To speed up the module, the federal state boundaries can als be given as optional input: federal_states. To generate this input the module can be run once with the optinal option output. The returning output-map can then be used as federal_states input in following module runs (See example below). Further the optional option federal_state_file can be set. With this option the printed output (federal state of given polygon) will be written into a file, defined by federal_state_file. If the polygon is not in Germany, no file be generated.

EXAMPLE

Check federal state for a given polygon in Hamburg, named=poly_HH.

v.check.federal_state aoi=poly_HH

Check federal state for a given polygon in Hamburg and save it in a file

v.check.federal_state aoi=poly_HH federal_state_file=poly_HH_federal_state.txt

Check federal state for a given polygon in Hamburg, named 'poly_HH', and save the federal state boundaries as 'federal_states'.

v.check.federal_state aoi=poly_HH output=federal_states

Save federal states data, to avoid downloading them each time calling v.check.federal_state.

First step: Run module once, to generate federal_states output

v.check.federal_state aoi=poly_HH output=federal_states

Second step: Next time the module can be run by giving federal_states as input (faster, because this avoids downloading data each time running module)

v.check.federal_state aoi=poly_HH federal_states=federal_states

AUTHORS

Lina Krisztian, mundialis

SOURCE CODE

Available at: v.check.federal_state source code (history)

Accessed: Monday Jul 27 12:30:40 2026