https://github.com/satellogic/telluric
telluric is a Python library to manage vector and raster geospatial data in an interactive and easy way
https://github.com/satellogic/telluric
geospatial-data maps python python-library python3 raster
Last synced: about 1 month ago
JSON representation
telluric is a Python library to manage vector and raster geospatial data in an interactive and easy way
- Host: GitHub
- URL: https://github.com/satellogic/telluric
- Owner: satellogic
- License: mit
- Created: 2018-04-10T10:43:15.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2025-02-12T01:40:37.000Z (9 months ago)
- Last Synced: 2025-10-21T19:58:15.454Z (about 1 month ago)
- Topics: geospatial-data, maps, python, python-library, python3, raster
- Language: Jupyter Notebook
- Size: 43.3 MB
- Stars: 87
- Watchers: 10
- Forks: 18
- Open Issues: 52
-
Metadata Files:
- Readme: README.md
- Changelog: NEWS.rst
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- awesome-earthobservation-code - Telluric - telluric is a `Python` library to manage vector and raster geospatial data in an interactive and easy way (`Python` processing of optical imagery (non deep learning) / Processing imagery - post processing)
- Awesome-Geospatial - telluric - telluric is a Python library to manage vector and raster geospatial data in an interactive and easy way. (Python)
README
# telluric
## Overview
telluric is a Python library to manage vector and raster geospatial data in an interactive
and easy way.
[](https://travis-ci.org/satellogic/telluric)
[](https://codecov.io/gh/satellogic/telluric)
[](https://riot.im/app/#/room/#telluric-dev:matrix.org)
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]:
```
And reading some vector data is equally simple:
```
In [3]: tl.FileCollection.open("shapefiles/usa-major-cities.shp")
Out[3]:
```
For more usage examples and a complete API reference,
[check out our documentation](http://telluric.readthedocs.io/) on Read the Docs.
The [source code](https://github.com/satellogic/telluric) and
[issue tracker](https://github.com/satellogic/telluric/issues) 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](http://telluric.readthedocs.io/).
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](https://github.com/satellogic/telluric/issues/new)
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](https://riot.im/app/#/room/#telluric-dev:matrix.org) to ask all sorts of questions!