Usage as a Command Line Interface (CLI)

Once installed, geoextent is accessible as acommand line tool. This document is intended to demonstrate the library usage as CLI.

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

A useful way to navigate the library CLI usage is through the help command -h/--help which will proivde information about how to use the it, optinal arguments and current supported formats.

In [1]:
python3 -m geoextent --help
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] [-b] [-t] [-input= '[filepath|input file]']

optional arguments:
  -h, --help            show help message and exit
  -formats              show supported formats
  -b, --bounding-box    extract spatial extent (bounding box)
  -t, --time-box        extract temporal extent
  -input= INPUT= [INPUT= ...]
                        input file or path

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)

The following examble shows how to 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.

In [2]:
python3 -m geoextent -b -input= 'tests/testdata/geojson/muenster_ring_zeit.geojson'
ERROR:geoextent.lib.extent:
{'format': 'application/geojson', 'crs': 4326, 'bbox': [7.60168075561523, 51.9488147720619, 7.64725685119629, 51.9746240298775]}

The following examble shows how to extract time interval from a single file

In [3]:
python3 -m geoextent -t -input= 'tests/testdata/geojson/muenster_ring_zeit.geojson'
{'format': 'application/geojson', 'tbox': ['2018-11-14', '2018-11-14']}

The following examble shows how to extract box and time interval from a single file

In [4]:
python3 -m geoextent -b -t -input= 'tests/testdata/geojson/muenster_ring_zeit.geojson'
ERROR:geoextent.lib.extent:
{'format': 'application/geojson', 'crs': 4326, 'tbox': ['2018-11-14', '2018-11-14'], 'bbox': [7.60168075561523, 51.9488147720619, 7.64725685119629, 51.9746240298775]}
ERROR:geoextent.lib.extent: