Metadata-Version: 2.4
Name: sedtrails
Version: 1.0.0a2
Summary: Sediment TRAnsport vIsualization and Lagrangian Simulator.
Project-URL: Homepage, https://github.com/sedtrails/sedtrails
Project-URL: Documentation, https://sedtrails.github.io/sedtrails
Project-URL: Repository, https://github.com/sedtrails/sedtrails.git
Project-URL: Bug Tracker, https://github.com/sedtrails/sedtrails/issues
Project-URL: Changelog, https://github.com/sedtrails/sedtrails/blob/main/CHANGELOG.md
Author-email: Stuart Pearson <s.g.pearson@tudelft.nl>, Natascia Pannozzo <n.pannozzo@tudelft.nl>, Johan Reyns <johan.reyns@deltares.nl>
Maintainer-email: Stuart Pearson <s.g.pearson@tudelft.nl>, Johan Reyns <johan.reyns@deltares.nl>
License-Expression: MIT
Keywords: analysis,sediment
Classifier: Development Status :: 1 - Planning
Classifier: Programming Language :: Python
Requires-Python: <3.14,>=3.10
Requires-Dist: jsonschema
Requires-Dist: matplotlib
Requires-Dist: numba
Requires-Dist: numpy<2.2,>=1.24
Requires-Dist: pandas
Requires-Dist: pyyaml
Requires-Dist: referencing>=0.36.2
Requires-Dist: tqdm
Requires-Dist: typer<1.0,>=0.15.0
Requires-Dist: xarray
Requires-Dist: xugrid
Provides-Extra: cli
Requires-Dist: typer<1.0,>=0.15.0; extra == 'cli'
Provides-Extra: dev
Requires-Dist: myst-parser==4.0.1; extra == 'dev'
Requires-Dist: pytest; extra == 'dev'
Requires-Dist: ruff; extra == 'dev'
Requires-Dist: sphinx-rtd-theme; extra == 'dev'
Requires-Dist: sphinx==8.2.0; extra == 'dev'
Description-Content-Type: text/markdown

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![TUDelft DCC](https://img.shields.io/badge/tu_delft-DCC-black?style=flat&label=TU%20Delft&labelColor=%23000000%20&color=%2300A6D6)](https://dcc.tudelft.nl)
[![Deploy Sphinx Documentation](https://github.com/sedtrails/sedtrails/actions/workflows/publish.yml/badge.svg)](https://github.com/sedtrails/sedtrails/actions/workflows/publish.yml)
[![Ruff](https://github.com/sedtrails/sedtrails/actions/workflows/ruff.yml/badge.svg?branch=dev)](https://github.com/sedtrails/sedtrails/actions/workflows/ruff.yml)
[![Pytest](https://github.com/sedtrails/sedtrails/actions/workflows/pytest.yml/badge.svg?branch=dev&event=push)](https://github.com/sedtrails/sedtrails/actions/workflows/pytest.yml)

# SedTRAILS
**Sed**iment **TRA**nsport v**I**sualization and **L**agrangian **S**imulator.

## Installation

SedTRAILS requires Python 3.12 and above, but it is likely to work with Python 3.10 and above.

1. Clone the repository:
```bash

git clone https://github.com/sedtrails/sedtrails.git
```

2. Change the directory:
```bash
cd sedtrails
```
3. Install the dependencies:
```bash
pip install .
```

## Software Architecture
The `diagrams/c4` directory was obtained from the [C4-PlantUML GitHub repository](https://github.com/plantuml-stdlib/C4-PlantUML). The directory contains some of the files required to run PlantUML, as well as a short [README.md](https://github.com/sedtrails/sedtrails/blob/main/diagrams/c4/README.md) that explains how to use the library.

**Requirements** 
- Java
- GraphViz

You can read more about the PlantUML syntax on the [PlantUML documentation](https://plantuml.com/command-line). They provide extensive support, which may be an overkill at the moment.
- If you have the requirements already installed, you can simply clone the repository and get started. 
- TL;DR: the basic command to save your diagram to a PNG file: 
    ```shell
    # Bash terminal
    plantuml -tpng <file.puml>
    ```

## Contributing Guidelines

Read the [contributing guidelines](CONTRIBUTING.md) to know how can you take part in this project. 

## License

SetTRAILS is licensed under the [MIT License](LICENSE).

&copy; (2025) SedTRAILS Team, Delft, The Netherlands. 

## Citation

Pannozzo, N., Shafiei, H., van Westen, B., Pearson, S. G., Reyns, J., & Aguilera Chaves, M. SedTRAILS (Version 0.1) [Computer software]

### Author Contributions:
| [Role](https://credit.niso.org/contributor-roles-defined/) | Author |
|------|--------|
| Conceptualization |  |
| Funding acquisition | |
| Project management |  |
| Research |  |
| Software |  |
| Supervision |  |

## Acknowlegdements

> The development of *SedTRAILS Software* was supported by the [Digital Competence Centre](https://dcc.tudelft.nl/), Delft University of Technology. 
