ROMS-Tools

Warning

This project is still in an early phase of development.

The python API is not yet stable. Therefore whilst you are welcome to try out using the package, we cannot yet guarantee backwards compatibility. We expect to reach a more stable version in Q1 2025.

Overview

A suite of Python tools for setting up a ROMS simulation.

Installation

Installation from conda forge

conda install -c conda-forge roms-tools

This command installs ROMS-Tools along with its dask dependency.

Installation from pip

pip install roms-tools

If you want to use ROMS-Tools together with dask (which we recommend), you can install ROMS-Tools along with the additional dependency via:

pip install roms-tools[dask]

Installation from GitHub

To obtain the latest development version, first clone the source repository:

git clone https://github.com/CWorthy-ocean/roms-tools.git
cd roms-tools

Next, install and activate the following conda environment:

conda env create -f ci/environment.yml
conda activate romstools-test

Finally, install ROMS-Tools in the same environment:

pip install -e .

If you want to use ROMS-Tools together with dask (which we recommend), you can install ROMS-Tools along with the additional dependency via:

pip install -e ".[dask]"

Run the tests

Before running the tests, you can activate the conda environment created in the previous section:

conda activate romstools-test

Check the installation of ROMS-Tools has worked by running the test suite

cd roms-tools
pytest

Getting Started

To learn how to use ROMS-Tools, check out the documentation.

Feedback and contributions

If you find a bug, have a feature suggestion, or any other kind of feedback, please start a Discussion.

We also accept contributions in the form of Pull Requests.

See also

• ROMS source code
• C-Star