Skip to main content

Tools for running and analysing UCLA-ROMS simulations

Project description

ROMS-Tools

Conda version PyPI version codecov Documentation Status Run Tests Supported Python Versions

Overview

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

DISCLAIMER: This project is ALPHA and will be EXPERIMENTAL at least throughout Fall 2024. We do not recommend to use this software before this ALPHA development and test phase is completed.

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

roms_tools-1.6.2.tar.gz (10.7 MB view details)

Uploaded Source

Built Distribution

roms_tools-1.6.2-py3-none-any.whl (577.2 kB view details)

Uploaded Python 3

File details

Details for the file roms_tools-1.6.2.tar.gz.

File metadata

  • Download URL: roms_tools-1.6.2.tar.gz
  • Upload date:
  • Size: 10.7 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/4.0.2 CPython/3.11.10

File hashes

Hashes for roms_tools-1.6.2.tar.gz
Algorithm Hash digest
SHA256 d4a68e12f54a838bc6f1be60b8c6456750eae87579539d29b26b5fbb1186220f
MD5 b985b250ded4c77c8c335f1cb611f21b
BLAKE2b-256 ecaf86f067349e1471ec03afc6dfb1eefef814af8c6d9fa469514e29bbccc4f3

See more details on using hashes here.

File details

Details for the file roms_tools-1.6.2-py3-none-any.whl.

File metadata

  • Download URL: roms_tools-1.6.2-py3-none-any.whl
  • Upload date:
  • Size: 577.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/4.0.2 CPython/3.11.10

File hashes

Hashes for roms_tools-1.6.2-py3-none-any.whl
Algorithm Hash digest
SHA256 c7ea4de24932c34506bffcfcfe752a4bf8fad5114ba2bbaf3a41bdb3dbd09d58
MD5 83c980f8a43504db3aaf157a20c88466
BLAKE2b-256 07287fd7d9860b87cdab598d58ef16318a9bd05ad6568bd6e9a071f11f4750fe

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page