Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/TaufiqHassan/acccmip6

Python package for accessing and downloading CMIP6 database
https://github.com/TaufiqHassan/acccmip6

cmip6 cmip6-data-download cmip6-realtime

Last synced: about 2 months ago
JSON representation

Python package for accessing and downloading CMIP6 database

Host: GitHub
URL: https://github.com/TaufiqHassan/acccmip6
Owner: TaufiqHassan
License: mit
Created: 2019-09-13T11:35:58.000Z (about 5 years ago)
Default Branch: master
Last Pushed: 2023-11-06T20:44:20.000Z (11 months ago)
Last Synced: 2024-07-07T17:08:04.821Z (3 months ago)
Topics: cmip6, cmip6-data-download, cmip6-realtime
Language: Python
Homepage:
Size: 16.3 MB
Stars: 109
Watchers: 5
Forks: 25
Open Issues: 3
Metadata Files:
- Readme: README.rst
- License: LICENSE
- Citation: CITATION.cff
- Authors: AUTHORS.rst

Awesome Lists containing this project

awesome-meteo - **Access Cmip6**

README

===============================
Access Cmip6
===============================

.. image:: https://img.shields.io/travis/TaufiqHassan/acccmip6.svg
:target: https://travis-ci.org/TaufiqHassan/acccmip6

.. image:: https://img.shields.io/pypi/v/acccmip6.svg
:target: https://pypi.python.org/pypi/acccmip6

.. image:: https://readthedocs.org/projects/acccmip6/badge
:target: https://acccmip6.readthedocs.org

.. image:: https://zenodo.org/badge/208252347.svg
:target: https://zenodo.org/badge/latestdoi/208252347

``acccmip6`` package can access CMIP6 database in real-time.

* GitHub repo: https://github.com/TaufiqHassan/acccmip6
* Documentation: https://acccmip6.readthedocs.org.

Features
--------

- Real-time search and download from continuously updating CMIP6 database
- Find data for any specific items (e.g. model, experiment, variable, frequency, realm)
- Search and download any combination of the above items
- Find the total number of available files and realizations
- Validate your search items
- Get suggestions if necessary
- Access definition of the experiments
- Skips already existing files

Installation
------------

Install is as simple as typing -

``pip install acccmip6``

Requires python v3.5 or up and pip. Mac users can use ``brew install python3`` and ``python get-pip.py`` from terminal. Windows users can use `Windows Subsystem`_.

.. _`Windows Subsystem`: https://docs.microsoft.com/en-us/windows/wsl/install-win10

Installation demo

.. image:: docs/installation_demo.gif

You may also install the package via conda. Make sure you have added the conda-forge channel in your environment. You can add any channel by -

``conda config --env --add channels conda-forge``

Then install ``acccmip6`` from ``thassan`` channel:

``conda install -c thassan acccmip6``

Usage
-----

``acccmip6`` searches the live CMIP6 database and spits out currently available models, experiments and variables that satisfies your search criteria. It will also output the number of available files.
``acccmip6`` also tries to be a good command-line interface (CLI). Run ``acccmip6 -h`` to see a help message with all the arguments you can pass.

Required Arguments
------------------

- ``-o`` : Takes output type. 'S' for searching the database or 'D' for downloading from the database.

Optional Arguments
------------------

- ``-m`` : Model names (multiple comma separated names are allowed)
- ``-e`` : Experiment names
- ``-f`` : CMIP6 output frequency (e.g. mon, day etc.)
- ``-v`` : Variable names
- ``-r`` : Realm name (e.g. atmos, ocean etc.)
- ``-rlzn`` : Select a specified realization
- ``-c`` : 'yes' to use checker when searching or downloading. This helps to find out whether the search items are currently available. If not, it will produce suggestions that matches closely to your search.
- ``-desc`` : 'yes' to get the description of the experiments searched for
- ``-dir`` : Download directory
- ``-skip`` : Skip any item (model/experiment/realizations) from your download
- ``-time`` : 'yes' to print out all available time periods
- ``-yr`` : Select data for a time period (number of years)
- ``-n`` : Select specific data nodes (multiple node selection allowed)
- ``-serv`` : Set user-defined server
- ``-cr`` : Select common realizations among selected experiments

Demo
-----

Search CMIP6 database with ``acccmip6 -o S``

.. image:: docs/searching_demo.gif

Download CMIP6 data with ``acccmip6 -o D``

.. image:: docs/downloading_demo.gif

License
-------

This code is licensed under the `MIT License`_.

.. _`MIT License`: https://opensource.org/licenses/MIT