diff --git a/.github/workflows/docs-build-and-deploy.yml b/.github/workflows/docs-build-and-deploy.yml index 55ad033ed7..3c7b1008b0 100644 --- a/.github/workflows/docs-build-and-deploy.yml +++ b/.github/workflows/docs-build-and-deploy.yml @@ -14,6 +14,7 @@ on: - 'src/README.unit_testing' - 'tools/README' - 'doc/test/test_container_eq_ctsm_pylib.sh' + - 'cime/CIME/non_py/cprnc/README.md' # Allows you to run this workflow manually from the Actions tab workflow_dispatch: diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml index 6c211d2a3c..1553514c05 100644 --- a/.github/workflows/docs.yml +++ b/.github/workflows/docs.yml @@ -16,6 +16,7 @@ on: - 'src/README.unit_testing' - 'tools/README' - 'doc/test/test_container_eq_ctsm_pylib.sh' + - 'cime/CIME/non_py/cprnc/README.md' pull_request: # Run on pull requests that change the listed files @@ -30,6 +31,7 @@ on: - 'src/README.unit_testing' - 'tools/README' - 'doc/test/test_container_eq_ctsm_pylib.sh' + - 'cime/CIME/non_py/cprnc/README.md' workflow_dispatch: diff --git a/doc/source/users_guide/using-clm-tools/compare-history-files.md b/doc/source/users_guide/using-clm-tools/compare-history-files.md new file mode 100644 index 0000000000..af24eb5391 --- /dev/null +++ b/doc/source/users_guide/using-clm-tools/compare-history-files.md @@ -0,0 +1,25 @@ +(comparing-history-files)= + +# Comparing History Files + +## `nccmp` + +`nccmp` allows you to compare data and/or metadata between two netCDF files. It is available as a module (`module load nccmp`) on Derecho and Casper. See the project's [GitLab](https://gitlab.com/remikz/nccmp/-/blob/master/README.md) for more information and installation instructions. + +## `cprnc` + +`cprnc` ([GitHub](https://github.com/ESMCI/cprnc)) is a tool shared across CESM to compare two NetCDF history files. It differences every field that is shared on both files, and reports a summary of the difference. The summary includes the three largest differences, as well as the root mean square (RMS) difference. It also gives some summary information on the field as well. You have to enter at least one file, and up to two files. With one file it gives you summary information on the file, and with two it gives you information on the differences between the two. At the end it will give you a summary of the fields compared and how many fields were different and how many were identical. + +`cprnc` is available as a module (`module load cprnc`) on Derecho and Casper. To install on a different machine, from the top level of a CTSM checkout, do: +```shell +cd cime/CIME/non_py/cprnc +mkdir bld +cd bld +cmake ../ +make +``` + +The `cprnc` README is embedded below for your convenience. Note that this is for the version included with CTSM (via CIME), which might differ from the version (if any) available on your machine. + +```{include} ../../../../cime/CIME/non_py/cprnc/README.md +``` diff --git a/doc/source/users_guide/using-clm-tools/cprnc.rst b/doc/source/users_guide/using-clm-tools/cprnc.rst deleted file mode 100644 index 81418877c9..0000000000 --- a/doc/source/users_guide/using-clm-tools/cprnc.rst +++ /dev/null @@ -1,24 +0,0 @@ -.. include:: ../substitutions.rst - -.. _comparing-history-files: - -========================= - Comparing History Files -========================= - -``cprnc`` is a tool shared by |cesmrelease| to compare two NetCDF history files. It differences every field that is shared on both files, and reports a summary of the difference. The summary includes the three largest differences, as well as the root mean square (RMS) difference. It also gives some summary information on the field as well. You have to enter at least one file, and up to two files. With one file it gives you summary information on the file, and with two it gives you information on the differences between the two. At the end it will give you a summary of the fields compared and how many fields were different and how many were identical. - -Options: - --m = do NOT align time-stamps before comparing - --v = verbose output - --ipr - --jpr - --kpr - -See the ``cprnc`` `README `_ file for more details. - diff --git a/doc/source/users_guide/using-clm-tools/index.rst b/doc/source/users_guide/using-clm-tools/index.rst index b721b3e7d6..bf4d1ae072 100644 --- a/doc/source/users_guide/using-clm-tools/index.rst +++ b/doc/source/users_guide/using-clm-tools/index.rst @@ -21,5 +21,5 @@ Using CLM tools creating-surface-datasets.rst creating-domain-files.rst observational-sites-datasets.rst - cprnc.rst + compare-history-files.md paramfile-tools.md