Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/SalishSeaCast/SalishSeaNowcast

Python package associated with running the SalishSeaCast NEMO and other ocean models in near-real-time to produce daily nowcasts/forecasts
https://github.com/SalishSeaCast/SalishSeaNowcast

automation ocean-modelling oceanography salishsea salishseacast ubc-moad

Last synced: about 1 month ago
JSON representation

Python package associated with running the SalishSeaCast NEMO and other ocean models in near-real-time to produce daily nowcasts/forecasts

Host: GitHub
URL: https://github.com/SalishSeaCast/SalishSeaNowcast
Owner: SalishSeaCast
License: apache-2.0
Created: 2020-02-01T01:41:43.000Z (over 4 years ago)
Default Branch: main
Last Pushed: 2024-07-30T21:38:35.000Z (about 2 months ago)
Last Synced: 2024-08-07T02:56:39.916Z (about 1 month ago)
Topics: automation, ocean-modelling, oceanography, salishsea, salishseacast, ubc-moad
Language: Python
Homepage: https://salishsea.eos.ubc.ca/nemo/
Size: 240 MB
Stars: 4
Watchers: 5
Forks: 3
Open Issues: 33
Metadata Files:
- Readme: README.rst
- License: LICENSE

Awesome Lists containing this project

open-sustainable-technology - SalishSeaNowcast - A collection of Python modules associated with running the SalishSeaCast ocean models system of daily nowcasts and forecasts. (Hydrosphere / Ocean Models)

README

****************
SalishSeaNowcast
****************

+----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| **Continuous Integration** | .. image:: https://github.com/SalishSeaCast/SalishSeaNowcast/actions/workflows/pytest-with-coverage.yaml/badge.svg |
| | :target: https://github.com/SalishSeaCast/SalishSeaNowcast/actions?query=workflow:pytest-with-coverage |
| | :alt: Pytest with Coverage Status |
| | .. image:: https://codecov.io/gh/SalishSeaCast/SalishSeaNowcast/branch/main/graph/badge.svg |
| | :target: https://app.codecov.io/gh/SalishSeaCast/SalishSeaNowcast |
| | :alt: Codecov Testing Coverage Report |
| | .. image:: https://github.com/SalishSeaCast/SalishSeaNowcast/actions/workflows/codeql-analysis.yaml/badge.svg |
| | :target: https://github.com/SalishSeaCast/SalishSeaNowcast/actions?query=workflow:CodeQL |
| | :alt: CodeQL analysis |
+----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| **Documentation** | .. image:: https://readthedocs.org/projects/salishsea-nowcast/badge/?version=latest |
| | :target: https://salishsea-nowcast.readthedocs.io/en/latest/ |
| | :alt: Documentation Status |
| | .. image:: https://github.com/SalishSeaCast/SalishSeaNowcast/actions/workflows/sphinx-linkcheck.yaml/badge.svg |
| | :target: https://github.com/SalishSeaCast/SalishSeaNowcast/actions?query=workflow:sphinx-linkcheck |
| | :alt: Sphinx linkcheck |
+----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| **Package** | .. image:: https://img.shields.io/github/v/release/SalishSeaCast/SalishSeaNowcast?logo=github |
| | :target: https://github.com/SalishSeaCast/SalishSeaNowcast/releases |
| | :alt: Releases |
| | .. image:: https://img.shields.io/python/required-version-toml?tomlFilePath=https://raw.githubusercontent.com/SalishSeaCast/SalishSeaNowcast/main/pyproject.toml&logo=Python&logoColor=gold&label=Python |
| | :target: https://docs.python.org/3.12/ |
| | :alt: Python Version from PEP 621 TOML |
| | .. image:: https://img.shields.io/github/issues/SalishSeaCast/SalishSeaNowcast?logo=github |
| | :target: https://github.com/SalishSeaCast/SalishSeaNowcast/issues |
| | :alt: Issue Tracker |
+----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| **Meta** | .. image:: https://img.shields.io/badge/license-Apache%202-cb2533.svg |
| | :target: https://www.apache.org/licenses/LICENSE-2.0 |
| | :alt: Licensed under the Apache License, Version 2.0 |
| | .. image:: https://img.shields.io/badge/version%20control-git-blue.svg?logo=github |
| | :target: https://github.com/SalishSeaCast/SalishSeaNowcast |
| | :alt: Git on GitHub |
| | .. image:: https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white |
| | :target: https://pre-commit.com |
| | :alt: pre-commit |
| | .. image:: https://img.shields.io/badge/code%20style-black-000000.svg |
| | :target: https://black.readthedocs.io/en/stable/ |
| | :alt: The uncompromising Python code formatter |
| | .. image:: https://img.shields.io/badge/%F0%9F%A5%9A-Hatch-4051b5.svg |
| | :target: https://github.com/pypa/hatch |
| | :alt: Hatch project |
+----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+

The ``SalishSeaNowcast`` package is a collection of Python modules associated with running
the SalishSeaCast ocean models system of daily nowcasts and forecasts.
The runs use as-recent-as-available
(typically previous day)
forcing data for the western boundary sea surface height and the Fraser River flow,
and atmospheric forcing from the four-times-daily produced forecast results from the
Environment and Climate Change Canada High Resolution Deterministic Prediction System
(HRDPS) operational GEM 2.5km resolution model.

The model runs are automated using an asynchronous,
message-based architecture that:

* obtains the forcing datasets from web services
* pre-processes the forcing datasets into the formats expected by NEMO and the other models
in the automation system
* uploads the forcing dataset files to the HPC or cloud-computing facility where the runs
will be executed
* executes the run
* downloads the results
* prepares a collection of plots from the run results for monitoring purposes
* publishes the plots and the processing log to the web

Documentation for the package is in the ``docs/`` directory and is rendered at https://salishsea-nowcast.readthedocs.io/en/latest/.

.. image:: https://readthedocs.org/projects/salishsea-nowcast/badge/?version=latest
:target: https://salishsea-nowcast.readthedocs.io/en/latest/
:alt: Documentation Status

License
=======

.. image:: https://img.shields.io/badge/license-Apache%202-cb2533.svg
:target: https://www.apache.org/licenses/LICENSE-2.0
:alt: Licensed under the Apache License, Version 2.0

The SalishSeaCast ocean model automation system code and documentation are copyright 2013 – present
by the `SalishSeaCast Project Contributors`_ and The University of British Columbia.

.. _SalishSeaCast Project Contributors: https://github.com/SalishSeaCast/docs/blob/master/CONTRIBUTORS.rst

They are licensed under the Apache License, Version 2.0.
http://www.apache.org/licenses/LICENSE-2.0
Please see the LICENSE file for details of the license.