merged with development

docs/models/configurations/access-am.md

@@ -4,23 +4,33 @@
 
 <img src="../../../assets/model-config-logos/access-am-config.png" alt="ACCESS AM model" class="image-background center-img with-border with-padding"></img>
 
-The ACCESS-AM model is a coupled model between the atmosphere and the land. The atmospheric model component is the [UM model][UM-hive]. The UM model comes by default coupled to the [JULES][JULES-hive] land model. That is why the first configurations and experiments released of ACCESS-AM will be UM-JULES configurations. But the ACCESS-NRI is working to ensure subsequent releases of ACCESS-AM use the [CABLE][CABLE-hive] land model instead.
+The ACCESS **A**tmosphere **M**odel (ACCESS-AM) is a global model with atmosphere and land surface components. It is often used in Atmospheric Model Intercomparison Project (AMIP) experiments where it is driven by historically observed sea surface temperature and sea ice data.
 
-### Getting started information
+ACCESS-NRI will release supported ACCESS-AM configurations.  The first release, ACCESS-AM2, will be derived from the [CSIRO ACCESS-CM2 configuration](access-cm.md#access-cm2) and will include [atmosphere] and [land] components.
 
-[On this page][UMstart], you will find information on how to gain access to the UM model and start using the model. You will also find links to various configurations and experiments you can use as a basis to design your experiment.
+## <div class="center-icons"> ACCESS-AM2 </div>
 
-### Configurations
+This is the model configuration used for the AMIP experiments contributed to the World Climate Research Programme’s Coupled Model Intercomparison Project Phase 6 (CMIP6). Note that the CMIP model naming is the same for both the AM and CM configurations, so the CMIP6 experiments are ACCESS-CM2 AMIP rather than ACCESS-AM2.
 
+The component models are the same as ACCESS-CM2:
 
-### Experiments
+- Atmosphere model (UM vn10.6, GA7.1 science configuration): N96 resolution (1.875° x 1.25°, 85 levels). Physical model only – no carbon cycle.
 
-Some experiments already run with the UM are listed on:
+- Land surface model (CABLE2.5)
+
+[**Citation** [@Bi2020-vj]][ACCESS-CM2-cite]
+
+### Other configurations
+
+Some experiments already run with other atmospheric model configurations  are listed at:
 
  - [CLEX CMS wiki][UMexperiments]
 
+[atmosphere]: ../model_components/atmosphere.md
+[land]: ../model_components/land.md
 [UM-hive]: ../model_components/atmosphere.md#the-unified-model
 [JULES-hive]: ../model_components/land.md#jules
 [CABLE-hive]: ../model_components/land.md#cable
 [UMstart]: http://climate-cms.wikis.unsw.edu.au/Unified_Model
 [UMexperiments]: http://climate-cms.wikis.unsw.edu.au/UM_Experiments
+[ACCESS-CM2-cite]: https://www.publish.csiro.au/es/ES19040

docs/models/configurations/access-cm.md

@@ -1,38 +1,34 @@
 # <div class="highlight-bg"> ACCESS-CM  </div>
 
-ACCESS-CM2 (ACCESS Coupled Model 2) is a global fully-coupled climate model that includes the atmosphere, ocean and sea-ice components, and produces physical climate simulations. ACCESS-CM2 is one of the two models run by the Australian climate community for the 
-<a href = "https://www.wcrp-climate.org/wgcm-cmip" target="_blank"> Coupled Model Intercomparison Project, CMIP</a>.
+The ACCESS **C**oupled **M**odel (ACCESS-CM) is a fully-coupled global climate model that includes atmosphere, land, ocean and sea ice components, and produces physical climate simulations. Coupled models run by the Australian climate community are contributed to the
+<a href = "https://www.wcrp-climate.org/wgcm-cmip" target="_blank"> Coupled Model Intercomparison Project (CMIP)</a>.
 <br>
 
+ACCESS-NRI will release supported ACCESS-CM configurations.  The first release of ACCESS-CM will be derived from the [CSIRO ACCESS-CM2 configuration](#access-cm2) and will include [atmosphere], [land], [ocean] and [sea ice] components.
+
 <img src="../../../assets/model-config-logos/access-cm2-config.png" alt="ACCESS CM model" class="image-background center-img with-border with-padding"></img>
 
-## ACCESS-CM2 configurations
+## <div class="center-icons"> [ACCESS-CM2]  </div>
 
-- Atmosphere model (UM10.6): N96 resolution (1.875° x 1.25°, 85 levels). Physical model only – no carbon cycle.
+ACCESS-CM2 [@Bi2020-vj] is one of Australia’s contributions to the World Climate Research Programme’s Coupled Model Intercomparison Project Phase 6 (CMIP6).
 
-- Land surface model (CABLE2.5) 
+The component models are:
 
-- Ocean model (MOM5): Tripolar grid, 1° resolution, 50 levels.
+- Atmosphere model (UM vn10.6, GA7.1 science configuration): N96 resolution (1.875° x 1.25°, 85 levels). Physical model only – no carbon cycle.
 
-- Sea ice model (CICE5.1) 
+- Land surface model (CABLE2.5)
 
-    | COMPONENT     | MODEL         | VERSION               |
-    | ------------- | ------------- | --------------------- |
-    | Atmosphere    | UM            | 10.6                  |
-    | Land Surface  | CABLE         | 2.5 (integrated in UM)|
-    | Ocean         | MOM	        | 5                     |
-    | Sea Ice       | CICE          | 5.1                   |
-    | Coupler       | OASIS-MCT     | 3                     |
+- Ocean model (MOM5): Tripolar grid, 1° resolution, 50 levels.
 
-ACCESS-NRI will release an ACCESS-CM model configuration. The first release of ACCESS-CM will be derived from the [CSIRO ACCESS-CM2 configuration](#access-cm2) and will include [atmosphere], [land], [ocean] and [sea ice] components.
+- Sea ice model (CICE5.1.2): Same grid as ocean.
 
-## [ACCESS-CM2]
+- Coupler (OASIS3-MCT)
+
+Compared to previous model versions, ACCESS-CM2 shows better global hydrological balance, more realistic ocean water properties (in terms of spatial distribution) and meridional overturning circulation in the Southern Ocean. It does, however, produce a poorer simulation of the Antarctic sea ice and a larger energy imbalance at the top of atmosphere. ACCESS-CM2 has a relatively high equilibrium climate sensivity of 4.7°C for doubled CO<sub>2</sub> concentration.
 
 [**Citation** [@Bi2020-vj]][ACCESS-CM2-cite] |
 [**Tutorial**][ACCESS-CM2-tute]
 
-ACCESS-CM2 [@Bi2020-vj] is one of Australia’s contributions to the World Climate Research Programme’s Coupled Model Intercomparison Project Phase 6 (CMIP6). The component models are: UM10.6 GA7.1 for the atmosphere, CABLE2.5 for the land surface, MOM5 for the ocean, and CICE5.1.2 for the sea ice. Compared to previous model versions ACCESS-CM2 shows better global hydrological balance, more realistic ocean water properties (in terms of spatial distribution) and meridional overturning circulation in the Southern Ocean but a poorer simulation of the Antarctic sea ice and a larger energy imbalance at the top of atmosphere. This energy imbalance reflects a noticeable warming trend of the global ocean over the spin-up period.
-
 [atmosphere]: ../model_components/atmosphere.md
 [land]: ../model_components/land.md
 [ocean]: ../model_components/ocean.md

docs/models/configurations/access-esm.md

@@ -4,20 +4,38 @@
 
 <img src="../../../assets/model-config-logos/access-esm-config.png" alt="ACCESS CM model" class="image-background center-img with-border with-padding"></img>
 
-ACCESS-ESM stands for ACCESS **E**arth **S**ystem **M**odel. Earth system model means it is a fully-coupled model that includes carbon cycle components.
+The ACCESS **E**arth **S**ystem **M**odel (ACCESS-ESM) is a fully-coupled global climate model that also includes representations of land and ocean biogeochemisty. This means it can simulate both the physical climate and global biogeochemical cycles (the carbon cycle in particular).
 
 ACCESS-NRI will release an ACCESS-ESM model configuration. The first release of ACCESS-ESM will be derived from the [CSIRO ACCESS-ESM1.5 configuration](#access-esm15) and will include [atmosphere], [land] and [land biogeochemistry], [ocean] and [ocean biogeochemistry], and [sea ice] components.
 
 ## [ACCESS-ESM1.5]
 
+ACCESS-ESM1.5 [@Ziehn2020-fq] is a fully-coupled climate model with land and ocean carbon cycle components. ACCESS-ESM1.5 was developed primarily to enable Australia to participate in the Coupled Model Intercomparison Project Phase 6 (CMIP6) with an ESM version.
+
+The model component are:
+
+- Atmosphere model (UM vn7.3, GA7.1): N96 resolution (1.875° x 1.25°, 38 levels).
+
+- Land surface model (CABLE2.4)
+
+- Land biogeochemistry (CASA-CNP)
+
+- Ocean model (MOM5): Tripolar grid, 1° resolution, 50 levels.
+
+- Ocean biogeochemistry (WOMBAT)
+
+- Sea ice model (CICE4.1): Same grid as the ocean.
+
+- Coupler (OASIS3-MCT)
+
+ACCESS-ESM1.5 has an equilibrium climate sensitivity of 3.87°C for doubled CO<sub>2</sub> concentration.
+
 [**Citation** [@Ziehn2020-fq]][ACCESS-ESM1.5-cite]
 
 [**ACCESS Training Workshop (AMOS 2021)**][ACCESS-AMOS-Workshop]
 
 [**Webinar: *Getting Started with ACCESS-CM2 and ACCESS-ESM1.5* **][ACCESS-ESM1.5-tute]
 
-ACCESS-ESM1.5 [@Ziehn2020-fq] is a fully-coupled climate model with land and ocean carbon cycle components. ACCESS-ESM1.5 has mainly been developed to enable Australia to participate in the Coupled Model Intercomparison Project Phase 6 (CMIP6) with an ESM version. An assessment of the climate response to CO2 forcing indicates that ACCESS-ESM1.5 has an equilibrium climate sensitivity of 3.87°C.
-
 [atmosphere]: ../model_components/atmosphere.md
 [land]: ../model_components/land.md
 [land biogeochemistry]: ../model_components/bgc_land.md
@@ -29,4 +47,3 @@ ACCESS-ESM1.5 [@Ziehn2020-fq] is a fully-coupled climate model with land and oce
 [ACCESS-ESM1.5-cite]: https://www.publish.csiro.au/es/ES19035
 [ACCESS-ESM1.5-tute]: https://nespclimate.com.au/wp-content/uploads/2020/10/Webinar-slides-Getting_started_with_ACCESS.pdf
 [ACCESS-AMOS-Workshop]: https://confluence.csiro.au/display/ACCESS/Setting+up+for+ACCESS-ESM1.5
-

docs/models/configurations/access-om.md

@@ -6,23 +6,23 @@ https://forum.access-hive.org.au/t/access-om2-control-runs/258
 -->
 <img src="../../../assets/model-config-logos/access-om2-config.png" alt="ACCESS CM model" class="image-background center-img with-border with-padding"></img>
 
-The ACCESS **O**cean **M**odel, ACCESS-OM, is a global coupled ocean and sea ice configuration. It couples the ocean and sea ice components via a coupler. The atmospheric fields that drive the model are provided by a data product, usually derived from reanalysis.
+The ACCESS **O**cean **M**odel (ACCESS-OM) is a global coupled ocean and sea ice configuration with ocean and sea ice models connected via a coupler. The atmospheric fields that drive the model are provided by a data product, usually derived from reanalysis.
 
 ACCESS-NRI will release supported ACCESS-OM configurations. The first release will be derived from the COSIMA [ACCESS-OM2][COSIMA-models] suite and will include [ocean] and [sea ice] components.
 
 
 ## [ACCESS-OM2][COSIMA-models]
 
-[**Citation** [@Kiss2020-gmd]][ACCESS-OM2-cite] |
-[**Documentation**][ACCESS-OM2-docs]
+ACCESS-OM2 [@Kiss2020-gmd] is a suite of coupled ocean-sea ice models developed by the Consortium for Ocean-Sea Ice Modelling in Australia ([COSIMA][COSIMA]). All models use the [MOM5] ocean model coupled to the [CICE5] sea ice model via the OASIS3-MCT coupler.
 
-ACCESS-OM2 [@Kiss2020-gmd] is a suite of coupled ocean-sea ice models developed by the Consortium for Ocean-Sea Ice Modelling in Australia ([COSIMA][COSIMA]). All models use the [MOM5] ocean model coupled to the [CICE5] sea ice model via an OASIS3-MCT coupler.
+The ACCESS-OM2 suite has models at three different spatial resolutions:
 
-The models in the ACCESS-OM2 suite differ by their grid spatial resolution:
+ - [ACCESS-OM2][ACCESS-OM2] at 1° with 50 vertical levels.
+ - [ACCESS-OM2-025][ACCESS-OM2-025] at 0.25° with 50 vertical levels.
+ - [ACCESS-OM2-01][ACCESS-OM2-01] at 0.1° with 75 vertical levels.
 
- - [ACCESS-OM2][ACCESS-OM2] at 1° with 50 vertical levels
- - [ACCESS-OM2-025][ACCESS-OM2-025] at 0.25° with 50 vertical levels
- - [ACCESS-OM2-01][ACCESS-OM2-01] at 0.1° with 75 vertical levels
+[**Citation** [@Kiss2020-gmd]][ACCESS-OM2-cite] |
+[**Documentation**][ACCESS-OM2-docs]
 
 [ocean]: ../model_components/ocean.md
 [sea ice]: ../model_components/sea-ice.md
@@ -36,4 +36,4 @@ The models in the ACCESS-OM2 suite differ by their grid spatial resolution:
 [ACCESS-OM2-01]: http://cosima.org.au/index.php/models/access-om2-01-2/
 
 [ACCESS-OM2-cite]: https://gmd.copernicus.org/articles/13/401/2020/
-[ACCESS-OM2-docs]: https://github.com/COSIMA/access-om2/wiki
+[ACCESS-OM2-docs]: https://github.com/COSIMA/access-om2/wiki

docs/models/model_components/bgc_ocean.md

@@ -6,13 +6,12 @@
 
 <img src = "../../../assets/component-logos/component-maps/bgc-ocean-component-map.png" class="image-background"></img>
 
-## WOMBAT
-WOMBAT is the ocean carbon model (World Ocean Model of Biogeochemistry And Trophic-dynamics), developed in Australia. It calculates the carbon fluxes of the ocean, by simulating the evolution of phosphate, oxygen, dissolved inorganic carbon, alkalinity and iron with one class of phytoplankton and zooplankton.
+## <div class="center-icons"> WOMBAT  </div>
 
-WOMBAT is a Nutrient, Phytoplankton, Zooplankton and Detritus (NPZD) model, with one zooplankton and one phytoplankton class.
+The World Ocean Model of Biogeochemistry And Trophic-dynamics (WOMBAT) is the ocean biogeochemistry module added to ACCESS models. The core of WOMBAT is a Nutrient, Phytoplankton, Zooplankton and Detritus (NPZD) cycle. WOMBAT simulates the evolution of open-ocean phosphate, oxygen, dissolved inorganic carbon, alkalinity, iron and carbon fluxes with one zooplankton and one phytoplankton class.
 
 ### How is WOMBAT used?
+WOMBAT is applied as a tracer package in the ACCESS ocean model [MOM5][mom5-github]. In the ACCESS-OM2 configuration, WOMBAT is used in MOM5 and coupled with sea ice biogeochemistry. WOMBAT is also applied in [MOM5 of the ACCESS-ESM1.5 configuration][MOM5-esm-code]  used for CMIP6.
 
-WOMBAT is [coupled to the MOM5 ocean model][MOM5-WOMBAT-code] in the ACCESS-ESM1.5 and ACCESS-OM2 models.
-
-[MOM5-WOMBAT-code]: https://github.com/COSIMA/ACCESS-ESM1.5-MOM5
+[mom5-github]: https://github.com/mom-ocean/MOM5
+[MOM5-esm-code]: https://github.com/COSIMA/ACCESS-ESM1.5-MOM5

docs/models/model_components/land.md

@@ -8,11 +8,11 @@
 
 ## [CABLE][cable-wiki]
 
-[Community Atmosphere Biosphere Land Exchange (CABLE)][cable-web] is a land surface model, used to calculate the fluxes of momentum, energy, water and carbon between the land surface and the atmosphere. It also models the main biogeochemical cycles of the land ecosystem when used in conjunction with [the CASA-CNP module][casa-cnp]. 
+[Community Atmosphere Biosphere Land Exchange (CABLE)][cable-web] is a land surface model used to calculate the fluxes of momentum, energy, water and carbon between the land surface, vegetation canopy and the atmospheric boundary layer. It also includes descriptions of thermal and hydrological processes in the soil and snow, and models the main biogeochemical cycles of the land ecosystem when used in conjunction with the [CASA-CNP][casa-cnp] module.  
 
 ### How is CABLE used?
 
-CABLE can be run as a standalone model, for a single location, a region or globally. Coupled to the Met Office [Unified Model (UM)](um-web), CABLE provides the land surface component of the ACCESS Earth System Model (ACCESS-ESM) and ACCESS Coupled Model (ACCESS-CM).
+CABLE provides the land surface component of the ACCESS Earth System Model (ACCESS-ESM) and the ACCESS Coupled Model (ACCESS-CM). Directly coupled into the [Unified Model (UM)](um-web), CABLE replaces relevant parts of the functionality of the UM’s own land surface scheme (JULES). CABLE can also be run as a standalone model, for a single location, a region or globally. 
 
 CABLE is an open source model developed by a community of Australian climate science researchers. [Registration][cable-wiki] is required to access the CABLE code repository.