Miranda

A modern Python utility library for climate data collection and management.
https://github.com/Ouranosinc/miranda

Category: Climate Change
Sub Category: Climate Data Processing and Analysis

Keywords

archiving climate collection management netcdf

Keywords from Contributors

earth-system-model icclim climate-analysis climate-science netcdf4 xclim anuclim raven ogc indices

Last synced: about 24 hours ago
JSON representation

Repository metadata

A modern Python utility library for climate data collection and management

• Host: GitHub
• URL: https://github.com/Ouranosinc/miranda
• Owner: Ouranosinc
• License: apache-2.0
• Created: 2019-08-22T16:12:39.000Z (over 6 years ago)
• Default Branch: main
• Last Pushed: 2025-12-12T17:23:59.000Z (14 days ago)
• Last Synced: 2025-12-14T08:20:21.559Z (12 days ago)
• Topics: archiving, climate, collection, management, netcdf
• Language: Python
• Size: 51.4 MB
• Stars: 20
• Watchers: 5
• Forks: 2
• Open Issues: 19
• Releases: 4
• Metadata Files:
  • Readme: README.rst
  • Changelog: CHANGELOG.rst
  • Contributing: CONTRIBUTING.rst
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md
  • Citation: CITATION.cff
  • Security: SECURITY.md
  • Authors: AUTHORS.rst
  • Zenodo: .zenodo.json

README.rst

          ==============
Miranda |logo|
==============

+----------------------------+-----------------------------------------------------+
| Versions                   | |pypi| |conda|                                      |
+----------------------------+-----------------------------------------------------+
| Documentation and Support  | |docs| |versions|                                   |
+----------------------------+-----------------------------------------------------+
| Open Source                | |license| |ossf-score| |zenodo|                     |
+----------------------------+-----------------------------------------------------+
| Coding Standards           | |ruff| |pre-commit| |ossf-bp|                       |
+----------------------------+-----------------------------------------------------+
| Development Status         | |status| |build| |coveralls|                        |
+----------------------------+-----------------------------------------------------+

Python utilities for climate data collection, conversion, and management.

* Free software: Apache Software License 2.0
* Documentation: https://miranda.readthedocs.io.

Features
--------

Data collection functions for climate and forecast data hosted at:
    * ECMWF (Europe) (ERA5, ERA5-Land, TIGGE)
    * ECCC (Canada) (Monthly Climate Summaries, ECCC GEOAPI) (In development)
    * NCAR (CORDEX-NA on AWS)

Data conversion for `Climate and Forecasting (CF) `_ Variable and Metadata compliance:
    * ECMWF (Europe) (ERA5, ERA5-Land, TIGGE) (In Development)
    * ECCC (Canada) (Flat File Observations, Monthly Climate Summaries, Adjusted and Homogenized Climate Data, ECCC GEOAPI) (In Development)
    * MELCC (Québec)
    * Hydro-Québec (In Development)

Database structuring and facets validation:
    * Simulations:
       * WCRP (CMIP5, CMIP6, CMIP5-CORDEX, CORDEX-ADJUST, ISIMIP, etc.)
    * Station-Observations:
       * MELCC (Québec) (Needs `mdbtools `_ installed)
       * ECCC (Canada) (In Development)
       * Hydro-Québec (In Development)
    * Gridded-Observations:
       * NRCAN (Canada) (In Development)
       * MELCC (Québec) (In Development)
    * Reanalyses:
       * ECCC (Canada) (CanSWE, CaSR, RDRS)
       * ECMWF (Europe) (ERA5, ERA5-Land, TIGGE)
       * NASA (DayMET, NEX-GDDP) (In Development)
       * USask (Canada) (EMDNA)

Installation
------------
`miranda` can be installed from PyPI::

    $ pip install miranda

Some functionalities require complex-to-install dependencies.
In order to gain access to them, we strongly suggest using `Anaconda `_ to manage your environment::

    $ conda env create -f environment.yml
    $ conda activate miranda
    $ pip install miranda[full]

For more information about Anaconda/Miniconda/conda-forge:
 * Miniconda: https://docs.conda.io/en/latest/miniconda.html
 * conda-forge: https://conda-forge.org/#about

`miranda` also relies on `PyESSV `_ for its climate data controlled vocabulary.
This library is optional for users who do not require validation checks,
but enabling this feature requires additional installation steps::

    $ mkdir -p ~/.esdoc
    $ git clone git@github.com:ES-DOC/pyessv-archive.git ~/.esdoc/pyessv-archive

Contributing
------------
See the contributing documentation: https://miranda.readthedocs.io/en/latest/contributing.html

Credits
-------

This package was created with Cookiecutter_ and the `Ouranosinc/cookiecutter-pypackage`_ project template.

.. _Cookiecutter: https://github.com/cookiecutter/cookiecutter
.. _`Ouranosinc/cookiecutter-pypackage`: https://github.com/Ouranosinc/cookiecutter-pypackage

