esgf-qa 0.3.0__tar.gz → 0.5.0__tar.gz

{esgf_qa-0.3.0 → esgf_qa-0.5.0}/HISTORY.rst

@@ -1,3 +1,33 @@
+0.5.0 (2026-02-06)
+------------------
+
+New Features
+^^^^^^^^^^^^
+
+* Allowing to limit the number of parallel processes with the ``-P <max_processes>`` command line parameter.
+* Generally, any ``cc-plugin`` is now supported.
+* Creation of dataset-ids now supports a variety of projects. The list can be updated if needed.
+* Information on found files and organization into datasets now stored to disk rather than being output to stdout.
+
+0.4.0 (2025-11-05)
+------------------
+
+New Features
+^^^^^^^^^^^^
+
+* Allowing checker options to be specified via command line for all checkers.
+* Improved support of ``cc-plugin-wcrp``: enabled inter-file/dataset consistency & continuity checks.
+
+Bug Fixes
+^^^^^^^^^
+
+* Time continuity check: No longer throwing exception on unsupported time coordinates.
+
+Breaking Changes
+^^^^^^^^^^^^^^^^
+
+* No longer allowing respecification of checkers and options when resuming QA run (commit 3d2e082d40aef7c512ce828b1e4600ef81176e37).
+
 0.3.0 (2025-10-17)
 ------------------
 

esgf_qa-0.5.0/MANIFEST.in

@@ -0,0 +1,21 @@
+include LICENSE
+include README.md
+
+recursive-include tests *.py
+recursive-include fonts *
+
+global-exclude __pycache__ *.py[co]
+
+# Exclude GitHub workflows and metadata
+prune .github
+
+# Exclude CI environment
+prune ci
+
+# Exclude documentation
+prune docs
+
+# Exclude project config files
+exclude mkdocs.yml
+exclude .pre-commit-config.yaml
+exclude .gitignore

