README.md

Thalassa

Thalassa ia a library for visualizing unstructured mesh data.

It builds upon geoviews and datashader and can easily handle meshes with millions of nodes interactively.

Thalassa is currently supporting visualization of the output of the following solvers:

• Schism
• ADCIRC

Adding support for new solvers is relatively straight-forward.

Installation

PyPI

1. Install the binary dependencies:

• python >= 3.9
• geos

2. Install from PyPI with:

pip install thalassa

Conda

You can also install using conda/mamba:

mamba install -y -c conda-forge thalassa

Obtaining Data

You will need some data to visualize. You can download sample datasets from the following links:

• 2D Output from the STOFS-2D Global model which uses ADCIRC from here (12GB)
• 3D Output from the STOFS-3D Atlantic model which uses Schism 5.9 (old IO) from here (12GB)
• 2D Output from the STOFS-3D Atlantic model which uses Schism 5.10 (new IO) from here (3GB)

Thalassa-server

thalassa-server is an web-application leveraging the thalassa library and panel. Check-it out!

Developing

Prerequisites

For developing we are using poetry and pre-commit. You can install both with pipx:

# poetry
pipx install poetry
pipx inject poetry poetry-dynamic-versioning
pipx inject poetry poetry-plugin-export
# pre-commit
pipx install pre-commit

Install dependencies

Just run:

make init

License

The project is released under the EUPL v1.2 license which is compatible with GPL v3