Command-Line Interface (CLI)

Basics

geoextent can be called on the command line with this command:

usage: geoextent [-h] [--formats] [--version] [--debug] [-b] [-t] [input file]']
files

input file or path

-h, --help

show help message and exit

--formats

show supported formats

--version

show installed version

--debug

turn on debug logging, alternatively set environment variable GEOEXTENT_DEBUG=1

-b, --bounding-box

extract spatial extent (bounding box)

-t, --time-box

extract temporal extent

Examples

Note

Depending on the local configuration, geoextent might need to be called with the python interpreter prepended:

python -m geoextent …

Show help message

geoextent -h

geoextent is a Python library for extracting geospatial and temporal extents of a file or a directory of multiple geospatial data formats.

usage: geoextent [-h] [--formats] [--version] [--debug] [-b] [-t] [input file]']

positional arguments:
  files               input file or path

optional arguments:
  -h, --help          show help message and exit
  --formats           show supported formats
  --version           show installed version
  --debug             turn on debug logging, alternatively set environment
                      variable GEOEXTENT_DEBUG=1
  -b, --bounding-box  extract spatial extent (bounding box)
  -t, --time-box      extract temporal extent

By default, both bounding box and temporal extent are extracted.

Examples:

geoextent path/to/geofile.ext
geoextent -b path/to/directory_with_geospatial_data
geoextent -t path/to/file_with_temporal_extent
geoextent -b -t path/to/geospatial_files


Supported formats:
- GeoJSON (.geojson)
- Tabular data (.csv)
- Shapefile (.shp)
- GeoTIFF (.geotiff, .tif)

Extract bounding box from a single file

Note

You can find the file used in the examples of this section from muenster_ring_zeit. Furthermore, for displaying the rendering of the file contents, see rendered blob.

geoextent -b muenster_ring_zeit.geojson

Output:

{'format': 'application/geojson',
 'bbox': [7.60168075561523,
  51.9488147720619,
  7.64725685119629,
  51.9746240298775],
 'crs': 4326}

Extract time interval from a single file

Note

You can find the file used in the examples of this section from muenster_ring_zeit. Furthermore, for displaying the rendering of the file contents, see rendered blob.

geoextent -t muenster_ring_zeit.geojson

Output:

{'format': 'application/geojson',
 'tbox': ['2018-11-14', '2018-11-14'],
 'crs': 4326}

Extract both bounding box and time interval from a single file

Note

You can find the file used in the examples of this section from muenster_ring_zeit. Furthermore, for displaying the rendering of the file contents, see rendered blob.

geoextent -b -t muenster_ring_zeit.geojson
{'format': 'application/geojson',
 'tbox': ['2018-11-14', '2018-11-14'],
 'bbox': [7.60168075561523,
  51.9488147720619,
  7.64725685119629,
  51.9746240298775],
 'crs': 4326}

Debugging

You can enable detailed logs by passing the --debug option, or by setting the environment variable GEOEXTENT_DEBUG=1.

geoextent --debug -b -t muenster_ring_zeit.geojson

GEOEXTENT_DEBUG=1 geoextent -b -t muenster_ring_zeit.geojson