.. |build| image:: https://github.com/Ouranosinc/miranda/actions/workflows/main.yml/badge.svg
        :target: https://github.com/Ouranosinc/miranda/actions
        :alt: Build Status

.. |conda| image:: https://img.shields.io/conda/vn/conda-forge/python-miranda.svg
        :target: https://anaconda.org/conda-forge/python-miranda
        :alt: Conda-forge Build Version

.. |coveralls| image:: https://coveralls.io/repos/github/Ouranosinc/miranda/badge.svg
        :target: https://coveralls.io/github/Ouranosinc/miranda
        :alt: Coveralls

.. |docs| image:: https://readthedocs.org/projects/miranda/badge/?version=latest
        :target: https://miranda.readthedocs.io/en/latest/?version=latest
        :alt: Documentation Status

.. |license| image:: https://img.shields.io/github/license/Ouranosinc/miranda.svg
        :target: https://github.com/Ouranosinc/miranda/blob/main/LICENSE
        :alt: License

.. |ossf-bp| image:: https://bestpractices.coreinfrastructure.org/projects/11291/badge
        :target: https://bestpractices.coreinfrastructure.org/projects/11291
        :alt: Open Source Security Foundation Best Practices

.. |ossf-score| image:: https://api.securityscorecards.dev/projects/github.com/Ouranosinc/miranda/badge
        :target: https://securityscorecards.dev/viewer/?uri=github.com/Ouranosinc/miranda
        :alt: OpenSSF Scorecard

.. |logo| image:: https://raw.githubusercontent.com/Ouranosinc/miranda/main/docs/_static/images/miranda-logo-small.png
        :target: https://github.com/Ouranosinc/miranda
        :alt: Miranda

.. |pre-commit| image:: https://results.pre-commit.ci/badge/github/Ouranosinc/miranda/main.svg
        :target: https://results.pre-commit.ci/latest/github/Ouranosinc/miranda/main
        :alt: pre-commit.ci status

.. |pypi| image:: https://img.shields.io/pypi/v/miranda.svg
        :target: https://pypi.python.org/pypi/miranda
        :alt: PyPI

.. |ruff| image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json
        :target: https://github.com/astral-sh/ruff
        :alt: Ruff

.. |status| image:: https://www.repostatus.org/badges/latest/active.svg
        :target: https://www.repostatus.org/#active
        :alt: Project Status: Active – The project has reached a stable, usable state and is being actively developed.

.. |versions| image:: https://img.shields.io/pypi/pyversions/miranda.svg
        :target: https://pypi.python.org/pypi/miranda
        :alt: Supported Python Versions

.. |zenodo| image:: https://zenodo.org/badge/203830590.svg
        :target: https://zenodo.org/badge/latestdoi/203830590
        :alt: DOI

        

---

Owner metadata

• Name: Ouranos inc.
• Login: Ouranosinc
• Email:
• Kind: organization
• Description: Consortium on regional climatology
• Website: www.ouranos.ca
• Location: Canada
• Twitter: ouranos_cc
• Company:
• Icon url: https://avatars.githubusercontent.com/u/1696763?v=4
• Repositories: 37
• Last ynced at: 2023-02-26T14:20:41.025Z
• Profile URL: https://github.com/Ouranosinc

---

GitHub Events

Total

• Create event: 74
• Release event: 1
• Issues event: 3
• Watch event: 3
• Delete event: 61
• Issue comment event: 54
• Push event: 258
• Pull request review comment event: 36
• Pull request event: 116
• Pull request review event: 85

Last Year

• Create event: 74
• Release event: 1
• Issues event: 3
• Watch event: 3
• Delete event: 61
• Issue comment event: 54
• Push event: 257
• Pull request review comment event: 36
• Pull request review event: 84
• Pull request event: 116

---

Committers metadata

Last synced: 24 days ago

Name	Email	Commits
Zeitsperre	1****e	1076
tlogan2000	l****s@o****a	172
pre-commit-ci[bot]	6****]	143
dependabot[bot]	4****]	73
Asli Bese	a****e@d****a	45
bumpversion[bot]	b****]@o****a	36
juliettelavoie	j****e@h****a	27
Pascal Bourgault	b****l@o****a	25
Asli Bese	1****e	3
RondeauG	r****l@o****a	3
David Huard	h****d@o****a	2

Committer domains:

• ouranos.ca: 5
• hotmail.ca: 1
• doris.ouranos.ca: 1

---

Issue and Pull Request metadata

Last synced: 2 months ago

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/Ouranosinc/miranda

---

---

---

Package metadata

• Total packages: 3
• Total downloads:
  • pypi: 79 last-month
• Total dependent packages: 0 (may contain duplicates)
• Total dependent repositories: 0 (may contain duplicates)
• Total versions: 12
• Total maintainers: 2

---

Dependencies

Score: 10.455906073600456