General Spatial Tools

cmap_mpl2gdal	convert a matplotlib color table to a GDAL representation.
coordinate_reproject	reproject a coordinate from one CRS to another
crsConvert	convert between different types of spatial reference representations
gdal_rasterize	a simple wrapper for osgeo.gdal.Rasterize()
gdal_translate	a simple wrapper for osgeo.gdal.Translate()
gdalbuildvrt	a simple wrapper for osgeo.gdal.BuildVRT()
gdalwarp	a simple wrapper for osgeo.gdal.Warp()
haversine	compute the distance in meters between two points in latlon
ogr2ogr	a simple wrapper for osgeo.gdal.VectorTranslate() aka ogr2ogr
utm_autodetect	get the UTM CRS for a spatial object

spatialist.auxil.cmap_mpl2gdal(mplcolor, values)

convert a matplotlib color table to a GDAL representation.

Parameters:

• mplcolor (str) – a color table code

• values (list[int] | range) – the integer data values for which to retrieve colors

Returns:

the color table in GDAL format

Return type:

ColorTable

Note

This function is currently only developed for handling discrete integer data values in an 8 Bit file. Colors are thus scaled between 0 and 255.

Examples

>>> from osgeo import gdal
>>> from spatialist.auxil import cmap_mpl2gdal
>>> values = list(range(0, 100))
>>> cmap = cmap_mpl2gdal(mplcolor='YlGnBu', values=values)
>>> print(isinstance(cmap, gdal.ColorTable))
True

spatialist.auxil.coordinate_reproject(x, y, s_crs, t_crs)

reproject a coordinate from one CRS to another

Parameters:

• x (float) – the X coordinate component

• y (float) – the Y coordinate component

• s_crs (int | str | SpatialReference) – the source CRS. See crsConvert() for options.

• t_crs (int | str | SpatialReference) – the target CRS. See crsConvert() for options.

Return type:

tuple[float, float]

spatialist.auxil.crsConvert(crsIn, crsOut, wkt_format='DEFAULT')

convert between different types of spatial reference representations

Parameters:

• crsIn (int | str | SpatialReference) – the input CRS

• crsOut (str) –

  the output CRS type; supported options:

  • epsg

  • opengis

  • osr

  • prettyWkt

  • proj4

  • wkt

• wkt_format (str) – the format of the wkt string. See here for options: https://gdal.org/api/ogrspatialref.html#_CPPv4NK19OGRSpatialReference11exportToWktEPPcPPCKc

Return type:

int | str | SpatialReference

Returns:

the output CRS

Examples

convert an integer EPSG code to PROJ.4:

>>> crsConvert(4326, 'proj4')
'+proj=longlat +datum=WGS84 +no_defs '

convert the opengis URL back to EPSG:

>>> crsConvert('https://www.opengis.net/def/crs/EPSG/0/4326', 'epsg')
4326

convert an EPSG compound CRS (WGS84 horizontal + EGM96 vertical) to PROJ.4

>>> crsConvert('EPSG:4326+5773', 'proj4')
'+proj=longlat +datum=WGS84 +geoidgrids=us_nga_egm96_15.tif +vunits=m +no_defs'

spatialist.auxil.gdal_rasterize(src, dst, **kwargs)

a simple wrapper for osgeo.gdal.Rasterize()

Parameters:

• src (str | Dataset) – the input data set

• dst (str) – the output data set

• **kwargs (Any) – Additional parameters passed to osgeo.gdal.Rasterize(). See osgeo.gdal.RasterizeOptions().

Return type:

None

spatialist.auxil.gdal_translate(src, dst, **kwargs)

a simple wrapper for osgeo.gdal.Translate()

Parameters:

• src (str | Dataset) – the input data set

• dst (str) – the output data set

• **kwargs (Any) – additional parameters passed to osgeo.gdal.Translate(); see osgeo.gdal.TranslateOptions()

Return type:

None

spatialist.auxil.gdalbuildvrt(src, dst, void=True, **kwargs)

a simple wrapper for osgeo.gdal.BuildVRT()

Parameters:

• src (str | Dataset | list[str | Dataset]) – the input data set(s)

• dst (str) – the output data set

• void (bool) – just write the results and don’t return anything? If not, the spatial object is returned

• **kwargs (Any) – additional parameters passed to osgeo.gdal.BuildVRT(); see osgeo.gdal.BuildVRTOptions()

Return type:

Dataset | None

spatialist.auxil.gdalwarp(src, dst, pbar=False, **kwargs)

a simple wrapper for osgeo.gdal.Warp()

Parameters:

• src (str | Dataset | list[str | Dataset]) – the input data set

• dst (str) – the output data set

• pbar (bool) – add a progressbar?

• **kwargs (Any) – additional parameters passed to osgeo.gdal.Warp(); see osgeo.gdal.WarpOptions()

Return type:

None

spatialist.auxil.haversine(lat1, lon1, lat2, lon2)

compute the distance in meters between two points in latlon

Parameters:

• lat1 (float) – the latitude of point 1

• lon1 (float) – the longitude of point 1

• lat2 (float) – the latitude of point 2

• lon2 (float) – the longitude of point 2

Return type:

float

Returns:

the distance between point 1 and point 2 in meters

spatialist.auxil.ogr2ogr(src, dst, **kwargs)

a simple wrapper for osgeo.gdal.VectorTranslate() aka ogr2ogr

Parameters:

• src (str | Dataset) – the input data set

• dst (str) – the output data set

• **kwargs (Any) – additional parameters passed to osgeo.gdal.VectorTranslate(); see osgeo.gdal.VectorTranslateOptions()

Return type:

None

spatialist.auxil.utm_autodetect(spatial, crsOut)

get the UTM CRS for a spatial object

The bounding box of the object is extracted, reprojected to EPSG:4326 and its center coordinate used for computing the best UTM zone fit.

Parameters:

• spatial (Raster | Vector) – a spatial object in an arbitrary CRS

• crsOut (str) – the output CRS type; see function crsConvert() for options

Returns:

the output CRS

Return type:

int | str | SpatialReference