Metadata-Version: 2.2
Name: telluric
Version: 0.15.0
Summary: Interactive geospatial data manipulation in Python
Home-page: https://github.com/satellogic/telluric/
Download-URL: https://github.com/satellogic/telluric/tags/v0.15.0
Author: Juan Luis Cano, Guy Doulberg, Slava Kerner, Lucio Torre, Ariel Zerahia, Denis Rykov
Maintainer-email: juanlu@satellogic.com
License: MIT
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Scientific/Engineering :: GIS
Classifier: Topic :: Scientific/Engineering :: Visualization
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: affine
Requires-Dist: fiona<1.9.0,>=1.8.4
Requires-Dist: shapely<2.0.0,>=1.6.3
Requires-Dist: rasterio<1.4.0,>=1.2.0
Requires-Dist: pillow
Requires-Dist: mercantile>=0.10.0
Requires-Dist: boltons
Requires-Dist: imageio
Requires-Dist: lxml
Requires-Dist: python-dateutil
Requires-Dist: numpy<2.0
Provides-Extra: dev
Requires-Dist: coverage; extra == "dev"
Requires-Dist: mypy; extra == "dev"
Requires-Dist: types-python-dateutil; extra == "dev"
Requires-Dist: packaging; extra == "dev"
Requires-Dist: pycodestyle; extra == "dev"
Requires-Dist: pytest>=4; extra == "dev"
Requires-Dist: pytest-cov<=2.8.1; extra == "dev"
Requires-Dist: sphinx; extra == "dev"
Requires-Dist: ipython; extra == "dev"
Requires-Dist: nbsphinx; extra == "dev"
Requires-Dist: sphinx_rtd_theme; extra == "dev"
Provides-Extra: vis
Requires-Dist: ipyleaflet!=0.8.2; extra == "vis"
Requires-Dist: matplotlib; extra == "vis"
Requires-Dist: folium>=0.6.0; extra == "vis"
Requires-Dist: tornado; extra == "vis"
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: download-url
Dynamic: home-page
Dynamic: license
Dynamic: maintainer-email
Dynamic: provides-extra
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# telluric

## Overview

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

[![Build Status](https://travis-ci.org/satellogic/telluric.svg?branch=master)](https://travis-ci.org/satellogic/telluric)
[![Coverage](https://codecov.io/gh/satellogic/telluric/branch/master/graph/badge.svg)](https://codecov.io/gh/satellogic/telluric)
[![Chat](https://img.shields.io/matrix/telluric-dev:matrix.org.svg?style=flat-square)](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]: <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](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!
