cc-qa 0.1.1

QA based on compliance-checker

cc-qa: Quality Assurance Workflow Based on compliance-checker and cc-plugin-cc6

This makes use of the frameworks and CF-compliance checks of the ioos/compliance-checker and extensions coming with euro-cordex/cc-plugin-cc6.

This tool is designed to run the desired file-based QC tests with ioos/compliance-checker and euro-cordex/cc-plugin-cc6, conduct additional dataset-based checks (such as time axis continuity and consistency checks) as well as summarizing the test results.

cc-qa is mainly aimed at a QA workflow testing compliance with CORDEX-CMIP6 Archive Specifications (see below). However, it is generally applicable to test for compliance with the CF conventions through application of the IOOS Compliance Checker, and it should be easily extendable for any cc-plugin and for projects defining CORDEX, CORDEX-CMIP6, CMIP5 or CMIP6 style CMOR-tables.

Standard	Checker Name
cordex-cmip6-cv	cc6
cordex-cmip6-cmor-tables	cc6
CORDEX-CMIP6 Archive Specifications	cc6

Installation

Pip installation

$ pip install cc_qa

Pip installation from source

Clone the repository and cd into the repository folder, then:

$ pip install -e .

Optionally install the dependencies for development:

$ pip install -e .[dev]

See the ioos/compliance-checker for additional Installation notes if problems arise with the dependencies.

Usage

$ ccqa [-h] [-o <RESULT_DIR>][-t <TEST>] [-i <INFO>] [-r] <parent_dir>

• positional arguments:
  • parent_dir: Parent directory to scan for netCDF-files to check
• options:
  • -h, --help: show this help message and exit
  • -o, --output_dir OUTPUT_DIR: Directory to store QA results. Needs to be non-existing or empty. If not specified, will store results in ./cc-qa-check-results/YYYYMMDD-HHmm_<hash>.
  • -t, --test TEST: The test to run ('cc6' or 'cf', can be specified multiple times) - default: running 'cc6' and 'cf'.
  • -i, --info INFO: Information used to tag the QA results, eg. the simulation id to identify the checked run. Suggested is the original experiment-id you gave the run.
  • -r, --resume: Specify to continue a previous QC run. Requires the <output_dir> argument to be set.

Example Usage

$ ccqa -o /work/bb1364/dkrz/QC_results/IAEVALL02_2025-04-20 -i "IAEVALL02" /work/bb1149/ESGF_Buff/IAEVALL02/CORDEX-CMIP6

To resume at a later date, eg. if the QA run did not finish in time or more files have been added to the <parent_dir> (note, that the last modification date of files is NOT taken into account - once a certain file path has been checked it will be marked as checked and checks will only be repeated if runtime errors occured):

$ ccqa -o /work/bb1364/dkrz/QC_results/IAEVALL02_2025-04-20 -r

Displaying the check results

The results will be stored in a single json file, which can be viewed using the following website: https://cmiphub.dkrz.de/info/display_qc_results.html. This website runs entirely in the user's browser using JavaScript, without requiring interaction with a web server. Alternatively, you can open the included display_qc_results.html file directly in your browser.

Add results to QA results repository

https://cmiphub.dkrz.de/info/display_qc_results.html allows viewing QA results hosted in the GitLab Repository qa-results. You can create a Merge Request in that repository to add your own results.

License

This project is licensed under the Apache License 2.0, and includes the Inter font, which is licensed under the SIL Open Font License 1.1. See the LICENSE file for more details.