GLOMAP versions: Difference between revisions

Latest revision as of 10:20, 15 January 2024

A 3-month activity in January to March 2019, funded via the JWCRP project ACE (Aerosol and Chemistry Efficiency, PI Dr. Graham Mann, NCAS-Climate, Univ Leeds; co-I Dr. Fiona O'Connor, UK Met Office), involved PDRA Dr. Masaru Yoshioka (Univ. Leeds) consolidating code-changes added by Leeds University researchers in projects during 2015-2018 into "upgrade branches" defining the different versions of the GLOMAP codebase maintained by the core GLOMAP development team at Leeds.

The work successfully consolidated these code-changes into UM branches of the latest version of the UM at that time (UM v11.0), in preparation for lodging these back to the trunk at a subsequent UM v11.x version.

The information on the content of these branches and other details can be found in these two documents -- a brief report for the JWCRP/NCAS-funded activity and a summary poster presented to the UK composition climate modelling meeting in March 2019, with input also from Dr. Adrian Hill at the Met Office :

Following discussion at the UKCA Code Management Group meeting, Mark Richardson created the Table below, to provide the main points from these documents -- and re: the reference GLOMAP versions set out in the GLOMAP software license Media:GLOMAPmode_PET_forECMWFandCNRSlicense_May2021version.pdf

GLOMAP-mode version	comment	reference	available in UM branch	MOSRS ticket ID
5.0	origin	gmd 2010 paper
6.0R	R means recalibrated	x
7newprim	primary emissions	x
7newprim+dust	Dust modal scheme and its ageing	x	vn11.0_dust_ageing	x
8.0	Implementation of vapour pressure of H2SO4 gas, mainly affecting stratospheric aerosol	Dhomse, ACP, 2014 (Section 2.2) - https://acp.copernicus.org/articles/14/11221/2014/acp-14-11221-2014.html	Originally masaruyoshioka/vn11.0_updateGLOMAPtoDhomse14ACP + masaruyoshioka/vn11.0_other_minor_updates; those 2 branches combined at vn12.2 into danielgrosvenor/vn12.2_UKCA_upgrade_to_GLOMAPv8.0_based_on_Dhomse2014	https://code.metoffice.gov.uk/trac/um/ticket/1442 & https://code.metoffice.gov.uk/trac/um/ticket/6743
8.0+dust	Dust modal scheme and its ageing	x	masaruyoshioka/vn11.0_dust_ageing@62858	x
8.1	Cloud ice fraction threshold added to suppress nucleation scavenging in mixed phase clouds. Only a fraction of sec org is now used in Metzger nucleation. Bug-fix: missing scaling of SEC_ORG discovered by Cat Scott (*This bug-fix has now been implemented in the UM trunk@vn12.0 - https://code.metoffice.gov.uk/trac/um/ticket/6159 - so, we won't want to add this part. CHECK whether this also applies to "only using a fraction of sec org" above. *)	x	masaruyoshioka/vn11.0_ukca_glomap_bugfix_SECORGorgNPF, vn11.0_ACID_PRUF_GASSP, vn11.0_UKCA_icescavupd_fromJMscav, Sec_Org scaling bug fix only: UM trunk@vn12.0	Sec_Org scaling bug fix only: https://code.metoffice.gov.uk/trac/um/ticket/6159
8.2	Changes to ageing of Meteoric Smoke Particles (MSP)	x	masaruyoshioka/vn11.0_GLOMAPmode6matchMSPfromWACCM	x
8.3	Improvement of Evaporation of H2SO4 off MSPs	x	Not ported to vn11.0 (or higher)	x
9.0	Hybrid Dissolution Solver (HyDiS) for Nitrate and Ammonia aerosols	Benduhn et al., 2016, GMD (https://gmd.copernicus.org/articles/9/3875/2016/); Hana Pearce's thesis (https://etheses.whiterose.ac.uk/25173/)	Not ported to vn11.0 (or higher). vn7.3 used in Hana Pearce's thesis	x

End of DOC

@@ Line 1: / Line 1: @@
+A 3-month activity in January to March 2019, funded via the JWCRP project ACE (Aerosol and Chemistry Efficiency, PI Dr. Graham Mann, NCAS-Climate, Univ Leeds; co-I Dr. Fiona O'Connor, UK Met Office), involved PDRA Dr. Masaru Yoshioka (Univ. Leeds) consolidating code-changes added by Leeds University researchers in projects during 2015-2018 into "upgrade branches" defining the different versions of the GLOMAP codebase maintained by the core GLOMAP development team at Leeds.
-This page will contain information on GLOMAP versions in the table below, e.g.
+The work successfully consolidated these code-changes into UM branches of the latest version of the UM at that time (UM v11.0), in preparation for lodging these back to the trunk at a subsequent UM v11.x version.
+The information on the content of these branches and other details can be found in these two documents -- a brief report for the JWCRP/NCAS-funded activity and a summary poster presented to the UK composition climate modelling meeting in March 2019, with input also from Dr. Adrian Hill at the Met Office :
+* [[Media:GLOMAP_code_consolidation_activities_2.pdf|GLOMAP_code_consolidation_activities_2.pdf]]
+* Poster: [[Media:2019-03_NCAS-CCI_poster_GLOMAP-1.pdf|2019-03_NCAS-CCI_poster_GLOMAP-1.pdf]]
+Following discussion at the UKCA Code Management Group meeting, Mark Richardson created the Table below, to provide the main points from these documents -- and re: the reference GLOMAP versions set out in the GLOMAP software license [[Media:GLOMAPmode_PET_forECMWFandCNRSlicense_May2021version.pdf|Media:GLOMAPmode_PET_forECMWFandCNRSlicense_May2021version.pdf]]
 {| class="wikitable" border = "1px"
+! GLOMAP-mode version !! comment !! reference !!  available in UM branch !! MOSRS ticket ID
-!style="text-align:top;rowspan:2";|GLOMAP CTM version & functionality
-!style="text-align:top;rowspan:2";|UM version (trunk version or branch with ticket)
-!style="text-align:top;rowspan:2";|IFS version
-!style="text-align:top;rowspan=2";|Other model...
-!style="text-align:top;rowspan=2";|Another model...
 |-
-| '''A.0'''<br/>Some functionality || UMvnX.Y (trunk) || IFS version ||  ||
+| 5.0  || origin || gmd  2010 paper || ||
 |-
+| 6.0R  || R means recalibrated || x ||  ||
-| '''B.1'''<br/>Some more functionality || In branch [https://code.metoffice.gov.uk/trac/um/log/main/branches/dev/lukeabraham/vn10.9_UKCA_Worked_Example vn10.9_UKCA_Worked_Example]<br/>See ticket [https://code.metoffice.gov.uk/trac/um/ticket/3639 um:#3639] ||  || Some other model version || A different model version
 |-
+| 7newprim || primary emissions || x || ||
+|-
+| 7newprim+dust || Dust modal scheme and its ageing || x || vn11.0_dust_ageing || x
+|-
+| 8.0 || Implementation of vapour pressure of H2SO4 gas, mainly affecting stratospheric aerosol || Dhomse, ACP, 2014 (Section 2.2) - https://acp.copernicus.org/articles/14/11221/2014/acp-14-11221-2014.html || Originally masaruyoshioka/vn11.0_updateGLOMAPtoDhomse14ACP + masaruyoshioka/vn11.0_other_minor_updates; those 2 branches combined at vn12.2 into danielgrosvenor/vn12.2_UKCA_upgrade_to_GLOMAPv8.0_based_on_Dhomse2014 || https://code.metoffice.gov.uk/trac/um/ticket/1442 & https://code.metoffice.gov.uk/trac/um/ticket/6743
+|-
+| 8.0+dust || Dust modal scheme and its ageing || x || masaruyoshioka/vn11.0_dust_ageing@62858 || x
+|-
+| 8.1 || Cloud ice fraction threshold added to suppress nucleation scavenging in mixed phase clouds. Only a fraction of sec org is now used in Metzger nucleation. Bug-fix: missing scaling of SEC_ORG discovered by Cat Scott (***This bug-fix has now been implemented in the UM trunk@vn12.0 - https://code.metoffice.gov.uk/trac/um/ticket/6159 - so, we won't want to add this part. CHECK whether this also applies to "only using a fraction of sec org" above. ***) || x || masaruyoshioka/vn11.0_ukca_glomap_bugfix_SECORGorgNPF, vn11.0_ACID_PRUF_GASSP, vn11.0_UKCA_icescavupd_fromJMscav, Sec_Org scaling bug fix only: UM trunk@vn12.0 || Sec_Org scaling bug fix only: https://code.metoffice.gov.uk/trac/um/ticket/6159
+|-
+| 8.2 || Changes to ageing of Meteoric Smoke Particles (MSP) || x || masaruyoshioka/vn11.0_GLOMAPmode6matchMSPfromWACCM || x
+|-
+| 8.3 || Improvement of Evaporation of H2SO4 off MSPs || x || Not ported to vn11.0 (or higher) || x
+|-
+| 9.0 || Hybrid Dissolution Solver (HyDiS) for Nitrate and Ammonia aerosols || Benduhn et al., 2016, GMD (https://gmd.copernicus.org/articles/9/3875/2016/); Hana Pearce's thesis (https://etheses.whiterose.ac.uk/25173/) || Not ported to vn11.0 (or higher). vn7.3 used in Hana Pearce's thesis  || x
 |}
+End of DOC