Difference between revisions of "GEOS-Chem v9-01-02"

From Geos-chem
Jump to: navigation, search
(Fixes in emep_mod.f)
 
(84 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
== Overview ==
 
== Overview ==
  
BETA RELEASE -- Summer/Fall 2011
+
=== History ===
  
*Previous version: [[GEOS-Chem v9-01-01]]
+
The table below shows the previous, current, and successive versions of GEOS-Chem:
*Next version: [[GEOS-Chem v9-01-03]]
+
 
 +
{| border=1 cellspacing=0 cellpadding=5
 +
|-align="center"
 +
!width="250px"|Previous version
 +
!width="250px" bgcolor="#CCFFFF"|This version
 +
!width="250px"|Next version
 +
|-align="center"
 +
|[[GEOS-Chem v9-01-01]]
 +
|bgcolor="#CCFFFF"|'''GEOS-Chem v9-01-02'''
 +
|[[GEOS-Chem v9-01-03]]
 +
|-align="center"
 +
|PUBLIC RELEASE Feb 10 2011<br>RE-RELEASED ON 07 Jun 2011
 +
|bgcolor="#CCFFFF"|'''PUBLIC RELEASE 28 Nov 2011'''
 +
|PUBLIC RELEASE 14 Sep 2012
 +
|-align="center"
 +
|[[GEOS-Chem v9-01-01 benchmark history|View v9-01-01 benchmark history]]
 +
|bgcolor="#CCFFFF"|[[GEOS-Chem v9-01-02 benchmark history|'''View v9-01-02 benchmark history''']]
 +
|[[GEOS-Chem v9-01-03 benchmark history|View v9-01-03 benchmark history]]
 +
|}
 +
 
 +
--[[User:Bmy|Bob Y.]] 10:21, 16 January 2014 (EST)
  
 
=== What's new in this version ===
 
=== What's new in this version ===
  
 
GEOS-Chem v9-01-02 contains the following new features:
 
GEOS-Chem v9-01-02 contains the following new features:
 +
 +
''v9-01-02a, v9-01-02b, etc. denote 1-month benchmark simulations, which are designed to evaluate GEOS-Chem's performance at intermediate stages of development.<br>Alternating stripes of color (white & cyan) in the table below group together features that were evaluated in the same 1-month benchmark.''
  
 
{| border=1 cellspacing=0 cellpadding=5  
 
{| border=1 cellspacing=0 cellpadding=5  
Line 29: Line 51:
 
|" "
 
|" "
 
|" "
 
|" "
|-
+
|-bgcolor="CCFFFF"
 
|[[Restart_files#Potential_issue_with_reading_restart.cspec_file|Fix for mis-indexing issue in CSPEC restart file]]
 
|[[Restart_files#Potential_issue_with_reading_restart.cspec_file|Fix for mis-indexing issue in CSPEC restart file]]
 
|Bug Fix
 
|Bug Fix
Line 41: Line 63:
 
|[[GEOS-Chem v9-01-02 benchmark history#v9-01-02d|v9-01-02d]]
 
|[[GEOS-Chem v9-01-02 benchmark history#v9-01-02d|v9-01-02d]]
 
|Approved 26 Jul 2011
 
|Approved 26 Jul 2011
|-
+
|-bgcolor="CCFFFF"
 
|[[#Various bug fixes for the offline Hg simulation|Various bug fixes for the offline Hg simulation]]
 
|[[#Various bug fixes for the offline Hg simulation|Various bug fixes for the offline Hg simulation]]
 
|Bug Fix
 
|Bug Fix
Line 47: Line 69:
 
|[[GEOS-Chem v9-01-02 benchmark history#v9-01-02e|v9-01-02e]]
 
|[[GEOS-Chem v9-01-02 benchmark history#v9-01-02e|v9-01-02e]]
 
|Approved 01 Aug 2011
 
|Approved 01 Aug 2011
|-
+
|-bgcolor="CCFFFF"
 
|[[#Bug fix for leap years with GCAP|Bug fixes for leap years when using GCAP met fields]]
 
|[[#Bug fix for leap years with GCAP|Bug fixes for leap years when using GCAP met fields]]
 
|Bug Fix
 
|Bug Fix
Line 53: Line 75:
 
|" "
 
|" "
 
|" "
 
|" "
|-
+
|-bgcolor="CCFFFF"
 
|[[#Minor bug fixes for emissions routines affecting offline simulations|Minor bug fixes for emissions routines affecting offline simulations]]
 
|[[#Minor bug fixes for emissions routines affecting offline simulations|Minor bug fixes for emissions routines affecting offline simulations]]
 
|Bug Fix
 
|Bug Fix
Line 59: Line 81:
 
|" "
 
|" "
 
|" "
 
|" "
|-
+
|-bgcolor="CCFFFF"
 
|[[#Fixes for minor issues affecting nested-grid simulations|Fixes for minor issues affecting nested-grid simulations]]
 
|[[#Fixes for minor issues affecting nested-grid simulations|Fixes for minor issues affecting nested-grid simulations]]
 
|Bug Fix
 
|Bug Fix
Line 65: Line 87:
 
|" "
 
|" "
 
|" "
 
|" "
|-
+
|-bgcolor="CCFFFF"
 
|[[#Bug fixes for compatibility with the PGI compiler|Fixes for better compatibility with the PGI compiler]]
 
|[[#Bug fixes for compatibility with the PGI compiler|Fixes for better compatibility with the PGI compiler]]
 
|Bug Fix
 
|Bug Fix
Line 71: Line 93:
 
|" "
 
|" "
 
|" "
 
|" "
|-
+
|-bgcolor="CCFFFF"
 
|[[#Planeflight diagnostic update|Add MERRA SEAICExx fields to the planeflight diagnostic]]
 
|[[#Planeflight diagnostic update|Add MERRA SEAICExx fields to the planeflight diagnostic]]
 
|Structural
 
|Structural
Line 83: Line 105:
 
|[[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02f|v9-01-02f]]
 
|[[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02f|v9-01-02f]]
 
|Approved 02 Aug 2011
 
|Approved 02 Aug 2011
|-
+
|-bgcolor="CCFFFF"
 
|[[#Overhaul of aerosol optical depth diagnostics|Overhaul of AOD diagnostics]]
 
|[[#Overhaul of aerosol optical depth diagnostics|Overhaul of AOD diagnostics]]
 
|Structural
 
|Structural
Line 95: Line 117:
 
|[[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02h|v9-01-02h]]
 
|[[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02h|v9-01-02h]]
 
|Approved 12 Aug 2011
 
|Approved 12 Aug 2011
|-
+
|-bgcolor="CCFFFF"
 
|[[Dry deposition#Aerosol dry deposition velocities over snow and ice surfaces|Updated dry deposition velocities for aerosols over ice and snow]]
 
|[[Dry deposition#Aerosol dry deposition velocities over snow and ice surfaces|Updated dry deposition velocities for aerosols over ice and snow]]
 
|Science
 
|Science
Line 101: Line 123:
 
|[[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02i|v9-01-02i]]
 
|[[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02i|v9-01-02i]]
 
|Approved 15 Aug 2011
 
|Approved 15 Aug 2011
|-
+
|-bgcolor="CCFFFF"
 
|[[#Archive the MERRA SWGDN field in the ND67 diagnostic|Archive the MERRA SWGDN (incident radiation @ sfc) field in the ND67 diagnostic]]
 
|[[#Archive the MERRA SWGDN field in the ND67 diagnostic|Archive the MERRA SWGDN (incident radiation @ sfc) field in the ND67 diagnostic]]
 
|Structural
 
|Structural
Line 108: Line 130:
 
|" "
 
|" "
 
|-
 
|-
|[[Anthropogenic_emissions#Streets_2000|Imposed seasonality on NH3 emissions from David Streets 2000 inventory]]
+
|[[David Streets regional emissions for China and SE Asia#NH3 emissions seasonality in Streets 2000|Imposed seasonality on NH3 emissions from David Streets 2000 inventory]]
 
|Science
 
|Science
 
|Jenny Fisher (Harvard)
 
|Jenny Fisher (Harvard)
Line 119: Line 141:
 
|" "
 
|" "
 
|" "
 
|" "
|-
+
|-bgcolor="CCFFFF"
 
|[[Implementation of RETRO Anthropogenic Emissions]]
 
|[[Implementation of RETRO Anthropogenic Emissions]]
 
|Science
 
|Science
Line 137: Line 159:
 
|" "
 
|" "
 
|" "
 
|" "
|-
+
|-bgcolor="CCFFFF"
 
|[[Grid-independent GEOS-Chem#Elimination of COMMON_blocks|Eliminate common block header files + Other source-code updates for ESMF compatibility]]
 
|[[Grid-independent GEOS-Chem#Elimination of COMMON_blocks|Eliminate common block header files + Other source-code updates for ESMF compatibility]]
 
|Structural
 
|Structural
Line 155: Line 177:
 
|" "
 
|" "
 
|" "
 
|" "
|-
+
|-bgcolor="CCFFFF"
 
|[[Implementation of RETRO Anthropogenic Emissions#Double-counting of residential biofuel|Eliminate double-counting of residential biofuel when using RETRO anthro VOC emissions]]
 
|[[Implementation of RETRO Anthropogenic Emissions#Double-counting of residential biofuel|Eliminate double-counting of residential biofuel when using RETRO anthro VOC emissions]]
 
|Bug Fix
 
|Bug Fix
Line 185: Line 207:
 
|" "
 
|" "
 
|" "
 
|" "
|-
+
|-bgcolor="CCFFFF"
 
|[[Centralized chemistry time step|Centralizing chemistry time step]]
 
|[[Centralized chemistry time step|Centralizing chemistry time step]]
 
|Structural
 
|Structural
Line 197: Line 219:
 
|[[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02r|v9-01-02r]]
 
|[[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02r|v9-01-02r]]
 
|Approved 20 Oct 2011
 
|Approved 20 Oct 2011
|-
+
|-bgcolor="CCFFFF"
 
|[[#Bug fixes for biofuel emissions|Bug fixes for biofuel emissions]]
 
|[[#Bug fixes for biofuel emissions|Bug fixes for biofuel emissions]]
 
|Bug Fix
 
|Bug Fix
Line 203: Line 225:
 
|[[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02s|v9-01-02s]]
 
|[[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02s|v9-01-02s]]
 
|Approved 5 Nov 2011
 
|Approved 5 Nov 2011
|-
+
|-bgcolor="CCFFFF"
 
|[[Ship emissions#Potential bug in EDGAR ship emissions code|Fix bug in EDGAR ship emissions code]]
 
|[[Ship emissions#Potential bug in EDGAR ship emissions code|Fix bug in EDGAR ship emissions code]]
 
|Bug Fix
 
|Bug Fix
Line 209: Line 231:
 
|" "
 
|" "
 
|" "
 
|" "
|-
+
|-bgcolor="CCFFFF"
 
|[[Ship emissions#Bug in ship NOx emissions|Bug fix for ship NOx emissions]]
 
|[[Ship emissions#Bug in ship NOx emissions|Bug fix for ship NOx emissions]]
 
|Bug fix
 
|Bug fix
Line 215: Line 237:
 
|" "
 
|" "
 
|" "
 
|" "
|-
+
|-bgcolor="CCFFFF"
 
|[[Mercury#Anthropogenic_Emissions|GEIA 2005 Hg emissions]]
 
|[[Mercury#Anthropogenic_Emissions|GEIA 2005 Hg emissions]]
 
|Science
 
|Science
Line 221: Line 243:
 
|" "
 
|" "
 
|" "
 
|" "
 +
|-
 +
|[[#Prevent out-of-bounds errors in ND01 and ND02 diagnostics for Rn-Pb-Be simulation|Prevent out-of-bounds errors in ND01 and ND02 diagnostics for Rn-Pb-Be simulation]]
 +
|Bug fix
 +
|[[GEOS-Chem Support Team]]
 +
|last-minute fix
 +
|08 Nov 2011
 
|-
 
|-
 
|[[#Do not use erroneous MEGAN AEF data for nested-grid simulations|Do not use erroneous MEGAN AEF data for nested-grid simulations]]
 
|[[#Do not use erroneous MEGAN AEF data for nested-grid simulations|Do not use erroneous MEGAN AEF data for nested-grid simulations]]
 
|Bug fix
 
|Bug fix
 
|Lin Zhang
 
|Lin Zhang
 +
|last-minute fix
 +
|22 Nov 2011
 +
|-
 +
|[[Mercury#In-plume reduction|Modify constant used for in-plume reduction in Hg simulation]]
 +
|Science
 +
|Helen Amos(Harvard)<br>Noelle Selin (MIT)<br>Yanxu Zhang (U. Washington
 
|last-minute fix
 
|last-minute fix
 
|28 Nov 2011
 
|28 Nov 2011
 
|}
 
|}
  
--[[User:Bmy|Bob Y.]] 10:15, 28 November 2011 (EST)
+
--[[User:Bmy|Bob Y.]] 14:51, 29 November 2011 (EST)
  
 
=== New data directories ===
 
=== New data directories ===
Line 235: Line 269:
 
The following new data directories have been added for GEOS-Chem v9-01-02.  You will have to download the directories relevant to your simulation.
 
The following new data directories have been added for GEOS-Chem v9-01-02.  You will have to download the directories relevant to your simulation.
  
You can download these directories with anonymous FTP or the Wget utility.  For instructions, please see [http://acmg.seas.harvard.edu/geos/doc/man/chapter_2.html#2.4 Chapter 2.4, Downloading the GEOS-Chem shared data directories] in the GEOS-Chem Online User's Guide.
+
You can download these directories with anonymous FTP or the Wget utility.  For instructions, please see [http://acmg.seas.harvard.edu/geos/doc/archive/man.v9-01-02/chapter_2.html#2.4 Chapter 2.4, Downloading the GEOS-Chem shared data directories] in the GEOS-Chem Online User's Guide.
 
   
 
   
 
  GEOS_1x1/APM_201011                                            # For APM microphysics only
 
  GEOS_1x1/APM_201011                                            # For APM microphysics only
Line 253: Line 287:
  
 
--[[User:Bmy|Bob Y.]] 16:58, 15 November 2011 (EST)
 
--[[User:Bmy|Bob Y.]] 16:58, 15 November 2011 (EST)
 +
 +
== 1-year benchmarks ==
 +
 +
For a complete description of the 1-year benchmark simulations that were used to validate GEOS-Chem v9-01-02, please see the
 +
[[GEOS-Chem_v9-01-02_benchmark_history#1-year_benchmarks|1-year benchmark simulations]] section of our [[GEOS-Chem v9-01-02 benchmark history]] wiki page.
 +
 +
--[[User:Bmy|Bob Y.]] 11:24, 28 November 2011 (EST)
  
 
== Previous issues now resolved in v9-01-02 ==
 
== Previous issues now resolved in v9-01-02 ==
Line 275: Line 316:
 
=== Mis-indexing error in partition.f ===
 
=== Mis-indexing error in partition.f ===
  
'''''This update was tested in the 1-month benchmark simulation [[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02a|v9-01-02a]] and approved on 28 Jun 2011.'''''
+
<span style="color:green">'''''This update was tested in the 1-month benchmark simulation [[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02a|v9-01-02a]] and approved on 28 Jun 2011.'''''</span>
 +
 
 +
<span style="color:darkorange">'''''NOTE: Routine <tt>partition.F</tt> will be removed (along with the other SMVGEAR routines) once FlexChem is implemented into GEOS-Chem.'''''</span>
  
 
The implementation of the [[Dynamic tropopause]] was causing a [[Dynamic tropopause#Problems with dynamic tropopause and adjoint model|mis-indexing error in subroutine <tt>partition.f</tt>]].  On every timestep, <tt>partition.f</tt> uses the concentrations of grid boxes at the previous timestep to partition family tracers (e.g. NOx, Ox) into individual species (e.g. NO2, NO, O3, etc.).  The way in which this was done did not take into account the fact that some boxes near the tropopause could be in the troposphere at one timestep and in the stratosphere at the next timestep (or vice-versa).  Thus, the concentrations that <tt>partition.f</tt> was sending to the chemistry solver was incorrect.   
 
The implementation of the [[Dynamic tropopause]] was causing a [[Dynamic tropopause#Problems with dynamic tropopause and adjoint model|mis-indexing error in subroutine <tt>partition.f</tt>]].  On every timestep, <tt>partition.f</tt> uses the concentrations of grid boxes at the previous timestep to partition family tracers (e.g. NOx, Ox) into individual species (e.g. NO2, NO, O3, etc.).  The way in which this was done did not take into account the fact that some boxes near the tropopause could be in the troposphere at one timestep and in the stratosphere at the next timestep (or vice-versa).  Thus, the concentrations that <tt>partition.f</tt> was sending to the chemistry solver was incorrect.   
Line 281: Line 324:
 
This problem affected both the forward and [[GEOS-Chem Adjoint|adjoint]] models.
 
This problem affected both the forward and [[GEOS-Chem Adjoint|adjoint]] models.
  
--[[User:Bmy|Bob Y.]] 10:14, 6 July 2011 (EDT)
+
--[[User:Bmy|Bob Y.]] 10:14, 6 July 2011 (EDT)<br>--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 14:47, 14 April 2016 (UTC)
  
 
=== Out-of-bounds error in readchem.f ===
 
=== Out-of-bounds error in readchem.f ===
  
'''''This update was tested in the 1-month benchmark simulation [[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02a|v9-01-02a]] and approved on 28 Jun 2011.'''''
+
[[Image:Obsolete.jpg]]
 +
 
 +
<span style="color:green">'''''This update was tested in the 1-month benchmark simulation [[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02a|v9-01-02a]] and approved on 28 Jun 2011.'''''</span>
 +
 
 +
<span style="color:red">'''''SMVGEAR was completely removed from [[GEOS-Chem v11-01]].  It was be replaced by the FlexChem solver package.'''''</span>
  
 
It was discovered that this code near the end of subroutine <tt>readchem.f</tt>:
 
It was discovered that this code near the end of subroutine <tt>readchem.f</tt>:
Line 318: Line 365:
 
=== Mis-indexing when reading restart.cspec file ===
 
=== Mis-indexing when reading restart.cspec file ===
  
'''''This update was tested in the 1-month benchmark simulation [[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02c|v9-01-02c]] and approved on 21 Jul 2011.'''''
+
<span style="color:green">'''''This update was tested in the 1-month benchmark simulation [[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02c|v9-01-02c]] and approved on 21 Jul 2011.'''''</span>
  
 
Please see [[Restart_files#Potential_issue_with_reading_restart.cspec_file|this post on the "Restart files" wiki page]] for more information about an indexing problem when reading the <tt>restart.cspec.YYYYMMDDhh</tt> file.
 
Please see [[Restart_files#Potential_issue_with_reading_restart.cspec_file|this post on the "Restart files" wiki page]] for more information about an indexing problem when reading the <tt>restart.cspec.YYYYMMDDhh</tt> file.
Line 326: Line 373:
 
=== Various bug fixes for the offline Hg simulation ===
 
=== Various bug fixes for the offline Hg simulation ===
  
'''''This update was tested in the 1-month benchmark simulation [[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02e|v9-01-02e]] and approved on 01 Aug 2011.'''''
+
<span style="color:green">'''''This update was tested in the 1-month benchmark simulation [[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02e|v9-01-02e]] and approved on 01 Aug 2011.'''''</span>
  
 
The following issues were discovered in the offline Hg simulation shortly after the release of [[GEOS-Chem v9-01-01|v9-01-01]].  These have all been fixed in v9-01-02.  Please follow the links below for more information:
 
The following issues were discovered in the offline Hg simulation shortly after the release of [[GEOS-Chem v9-01-01|v9-01-01]].  These have all been fixed in v9-01-02.  Please follow the links below for more information:
Line 338: Line 385:
 
=== Bug fix for leap years with GCAP ===
 
=== Bug fix for leap years with GCAP ===
  
'''''This update was tested in the 1-month benchmark simulation [[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02e|v9-01-02e]] and approved on 01 Aug 2011.'''''
+
<span style="color:green">'''''This update was tested in the 1-month benchmark simulation [[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02e|v9-01-02e]] and approved on 01 Aug 2011.'''''</span>
  
 
Recall that the [[GCAP|GCAP met fields]] are climatological GCM output, and do not have any leap years (i.e. there are no Feb 29ths).  In [[GEOS-Chem v9-01-01]] and prior versions, the code did not robustly skip over leap year days.   
 
Recall that the [[GCAP|GCAP met fields]] are climatological GCM output, and do not have any leap years (i.e. there are no Feb 29ths).  In [[GEOS-Chem v9-01-01]] and prior versions, the code did not robustly skip over leap year days.   
Line 351: Line 398:
  
 
==== Fixes in biomass_mod.f ====
 
==== Fixes in biomass_mod.f ====
 +
[[Image:Obsolete.jpg]]
  
'''''This update was tested in the 1-month benchmark simulation [[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02e|v9-01-02e]] and approved on 01 Aug 2011.'''''
+
<span style="color:green">'''''This update was tested in the 1-month benchmark simulation [[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02e|v9-01-02e]] and approved on 01 Aug 2011.'''''</span>
 +
 
 +
<span style="color:red">'''''Module <tt>biomass_mod.F</tt> was removed from [[GEOS-Chem v10-01]] and higher versions.  Emissions in these versions are now handled by [[HEMCO]].'''''</span>
  
 
In <tt>biomass_mod.f</tt>, there are some IF blocks such as:
 
In <tt>biomass_mod.f</tt>, there are some IF blocks such as:
Line 374: Line 424:
 
             ENDIF
 
             ENDIF
  
--[[User:Bmy|Bob Y.]] 10:44, 1 August 2011 (EDT)
+
--[[User:Bmy|Bob Y.]] 10:44, 1 August 2011 (EDT)<br>--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 16:04, 16 November 2017 (UTC)
  
 
=== Fixes for minor issues affecting nested-grid simulations ===
 
=== Fixes for minor issues affecting nested-grid simulations ===
Line 381: Line 431:
  
 
==== Wrong directory specified in nei2005_anthro_mod.f ====
 
==== Wrong directory specified in nei2005_anthro_mod.f ====
 +
[[Image:Obsolete.jpg]]
  
'''''This update was tested in the 1-month benchmark simulation [[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02e|v9-01-02e]] and approved on 01 Aug 2011.'''''
+
<span style="color:green">'''''This update was tested in the 1-month benchmark simulation [[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02e|v9-01-02e]] and approved on 01 Aug 2011.'''''</span>
 +
 
 +
<span style="color:red">'''''Module <tt>nei2005_anthro_mod.F</tt> was removed from [[GEOS-Chem v10-01]] and higher versions. Emissions in these versions are now handled by [[HEMCO]].'''''</span>
  
 
'''''[mailto:lschiferl@gmail.com Luke Schiferl] wrote:'''''
 
'''''[mailto:lschiferl@gmail.com Luke Schiferl] wrote:'''''
Line 388: Line 441:
 
:I have been working with the nested NA simulation and ran into a bug in the code.  In [[GEOS-Chem v9-01-01]], line 779 of <tt>nei2005_anthro_mod.f</tt> should point to the <tt>NEI2005_201007</tt> directory rather than <tt>NEI2005_200710</tt>.  There is a comment in line 709 that confirms this.
 
:I have been working with the nested NA simulation and ran into a bug in the code.  In [[GEOS-Chem v9-01-01]], line 779 of <tt>nei2005_anthro_mod.f</tt> should point to the <tt>NEI2005_201007</tt> directory rather than <tt>NEI2005_200710</tt>.  There is a comment in line 709 that confirms this.
  
--[[User:Bmy|Bob Y.]] 13:34, 27 July 2011 (EDT)
+
--[[User:Bmy|Bob Y.]] 13:34, 27 July 2011 (EDT)<br>--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 16:05, 16 November 2017 (UTC)
  
 
==== CAC, BRAVO emissions inadvertently turned off in NA nested grid runs ====
 
==== CAC, BRAVO emissions inadvertently turned off in NA nested grid runs ====
 +
[[Image:Obsolete.jpg]]
  
'''''This update was tested in the 1-month benchmark simulation [[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02e|v9-01-02e]] and approved on 01 Aug 2011.'''''
+
<span style="color:green">'''''This update was tested in the 1-month benchmark simulation [[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02e|v9-01-02e]] and approved on 01 Aug 2011.'''''</span>
 +
 
 +
<span style="color:red">'''''In [[GEOS-Chem v10-01]] and higher versions, all emissions options are read in via the [[HEMCO]] configuration file.'''''</span>
  
 
'''''[mailto:linzhang@fas.harvard.edu Lin Zhang] wrote:'''''
 
'''''[mailto:linzhang@fas.harvard.edu Lin Zhang] wrote:'''''
Line 410: Line 466:
 
:Otherwise, it will turn off CAC, BRAVO emissions when running nested NA.   
 
:Otherwise, it will turn off CAC, BRAVO emissions when running nested NA.   
  
--[[User:Bmy|Bob Y.]] 10:44, 1 August 2011 (EDT)
+
--[[User:Bmy|Bob Y.]] 10:44, 1 August 2011 (EDT)<br>--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 16:05, 16 November 2017 (UTC)
  
 
=== Bug fixes for compatibility with the PGI compiler ===
 
=== Bug fixes for compatibility with the PGI compiler ===
  
'''''This update was tested in the 1-month benchmark simulation [[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02e|v9-01-02e]] and approved on 01 Aug 2011.'''''
+
[[Image:Obsolete.jpg]]
 +
 
 +
<span style="color:green">'''''This update was tested in the 1-month benchmark simulation [[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02e|v9-01-02e]] and approved on 01 Aug 2011.'''''</span>
 +
 
 +
<span style="color:red">'''''Include file <tt>define.h</tt> was removed from [[GEOS-Chem v9-02]] and higher versions.'''''</span>
  
 
Gan Luo from SUNY/Albany pointed out several minor typos that cause the PGI compiler to choke when building the GEOS-Chem executable.  These will all be fixed in v9-01-02.
 
Gan Luo from SUNY/Albany pointed out several minor typos that cause the PGI compiler to choke when building the GEOS-Chem executable.  These will all be fixed in v9-01-02.
Line 467: Line 527:
 
=== Planeflight diagnostic update ===
 
=== Planeflight diagnostic update ===
  
'''''This update was tested in the 1-month benchmark simulation [[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02e|v9-01-02e]] and approved on 01 Aug 2011.'''''
+
<span style="color:green">'''''This update was tested in the 1-month benchmark simulation [[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02e|v9-01-02e]] and approved on 01 Aug 2011.'''''</span>
  
The [[List of MERRA met fields#A1 fields|MERRA SEAICExx]] fields are now saved to the [http://acmg.seas.harvard.edu/geos/doc/man/chapter_5.html#5.2.1.16 plane flight diagnostic], per request of Jenny Fisher.
+
The [[List of MERRA met fields#A1 fields|MERRA SEAICExx]] fields are now saved to the [[GEOS-Chem_Input_Files#Planeflight_Menu|plane flight diagnostic]], per request of Jenny Fisher.
  
 
--[[User:Bmy|Bob Y.]] 10:45, 1 August 2011 (EDT)
 
--[[User:Bmy|Bob Y.]] 10:45, 1 August 2011 (EDT)
Line 475: Line 535:
 
=== Washout fix for non-aerosol species ===
 
=== Washout fix for non-aerosol species ===
  
'''''This update was tested in the 1-month benchmark simulation [[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02f|v9-01-02f]] and approved on 02 Aug 2011.'''''
+
<span style="color:green">'''''This update was tested in the 1-month benchmark simulation [[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02f|v9-01-02f]] and approved on 02 Aug 2011.'''''</span>
  
 
The current [[Wet deposition]] algorithm was underestimating washout of non-aerosol species.  Please see [[Wet deposition#Washout fix for non-aerosol species|this wiki post]] for more information about how we corrected this situation.
 
The current [[Wet deposition]] algorithm was underestimating washout of non-aerosol species.  Please see [[Wet deposition#Washout fix for non-aerosol species|this wiki post]] for more information about how we corrected this situation.
Line 483: Line 543:
 
=== Overhaul of aerosol optical depth diagnostics ===
 
=== Overhaul of aerosol optical depth diagnostics ===
  
'''''This update was tested in the 1-month benchmark simulation [[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02g|v9-01-02g]] and approved on 10 Aug 2011.'''''
+
<span style="color:green">'''''This update was tested in the 1-month benchmark simulation [[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02g|v9-01-02g]] and approved on 10 Aug 2011.'''''</span>
  
 
Patrick Kim discovered some [[GEOS-Chem_v9-01-01#Inconsistencies_in_aerosol_diagnostics|inconsistencies in the way aerosol optical depth diagnostics were being computed]] in [[GEOS-Chem v9-01-01]] and prior versions.  We have now corrected these inconsistencies.
 
Patrick Kim discovered some [[GEOS-Chem_v9-01-01#Inconsistencies_in_aerosol_diagnostics|inconsistencies in the way aerosol optical depth diagnostics were being computed]] in [[GEOS-Chem v9-01-01]] and prior versions.  We have now corrected these inconsistencies.
Line 495: Line 555:
 
=== Fix for GEIA emissions scaling factor over Botswana ===
 
=== Fix for GEIA emissions scaling factor over Botswana ===
  
'''''This update was tested in the 1-month benchmark simulation [[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02h|v9-01-02h]] and approved on 12 Aug 2011.'''''
+
[[Image:Obsolete.jpg]]
  
Please see [[Carbon Gases and Organics Working Group#GEIA anthropogenic scaling factors|this wiki post about a problem in the scale factors for GEIA emissions over Botswana and southern Africa]].  We are planning to fix this in GEOS-Chem v9-01-02.
+
<span style="color:green">'''''This update was tested in the 1-month benchmark simulation [[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02h|v9-01-02h]] and approved on 12 Aug 2011.'''''</span>
 +
 
 +
<span style="color:red">'''''In [[GEOS-Chem v10-01]] and higher versions, all emissions and scale factors are handled by the [[HEMCO|HEMCO emissions component]].'''''</span>
 +
 
 +
Please see [[Organics Working Group#GEIA anthropogenic scaling factors|this wiki post about a problem in the scale factors for GEIA emissions over Botswana and southern Africa]].
  
 
--[[User:Bmy|Bob Y.]] 11:16, 15 August 2011 (EDT)
 
--[[User:Bmy|Bob Y.]] 11:16, 15 August 2011 (EDT)
Line 503: Line 567:
 
=== Archive the MERRA SWGDN field in the ND67 diagnostic ===
 
=== Archive the MERRA SWGDN field in the ND67 diagnostic ===
  
'''''This update was tested in the 1-month benchmark simulation [[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02i|v9-01-02i]] and approved on 15 Aug 2011.'''''
+
<span style="color:green">'''''This update was tested in the 1-month benchmark simulation [[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02i|v9-01-02i]] and approved on 15 Aug 2011.'''''</span>
  
 
Jenny Fisher pointed out that we were saving the MERRA "longwave radiation at the ground" (LWGNT) field into the ND67 diagnostic  instead of the MERRA "shortwave radiation at the ground" (SWGDN) field.  We have fixed this by archiving SWGDN to ND67 instead of LWGNT.  This is done in the module <tt>merra_a1_mod.F</tt>.
 
Jenny Fisher pointed out that we were saving the MERRA "longwave radiation at the ground" (LWGNT) field into the ND67 diagnostic  instead of the MERRA "shortwave radiation at the ground" (SWGDN) field.  We have fixed this by archiving SWGDN to ND67 instead of LWGNT.  This is done in the module <tt>merra_a1_mod.F</tt>.
Line 511: Line 575:
 
=== Fixed minor issues in MERRA cloud convection routine ===
 
=== Fixed minor issues in MERRA cloud convection routine ===
  
Jenny Fisher discovered two minor issues in the [[MERRA]] convection routine <tt>DO_MERRA_CONVECTION</tt> (in module <tt>convection_mod.f</tt>):
+
Jenny Fisher discovered two minor issues in the [[MERRA]] convection routine <tt>DO_MERRA_CONVECTION</tt> (in module <tt>convection_mod.f</tt>).  Please see [[Cloud_convection#Fixed_minor_issues_in_MERRA_cloud_convection_routine|this post on our ''Cloud convection'' wiki page]] for a full description of the issue.
 
+
==== ND38 diagnostic issue in routine DO_MERRA_CONVECTION ====
+
 
+
'''''This update was tested in the 1-month benchmark simulation [[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02j|v9-01-02j]] and approved on 16 Aug 2011.'''''
+
 
+
'''''[mailto:jafisher@fas.harvard.edu Jenny Fisher] wrote]:'''''
+
 
+
:The bug is in routine <tt>DO_MERRA_CONVECTION</tt>.  When <tt>DIAG38</tt> is first written (around line 2056 in my code, after the comment titled "(3.4) ND38 Diagnostic"), DIAG38 is formed by adding T0 (converted to appropriate units) to the diagnostic each level K. This is correct. However, the second time we add to <tt>DIAG38</tt> (below the cloud base, around line 2245 in my code), we add <tt>T0_SUM</tt> to each level. From what we can tell, <tt>T0_SUM</tt> represents not the washout from each level but instead the total wet scavenging loss, summed over the entire column. So we are effectively double counting in these levels and adding way too much. [Helen Amos and I] think this should instead be adding <tt>WETLOSS</tt>.
+
 
+
The fix is below:
+
 
+
                  IF ( OPTIONS%USE_DIAG38 .and. F(K,IC) > 0d0 ) THEN
+
                      DIAG38(K,IC) = DIAG38(K,IC)
+
!------------------------------------------------------------------------------
+
! Prior to 8/16/11:
+
! Now use WETLOSS instead of T0_SUM in the ND38 diagnostic below the cloud
+
! base. WETLOSS is the loss in this level, but T0_SUM is the loss summed
+
! over the entire column.  Using T0_SUM leads us to over-count the tracer
+
! scavenged out of the column. (jaf, hamos, bmy, 8/16/11)
+
!    &                            + ( T0_SUM * AREA_M2 / TCVV_DNS )
+
!------------------------------------------------------------------------------
+
      &                            + ( WETLOSS * AREA_M2 / TCVV_DNS )
+
                  ENDIF
+
 
+
--[[User:Bmy|Bob Y.]] 16:48, 16 August 2011 (EDT)
+
 
+
==== Wrong IF tests used in routine DO_MERRA_CONVECTION ====
+
 
+
'''''This update was tested in the 1-month benchmark simulation [[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02j|v9-01-02j]] and approved on 16 Aug 2011.'''''
+
 
+
:Routine <tt>DO_MERRA_CONVECTION</tt> was using tracer flags <tt>IDTHg2</tt> and <tt>IDTHgP</tt> to determine whether routines <tt>ADD_Hg2_WD</tt>, <tt>ADD_HgP_WD</tt>, and <tt>ADD_Hg2_SNOWPACK</tt> should be called.  However, <tt>IDTHg2</tt> and <tt>IDTHgP</tt> aren't ever defined and were set to zero, so these routines were never called even when the correct mercury species were used.
+
 
+
The fix is to replace these two lines of code
+
 
+
    IF ( IS_Hg .and. IC == IDT%Hg2 ) THEN
+
    ...
+
    IF ( IS_Hg .and. IC == IDT%HgP ) THEN
+
 
+
with these:
+
 
+
    IF ( IS_Hg .and. IS_Hg2( IC ) ) THEN
+
    ...
+
    IF ( IS_Hg .and. IS_HgP( IC ) ) THEN
+
  
--[[User:Bmy|Bob Y.]] 16:47, 16 August 2011 (EDT)
+
--[[User:Bmy|Bob Y.]] 15:54, 20 December 2012 (EST)
  
 
=== Minor fixes in APM microphysics ===
 
=== Minor fixes in APM microphysics ===
  
'''''This update was tested in the 1-month benchmark simulation [[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02n|v9-01-02n]] and approved on 22 Sep 2011.'''''
+
<span style="color:green">'''''This update was tested in the 1-month benchmark simulation [[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02n|v9-01-02n]] and approved on 22 Sep 2011.'''''</span>
  
 
'''''[mailto:ganluo@asrc.albany.edu Gan Luo] wrote:'''''
 
'''''[mailto:ganluo@asrc.albany.edu Gan Luo] wrote:'''''
Line 583: Line 604:
 
=== Fix for vertical regridding of offline OH for offline simulations ===
 
=== Fix for vertical regridding of offline OH for offline simulations ===
  
'''''This update was tested in the 1-month benchmark simulation [[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02p|v9-01-02p]] and approved on 29 Sep 2011.'''''
+
[[Image:Obsolete.jpg]]
 +
 
 +
<span style="color:green">'''''This update was tested in the 1-month benchmark simulation [[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02p|v9-01-02p]] and approved on 29 Sep 2011.'''''</span>
 +
 
 +
<span style="color:red">'''''This code was removed from [[GEOS-Chem v10-01]] and higher versions.  The [[HEMCO|HEMCO emissions component]] now reads in 3D oxidant fields from netCDF data files.'''''</span>
  
 
'''''[mailto:cdholmes@uci.edu Chris Holmes] wrote:'''''
 
'''''[mailto:cdholmes@uci.edu Chris Holmes] wrote:'''''
Line 601: Line 626:
 
=== Further bug fixes for the offline Hg simulation ===
 
=== Further bug fixes for the offline Hg simulation ===
  
'''''This update was tested in the 1-month benchmark simulation [[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02p|v9-01-02p]] and approved on 29 Sep 2011.'''''
+
<span style="color:green">'''''This update was tested in the 1-month benchmark simulation [[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02p|v9-01-02p]] and approved on 29 Sep 2011.'''''</span>
  
 
The following bugs were discovered after the release of [[GEOS-Chem v9-01-01|v9-01-01]] and have been fixed in v9-01-02.  Please follow the links below for more information:
 
The following bugs were discovered after the release of [[GEOS-Chem v9-01-01|v9-01-01]] and have been fixed in v9-01-02.  Please follow the links below for more information:
Line 616: Line 641:
 
==== Bug fix in planeflight diagnostic for nested-grid simulation====
 
==== Bug fix in planeflight diagnostic for nested-grid simulation====
  
'''''This update was tested in the 1-month benchmark simulation [[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02p|v9-01-02p]] and approved on 29 Sep 2011.'''''
+
<span style="color:green">'''''This update was tested in the 1-month benchmark simulation [[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02p|v9-01-02p]] and approved on 29 Sep 2011.'''''</span>
  
 
'''''[mailto:lschifer@atmos.colostate.edu Luke Schiferl] wrote:'''''  
 
'''''[mailto:lschifer@atmos.colostate.edu Luke Schiferl] wrote:'''''  
Line 626: Line 651:
 
==== NH3 emissions set to zero in China nested-grid simulations ====
 
==== NH3 emissions set to zero in China nested-grid simulations ====
  
'''''This update was tested in the 1-month benchmark simulation [[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02p|v9-01-02p]] and approved on 29 Sep 2011.'''''
+
[[Image:Obsolete.jpg]]
 +
 
 +
<span style="color:green">'''''This update was tested in the 1-month benchmark simulation [[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02p|v9-01-02p]] and approved on 29 Sep 2011.'''''</span>
 +
 
 +
<span style="color:red">'''''In [[GEOS-Chem v10-01]] and higher versions, the [[HEMCO|HEMCO emissions component]] now processes all emissions.'''''</span>
  
 
'''''[mailto:aaron.van.donkelaar@dal.ca Aaron van Donkelaar] wrote:'''''  
 
'''''[mailto:aaron.van.donkelaar@dal.ca Aaron van Donkelaar] wrote:'''''  
Line 636: Line 665:
 
=== Further fixes for APM microphysics ===
 
=== Further fixes for APM microphysics ===
  
'''''This update was tested in the 1-month benchmark simulation [[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02p|v9-01-02p]] and approved on 29 Sep 2011.'''''
+
<span style="color:green">'''''This update was tested in the 1-month benchmark simulation [[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02p|v9-01-02p]] and approved on 29 Sep 2011.'''''</span>
  
 
'''''[mailto:ganluo@asrc.albany.edu Gan Luo] wrote:'''''
 
'''''[mailto:ganluo@asrc.albany.edu Gan Luo] wrote:'''''
Line 654: Line 683:
 
=== Fix for partitioning chemical species ===
 
=== Fix for partitioning chemical species ===
  
'''''This update was tested in the 1-month benchmark simulation [[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02r|v9-01-02r]] and approved on 20 Oct 2011.'''''
+
[[Image:Obsolete.jpg]]
 +
 
 +
<span style="color:green">'''''This update was tested in the 1-month benchmark simulation [[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02r|v9-01-02r]] and approved on 20 Oct 2011.'''''</span>
 +
 
 +
<span style="color:red">'''''NOTE: The <tt>CSPEC</tt> array was removed (along with all other SMVGEAR arrays) when the [[FlexChem]] solver was implemented into [[GEOS-Chem v11-01]].'''''</span>
  
 
'''''[mailto:psk9@duke.edu Prasad Kasibhatla] wrote:'''''
 
'''''[mailto:psk9@duke.edu Prasad Kasibhatla] wrote:'''''
Line 676: Line 709:
 
:The corrected version uses <tt>JLOOP_P</tt> and the <tt>CSPEC</tt> array from the previous step.  New tropospheric grid cells inherit concentrations below them, rather than values held over since the last time the cell was in the trop.  The only issue I see now with the version of <tt>CSPEC_FULL</tt> that gets written to a restart file would still contain some of these hold-over values.
 
:The corrected version uses <tt>JLOOP_P</tt> and the <tt>CSPEC</tt> array from the previous step.  New tropospheric grid cells inherit concentrations below them, rather than values held over since the last time the cell was in the trop.  The only issue I see now with the version of <tt>CSPEC_FULL</tt> that gets written to a restart file would still contain some of these hold-over values.
  
--[[User:Melissa Payer|Melissa Payer]] 15:15, 18 October 2011 (EDT)
+
--[[User:Melissa Payer|Melissa Payer]] 15:15, 18 October 2011 (EDT)<br>--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 17:24, 15 November 2017 (UTC)
  
 
=== Bug fixes for biofuel emissions ===
 
=== Bug fixes for biofuel emissions ===
  
'''''This update was tested in the 1-month benchmark simulation [[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02s|v9-01-02s]] and approved on 5 Nov 2011.'''''
+
[[Image:Obsolete.jpg]]
 +
 
 +
<span style="color:green">'''''This update was tested in the 1-month benchmark simulation [[GEOS-Chem_v9-01-02_benchmark_history#v9-01-02s|v9-01-02s]] and approved on 5 Nov 2011. (Included in Adjoint [[GEOS-Chem_Adjoint_v34 | v34e]] ) '''''</span>
 +
 
 +
<span style="color:red">'''''This code was removed from [[GEOS-Chem v10-01]] and higher versions.  The [[HEMCO|HEMCO emissions component]] now processes all emissions data in these versions.'''''</span>
  
 
The following issues were discovered in <tt>biofuel_mod.F</tt>. Please follow the links below for more information:
 
The following issues were discovered in <tt>biofuel_mod.F</tt>. Please follow the links below for more information:
  
 
#[[Implementation of RETRO Anthropogenic Emissions#Further fix for double-counting of residential biofuel|Further fix for double-counting of residential biofuel when using RETRO]]
 
#[[Implementation of RETRO Anthropogenic Emissions#Further fix for double-counting of residential biofuel|Further fix for double-counting of residential biofuel when using RETRO]]
#[[Anthropogenic emissions#Bug fix for Streets biofuel emissions|Bug fix in biofuel emissions using Streets inventory]]
+
#[[GEOS-Chem_v9-01-01#Double_counting_of_biofuel_emissions_over_Asia|Bug fix in biofuel emissions using Streets inventory]]
  
--[[User:Melissa Payer|Melissa Payer]] 13:27, 21 October 2011 (EDT)
+
--[[User:Melissa Payer|Melissa Payer]] 13:27, 21 October 2011 (EDT)<br>--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 17:24, 15 November 2017 (UTC)
  
=== Do not use erroneous MEGAN AEF's for nested grid simulatons ===
+
=== Prevent out-of-bounds errors in ND01 and ND02 diagnostics for Rn-Pb-Be simulation ===
  
'''''This bug fix was added to GEOS-Chem v9-01-02 just prior to release.  It does not affect the full-chemistry simulation, only nested-grid simulations.'''''
+
<span style="color:green">'''''This bug fix was added to GEOS-Chem v9-01-02 just prior to release.  It does not affect the full-chemistry simulation, only the Rn-Pb-Be simulations.'''''</span>
  
For more information, please see [[MEGAN biogenic emissions#Nested simulations use wrong_AEF.27s|this wiki post]] on the MEGAN biogenic emissions page.
+
For more information about this issue, please see [[Rn-Pb-Be_simulation#Out-of-bounds_errors_in_ND01.2C_ND02_diagnostics|this post on our ''Rn-Pb-Be simulation'']] wiki page.
  
Do_not_use_erroneous_MEGAN_AEF_data_for_nested-grid_simulations
+
--[[User:Bmy|Bob Y.]] 11:13, 28 November 2011 (EST)
 +
 
 +
=== Do not use erroneous MEGAN AEF's for nested grid simulations ===
 +
 
 +
<span style="color:green">'''''This bug fix was added to GEOS-Chem v9-01-02 just prior to release.  It does not affect the full-chemistry simulation, only nested-grid simulations.'''''</span>
 +
 
 +
For more information about this issue, please see [[MEGAN v2.1 biogenic emissions#Nested simulations use wrong_AEF.27s|this post on our ''MEGAN biogenic emissions'' wiki page]].
  
 
--[[User:Bmy|Bob Y.]] 10:18, 28 November 2011 (EST)
 
--[[User:Bmy|Bob Y.]] 10:18, 28 November 2011 (EST)
Line 705: Line 748:
 
=== Minor bug fixes in ISORROPIA II ===
 
=== Minor bug fixes in ISORROPIA II ===
  
Please see [[ISORROPIA_II#Minor_fixes_in_isorropiaIIcode.f|this wiki post]] for a description of two proposed bug fixes that should go into source code file <tt>ISOROPIA/isorropiaIIcode.f</tt>.  This bug should not affect the current GEOS-Chem ISORROPIA configuration, but may affect future development.
+
Please see [[ISORROPIA_II#Minor_fixes_in_isorropiaIIcode.f|this post on our ''ISORROPIA II'' wiki page]] for a description of two proposed bug fixes that should go into source code file <tt>ISOROPIA/isorropiaIIcode.f</tt>.  This bug should not affect the current GEOS-Chem ISORROPIA configuration, but may affect future development.
  
 
'''''Update 7/28/11:''''' Implementing this change causes the 1-month standard benchmark simulation to have divergent results than the previous version.  Therefore, we should understand the source of these differences before we add this update into
 
'''''Update 7/28/11:''''' Implementing this change causes the 1-month standard benchmark simulation to have divergent results than the previous version.  Therefore, we should understand the source of these differences before we add this update into
Line 714: Line 757:
 
=== Fixes in emep_mod.f ===
 
=== Fixes in emep_mod.f ===
  
In routines <tt>READ_EMEP_UPDATED</tt> and <tt>READ_EMEP_UPDATED_05x0666</tt> of <tt>emep_mod.f</tt>, there were some IF statements that were used to pick the proper filename and tracer number with which to read data from the bpch file format:
+
[[Image:Obsolete.jpg]]
  
        IF ( TRACER .eq. IDTNOx ) THEN
+
<span style="color:green">'''''NOTE: This issue was ultimately resolved in [[GEOS-Chem_v9-01-03_benchmark_history#v9-01-03g|GEOS-Chem v9-01-03g]]'''''.</span>
            FILENAME = TRIM( DIR ) // 'SeasonalVariation/'  
+
    &        // 'NOx-EMEP-SeasonalScalar.geos.1x1'
+
            RATIOID = 71
+
        ELSEIF ( TRACER .eq. IDTCO ) THEN
+
            FILENAME = TRIM( DIR ) // 'SeasonalVariation/'
+
    &        // 'CO-EMEP-SeasonalScalar.geos.1x1'
+
            RATIOID = 72
+
        ELSEIF ( TRACER .eq. IDTSO2 ) THEN
+
            FILENAME = TRIM( DIR ) // 'SeasonalVariation/'
+
    &        // 'SOx-EMEP-SeasonalScalar.geos.1x1'
+
            RATIOID = 73
+
        ELSEIF ( TRACER .eq. IDTNH3 ) THEN
+
            FILENAME = TRIM( DIR ) // 'SeasonalVariation/'
+
    &        // 'NH3-EMEP-SeasonalScalar.geos.1x1'
+
            RATIOID = 74
+
        ENDIF
+
  
where TRACER is passed to these routines via subroutine calls such as these:
+
<span style="color:red">'''''Module <tt>emep_mod.F</tt> was removed from [[GEOS-Chem v10-01]] and higher versions.  Emissions in these versions are now handled by [[HEMCO]].'''''</span>
  
        CALL READ_EMEP_UPDATED(  1, EMEP_YEAR, EMEP_NOx, 0 )
+
Please see [[EMEP_European_anthropogenic_emissions#Fixes_in_emep_mod.f|this post on our ''EMEP European anthropogenic emissions'' wiki page]] for a full description of this issue.
        CALL READ_EMEP_UPDATED(  4, EMEP_YEAR, EMEP_CO,  0 )
+
        CALL READ_EMEP_UPDATED( 26, EMEP_YEAR, EMEP_SO2, 0 )
+
        CALL READ_EMEP_UPDATED( 30, EMEP_YEAR, EMEP_NH3, 1 )
+
  
The problem is the code is set up to assume that <tt>IDTNOX</tt> will always be 1, <tt>IDTCO</tt> will always be 4, <tt>IDTSO2</tt> will always be 26, and <tt>IDTNH3</tt> will always be 30.  This is true only if you are running a full-chemistry simulation.  However, for an offline-aerosol simulation NOx and CO are undefined, and SO2 and NH3 will not equal 26 and 30.  Therefore, the IF statement will not return the proper file name and tracer ID.
+
--[[User:Bmy|Bob Y.]] 12:43, 20 December 2012 (EST)<br>--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 17:25, 15 November 2017 (UTC)
  
The solution is to remove all references to <tt>IDTNOX</tt>, <tt>IDTCO</tt>, <tt>IDTSO2</tt>, <tt>IDTNH3</tt> from that section of code. The new code looks like:
+
=== Fix for offline simulations in nei2005_anthro_mod.f ===
  
        ! Pick proper filename & tracer #
+
[[Image:Obsolete.jpg]]
        SELECT CASE( TRACER )
+
+
            ! NOx
+
            CASE( 1 )
+
              RATIOID  = 71
+
              FILENAME = TRIM( DIR )                        //
+
    &                    'SeasonalVariation/'              //
+
    &                    'NOx-EMEP-SeasonalScalar.geos.1x1'
+
            ! CO
+
            CASE( 4 )
+
              RATIOID  = 72
+
              FILENAME = TRIM( DIR )                        //
+
    &                    'SeasonalVariation/'              //
+
    &                    'CO-EMEP-SeasonalScalar.geos.1x1'
+
            ! SO2
+
            CASE( 26 )
+
              RATIOID  = 73
+
              FILENAME = TRIM( DIR )                        //
+
    &                    'SeasonalVariation/'              //
+
    &                    'SOx-EMEP-SeasonalScalar.geos.1x1'
+
            ! NH3
+
            CASE( 30 )
+
              RATIOID  = 74
+
              FILENAME = TRIM( DIR )                        //
+
    &                    'SeasonalVariation/'              //
+
    &                    'NH3-EMEP-SeasonalScalar.geos.1x1'
+
        END SELECT
+
  
There are a couple more instances of this error in <tt>emep_mod.f</tt>, but the fix is the same.
+
<span style="color:green">'''''NOTE: This issue was ultimately resolved in [[GEOS-Chem_v9-01-03_benchmark_history#v9-01-03g|GEOS-Chem v9-01-03g]]'''''.</span>
  
'''''Update 8/1/11:''''' Implementing this change causes the 1-month standard benchmark simulation to have divergent results than the previous version.  Therefore, we should understand the source of these differences before we add this update into
+
<span style="color:red">'''''Module <tt>nei2005_anthro_mod.F</tt> was removed from [[GEOS-Chem v10-01]] and higher versions. Emissions in these versions are now handled by [[HEMCO]].'''''</span>
the standard repository.
+
  
--[[User:Bmy|Bob Y.]] 10:43, 1 August 2011 (EDT)
+
Please see [[EPA/NEI05_North_American_emissions#Fix_for_offline_simulations_in_nei2005_anthro_mod.f|this post on our ''EPA/NEI05 North American Emissions'' wiki page]] for a full description of the issue.
  
'''''Update 11/28/11:''''' Patrick Kim tested this and found that the numerical discrepancy was being caused by ISORROPIA.  Therefore we will add this fix into [[GEOS-Chem v9-01-03]].
+
--[[User:Bmy|Bob Y.]] 12:46, 20 December 2012 (EST)<br>--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 17:25, 15 November 2017 (UTC)
  
--[[User:Bmy|Bob Y.]] 10:19, 28 November 2011 (EST)
+
== Outstanding issues not yet resolved in v9-01-02 ==
  
=== Fix for offline simulations in nei2005_anthro_mod.f ===
+
Please also see our [[Currently unresolved issues in GEOS-Chem]] wiki page for more information about as-yet unresolved issues first identified in prior versions.
  
Routines <tt>EMISS_NEI2005_ANTHRO</tt> and <tt>EMISS_NEI2005_ANTHRO_05x0666</tt> in <tt>nei2005_anthro_mod.f</tt> contained similar errors to the [[#Fixes in emep_mod.f|errors in <tt>emep_mod.f</tt> described above]].  Again, the crux of the problem is that the <tt>IDTxxxx</tt> tracer flags are being used for the indices of tracers in the binary punch file.  And as described above, the various <tt>IDTxxxx</tt> flags will have different values for an aerosol-only simulation as for a full-chemistry simulation.
+
=== RETRO anthropogenic ethane emissions are too low ===
  
The fix is to keep a separate array of tracer indices in the code, and use those for aerosol-only simulations:
+
[[Image:Obsolete.jpg]]
  
      ! list of ID of available species
+
<span style="color:red">'''''NOTE: All emissions are handled by [[HEMCO]] in [[GEOS-Chem v10-01]] and higher versions.'''''</span>
      SPECIES_ID = (/ IDTNOX,  IDTCO,  IDTSO2,  IDTSO4,  IDTNH3,
+
    &                IDTACET, IDTALK4, IDTC2H6, IDTC3H8, IDTOCPI,
+
    &                IDTBCPI, IDTALD2, IDTCH2O, IDTPRPE, IDTMEK  /)
+
+
      ! ID #'s for that are not tied to IDTxxxx flags
+
      OFFLINE_ID = (/ 1,      4,      26,      27,      30,
+
    &                9,      5,      21,      19,      35,         
+
    &                34,      11,      20,      18,      10      /)
+
+
      ! Loop over species
+
      DO KLM = 1, SIZE( SPECIES_ID )
+
+
        ! Species ID (IDT* flags)
+
        SNo        = SPECIES_ID( KLM )
+
+
        ! Skip undefined tracers (bmy, 4/11/11)
+
        IF ( SNo == 0 ) CYCLE
+
           
+
        ! Pick the proper tracer # for fullchem or offline simulations
+
        ! This prevents crashes for e.g. offline aersol sims (bmy, 4/11/11)
+
        IF ( ITS_A_FULLCHEM_SIM() ) THEN
+
            BPCH_ID = Sno
+
        ELSE
+
            BPCH_ID = OFFLINE_ID(KLM)
+
        ENDIF
+
  
where <tt>BPCH_ID</tt> is the index for the given species in the binary punch file.  If you are running the full-chemistry simulation, then <tt>BPCH_ID</tt> is defined from the <tt>IDTxxxx</tt> flagsIf you are running an offline aerosol-only simulation, then <tt>BPCH_ID</tt> is defined from the values in the <tt>OFFLINE_ID</tt> array.
+
Please see [[Implementation of RETRO Anthropogenic Emissions#RETRO anthropogenic ethane emissions are too low|this wiki post]] on the RETRO emissions wiki page for a full description of this issueWe expect to fix this issue in [[GEOS-Chem v9-01-03]].
  
'''''Update 7/28/11:''''' Implementing this change causes the 1-month standard benchmark simulation to have divergent results than the previous version.  Therefore, we should understand the source of these differences before we add this update into
+
--[[User:Bmy|Bob Y.]] 11:17, 28 November 2011 (EST)<br>--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 17:25, 15 November 2017 (UTC)
the standard repository.
+
 
+
--[[User:Bmy|Bob Y.]] 15:42, 28 July 2011 (EDT)
+
 
+
== Outstanding issues not yet resolved in v9-01-02 ==
+
  
 
=== Apparent bug in LINOZ ===
 
=== Apparent bug in LINOZ ===
Line 834: Line 800:
  
 
--[[User:Bmy|Bob Y.]] 10:52, 1 August 2011 (EDT)
 
--[[User:Bmy|Bob Y.]] 10:52, 1 August 2011 (EDT)
 +
 +
=== Incompatibility with GNU Make v3.80 ===
 +
 +
This is a minor technical issue caused by some leftover test code in the <tt>GeosApm/Makefile</tt> and <tt>GeosTomas/Makefile</tt>.  This will be corrected in [[GEOS-Chem v9-01-03]].
 +
 +
'''''[mailto:mayfu@pku.edu.cn May Fu] wrote:'''''
 +
 +
:In testing v912, I found that gnu make version 3.81 or later is required, because the ‘else ifeq’ syntax is used in the Makefiles. I would imagine most people have at least v3.81, unless they are using a really old Linux distribution like I do, where the default gnu make is 3.80.  The danger is that the user will not be able to do a proper ‘make realclean’, but might still be able to ‘make’, resulting in a bad build.
 +
 +
'''''[mailto:mlong@seas.harvard.edu Michael Long] wrote:'''''
 +
 +
:The instance of <tt>else ifeq</tt> is not meant to be operational in v9-01-02.  I will revise the Makefiles to undo this.
 +
 +
--[[User:Bmy|Bob Y.]] 15:54, 6 December 2011 (EST)

Latest revision as of 15:22, 19 June 2019

Contents

Overview

History

The table below shows the previous, current, and successive versions of GEOS-Chem:

Previous version This version Next version
GEOS-Chem v9-01-01 GEOS-Chem v9-01-02 GEOS-Chem v9-01-03
PUBLIC RELEASE Feb 10 2011
RE-RELEASED ON 07 Jun 2011
PUBLIC RELEASE 28 Nov 2011 PUBLIC RELEASE 14 Sep 2012
View v9-01-01 benchmark history View v9-01-02 benchmark history View v9-01-03 benchmark history

--Bob Y. 10:21, 16 January 2014 (EST)

What's new in this version

GEOS-Chem v9-01-02 contains the following new features:

v9-01-02a, v9-01-02b, etc. denote 1-month benchmark simulations, which are designed to evaluate GEOS-Chem's performance at intermediate stages of development.
Alternating stripes of color (white & cyan) in the table below group together features that were evaluated in the same 1-month benchmark.

Feature Type Submitted by Benchmark
(1 Month)
Status
Corrected mis-indexing error in partition.f caused by the dynamic tropopause Bug Fix Daven Henze (Colorado U)
Jamin Koo (MIT)
v9-01-02a Approved 28 Jun 2011
Corrected out-of-bounds error in readchem.f Bug Fix GEOS-Chem Support Team " " " "
Fix for mis-indexing issue in CSPEC restart file Bug Fix Jingqiu Mao (NOAA/GFDL)
GEOS-Chem Support Team
v9-01-02c Approved 21 Jul 2011
Initial source code modifications for compatibility with Earth System Model Framework Structural GEOS-Chem Support Team v9-01-02d Approved 26 Jul 2011
Various bug fixes for the offline Hg simulation Bug Fix Jenny Fisher (Harvard)
Helen Amos (Harvard)
Chris Holmes (UC Irvine)
v9-01-02e Approved 01 Aug 2011
Bug fixes for leap years when using GCAP met fields Bug Fix GEOS-Chem Support Team " " " "
Minor bug fixes for emissions routines affecting offline simulations Bug Fix GEOS-Chem Support Team " " " "
Fixes for minor issues affecting nested-grid simulations Bug Fix Luke Schiferl (Colorado State)
Lin Zhang (Harvard)
" " " "
Fixes for better compatibility with the PGI compiler Bug Fix Gan Luo (SUNY Albany)
GEOS-Chem Support Team
" " " "
Add MERRA SEAICExx fields to the planeflight diagnostic Structural Jenny Fisher (Harvard)
GEOS-Chem Support Team
" " " "
Washout fix for non-aerosol species Bug Fix Helen Amos (Harvard) v9-01-02f Approved 02 Aug 2011
Overhaul of AOD diagnostics Structural Sungshik Patrick Kim (Harvard)
GEOS-Chem Support Team
v9-01-02g Approved 10 Aug 2011
Fix for GEIA emissions scaling factor over Botswana Bug Fix Dylan Millet (U. Minnesota) v9-01-02h Approved 12 Aug 2011
Updated dry deposition velocities for aerosols over ice and snow Science Jenny Fisher (Harvard) v9-01-02i Approved 15 Aug 2011
Archive the MERRA SWGDN (incident radiation @ sfc) field in the ND67 diagnostic Structural Jenny Fisher (Harvard) " " " "
Imposed seasonality on NH3 emissions from David Streets 2000 inventory Science Jenny Fisher (Harvard) v9-01-02j Approved 16 Aug 2011
Fixed minor issues in MERRA cloud convection routine Bug Fix Jenny Fisher (Harvard) " " " "
Implementation of RETRO Anthropogenic Emissions Science Wes Reinhart (U. Minnesota)
Dylan Millet (U. Minnesota)
v9-01-02k Approved 17 Aug 2011
APM aerosol microphysics Science Fangqun Yu (SUNY Albany)
Gan Luo (SUNY Albany)
v9-01-02l Approved 23 Aug 2011
Attempt to eliminate numerical noise in ISORROPIA II (ifort compiler only) Structural Shannon Capps (Georgia Tech) " " " "
Eliminate common block header files + Other source-code updates for ESMF compatibility Structural GEOS-Chem Support Team v9-01-02m Approved 07 Sep 2011
GFED3 biomass burning emissions Science Prasad Kasibhatla (Duke) v9-01-02n Approved 22 Sep 2011
Minor fixes in APM microphysics Structural Gan Luo (SUNY Albany) " " " "
Eliminate double-counting of residential biofuel when using RETRO anthro VOC emissions Bug Fix Dylan Millet (U. Minnesota) v9-01-02o Approved 27 Sep 2011
Fix for vertical regridding of offline OH for offline simulations Bug Fix Chris Holmes (UC Irvine) v9-01-02p Approved 29 Sep 2011
Further bug fixes for the offline Hg simulation Bug Fix Chris Holmes (UC Irvine) " " " "
Further fixes for nested-grid simulations Bug Fix Luke Schiferl (Colo. State U.)
Aaron van Donkelaar (Dalhousie)
" " " "
Further fixes for APM microphysics Bug Fix Gan Luo (SUNY Albany) " " " "
Centralizing chemistry time step Structural Mauricio Santillana (Harvard)
Jingqiu Mao (NOAA/GFDL)
Lin Zhang (Harvard)
GEOS-Chem Support Team
v9-01-02q Approved 18 Oct 2011
Fix for partitioning chemical species Bug Fix Daven Henze (Colorado U)
Prasad Kasibhatla (Duke)
v9-01-02r Approved 20 Oct 2011
Bug fixes for biofuel emissions Bug Fix Chris Holmes (UC Irvine)
Dylan Millet (U. Minnesota)
Chris Miller (Harvard)
v9-01-02s Approved 5 Nov 2011
Fix bug in EDGAR ship emissions code Bug Fix GEOS-Chem Support Team
Chris Holmes (UC Irvine)
" " " "
Bug fix for ship NOx emissions Bug fix Chris Holmes (UC Irvine) " " " "
GEIA 2005 Hg emissions Science Bess Corbitt (Harvard)
Noelle Selin (MIT)
" " " "
Prevent out-of-bounds errors in ND01 and ND02 diagnostics for Rn-Pb-Be simulation Bug fix GEOS-Chem Support Team last-minute fix 08 Nov 2011
Do not use erroneous MEGAN AEF data for nested-grid simulations Bug fix Lin Zhang last-minute fix 22 Nov 2011
Modify constant used for in-plume reduction in Hg simulation Science Helen Amos(Harvard)
Noelle Selin (MIT)
Yanxu Zhang (U. Washington
last-minute fix 28 Nov 2011

--Bob Y. 14:51, 29 November 2011 (EST)

New data directories

The following new data directories have been added for GEOS-Chem v9-01-02. You will have to download the directories relevant to your simulation.

You can download these directories with anonymous FTP or the Wget utility. For instructions, please see Chapter 2.4, Downloading the GEOS-Chem shared data directories in the GEOS-Chem Online User's Guide.

GEOS_1x1/APM_201011                                             # For APM microphysics only
GEOS_1x1/Streets_200607/NH3-Streets-SeasonalScalar.generic.1x1  # For NH3 seasonality in Streets 2000
GEOS_1x1/GFED3_201110                                           # GFED3 biomass burning emissions

GEOS_2x2.5/CO_201003/fossilfuel_andres/annual_v2010             # CO2 annual emissions from CDIAC
GEOS_2x2.5/CO_201003/fossilfuel_andres/monthly_v2010            # CO2 monthly emissions from CDIAC
GEOS_2x2.5/mercury_201007                                       # Renamed from mercury_201002
GEOS_2x2.5/mercury_201110                                       # Soil conc's of Hg (present + pre-ind)
GEOS_2x2.5/RETRO_201103                                         # RETRO anthropogenic VOC emissions
 
GEOS_4x5/CO_201003/fossilfuel_andres/annual_v2010               # CO2 annual emissions from CDIAC
GEOS_4x5/CO_201003/fossilfuel_andres/monthly_v2010              # CO2 monthly emissions from CDIAC
GEOS_4x5/mercury_201110                                         # Soil conc's of Hg (present + pre-ind)
GEOS_4x5/RETRO_201103                                           # RETRO anthropogenic VOC emissions

--Bob Y. 16:58, 15 November 2011 (EST)

1-year benchmarks

For a complete description of the 1-year benchmark simulations that were used to validate GEOS-Chem v9-01-02, please see the 1-year benchmark simulations section of our GEOS-Chem v9-01-02 benchmark history wiki page.

--Bob Y. 11:24, 28 November 2011 (EST)

Previous issues now resolved in v9-01-02

Patches from v9-01-01

The following patches that were issued after the initial release of GEOS-Chem v9-01-01 are now standardized in v9-01-02:

  1. Double counting of biofuel emissions over Asia
  2. Updated annual and monthly CO2 emissions from CDIAC
  3. Typos in vdiff_mod.f90
  4. Negative tracer caused by DO_MERRA_CONVECTION
  5. Omitted code in Hg simulation
  6. Bug fixes for drydep (ND44) and wetdep (ND17,ND18,ND37,ND38,ND39) diagnostic archival
  7. Bug fix for time-in-tropopause (ND54) diagnostic
  8. Only apply wetdep error trap when using MERRA met fields
  9. Apply washout to the proper fraction of the grid box
  10. Better representation of aqueous SO2 chemistry

--Bob Y. 11:51, 24 June 2011 (EDT)

Mis-indexing error in partition.f

This update was tested in the 1-month benchmark simulation v9-01-02a and approved on 28 Jun 2011.

NOTE: Routine partition.F will be removed (along with the other SMVGEAR routines) once FlexChem is implemented into GEOS-Chem.

The implementation of the Dynamic tropopause was causing a mis-indexing error in subroutine partition.f. On every timestep, partition.f uses the concentrations of grid boxes at the previous timestep to partition family tracers (e.g. NOx, Ox) into individual species (e.g. NO2, NO, O3, etc.). The way in which this was done did not take into account the fact that some boxes near the tropopause could be in the troposphere at one timestep and in the stratosphere at the next timestep (or vice-versa). Thus, the concentrations that partition.f was sending to the chemistry solver was incorrect.

This problem affected both the forward and adjoint models.

--Bob Y. 10:14, 6 July 2011 (EDT)
--Bob Yantosca (talk) 14:47, 14 April 2016 (UTC)

Out-of-bounds error in readchem.f

Obsolete.jpg

This update was tested in the 1-month benchmark simulation v9-01-02a and approved on 28 Jun 2011.

SMVGEAR was completely removed from GEOS-Chem v11-01. It was be replaced by the FlexChem solver package.

It was discovered that this code near the end of subroutine readchem.f:

                 ELSEIF ( J == MAPPL(ILBRO2H,NCS) .or.
    &                     J == MAPPL(ILBRO2N,NCS) .or.
    &                     J == MAPPL(ILTRO2H,NCS) .or.
    &                     J == MAPPL(ILTRO2N,NCS) .or.
    &                     J == MAPPL(ILXRO2H,NCS) .or.
    &                     J == MAPPL(ILXRO2N,NCS) ) THEN
                    ITS_NOT_A_ND65_FAMILY(J) = .FALSE.
                    EXIT

will cause an out-of-bounds error if any of the IL* indices are zero. This error manifested itself in a standard 43-tracer simulation.

We have corrected this error by first making sure that each IL* index is nonzero before doing the corresponding IF ( J = ... ) test:

                 ! Avoid out-of-bounds-errors by making sure that each
                 ! IL* index is nonzero before doing the IF test for J. 
                 ! (bmy, 3/1/11)
                 IF ( ILBRO2H > 0 ) THEN 
                    IF ( J == MAPPL(ILBRO2H,NCS) ) THEN
                       ITS_NOT_A_ND65_FAMILY(J) = .FALSE.
                       EXIT
                    ENDIF
                 ENDIF

                 ... etc ...

--Bob Y. 10:42, 24 June 2011 (EDT)

Mis-indexing when reading restart.cspec file

This update was tested in the 1-month benchmark simulation v9-01-02c and approved on 21 Jul 2011.

Please see this post on the "Restart files" wiki page for more information about an indexing problem when reading the restart.cspec.YYYYMMDDhh file.

--Bob Y. 15:22, 21 July 2011 (EDT)

Various bug fixes for the offline Hg simulation

This update was tested in the 1-month benchmark simulation v9-01-02e and approved on 01 Aug 2011.

The following issues were discovered in the offline Hg simulation shortly after the release of v9-01-01. These have all been fixed in v9-01-02. Please follow the links below for more information:

  1. De-hardwire file path BR_DIR in global_br_mod.f
  2. Negative concentrations of aquatic mercury
  3. VEGEMIS bug fix for GCAP simulation

--Bob Y. 10:41, 1 August 2011 (EDT)

Bug fix for leap years with GCAP

This update was tested in the 1-month benchmark simulation v9-01-02e and approved on 01 Aug 2011.

Recall that the GCAP met fields are climatological GCM output, and do not have any leap years (i.e. there are no Feb 29ths). In GEOS-Chem v9-01-01 and prior versions, the code did not robustly skip over leap year days.

This issue has now been fixed in GEOS-Chem v9-01-02. We have posted the the implementation details on the GCAP wiki page.

--Bob Y. 10:25, 31 October 2011 (EDT)

Minor bug fixes for emissions routines affecting offline simulations

We have now corrected some bugs that caused errors when running the offline aerosol-only simulation and tagged CO simulation. (NOTE: These errors do NOT occur when running the full-chemistry simulation, only the offline simulations.)

Fixes in biomass_mod.f

Obsolete.jpg

This update was tested in the 1-month benchmark simulation v9-01-02e and approved on 01 Aug 2011.

Module biomass_mod.F was removed from GEOS-Chem v10-01 and higher versions. Emissions in these versions are now handled by HEMCO.

In biomass_mod.f, there are some IF blocks such as:

           IF ( ITS_A_FULLCHEM_SIM() ) THEN              
              BIOMASS(:,:,IDBCO) = BIOMASS(:,:,IDBCO) * 1.05d0
           ELSE IF ( ITS_A_TAGCO_SIM() ) THEN
              BIOMASS(:,:,IDBCO) = BIOMASS(:,:,IDBCO) * 1.11d0
           ENDIF

However, if your simulation does not use CO (e.g. offline aerosols), then the ID flags IDTCO and IDBCO will both equal zero. If IDBCO = 0, this will cause an out-of-bounds error.

The solution is to add an outer IF block to prevent the code from being executed if IDBCO = 0.

           IF ( IDBCO > 0 ) THEN
              IF ( ITS_A_FULLCHEM_SIM() ) THEN              
                 BIOMASS(:,:,IDBCO) = BIOMASS(:,:,IDBCO) * 1.05d0
              ELSE IF ( ITS_A_TAGCO_SIM() ) THEN
                 BIOMASS(:,:,IDBCO) = BIOMASS(:,:,IDBCO) * 1.11d0
              ENDIF
           ENDIF

--Bob Y. 10:44, 1 August 2011 (EDT)
--Bob Yantosca (talk) 16:04, 16 November 2017 (UTC)

Fixes for minor issues affecting nested-grid simulations

The following typographical errors affect nested-grid simulations:

Wrong directory specified in nei2005_anthro_mod.f

Obsolete.jpg

This update was tested in the 1-month benchmark simulation v9-01-02e and approved on 01 Aug 2011.

Module nei2005_anthro_mod.F was removed from GEOS-Chem v10-01 and higher versions. Emissions in these versions are now handled by HEMCO.

Luke Schiferl wrote:

I have been working with the nested NA simulation and ran into a bug in the code. In GEOS-Chem v9-01-01, line 779 of nei2005_anthro_mod.f should point to the NEI2005_201007 directory rather than NEI2005_200710. There is a comment in line 709 that confirms this.

--Bob Y. 13:34, 27 July 2011 (EDT)
--Bob Yantosca (talk) 16:05, 16 November 2017 (UTC)

CAC, BRAVO emissions inadvertently turned off in NA nested grid runs

Obsolete.jpg

This update was tested in the 1-month benchmark simulation v9-01-02e and approved on 01 Aug 2011.

In GEOS-Chem v10-01 and higher versions, all emissions options are read in via the HEMCO configuration file.

Lin Zhang wrote:

I found a small bug in recent GEOS-Chem v9-01-01 when running nested NA. The error is in routine READ_EMISSIONS_MENU of module input_mod.f, around line 1700. The line:
   #if defined( GRID05x0666 ) || defined( NESTED_CH ) 
should be
   #if defined( GRID05x0666 ) && defined( NESTED_CH ) 
or just simply
   #if defined( NESTED_CH )
Otherwise, it will turn off CAC, BRAVO emissions when running nested NA.

--Bob Y. 10:44, 1 August 2011 (EDT)
--Bob Yantosca (talk) 16:05, 16 November 2017 (UTC)

Bug fixes for compatibility with the PGI compiler

Obsolete.jpg

This update was tested in the 1-month benchmark simulation v9-01-02e and approved on 01 Aug 2011.

Include file define.h was removed from GEOS-Chem v9-02 and higher versions.

Gan Luo from SUNY/Albany pointed out several minor typos that cause the PGI compiler to choke when building the GEOS-Chem executable. These will all be fixed in v9-01-02.

(1) Line 303 of GeosCore/depo_mercury_mod.f:

Change this:
 #include 'define.h'

to this:
 #include "define.h"

(2) Line 169 of GeosCore/ocean_mercury_mod.f:

Change this:
 REAL*8, PARAMETER     :: Kd_part   = 10**(5.5)

to this:
 REAL*8, PARAMETER     :: Kd_part   = 10d0**(5.5d0)

(3) Line 1281 of GeosCore/ocean_mercury_mod.f:

Change this:
 HgPaq(I,J)   = MAX ( HgPaq(I,J) , 0.0 )

to this:
 HgPaq(I,J)   = MAX ( HgPaq(I,J) , 0d0 )

(4) In subroutine DO_MERRA_CONVECTION of convection_mod.f

Change this:
 REAL*8            :: ALPHA,       ALPHA2,   CLDBASE, CMFMC_BELOW

to this:
 INTEGER           :: CLDBASE
 REAL*8            :: CMFMC_BELOW, ALPHA,    ALPHA2

(5) In module vdiff_mod.f90: Several numerical constants had to be rewritten so that explicitly use "D" exponents. In other words:

Change numbers like these:
 1.
 1.e-12

to these:
 1.d0
 1.d-12

In short, the PGI compiler expects constants to agree strictly with the type of the variable that they are being assigned to (i.e. if A is a REAL*8, then you must use A = 1.0d0 instead of A = 1.0). IFORT will correct for this situation during compilation, but PGI will throw an error.

--Bob Y. 10:44, 1 August 2011 (EDT)

Planeflight diagnostic update

This update was tested in the 1-month benchmark simulation v9-01-02e and approved on 01 Aug 2011.

The MERRA SEAICExx fields are now saved to the plane flight diagnostic, per request of Jenny Fisher.

--Bob Y. 10:45, 1 August 2011 (EDT)

Washout fix for non-aerosol species

This update was tested in the 1-month benchmark simulation v9-01-02f and approved on 02 Aug 2011.

The current Wet deposition algorithm was underestimating washout of non-aerosol species. Please see this wiki post for more information about how we corrected this situation.

--Bob Y. 14:34, 2 August 2011 (EDT)

Overhaul of aerosol optical depth diagnostics

This update was tested in the 1-month benchmark simulation v9-01-02g and approved on 10 Aug 2011.

Patrick Kim discovered some inconsistencies in the way aerosol optical depth diagnostics were being computed in GEOS-Chem v9-01-01 and prior versions. We have now corrected these inconsistencies.

Sungshik Patrick Kim wrote:

Here is an example of a daily (first page) and monthly (second page) average AOD for January 2008 from the public release of v9-01-01 and a newer version that addresses the changes we discussed earlier vs. the corresponding average AERONET data, a difference plot, and a histogram of the differences by grid box. [T]he largest differences appear to be due to the change in met field rather than changing the timing of the AOD calculation and it may be largest in the Arctic due to uncertainties in the previous calculation of RH.

--Bob Y. 15:15, 10 August 2011 (EDT)

Fix for GEIA emissions scaling factor over Botswana

Obsolete.jpg

This update was tested in the 1-month benchmark simulation v9-01-02h and approved on 12 Aug 2011.

In GEOS-Chem v10-01 and higher versions, all emissions and scale factors are handled by the HEMCO emissions component.

Please see this wiki post about a problem in the scale factors for GEIA emissions over Botswana and southern Africa.

--Bob Y. 11:16, 15 August 2011 (EDT)

Archive the MERRA SWGDN field in the ND67 diagnostic

This update was tested in the 1-month benchmark simulation v9-01-02i and approved on 15 Aug 2011.

Jenny Fisher pointed out that we were saving the MERRA "longwave radiation at the ground" (LWGNT) field into the ND67 diagnostic instead of the MERRA "shortwave radiation at the ground" (SWGDN) field. We have fixed this by archiving SWGDN to ND67 instead of LWGNT. This is done in the module merra_a1_mod.F.

--Bob Y. 10:24, 16 August 2011 (EDT)

Fixed minor issues in MERRA cloud convection routine

Jenny Fisher discovered two minor issues in the MERRA convection routine DO_MERRA_CONVECTION (in module convection_mod.f). Please see this post on our Cloud convection wiki page for a full description of the issue.

--Bob Y. 15:54, 20 December 2012 (EST)

Minor fixes in APM microphysics

This update was tested in the 1-month benchmark simulation v9-01-02n and approved on 22 Sep 2011.

Gan Luo wrote:

I have finished the checking of the updated V9-01-02 version copied from you last week. The updates from us are listed as follows:
1. Current version does not include updated code for pbl_mix_mod.F in GeosApm. The tracers need to be extended to all APM tracers.
2. In GeosApm/wetscav_mod.F:
a) Please add the missing codes after Line2066
        ELSE IF ( (N >= IDTCTSEA .and. N<(IDTCTSEA+NCTSEA)) .or.
       &          (N >= IDTSEABIN1 .and. N<(IDTSEABIN1+NSEA)) ) THEN
           CALL F_AEROSOL( KC, F )
b) Lines 5628-5632 need to be moved to the line after Line 5646
3. In GeosCore/vdiff_mod.F: Line884 [ustar(i) = max( ustr,.01 )] need to be changed to [ustar(i) = max( ustr,.01d0 )]
We have finished one year benchmark run with 4x5 horizontal resolution, and we also analyzed the results. They look reasonable.

--Bob Y. 15:39, 7 September 2011 (EDT)

Fix for vertical regridding of offline OH for offline simulations

Obsolete.jpg

This update was tested in the 1-month benchmark simulation v9-01-02p and approved on 29 Sep 2011.

This code was removed from GEOS-Chem v10-01 and higher versions. The HEMCO emissions component now reads in 3D oxidant fields from netCDF data files.

Chris Holmes wrote:

I have a bug fix for offline simulations that use offline OH fields. The way the code previously lumped layers in the stratosphere was incorrect for OH. Other offline fields (e.g. O3, Br, BrO) are OK, as long as they are in mixing ratio units.
Unlumped layers are unaffected. OH number densities in the lumped layers increase up to 7%. I tested for Hg only and found that they Hg changes were correspondingly modest.
Here are my comments from the commit:
Offline OH fields are stored as number concentrations (molec/cm3) on a 3D grid with unreduced vertical coordinate (e.g. in the file OH_3Dglobal.geos5.4x5). The model lumps layers in the stratosphere into a reduced vertical grid within global_oh_mod.f. The regridding routine (subroutine transfer_3d) requires input as a mixing ratio, but this assumption was violated for OH fields. To correct this problem, we convert OH number concentration to a mixing ratio, then regrid, then convert back to number concentration.
OH concentrations in unlumped layers are unaffected, while increases up to 7% occur in lumped layers in the stratosphere.

--Bob Y. 15:15, 10 August 2011 (EDT)

Further bug fixes for the offline Hg simulation

This update was tested in the 1-month benchmark simulation v9-01-02p and approved on 29 Sep 2011.

The following bugs were discovered after the release of v9-01-01 and have been fixed in v9-01-02. Please follow the links below for more information:

  1. Division by zero error
  2. Bug fixes for ND03 mercury diagnostics

--Melissa Payer 14:51, 19 September 2011 (EDT)

Further fixes for nested-grid simulations

The following fixes were submitted in September 2011 from the nested-grid user community:

Bug fix in planeflight diagnostic for nested-grid simulation

This update was tested in the 1-month benchmark simulation v9-01-02p and approved on 29 Sep 2011.

Luke Schiferl wrote:

While running the planeflight diagnostic with the NA nested grid in v9-01-01, I discovered an issue with the formulas that assign the grid box index from which to pull the concentration values. The formulas remained valid for the global grid regardless if running either a global or nested simulation, thus improperly assigning the grid box index for a nested run. I've made the necessary modifications which now take into account the offsets assigned in input.geos. These offsets are required when running a nested simulation, so the indices will now be properly calculated. I successfully tested the modification with global 2x2.5 and NA nested 0.5x0.667.

--Bob Y. 14:00, 6 September 2011 (EDT)

NH3 emissions set to zero in China nested-grid simulations

Obsolete.jpg

This update was tested in the 1-month benchmark simulation v9-01-02p and approved on 29 Sep 2011.

In GEOS-Chem v10-01 and higher versions, the HEMCO emissions component now processes all emissions.

Aaron van Donkelaar wrote:

We've recently found that CH Nested NH3 emissions were being set to zero when using the 2006 inventory in v9-0-01. This bug had already been addressed for the global simulation, but had not been applied to the CH nested one. Attached please find a patch file that corrects the problem.

--Bob Y. 11:47, 8 September 2011 (EDT)

Further fixes for APM microphysics

This update was tested in the 1-month benchmark simulation v9-01-02p and approved on 29 Sep 2011.

Gan Luo wrote:

The column concentrations of the original tracers of BC, OC and dust in GEOS-Chem (59 tracers for full chemistry simulation) simulated by v9-01-02n at remote oceans are much lower than those simulated by v9-01-02l. And we believe that the low values over remote oceans in v9-01-02n may be not reasonable.
The bug leading to the differences between v9-01-02n and v9-01-02l over remote regions is located at wetscav_mod.F. In v9-01-02n, GEOS_5 is undefined in module WETSCAV_MOD. After added # include "define.h" into wetscav_mod.F, the differences between v9-01-02n and v9-01-02l disappeared.
The summary of v9-01-02n debugging for APM is here:
1. In GeosApm/Makefile, the rules to make GFED3 related codes need to be added
2. Please add # include "define.h" at GeosApm/wetscav_mod.F line 19 and GeosApm/apm_wets_mod.F line 130

--Melissa Payer 13:57, 27 September 2011 (EDT)

Fix for partitioning chemical species

Obsolete.jpg

This update was tested in the 1-month benchmark simulation v9-01-02r and approved on 20 Oct 2011.

NOTE: The CSPEC array was removed (along with all other SMVGEAR arrays) when the FlexChem solver was implemented into GEOS-Chem v11-01.

Prasad Kasibhatla wrote:

It seems to me that CSPEC has the latest (post-transport) concentrations coming into PARTITION - but the index JLOOP_P refers to the previous time-step. So the effect of the statement CSAVE(JLOOP,N) = CSPEC(JLOOP_P,CSAVEID_JJ(N)) would be to populate CSAVE with the latest CSPEC array but with an index from the previous time step - which may mean it is from a different grid box since the same first index of CSPEC does not necessarily refer to the same box in each time step as it is recalculated in subroutine RURALBOX before each chem step.

Daven Henze wrote:

The problem is that CSPEC gets overwritten by CSPEC_FULL prior to partitioning. I believe the only thing required to make this fix work is to change:
     IF ( LVARTROP .or. FIRSTCHEM .or. READ_CSPEC ) CALL COPY_FULL_TROP
to
     IF ( FIRSTCHEM .or. READ_CSPEC ) CALL COPY_FULL_TROP
in gasconc.f.
The problem with the existing code is that it uses JLOOP_P but references a current CSPEC array which is ordered by JLOOP.
The corrected version uses JLOOP_P and the CSPEC array from the previous step. New tropospheric grid cells inherit concentrations below them, rather than values held over since the last time the cell was in the trop. The only issue I see now with the version of CSPEC_FULL that gets written to a restart file would still contain some of these hold-over values.

--Melissa Payer 15:15, 18 October 2011 (EDT)
--Bob Yantosca (talk) 17:24, 15 November 2017 (UTC)

Bug fixes for biofuel emissions

Obsolete.jpg

This update was tested in the 1-month benchmark simulation v9-01-02s and approved on 5 Nov 2011. (Included in Adjoint v34e )

This code was removed from GEOS-Chem v10-01 and higher versions. The HEMCO emissions component now processes all emissions data in these versions.

The following issues were discovered in biofuel_mod.F. Please follow the links below for more information:

  1. Further fix for double-counting of residential biofuel when using RETRO
  2. Bug fix in biofuel emissions using Streets inventory

--Melissa Payer 13:27, 21 October 2011 (EDT)
--Bob Yantosca (talk) 17:24, 15 November 2017 (UTC)

Prevent out-of-bounds errors in ND01 and ND02 diagnostics for Rn-Pb-Be simulation

This bug fix was added to GEOS-Chem v9-01-02 just prior to release. It does not affect the full-chemistry simulation, only the Rn-Pb-Be simulations.

For more information about this issue, please see this post on our Rn-Pb-Be simulation wiki page.

--Bob Y. 11:13, 28 November 2011 (EST)

Do not use erroneous MEGAN AEF's for nested grid simulations

This bug fix was added to GEOS-Chem v9-01-02 just prior to release. It does not affect the full-chemistry simulation, only nested-grid simulations.

For more information about this issue, please see this post on our MEGAN biogenic emissions wiki page.

--Bob Y. 10:18, 28 November 2011 (EST)

Under further investigation

The following updates (which should ideally not yield any differences) seem to cause slight numerical discrepancies when added to the standard code. We shall postpone including these into the standard code, pending investigation.

Minor bug fixes in ISORROPIA II

Please see this post on our ISORROPIA II wiki page for a description of two proposed bug fixes that should go into source code file ISOROPIA/isorropiaIIcode.f. This bug should not affect the current GEOS-Chem ISORROPIA configuration, but may affect future development.

Update 7/28/11: Implementing this change causes the 1-month standard benchmark simulation to have divergent results than the previous version. Therefore, we should understand the source of these differences before we add this update into the standard repository.

--Bob Y. 14:40, 28 July 2011 (EDT)

Fixes in emep_mod.f

Obsolete.jpg

NOTE: This issue was ultimately resolved in GEOS-Chem v9-01-03g.

Module emep_mod.F was removed from GEOS-Chem v10-01 and higher versions. Emissions in these versions are now handled by HEMCO.

Please see this post on our EMEP European anthropogenic emissions wiki page for a full description of this issue.

--Bob Y. 12:43, 20 December 2012 (EST)
--Bob Yantosca (talk) 17:25, 15 November 2017 (UTC)

Fix for offline simulations in nei2005_anthro_mod.f

Obsolete.jpg

NOTE: This issue was ultimately resolved in GEOS-Chem v9-01-03g.

Module nei2005_anthro_mod.F was removed from GEOS-Chem v10-01 and higher versions. Emissions in these versions are now handled by HEMCO.

Please see this post on our EPA/NEI05 North American Emissions wiki page for a full description of the issue.

--Bob Y. 12:46, 20 December 2012 (EST)
--Bob Yantosca (talk) 17:25, 15 November 2017 (UTC)

Outstanding issues not yet resolved in v9-01-02

Please also see our Currently unresolved issues in GEOS-Chem wiki page for more information about as-yet unresolved issues first identified in prior versions.

RETRO anthropogenic ethane emissions are too low

Obsolete.jpg

NOTE: All emissions are handled by HEMCO in GEOS-Chem v10-01 and higher versions.

Please see this wiki post on the RETRO emissions wiki page for a full description of this issue. We expect to fix this issue in GEOS-Chem v9-01-03.

--Bob Y. 11:17, 28 November 2011 (EST)
--Bob Yantosca (talk) 17:25, 15 November 2017 (UTC)

Apparent bug in LINOZ

Prasad Kasibhatla wrote:

There is a bug in LINOZ related to calculation of column ozone associated with very tiny negative O3 mixing ratios in strat, that can cause the model to crash. This is compiler dependent because sometimes the tiny concentrations appear as tiny positive numbers and the model does not crash. Dylan Jones. is looking into this - a quick fix is possible to prevent the model from crashing, but a bigger issue is the non-physical tiny O3 concentrations that occassionally occur in stratosphere - I suspect this has something to do with handling of STT and CSPEC arrays when a box goes [from the troposphere to the stratosphere] in a time-step.

--Bob Y. 10:52, 1 August 2011 (EDT)

Incompatibility with GNU Make v3.80

This is a minor technical issue caused by some leftover test code in the GeosApm/Makefile and GeosTomas/Makefile. This will be corrected in GEOS-Chem v9-01-03.

May Fu wrote:

In testing v912, I found that gnu make version 3.81 or later is required, because the ‘else ifeq’ syntax is used in the Makefiles. I would imagine most people have at least v3.81, unless they are using a really old Linux distribution like I do, where the default gnu make is 3.80. The danger is that the user will not be able to do a proper ‘make realclean’, but might still be able to ‘make’, resulting in a bad build.

Michael Long wrote:

The instance of else ifeq is not meant to be operational in v9-01-02. I will revise the Makefiles to undo this.

--Bob Y. 15:54, 6 December 2011 (EST)