Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
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 (over 5 years ago)
- Default Branch: master
- Last Pushed: 2023-11-06T20:44:20.000Z (about 1 year ago)
- Last Synced: 2024-11-02T01:47:37.370Z (2 months ago)
- Topics: cmip6, cmip6-data-download, cmip6-realtime
- Language: Python
- Homepage:
- Size: 16.3 MB
- Stars: 121
- Watchers: 5
- Forks: 27
- 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 filesInstallation
------------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 experimentsDemo
-----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