satellogic / telluric

telluric is a Python library to manage vector and raster geospatial data in an interactive and easy way
MIT License
87 stars 18 forks source link
geospatial-data maps python python-library python3 raster

telluric

Overview

telluric is a Python library to manage vector and raster geospatial data in an interactive and easy way.

Build Status Coverage Chat

Opening a raster is as simple as:

In [1]: import telluric as tl

In [2]: tl.GeoRaster2.open("http://download.osgeo.org/geotiff/samples/usgs/f41078e1.tif")
Out[2]: <telluric.georaster.GeoRaster2 at 0x7facd183ad68>

And reading some vector data is equally simple:

In [3]: tl.FileCollection.open("shapefiles/usa-major-cities.shp")
Out[3]: <telluric.collections.FileCollection at 0x7facd1183048>

For more usage examples and a complete API reference, check out our documentation on Read the Docs.

The source code and issue tracker are hosted on GitHub, and all contributions and feedback are more than welcome.

Installation

You can install telluric using pip:

pip install telluric[vis]

Read more complete installation instructions at our documentation.

telluric is a pure Python library, and therefore should work on Linux, OS X and Windows provided that you can install its dependencies. If you find any problem, please open an issue and we will take care of it.

Development

telluric is usually developed on Linux. For full tests do:

$ make build
$ make test

for testing single tests do:

$ make dockershell
docker$ python -m pytest TEST_FILE::TEST_NAME

Support

Join our Matrix chat to ask all sorts of questions!