Metadata-Version: 2.4
Name: telesto
Version: 0.1.2
Summary: Explore EO data
Author-email: Visual Topology <dev@visualtopology.com>
License-Expression: MIT
Project-URL: Homepage, https://codeberg.org/visual-topology/telesto-package
Project-URL: Documentation, https://codeberg.org/visual-topology/telesto-package
Project-URL: Repository, https://codeberg.org/visual-topology/telesto-package
Project-URL: Issues, https://codeberg.org/visual-topology/telesto-package/issues
Project-URL: Changelog, https://codeberg.org/visual-topology/telesto-package/src/branch/main/CHANGELOG.md
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: JavaScript
Classifier: Operating System :: POSIX :: Linux
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Development Status :: 3 - Alpha
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: hyrrokkin[ALL]
Requires-Dist: hyrrokkin_x
Requires-Dist: netcdf4
Requires-Dist: xarray
Requires-Dist: dask
Requires-Dist: openeo
Requires-Dist: scikit-learn
Requires-Dist: pillow
Requires-Dist: matplotlib
Requires-Dist: pyproj
Requires-Dist: jwt
Dynamic: license-file

# Telesto

Telesto is a [hyrrokkin](https://codeberg.org/visual-topology/hyrrokkin) package for exploring and modelling Earth Observation data.

* Telesto relies on the openEO API to retrieve Earth Observation imagery from the [Copernicus Data Space Ecosystem (CDSE)](https://dataspace.copernicus.eu/)
* Free sign up and a substantial amount of free usage is available 
* Integration to other Earth Observation platforms may be added in future...

Important Note: Telesto is currently an experimental release.  Some functionality is buggy and subject to change.

Important Note: Telesto has only been tested on linux.  It may not work on other operating systems.

## Prerequisites

* A CDSE account
* Python 3.11 or later

## Installation

To install telesto and its dependencies, run:

```
pip install hyrrokkin
```

![img.png](img.png)

## Running Telesto

You may choose to install and run Telesto locally (on your own computer) or as part of a notebook in a cloud environment.

### Local installation - starting Telesto

Use the `telesto_designer` tool to create and edit a single topology

```
myhost% telesto_designer --topology-path <path-to-folder>
http://localhost:9002/topology-designer.html
...
```

Where `<path-to-folder>` specifies a folder where the topology definition will be stored.

Copy and paste the URL printed to the command line into your browser to open the designer user interface.

For managing a set of topologies, use the `telesto_directory` tool

```
myhost% telesto_directory --topologies-folder <path-to-folder>
http://localhost:9002/topology-directory.html
...
```

Where `<path-to-folder>` specifies a parent folder under which topology folders are created and stored.

Copy and paste the URL printed to the command line into your browser to open the directory user interface.

### Running in a CDSE notebook

### Running in a Google Colab notebook

