diff --git a/docs/model_evaluation/model_evaluation_on_gadi/index.md b/docs/model_evaluation/model_evaluation_on_gadi/index.md index 17f0a33a6..bce9227f8 100644 --- a/docs/model_evaluation/model_evaluation_on_gadi/index.md +++ b/docs/model_evaluation/model_evaluation_on_gadi/index.md @@ -1,7 +1,6 @@ -# Model Evaluation on Gadi/NCI - -At the moment, we are providing support for an the following model evaluation frameworks on Gadi/NCI: +# Model Evaluation on Gadi +ACCESS-NRI currently provides support for the following model evaluation frameworks on Gadi:
@@ -30,6 +29,6 @@ At the moment, we are providing support for an the following model evaluation fr
-The best way to get our help is by raising an issue on the community forum with tags `help` and another tag for the specific framework. - -In the future, we are also aiming to support a broader range of frameworks and recipes which are currently not supported (see [our community resource lists](../../community_resources/community_med/index.md) for this collection). \ No newline at end of file + +
+In future, ACCESS-NRI aims to support a broader range of frameworks and recipes that are currently not supported, but are listed in Community Resources. \ No newline at end of file diff --git a/docs/model_evaluation/model_evaluation_on_gadi/model_evaluation_on_gadi_ilamb.md b/docs/model_evaluation/model_evaluation_on_gadi/model_evaluation_on_gadi_ilamb.md index dcf56fdb9..bc1b78751 100644 --- a/docs/model_evaluation/model_evaluation_on_gadi/model_evaluation_on_gadi_ilamb.md +++ b/docs/model_evaluation/model_evaluation_on_gadi/model_evaluation_on_gadi_ilamb.md @@ -1,24 +1,31 @@ -# ILAMB and IOMB on Gadi at NCI +# ILAMB and IOMB on Gadi ## What are ILAMB and IOMB? -`ilamb` is a Python framework for International Land Model Benchmarking (ILAMB) and International Ocean Model Benchmark (IOMB). In brief, `ilamb` can be used to quantitatively compare a defined set of observable variables with a number of land and ocean models. +`ilamb` is a Python framework for both the International Land Model Benchmarking (ILAMB) project and the International Ocean Model Benchmark (IOMB) package. +
+In brief, `ilamb` can be used to quantitatively compare a defined set of observable variables with a number of land and ocean models. -???+ warning "Support Level: Supported on Gadi, but not owned by ACCESS-NRI" +???+ warning "Support Level: supported on Gadi, but not owned by ACCESS-NRI" ILAMB/IOMB is a community-developed climate model diagnostics and evaluation software package. - ACCESS-NRI does not own the code of ILAMB/IOMB, but actively supports the use of ILAMB/IOMB on Gadi. - ILAMB development is primarily performed by the RUBISCO Science Focus Area and supported by the RGMA Activity of the EESSD division of the BER program in the United States Department of Energy’s Office of Science. - ACCESS-NRI provides access to the latest version of ILAMB/IOMB via the `xp65` access-med conda environment deployed on Gadi. + While ACCESS-NRI does not own the code, it actively supports the use of the software package on Gadi. +
+ + ACCESS-NRI provides access to the latest version of ILAMB/IOMB via the `xp65` access-med conda environment deployed on Gadi. -This documentation is tailored to using the tool within the NCI infrastructure and designed to supplement, rather than replace, the official documentation. We encourage users to read the ILAMB documentation and its Tutorials. +This documentation is tailored to using `ilamb` on Gadi and, thus, it designed to supplement rather than replace the official documentation. Users are encouraged to read the ILAMB documentation and relevant tutorials. ## Using ILAMB and IOMB on Gadi -`ilamb` is provided through both the `xp65` and `hh5` code projects on Gadi at the National Computational Infrastructure. To use `ilamb` through this infrastructure, you need to have an NCI account and join the projects. See our [Getting Started Guide](../../getting_started/index.md). +`ilamb` is provided through both the `xp65` and `hh5` NCI projects on Gadi. Hence, you need to have an NCI account and be a member of these projects to use `ilamb`. -You will find the information needed to run ILAMB and IOMB on Gadi in our documentation: +
+ To obtain an NCI account and join NCI projects, refer to Getting Started. +
+ +For ACCESS-NRI documentation on how to run ILAMB and IOMB on Gadi, please visit:
@@ -29,40 +36,56 @@ You will find the information needed to run ILAMB and IOMB on Gadi in our docume
-To run `ilamb`, you need to execute the command `ilamb-run` with a number of arguments/files: +
+To run `ilamb`, you need to execute the command `ilamb-run` with a number of arguments/ files: ``` ilamb-run --config config.cfg --model_setup model_setup.txt --regions regions.txt ``` + -- `config.cfg` defines which observables and observational datasets will be compared -- `model_setup.txt` defines the paths of the models that will be compared -- `regions.txt` defines the regions (like `global`, `aust` for Australia, or your own region definition) that will be compared. - -While you can define these files yourself, ACCESS-NRI is providing the files and tools to get your model paths sorted and perform computations on Gadi. - -All you need to do is figure out which observations and models you would like to compare: ACCESS-NRI, and NCI as the host, are providing replicas of the ILAMB and IOMB observational data sets through the NCI project `ct11`. Thanks to NCI as national data repository, you can easily get access to a large amount of model outputs on Gadi, including ACCESS mdoel output, and compare it to observations. You can read on how to find more observational data in our [Observational Data Section](../model_evaluation_observational_catalogs.md) and how to find model outputs in our [Model Data Section](../model_evaluation_model_catalogs/index.md). +While you can define these files yourself, ACCESS-NRI provides the necessary files and tools to set your model paths for running computations on Gadi. All you need to do is decide which observations and models you would like to compare. +
+NCI hosts replicas of the ILAMB and IOMB observational data sets through the NCI project `ct11` as well as a large amount of model outputs are available on Gadi, such as ACCESS model output. -If you want to learn how to adjust the `ilamb` setup, you can also read the official ILAMB documentation and its Tutorial. +For more information, refer to Observational Data Catalogue on how to find observational data on NCI and ACCESS-NRI Intake Catalog for how to find model outputs. +
+To learn more about how to adjust the ilamb setup, refer to the official ILAMB documentation and relevant tutorials. -## Showcases: CMIP6 comparisons and ACCESS ESM1.5 benchmarking +## Showcase: CMIP6 comparisons and ACCESS ESM1.5 benchmarking -ACCESS-NRI is maintaining a collection of benchmark comparisons for the community, such as the comparison of Coupled Model Intercomparison Project (CMIP) like +ACCESS-NRI is maintaining a collection of benchmark comparisons for the ACCESS community, such as that with Coupled Model Intercomparison Project (CMIP) data: -- CMIP5 and CMIP6 Land Models, -- CMIP6 Land Models, -- Offline CMIP6 Models, and -- CMIP5 and CMIP6 Ocean Models. +- CMIP5 and CMIP6 Land Models +- CMIP6 Land Models +- Offline CMIP6 Models +- CMIP5 and CMIP6 Ocean Models -For our showcase, however, we are comparing the ACCESS Earth System Model version 1.5 that is supported by ACCESS-NRI with two other Earth System Models: +In the following example, the supported ACCESS Earth System Model (ESM) ACCESS-ESM1.5 is compared with two other ESM models: -- ACCESS-ESM1.5 (ACCESS Earth System Model version 1.5), -- BCC ESM1 (Beijing Climate Center Earth System Model version 1), and +- BCC ESM1 (Beijing Climate Center Earth System Model version 1) - CanESM5 (Canadian Earth System Model version 5) -We have performed a large amount of benchmark comparisons that were defined in the configuration file. We have organised the comparison of variables under different sections, like the Hydrology Cycle. For different variables, like the gross primary productivity `gpp`, we can compare to one or more datasets, like the gross primary productivity measurements of FLUXNET2015. Clicking on a row of the table will expand it to reveal the underlying datasets used. In the below table, the colormap extends from best values in purple to worse data in orange. +A large amount of benchmark comparisons have been defined in the configuration file. +
+The comparison of variables have been organised under different sections, such as the Hydrology Cycle. +
+For other variables, such as the gross primary productivity `gpp`, one or more datasets are available. For example, the gross primary productivity measurements of FLUXNET2015. +
+
+By clicking on a row in the table, you can expand it to see the underlying datasets used. +
+In the below table, the colourmap extends from best values in purple to worse data in orange.

Starting side of ILAMB output

-Clicking on one of these datasets, for example CERESed4.1, will take you to an interactive and quantitative comparison page for Albedo measurements of the Clouds and the Earth’s Radiant Energy System (CERES) project: +
+Clicking on one of these datasets, for example `CERESed4.1`, will take you to an interactive and quantitative comparison page for Albedo measurements of the Clouds and the Earth’s Radiant Energy System (CERES) project:

Comparison of different ILAMB outputs

\ No newline at end of file