{esgf_qa-0.3.0 → esgf_qa-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: esgf-qa
-Version: 0.3.0
+Version: 0.5.0
 Summary: QA based on compliance-checker
 Author-email: Martin Schupfner <schupfner@dkrz.de>
 Maintainer-email: Martin Schupfner <schupfner@dkrz.de>
@@ -21,6 +21,7 @@ Requires-Dist: cf_xarray
 Requires-Dist: compliance-checker>=5.3.0
 Requires-Dist: dask
 Requires-Dist: netCDF4
+Requires-Dist: packaging
 Requires-Dist: pandas
 Requires-Dist: textual
 Requires-Dist: xarray
@@ -38,6 +39,7 @@ Requires-Dist: flake8-print; extra == "dev"
 Requires-Dist: pre-commit; extra == "dev"
 Requires-Dist: pytest>=7.0.0; extra == "dev"
 Requires-Dist: pytest-flake8; extra == "dev"
+Requires-Dist: pytest-asyncio; extra == "dev"
 Requires-Dist: ruff>=0.1.0; extra == "dev"
 Requires-Dist: twine; extra == "dev"
 Requires-Dist: wheel; extra == "dev"
@@ -45,34 +47,36 @@ Dynamic: license-file
 
 [![PyPI version](https://img.shields.io/pypi/v/esgf-qa.svg)](https://pypi.org/project/esgf-qa/)
 
-# esgf-qa: Quality Assurance Workflow Based on `compliance-checker` and `cc-plugin-wcrp` 
-<img src="docs/esgf-qa_Logo.png" align="left" width="120">
+# esgf-qa
+### Quality Assurance Workflow Based on `compliance-checker` and `cc-plugin-wcrp` (or other cc-plugins)
+<img src="https://raw.githubusercontent.com/ESGF/esgf-qa/master/docs/esgf-qa_Logo.png" align="left" width="120">
 
-`esgf-qa` makes use of the frameworks and [CF](https://cfconventions.org/)-compliance checks of the
-[ioos/compliance-checker](https://github.com/ioos/compliance-checker) and extensions coming with
+`esgf-qa` provides a flexible quality assurance (QA) workflow for evaluating dataset compliance using the
+[ioos/compliance-checker](https://github.com/ioos/compliance-checker) framework
+(including [CF](https://cfconventions.org/) compliance checks)
+and any community plugins (`cc-plugin`s), such as
 [ESGF/cc-plugin-wcrp](https://github.com/ESGF/cc-plugin-wcrp) and
 [euro-cordex/cc-plugin-cc6](https://github.com/euro-cordex/cc-plugin-cc6).
 
-This tool is designed to run the desired file-based QC tests with
-[ioos/compliance-checker](https://github.com/ioos/compliance-checker) and
-[euro-cordex/cc-plugin-wcrp](https://github.com/euro-cordex/cc-plugin-wcrp),
-to conduct additional dataset-based checks (such as time axis continuity and
-consistency checks) as well as to summarize the test results.
+The tool executes file-based quality control (QC) tests through the Compliance Checker,
+and, where applicable, performs additional dataset-level checks to test inter-file time-axis continuity
+and consistency in variable, coordinate and attribute definitions.
+Results from both file- and dataset-level checks are aggregated, summarized, and clustered for easier interpretation.
 
-`esgf-qa` is mainly aimed at a QA workflow testing compliance with various WCRP Project 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 is easily extendable for any `cc-plugin` and for projects defining CORDEX or CMIP style CMOR-tables.
+### Currently supported checkers
+
+While `esgf-qa` has been primarily developed for workflows assessing compliance with WCRP project data specifications
+(e.g., CMIP, CORDEX), it can also be used for general CF-compliance testing and generally supports any
+`cc-plugin`. It can be easily extended to support any projects following CORDEX- or CMIP-style CMOR table conventions.
 
 | Standard                                                                                             | Checker Name |
 | ---------------------------------------------------------------------------------------------------- | ------------ |
-| [cordex-cmip6-cv](https://github.com/WCRP-CORDEX/cordex-cmip6-cv)                                    |  wcrp_cordex_cmip6, cc6 |
-| [cordex-cmip6-cmor-tables](https://github.com/WCRP-CORDEX/cordex-cmip6-cmor-tables)                  |  wcrp_cordex_cmip6, cc6 |
-| [CORDEX-CMIP6 Archive Specifications](https://doi.org/10.5281/zenodo.10961069)                       |  wcrp_cordex_cmip6, cc6 |
-| [CMIP6 DRS](https://wcrp-cmip.github.io/WGCM_Infrastructure_Panel/Papers/CMIP6_global_attributes_filenames_CVs_v6.2.7.pdf) | wcrp_cmip6 / plugin_cmip6 |
-| [cmip6-cmor-tables](https://github.com/PCMDI/cmip6-cmor-tables) (esgvoc) | wcrp_cmip6 / plugin_cmip6 |
-| [CMIP6 CVs](https://github.com/WCRP-CMIP/CMIP6_CVs) (esgvoc) | wcrp_cmip6 / plugin_cmip6 |
-| [EERIE CMOR Tables & CV](https://github.com/eerie-project/dreq_tools) | eerie |
-| Custom MIP | mip |
+| [CF Conventions](https://cfconventions.org/) (shipped with [ioos/compliance-checker](https://github.com/ioos/compliance-checker)) | cf |
+| [WCRP CMIP6](https://pcmdi.llnl.gov/CMIP6/):<br><ul><li>[CMIP6 DRS](https://wcrp-cmip.github.io/WGCM_Infrastructure_Panel/Papers/CMIP6_global_attributes_filenames_CVs_v6.2.7.pdf)</li><li>[CMIP6 CVs](https://github.com/WCRP-CMIP/CMIP6_CVs) (esgvoc)</li></li><li>[cmip6-cmor-tables](https://github.com/PCMDI/cmip6-cmor-tables) (esgvoc)</li></ul> | wcrp_cmip6 |
+| [WCRP CORDEX-CMIP6](https://cordex.org/):<br><ul><li>[CORDEX-CMIP6 Archive Specifications](https://doi.org/10.5281/zenodo.10961069)</li><li>[cordex-cmip6-cv](https://github.com/WCRP-CORDEX/cordex-cmip6-cv) (esgvoc)</li><li>[cordex-cmip6-cmor-tables](https://github.com/WCRP-CORDEX/cordex-cmip6-cmor-tables) (esgvoc)</li></ul> |  wcrp_cordex_cmip6 |
+|  [WCRP CORDEX-CMIP6](https://cordex.org/):<br><ul><li>[CORDEX-CMIP6 Archive Specifications](https://doi.org/10.5281/zenodo.10961069)</li><li>[cordex-cmip6-cv](https://github.com/WCRP-CORDEX/cordex-cmip6-cv)</li><li>[cordex-cmip6-cmor-tables](https://github.com/WCRP-CORDEX/cordex-cmip6-cmor-tables)</li></ul>  | cc6 |
+| [EERIE](https://eerie-project.eu/):<br>[EERIE CMOR Tables & CV](https://github.com/eerie-project/dreq_tools) | eerie |
+| Custom MIP (CMOR/MIP tables have to be specified) | mip |
 
 ## Installation
 
@@ -109,35 +113,41 @@ esgvoc install
 
 - Test your installation
 
-The following command should now also list the `esgf-qc` checks next to all `cc_plugin_cc6` and `compliance_checker` checks:
+The following command should now also list the `cc-plugin-wcrp` checks next to all `cc_plugin_cc6` and `compliance_checker` checks:
 ```
 cchecker.py -l
 ```
 
+The following command should now list the necessary projects with metadata sources for `esgvoc`:
+```
+esgvoc status
+```
+
 ## Usage
 
 ```shell
-$ esgqa [-h] [-o <OUTPUT_DIR>] [-t <TEST>] [-O OPTION] [-i <INFO>] [-r] [-C] <parent_dir>
+$ esgqa [-h] [-P <parallel_processes>] [-o <OUTPUT_DIR>] [-t <TEST>] [-O OPTION] [-i <INFO>] [-r] [-C] <parent_dir>
 ```
 
 - positional arguments:
   - `parent_dir`: Parent directory to scan for netCDF-files to check
 - options:
   - `-h, --help`: show this help message and exit
+  - `-P, --parallel_processes`: Specify the maximum number of parallel processes. Default: 0 (= number of cores).
   - `-o, --output_dir OUTPUT_DIR`: Directory to store QA results. Needs to be non-existing or empty or from previous QA run. If not specified, will store results in `./cc-qa-check-results/YYYYMMDD-HHmm_<hash>`.
-  - `-t, --test TEST`: The test to run ('wcrp_cmip6:latest', 'wcrp_cordex_cmip6':latest' or 'cf:<version>', can be specified multiple times, eg.: '-t wcrp_cmip6:latest -t cf:1.7') - default: running latest CF checks 'cf:latest'.
-  - `-O, --option OPTION`: Additional options to be passed to the checkers. Format: '<checker>:<option_name>[:<option_value>]'. Multiple invocations possible.
+  - `-t, --test TEST`: The test to run (eg. `'wcrp_cmip6:latest'`, `'wcrp_cordex_cmip6:latest'` or `'cf:<version>'`, can be specified multiple times, eg.: `'-t wcrp_cmip6:latest -t cf:1.7'`) - default: running latest CF checks `'cf:latest'`. If the version is omitted, `latest` will be used.
+  - `-O, --option OPTION`: Additional options to be passed to the checkers. Format: `'<checker>:<option_name>[:<option_value>]'`. Multiple invocations possible.
   - `-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.
+  - `-r, --resume`: Specify to continue a previous QC run. Requires the `<output_dir>` argument to be set.
   - `-C, --include_consistency_checks`: Include basic consistency and continuity checks. When using the `wcrp-*`, `cc6`, `mip` or `eerie` checkers, they are included by default.
 
 ### Example Usage
 
 ```shell
-$ esgqa -t wcrp_cordex_cmip6:latest -t cf:1.11 -o QA_results/IAEVALL02_2025-10-20 -i "IAEVALL02" ESGF_Buff/IAEVALL02/CORDEX-CMIP6
+$ esgqa -P 8 -t wcrp_cordex_cmip6:latest -t cf:1.11 -o QA_results/IAEVALL02_2025-10-20 -i "IAEVALL02" 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>
+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):
 
@@ -148,7 +158,7 @@ $ esgqa -o QA_results/IAEVALL02_2025-10-20 -r
 For a custom MIP with defined CMOR tables (`"mip"` is not a placeholder but an actual basic checker of the `cc_plugin_cc6`):
 
 ```shell
-$ esgqa -o /path/to/test/results -t "mip:latest" -O "mip:tables:/path/to/mip_cmor_tables/Tables" /path/to/MIP/datasets/`
+$ esgqa -o /path/to/test/results -t "mip:latest" -O "mip:tables:/path/to/mip_cmor_tables/Tables" /path/to/MIP/datasets/
 ```
 
 For CF checks and basic time and consistency / continuity checks:
@@ -164,8 +174,13 @@ The results will be stored in two `json` files:
 
 ### Web view
 The clustered results can be viewed using the following website:
-[https://cmiphub.dkrz.de/info/display_qc_results.html](https://cmiphub.dkrz.de/info/display_qc_results.html).
+
+- DKRZ: [https://cmiphub.dkrz.de/info/display_qc_results.html](https://cmiphub.dkrz.de/info/display_qc_results.html).
+- IPSL: coming soon
+
 This website runs entirely in the user's browser using JavaScript, without requiring interaction with a web server.
+You can select one of the recent QA runs conducted at the respective site or select a local QA run result file to be displayed.
+
 Alternatively, you can open the included `display_qc_results.html` file directly in your browser.
 While the web view also supports the full (unclustered) results, it is recommended to not use the web view for files greater than a few MegaBytes.
 
@@ -188,8 +203,9 @@ in the GitLab Repository [qa-results](https://gitlab.dkrz.de/udag/qa-results). Y
 
 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](./LICENSE) file for more details.
 
+
 > [!NOTE]
-> **This project was originally developed by [DKRZ](https://www.dkrz.de)** under the name **cc-qa** (see [DKRZ GitLab](https://gitlab.dkrz.de/udag/cc-qa)), with funding from the German Ministry of Research, Technology and Space ([BMFTR](https://www.bmftr.bund.de/en), reference `01LP2326E`).
+> **This project was originally developed by [DKRZ](https://www.dkrz.de)** under the name **cc-qa** (see [DKRZ GitLab](https://gitlab.dkrz.de/udag/cc-qa)), with funding from the _German Ministry of Research, Technology and Space_ ([BMFTR](https://www.bmftr.bund.de/en), reference `01LP2326E`).
 > It has since been renamed to **esgf-qa** and is now maintained under the **Earth System Grid Federation (ESGF)** organization on GitHub.
 >
 > If you previously used `cc-qa`, please update your installations as described above.

{esgf_qa-0.3.0 → esgf_qa-0.5.0}/README.md

@@ -1,33 +1,35 @@
 [![PyPI version](https://img.shields.io/pypi/v/esgf-qa.svg)](https://pypi.org/project/esgf-qa/)
 
-# esgf-qa: Quality Assurance Workflow Based on `compliance-checker` and `cc-plugin-wcrp` 
-<img src="docs/esgf-qa_Logo.png" align="left" width="120">
-
-`esgf-qa` makes use of the frameworks and [CF](https://cfconventions.org/)-compliance checks of the
-[ioos/compliance-checker](https://github.com/ioos/compliance-checker) and extensions coming with
+# esgf-qa
+### Quality Assurance Workflow Based on `compliance-checker` and `cc-plugin-wcrp` (or other cc-plugins)
+<img src="https://raw.githubusercontent.com/ESGF/esgf-qa/master/docs/esgf-qa_Logo.png" align="left" width="120">
+
+`esgf-qa` provides a flexible quality assurance (QA) workflow for evaluating dataset compliance using the
+[ioos/compliance-checker](https://github.com/ioos/compliance-checker) framework
+(including [CF](https://cfconventions.org/) compliance checks)
+and any community plugins (`cc-plugin`s), such as
 [ESGF/cc-plugin-wcrp](https://github.com/ESGF/cc-plugin-wcrp) and
 [euro-cordex/cc-plugin-cc6](https://github.com/euro-cordex/cc-plugin-cc6).
 
-This tool is designed to run the desired file-based QC tests with
-[ioos/compliance-checker](https://github.com/ioos/compliance-checker) and
-[euro-cordex/cc-plugin-wcrp](https://github.com/euro-cordex/cc-plugin-wcrp),
-to conduct additional dataset-based checks (such as time axis continuity and
-consistency checks) as well as to summarize the test results.
+The tool executes file-based quality control (QC) tests through the Compliance Checker,
+and, where applicable, performs additional dataset-level checks to test inter-file time-axis continuity
+and consistency in variable, coordinate and attribute definitions.
+Results from both file- and dataset-level checks are aggregated, summarized, and clustered for easier interpretation.
+
+### Currently supported checkers
 
-`esgf-qa` is mainly aimed at a QA workflow testing compliance with various WCRP Project 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 is easily extendable for any `cc-plugin` and for projects defining CORDEX or CMIP style CMOR-tables.
+While `esgf-qa` has been primarily developed for workflows assessing compliance with WCRP project data specifications
+(e.g., CMIP, CORDEX), it can also be used for general CF-compliance testing and generally supports any
+`cc-plugin`. It can be easily extended to support any projects following CORDEX- or CMIP-style CMOR table conventions.
 
 | Standard                                                                                             | Checker Name |
 | ---------------------------------------------------------------------------------------------------- | ------------ |
-| [cordex-cmip6-cv](https://github.com/WCRP-CORDEX/cordex-cmip6-cv)                                    |  wcrp_cordex_cmip6, cc6 |
-| [cordex-cmip6-cmor-tables](https://github.com/WCRP-CORDEX/cordex-cmip6-cmor-tables)                  |  wcrp_cordex_cmip6, cc6 |
-| [CORDEX-CMIP6 Archive Specifications](https://doi.org/10.5281/zenodo.10961069)                       |  wcrp_cordex_cmip6, cc6 |
-| [CMIP6 DRS](https://wcrp-cmip.github.io/WGCM_Infrastructure_Panel/Papers/CMIP6_global_attributes_filenames_CVs_v6.2.7.pdf) | wcrp_cmip6 / plugin_cmip6 |
-| [cmip6-cmor-tables](https://github.com/PCMDI/cmip6-cmor-tables) (esgvoc) | wcrp_cmip6 / plugin_cmip6 |
-| [CMIP6 CVs](https://github.com/WCRP-CMIP/CMIP6_CVs) (esgvoc) | wcrp_cmip6 / plugin_cmip6 |
-| [EERIE CMOR Tables & CV](https://github.com/eerie-project/dreq_tools) | eerie |
-| Custom MIP | mip |
+| [CF Conventions](https://cfconventions.org/) (shipped with [ioos/compliance-checker](https://github.com/ioos/compliance-checker)) | cf |
+| [WCRP CMIP6](https://pcmdi.llnl.gov/CMIP6/):<br><ul><li>[CMIP6 DRS](https://wcrp-cmip.github.io/WGCM_Infrastructure_Panel/Papers/CMIP6_global_attributes_filenames_CVs_v6.2.7.pdf)</li><li>[CMIP6 CVs](https://github.com/WCRP-CMIP/CMIP6_CVs) (esgvoc)</li></li><li>[cmip6-cmor-tables](https://github.com/PCMDI/cmip6-cmor-tables) (esgvoc)</li></ul> | wcrp_cmip6 |
+| [WCRP CORDEX-CMIP6](https://cordex.org/):<br><ul><li>[CORDEX-CMIP6 Archive Specifications](https://doi.org/10.5281/zenodo.10961069)</li><li>[cordex-cmip6-cv](https://github.com/WCRP-CORDEX/cordex-cmip6-cv) (esgvoc)</li><li>[cordex-cmip6-cmor-tables](https://github.com/WCRP-CORDEX/cordex-cmip6-cmor-tables) (esgvoc)</li></ul> |  wcrp_cordex_cmip6 |
+|  [WCRP CORDEX-CMIP6](https://cordex.org/):<br><ul><li>[CORDEX-CMIP6 Archive Specifications](https://doi.org/10.5281/zenodo.10961069)</li><li>[cordex-cmip6-cv](https://github.com/WCRP-CORDEX/cordex-cmip6-cv)</li><li>[cordex-cmip6-cmor-tables](https://github.com/WCRP-CORDEX/cordex-cmip6-cmor-tables)</li></ul>  | cc6 |
+| [EERIE](https://eerie-project.eu/):<br>[EERIE CMOR Tables & CV](https://github.com/eerie-project/dreq_tools) | eerie |
+| Custom MIP (CMOR/MIP tables have to be specified) | mip |
 
 ## Installation
 
@@ -64,35 +66,41 @@ esgvoc install
 
 - Test your installation
 
-The following command should now also list the `esgf-qc` checks next to all `cc_plugin_cc6` and `compliance_checker` checks:
+The following command should now also list the `cc-plugin-wcrp` checks next to all `cc_plugin_cc6` and `compliance_checker` checks:
 ```
 cchecker.py -l
 ```
 
+The following command should now list the necessary projects with metadata sources for `esgvoc`:
+```
+esgvoc status
+```
+
 ## Usage
 
 ```shell
-$ esgqa [-h] [-o <OUTPUT_DIR>] [-t <TEST>] [-O OPTION] [-i <INFO>] [-r] [-C] <parent_dir>
+$ esgqa [-h] [-P <parallel_processes>] [-o <OUTPUT_DIR>] [-t <TEST>] [-O OPTION] [-i <INFO>] [-r] [-C] <parent_dir>
 ```
 
 - positional arguments:
   - `parent_dir`: Parent directory to scan for netCDF-files to check
 - options:
   - `-h, --help`: show this help message and exit
+  - `-P, --parallel_processes`: Specify the maximum number of parallel processes. Default: 0 (= number of cores).
   - `-o, --output_dir OUTPUT_DIR`: Directory to store QA results. Needs to be non-existing or empty or from previous QA run. If not specified, will store results in `./cc-qa-check-results/YYYYMMDD-HHmm_<hash>`.
-  - `-t, --test TEST`: The test to run ('wcrp_cmip6:latest', 'wcrp_cordex_cmip6':latest' or 'cf:<version>', can be specified multiple times, eg.: '-t wcrp_cmip6:latest -t cf:1.7') - default: running latest CF checks 'cf:latest'.
-  - `-O, --option OPTION`: Additional options to be passed to the checkers. Format: '<checker>:<option_name>[:<option_value>]'. Multiple invocations possible.
+  - `-t, --test TEST`: The test to run (eg. `'wcrp_cmip6:latest'`, `'wcrp_cordex_cmip6:latest'` or `'cf:<version>'`, can be specified multiple times, eg.: `'-t wcrp_cmip6:latest -t cf:1.7'`) - default: running latest CF checks `'cf:latest'`. If the version is omitted, `latest` will be used.
+  - `-O, --option OPTION`: Additional options to be passed to the checkers. Format: `'<checker>:<option_name>[:<option_value>]'`. Multiple invocations possible.
   - `-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.
+  - `-r, --resume`: Specify to continue a previous QC run. Requires the `<output_dir>` argument to be set.
   - `-C, --include_consistency_checks`: Include basic consistency and continuity checks. When using the `wcrp-*`, `cc6`, `mip` or `eerie` checkers, they are included by default.
 
 ### Example Usage
 
 ```shell
-$ esgqa -t wcrp_cordex_cmip6:latest -t cf:1.11 -o QA_results/IAEVALL02_2025-10-20 -i "IAEVALL02" ESGF_Buff/IAEVALL02/CORDEX-CMIP6
+$ esgqa -P 8 -t wcrp_cordex_cmip6:latest -t cf:1.11 -o QA_results/IAEVALL02_2025-10-20 -i "IAEVALL02" 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>
+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):
 
@@ -103,7 +111,7 @@ $ esgqa -o QA_results/IAEVALL02_2025-10-20 -r
 For a custom MIP with defined CMOR tables (`"mip"` is not a placeholder but an actual basic checker of the `cc_plugin_cc6`):
 
 ```shell
-$ esgqa -o /path/to/test/results -t "mip:latest" -O "mip:tables:/path/to/mip_cmor_tables/Tables" /path/to/MIP/datasets/`
+$ esgqa -o /path/to/test/results -t "mip:latest" -O "mip:tables:/path/to/mip_cmor_tables/Tables" /path/to/MIP/datasets/
 ```
 
 For CF checks and basic time and consistency / continuity checks:
@@ -119,8 +127,13 @@ The results will be stored in two `json` files:
 
 ### Web view
 The clustered results can be viewed using the following website:
-[https://cmiphub.dkrz.de/info/display_qc_results.html](https://cmiphub.dkrz.de/info/display_qc_results.html).
+
+- DKRZ: [https://cmiphub.dkrz.de/info/display_qc_results.html](https://cmiphub.dkrz.de/info/display_qc_results.html).
+- IPSL: coming soon
+
 This website runs entirely in the user's browser using JavaScript, without requiring interaction with a web server.
+You can select one of the recent QA runs conducted at the respective site or select a local QA run result file to be displayed.
+
 Alternatively, you can open the included `display_qc_results.html` file directly in your browser.
 While the web view also supports the full (unclustered) results, it is recommended to not use the web view for files greater than a few MegaBytes.
 
@@ -143,8 +156,9 @@ in the GitLab Repository [qa-results](https://gitlab.dkrz.de/udag/qa-results). Y
 
 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](./LICENSE) file for more details.
 
+
 > [!NOTE]
-> **This project was originally developed by [DKRZ](https://www.dkrz.de)** under the name **cc-qa** (see [DKRZ GitLab](https://gitlab.dkrz.de/udag/cc-qa)), with funding from the German Ministry of Research, Technology and Space ([BMFTR](https://www.bmftr.bund.de/en), reference `01LP2326E`).
+> **This project was originally developed by [DKRZ](https://www.dkrz.de)** under the name **cc-qa** (see [DKRZ GitLab](https://gitlab.dkrz.de/udag/cc-qa)), with funding from the _German Ministry of Research, Technology and Space_ ([BMFTR](https://www.bmftr.bund.de/en), reference `01LP2326E`).
 > It has since been renamed to **esgf-qa** and is now maintained under the **Earth System Grid Federation (ESGF)** organization on GitHub.
 >
 > If you previously used `cc-qa`, please update your installations as described above.

esgf_qa-0.5.0/esgf_qa/_constants.py

@@ -0,0 +1,93 @@
+from datetime import timedelta
+
+# Mapping of checker names to project names for better readability
+checker_dict = {
+    "cc6": "CORDEX-CMIP6",
+    "cf": "CF-Conventions",
+    "mip": "MIP",
+    # "wcrp-cmip5": "CMIP5",
+    "wcrp_cmip6": "CMIP6",
+    # "wcrp_cmip7aft: "CMIP7-AFT",
+    "wcrp_cmip7": "CMIP7",
+    # "wcrp_cordex": "CORDEX",
+    "wcrp_cordex_cmip6": "CORDEX-CMIP6",
+    # "obs4mips": "Obs4MIPs",
+    # "input4mips": "Input4MIPs",
+}
+checker_dict_ext = {
+    # "pcons": "ParentConsistency"
+    "cons": "Consistency",
+    "cont": "Continuity",
+    "comp": "Compatibility",
+    **checker_dict,
+}
+checker_release_versions = {}
+
+# Checkers for which consistency checks should be run
+checker_supporting_consistency_checks = [
+    "wcrp_cmip7",
+    "wcrp_cmip6",
+    "wcrp_cordex_cmip6",
+    "cc6",
+    "mip",
+]
+
+# DRS parent directory names (for identifying project root and building dataset id)
+supported_project_ids = [
+    "cmip7",
+    "cmip6plus",
+    "cmip6",
+    "cmip5",
+    "cordex",
+    "cordex-cmip6",
+    "cordex-fpsconv",
+    "obs4mips",
+    "input4mips",
+    "c3scordex",
+    "c3scmip5",
+    "c3scmip6",
+    "c3s-ipcc-ar6-atlas",
+    "c3satlas",
+    "c3s-cica-atlas",
+    "c3satlas_v1",
+    "c3s-atlas-dataset",
+    "c3satlas_v2",
+    "eerie",
+    "happi",
+    "cosmo-rea",
+]
+
+# Definition of maximum permitted deviations from the given frequency
+deltdic = {}
+deltdic["monmax"] = timedelta(days=31.01).total_seconds()
+deltdic["monmin"] = timedelta(days=27.99).total_seconds()
+deltdic["mon"] = timedelta(days=31).total_seconds()
+deltdic["daymax"] = timedelta(days=1.01).total_seconds()
+deltdic["daymin"] = timedelta(days=0.99).total_seconds()
+deltdic["day"] = timedelta(days=1).total_seconds()
+deltdic["1hrmin"] = timedelta(hours=0.99).total_seconds()
+deltdic["1hrmax"] = timedelta(hours=1.01).total_seconds()
+deltdic["1hr"] = timedelta(hours=1).total_seconds()
+deltdic["3hrmin"] = timedelta(hours=2.99).total_seconds()
+deltdic["3hrmax"] = timedelta(hours=3.01).total_seconds()
+deltdic["3hr"] = timedelta(hours=3).total_seconds()
+deltdic["6hrmin"] = timedelta(hours=5.99).total_seconds()
+deltdic["6hrmax"] = timedelta(hours=6.01).total_seconds()
+deltdic["6hr"] = timedelta(hours=6).total_seconds()
+deltdic["yrmax"] = timedelta(days=366.01).total_seconds()
+deltdic["yrmin"] = timedelta(days=359.99).total_seconds()
+deltdic["yr"] = timedelta(days=360).total_seconds()
+deltdic["subhr"] = timedelta(seconds=600).total_seconds()
+deltdic["subhrmax"] = timedelta(seconds=601).total_seconds()
+deltdic["subhrmin"] = timedelta(seconds=599).total_seconds()
+deltdic["dec"] = timedelta(days=3600).total_seconds()
+deltdic["decmax"] = timedelta(days=3599.99).total_seconds()
+deltdic["decmin"] = timedelta(days=3660.01).total_seconds()
+deltdic["cen"] = timedelta(days=36000).total_seconds()
+deltdic["cenmax"] = timedelta(days=35999.99).total_seconds()
+deltdic["cenmin"] = timedelta(days=36600.01).total_seconds()
+# CMIP-style frequencies for "time: point":
+for l_freq in ["subhr", "1hr", "3hr", "6hr", "day", "mon", "yr"]:
+    deltdic[l_freq + "Pt"] = deltdic[l_freq]
+    deltdic[l_freq + "Ptmax"] = deltdic[l_freq + "max"]
+    deltdic[l_freq + "Ptmin"] = deltdic[l_freq + "min"]

{esgf_qa-0.3.0 → esgf_qa-0.5.0}/esgf_qa/_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '0.3.0'
-__version_tuple__ = version_tuple = (0, 3, 0)
+__version__ = version = '0.5.0'
+__version_tuple__ = version_tuple = (0, 5, 0)
 
-__commit_id__ = commit_id = 'g82bd8eb5f'
+__commit_id__ = commit_id = 'g2b7e7f7fe'