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.
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.
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
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
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: