ACCESS-Community-Hub / ACCESS-MOPPeR

A tool to post-process ACCESS Model output using CMOR, based on APP4, work in progress!
https://access-mopper.readthedocs.io/en/latest/
Apache License 2.0
0 stars 0 forks source link

ACCESS Model Output Post-Processor (MOPPeR)

Read the docs DOI

This code is derived from the APP4, initially created by Peter Uhe for CMIP5, and further developed for CMIP6-era by Chloe Mackallah from CSIRO, O&A Aspendale.


The MOPPeR is a CMORisation tool designed to post-process ACCESS model output. The original APP4 main use was to produce ESGF-compliant formats, primarily for publication to CMIP6. The code was originally built for CMIP5, and was further developed for CMIP6-era activities.
It used CMOR3 and files created with the CMIP6 data request to generate CF-compliant files according to the CMIP6 data standards.The APP4 also had a custom mode option to allow users to post-process output without strict adherence to the ESGF standards. MOPPeR was developed to extend the custom mode as much as it is allowed by the CMOR tool, it can be used to produce CMIP6 compliant data but other standards can also be defined.

CMOR uses Controlled Vocabularies as metadata constraints, with CMIP6_CV.json being the main one. This has an effect on how the data is written in the files, variables' names, directory structure, filenames, and global attributes. The APP4 also relied on mapping files to match the raw model output to CMOR defined variables. To make this approach more flexible we introduced a new tool mopdb that helps the users create their own mapping and handling CMOR tables definitions.

Designed for use on ACCESS model output that has been archived using the ACCESS Archiver tool.

Although we retained a differentiation between custom and cmip mode the main workflow is the same and mode is now only another field in the main configuration file.

Install

You can install the latest version of mopper directly from conda (accessnri channel)::

conda install -c accessnri mopper

If you want to install an unstable version or a different branch:

* git clone
* git checkout <branch-name>   (if installing a a different branch from master)
* cd mopper
* pip install ./
  use --user flag if you want to install it in ~/.local

Working on the NCI server

MOPPeR is pre-installed into a Conda environment at NCI. Load it with::

module use /g/data3/hh5/public/modules
module load conda/analysis3-unstable

NB. You need to be a member of the hh5 project to load the modules.