Difference between revisions of "The input.geos file"

From Geos-chem
Jump to: navigation, search
(Overview)
(ObsPack diagnostic)
 
(81 intermediate revisions by 2 users not shown)
Line 1: Line 1:
== Overview ==
+
__FORCETOC__
 +
'''''[[GEOS-Chem configuration files|Previous]] | [[The HEMCO_Config.rc file|Next]] | [[Getting Started with GEOS-Chem]]'''''
 +
#[[Minimum system requirements for GEOS-Chem|Minimum system requirements]]
 +
#[[Installing required software]]
 +
#[[Configuring your computational environment]]
 +
#[[Downloading GEOS-Chem source code|Downloading source code]]
 +
#[[Downloading GEOS-Chem data directories|Downloading data directories]]
 +
#[[Creating GEOS-Chem run directories|Creating run directories]]
 +
#[[GEOS-Chem input files|Configuring runs]]
 +
#*<span style="color:blue">'''Editing <tt>input.geos</tt>'''</span>
 +
#*[[The HEMCO_Config.rc file|Editing <tt>HEMCO_Config.rc</tt>]]
 +
#*[[The HEMCO_Diagn.rc file|Editing <tt>HEMCO_Diagn.rc</tt>]]
 +
#*[[HISTORY.rc and other configuration files|Editing <tt>HISTORY.rc</tt> and other configuration files]]
 +
#[[Compiling GEOS-Chem|Compiling]]
 +
#[[Running GEOS-Chem|Running]]
 +
#[[GEOS-Chem output files|Output files]]
 +
#[[Python tools for use with GEOS-Chem]]
 +
#[[GEOS-Chem_coding_and_debugging|Coding and debugging]]
 +
#[[GEOS-Chem_overview#Further_reading|Further reading]]
  
Most user-defined input switches and settings which customize GEOS-Chem options (other than emissions and diagnostic output settings) are defined in the <tt>input.geos</tt> configuration file.
+
 
 +
The <tt>input.geos</tt> configuration file contains settings for most GEOS-Chem options (excluding [[The HEMCO User's Guide|emissions]] and [[Guide to GEOS-Chem History diagnostics|History diagnostics]])
 +
 
 +
== Overview ==
  
 
An <tt>input.geos</tt> file ships with each GEOS-Chem run directory. We invite you to [[Creating GEOS-Chem run directories|create the run directory]] for the simulation(s) that you are interested in and view the corresponding <tt>input.geos</tt> file.  You will note that the <tt>input.geos</tt> file is grouped into menus.  Each menu controls the options for a particular aspect of a GEOS-Chem simulation.  The sections below contain a list of the menus and the options that  they control.  
 
An <tt>input.geos</tt> file ships with each GEOS-Chem run directory. We invite you to [[Creating GEOS-Chem run directories|create the run directory]] for the simulation(s) that you are interested in and view the corresponding <tt>input.geos</tt> file.  You will note that the <tt>input.geos</tt> file is grouped into menus.  Each menu controls the options for a particular aspect of a GEOS-Chem simulation.  The sections below contain a list of the menus and the options that  they control.  
Line 14: Line 35:
  
 
  01: %%% SIMULATION MENU %%% :
 
  01: %%% SIMULATION MENU %%% :
  02: Start YYYYMMDD, hhmmss  : 20130701 000000
+
  02: Start YYYYMMDD, hhmmss  : 20190701 000000
  03: End  YYYYMMDD, hhmmss  : 20130801 000000
+
  03: End  YYYYMMDD, hhmmss  : 20190801 000000
 
  04: Run directory          : ./
 
  04: Run directory          : ./
  05: Root data directory    : <span style="color:red">/path/to/data/</span>
+
  05: Root data directory    : <span style="color:red">/path/to/data/</span>
  06: Met field              : geosfp
+
  06: Met field              : MERRA2
  07: Simulation name        : standard
+
  07: Simulation name        : fullchem
 +
08: Species database file  : ./species_database.yml
 +
09: Turn on debug printout? : F
 +
10: Use GC classic timers?  : F
  
 
Note: <span style="color:red"><tt>/path/to/data/</tt></span> indicates the path to the root data folder on your system.  If you don't know where this is, ask your IT staff.
 
Note: <span style="color:red"><tt>/path/to/data/</tt></span> indicates the path to the root data folder on your system.  If you don't know where this is, ask your IT staff.
Line 70: Line 94:
 
|<tt>Input_Opt%MetField</tt>
 
|<tt>Input_Opt%MetField</tt>
 
|Specify the meteorology fields for your simulation. Current options are [[GEOS-FP]] or [[MERRA-2]].
 
|Specify the meteorology fields for your simulation. Current options are [[GEOS-FP]] or [[MERRA-2]].
||Added in [[GEOS-Chem 12#12.6.0|12.6.0]]
+
|<span style="color:darkgreen">'''Added in 12.6.0'''</span>
  
 
|-valign="top"
 
|-valign="top"
 
|7
 
|7
 
|<tt>Input_Opt%SimulationName</tt>
 
|<tt>Input_Opt%SimulationName</tt>
|Specify the name of the simulation.  Allowable values (case-insensitive) are:
+
|Specify the name of the simulation.  Please see our ''[[Guide to GEOS-Chem simulations]]'' for detailed information about each simulation.  Allowable values (case-insensitive) are:
  
#aciduptake    
+
Full-chemistry   Specialry
#aerosol         
+
simulations      simulations
#apm             
+
--------------    ---------------
#benchmark       
+
  fullchem        aerosol
#CH4            
+
  custom          CH4 (and tagCH4)
#CO2            
+
                  CO2  
#complexSOA     
+
                  Hg (and tagHg)
#complexSOA_SVPOA
+
                  POPs
#HEMCO           
+
                  tagCO
#Hg              
+
                  tagO3
#marinePOA       
+
                  TransportTracers
#POPs
+
|<span style="color:darkgreen">'''Added in 12.6.0'''</span>
#RRTMG           
+
#standard       
+
#TransportTracers
+
#tropchem
+
#tagCO
+
#tagCH4
+
#tagHg
+
#tagO3
+
#TOMAS12
+
#TOMAS15
+
#TOMAS30
+
#TOMAS40
+
|Added in [[GEOS-Chem 12#12.6.0|12.6.0]]
+
|}
+
  
--[[User:Melissa Payer|Melissa Sulprizio]] ([[User talk:Melissa Payer|talk]]) 14:31, 28 June 2019 (UTC)<br>--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 18:29, 9 December 2019 (UTC)
+
|-valign="top"
 +
|8
 +
|<tt>Input_Opt%SpcDatabaseFile</tt>
 +
|Specify the path to the YAML file containing the GEOS-Chem species database.  The species database file is placed in the GEOS-Chem run directory, so you should not have to modify this line.
 +
|<span style="color:darkgreen">'''Added in 12.9.0'''</span>
 +
 
 +
|-valign="top"
 +
|9
 +
|<tt>Input_Opt%LPRT</tt>
 +
|Specify if additional debug information should be printed out to the log file.  This was formerly toggled by the ND70 diagnostic.
 +
|<span style="color:darkgreen">'''Added in 12.9.0'''</span>
 +
 
 +
|-valign="top"
 +
|10
 +
|<tt>Input_Opt%UseTimers</tt>
 +
|Specify if GEOS-Chem timing information should be printed out.  Was formerly toggled by the Makefile option <tt>TIMERS=1</tt>.
 +
|<span style="color:darkgreen">'''Added in 12.9.0'''</span>
 +
 
 +
|}
  
 
=== Grid ===
 
=== Grid ===
  
<span style="color:red">'''''NOTE: The Grid Menu was introduced in [[GEOS-Chem 12#12.4.0|GEOS-Chem 12.4.0]]. This menu is not read by GCHP or when running GEOS-Chem in an ESM.'''''</span>
+
<span style="color:darkgreen">'''''NOTE: The Grid Menu was introduced in [[GEOS-Chem 12#12.4.0|GEOS-Chem 12.4.0]]. This menu is not read by GCHP or when running GEOS-Chem in an ESM.'''''</span>
  
 
Line numbers are not part of the <tt>input.geos</tt> file, but have been included for reference.
 
Line numbers are not part of the <tt>input.geos</tt> file, but have been included for reference.
Line 141: Line 169:
  
 
GEOS-Chem will split this string and store values in <tt>State_Grid%DX</tt> and <tt>State_Grid%DY</tt>.
 
GEOS-Chem will split this string and store values in <tt>State_Grid%DX</tt> and <tt>State_Grid%DY</tt>.
|Added in [[GEOS-Chem 12#12.4.0|12.4.0]]
+
|<span style="color:darkgreen">'''Added in 12.4.0'''</span>
  
 
|-valign="top"
 
|-valign="top"
Line 150: Line 178:
 
The number of grid boxes in the X dimension are computed from these bounds using:
 
The number of grid boxes in the X dimension are computed from these bounds using:
 
:<tt>State_Grid%NX = ( State_Grid%XMax - State_Grid%XMin ) / State_Grid%DX )</tt>.
 
:<tt>State_Grid%NX = ( State_Grid%XMax - State_Grid%XMin ) / State_Grid%DX )</tt>.
|Added in [[GEOS-Chem 12#12.4.0|12.4.0]]
+
|<span style="color:darkgreen">'''Added in 12.4.0'''</span>
  
 
|-valign="top"
 
|-valign="top"
Line 159: Line 187:
 
The number of grid boxes in the Y dimension are computed from these bounds using:
 
The number of grid boxes in the Y dimension are computed from these bounds using:
 
:<tt>State_Grid%NY = ( State_Grid%YMax - State_Grid%YMin ) / State_Grid%DY )</tt>.
 
:<tt>State_Grid%NY = ( State_Grid%YMax - State_Grid%YMin ) / State_Grid%DY )</tt>.
|Added in [[GEOS-Chem 12#12.4.0|12.4.0]]
+
|<span style="color:darkgreen">'''Added in 12.4.0'''</span>
  
 
|-valign="top"
 
|-valign="top"
Line 165: Line 193:
 
|<tt>State_Grid%HalfPolar</tt>
 
|<tt>State_Grid%HalfPolar</tt>
 
|Set this to T to use half-sized polar grid boxes. This should always be set to T when using GMAO met fields (i.e. [[GEOS-FP]], [[MERRA-2]]).
 
|Set this to T to use half-sized polar grid boxes. This should always be set to T when using GMAO met fields (i.e. [[GEOS-FP]], [[MERRA-2]]).
|Added in [[GEOS-Chem 12#12.4.0|12.4.0]]
+
|<span style="color:darkgreen">'''Added in 12.4.0'''</span>
  
 
|-valign="top"
 
|-valign="top"
Line 171: Line 199:
 
|<tt>State_Grid%NZ</tt>
 
|<tt>State_Grid%NZ</tt>
 
|The number of vertical levels. Current supported options are [[GEOS-Chem_vertical_grids#47-layer_reduced_vertical_grid|47]] and [[GEOS-Chem_vertical_grids#72-layer_vertical_grid|72]].
 
|The number of vertical levels. Current supported options are [[GEOS-Chem_vertical_grids#47-layer_reduced_vertical_grid|47]] and [[GEOS-Chem_vertical_grids#72-layer_vertical_grid|72]].
|Added in [[GEOS-Chem 12#12.4.0|12.4.0]]
+
|<span style="color:darkgreen">'''Added in 12.4.0'''</span>
  
 
|-valign="top"
 
|-valign="top"
Line 177: Line 205:
 
|<tt>State_Grid%NestedGrid</tt>
 
|<tt>State_Grid%NestedGrid</tt>
 
|Set this to T when running a nested grid simulation or to F otherwise.
 
|Set this to T when running a nested grid simulation or to F otherwise.
|Added in [[GEOS-Chem 12#12.4.0|12.4.0]]
+
|<span style="color:darkgreen">'''Added in 12.4.0'''</span>
  
 
|-valign="top"
 
|-valign="top"
Line 183: Line 211:
 
|<tt>State_Grid%NorthBuffer<br>State_Grid%SouthBuffer<br>State_Grid%EastBuffer<br>State_Grid%WestBuffer</tt>
 
|<tt>State_Grid%NorthBuffer<br>State_Grid%SouthBuffer<br>State_Grid%EastBuffer<br>State_Grid%WestBuffer</tt>
 
|The nested grid longitude and latitude offsets (in # of boxes) of the which are used to define an inner window region in which transport is actually done. The region in which transport is done in the window is smaller than the actual size of them nested grid met fields in order to account for the boundary conditions. Please see the comments to the source code file <tt>tpcore_bc_mod.F</tt> for more information. Recommended values are <tt>3 3 3 3</tt>.
 
|The nested grid longitude and latitude offsets (in # of boxes) of the which are used to define an inner window region in which transport is actually done. The region in which transport is done in the window is smaller than the actual size of them nested grid met fields in order to account for the boundary conditions. Please see the comments to the source code file <tt>tpcore_bc_mod.F</tt> for more information. Recommended values are <tt>3 3 3 3</tt>.
|Added in [[GEOS-Chem 12#12.4.0|12.4.0]]
+
|<span style="color:darkgreen">'''Added in 12.4.0'''</span>
  
 
|}
 
|}
--[[User:Melissa Payer|Melissa Sulprizio]] ([[User talk:Melissa Payer|talk]]) 17:57, 11 July 2019 (UTC)<br>--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 20:02, 9 December 2019 (UTC)
 
  
 
=== Timestep ===
 
=== Timestep ===
 
''NOTE: In [[GEOS-Chem 12]], we have changed the units of all timesteps from minutes to seconds.  We made this change in order to be able to interface GEOS-Chem with the NASA the GEOS-DAS Earth System Model more efficiently.''
 
  
 
Line numbers are not part of the <tt>input.geos</tt> file, but have been included for reference.
 
Line numbers are not part of the <tt>input.geos</tt> file, but have been included for reference.
Line 223: Line 248:
 
**2&deg; x 2.5&deg; global simulations: 600 sec (=10 min)
 
**2&deg; x 2.5&deg; global simulations: 600 sec (=10 min)
 
**4&deg; x 5&deg; global simulations: 600 sec (=10 min)
 
**4&deg; x 5&deg; global simulations: 600 sec (=10 min)
|Added in [[GEOS-Chem 12#12.0.0|12.0.0]]
+
|<span style="color:darkgreen">'''Added in 12.0.0'''</span>
  
 
|-valign="top"
 
|-valign="top"
Line 237: Line 262:
 
**2&deg; x 2.5&deg; global simulations: 600 sec (=10 min)
 
**2&deg; x 2.5&deg; global simulations: 600 sec (=10 min)
 
**4&deg; x 5&deg; global simulations: 600 sec (=10 min)
 
**4&deg; x 5&deg; global simulations: 600 sec (=10 min)
|Added in [[GEOS-Chem 12#12.0.0|12.0.0]]
+
|<span style="color:darkgreen">'''Added in 12.0.0'''</span>
  
 
|-valign="top"
 
|-valign="top"
Line 243: Line 268:
  
 
|}
 
|}
 
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 20:48, 9 December 2019 (UTC)
 
  
 
=== Advected Species ===
 
=== Advected Species ===
Line 293: Line 316:
  
 
NOTE: In this example, the ADVECTED SPECIES MENU is set up for a "Standard" full chemistry simulation.  This is the simulation we use to generate the GEOS-Chem benchmark output.
 
NOTE: In this example, the ADVECTED SPECIES MENU is set up for a "Standard" full chemistry simulation.  This is the simulation we use to generate the GEOS-Chem benchmark output.
|Removed in [[GEOS-Chem 12#12.6.0|12.6.0]]
+
|<span style="color:red">'''Removed in in 12.6.0'''</span>
  
 
|-valign="top"
 
|-valign="top"
Line 299: Line 322:
 
|nothing
 
|nothing
 
|Header line
 
|Header line
|Removed in [[GEOS-Chem 12#12.6.0|12.6.0]]
+
|<span style="color:red">'''Removed in in 12.6.0'''</span>
 
+
  
 
|-valign="top"
 
|-valign="top"
Line 309: Line 331:
  
 
|}
 
|}
 
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 20:49, 9 December 2019 (UTC)
 
  
 
=== Transport ===
 
=== Transport ===
Line 410: Line 430:
 
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 20:03, 9 December 2019 (UTC)
 
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 20:03, 9 December 2019 (UTC)
  
=== Emissions ===
+
=== Emissions (12.9.0 and later) ===
 
+
Line numbers are not part of the <tt>input.geos</tt> file, but have been included for reference.
+
  
 
  01: %%% EMISSIONS MENU %%%  :
 
  01: %%% EMISSIONS MENU %%%  :
  02: Turn on emissions?      : T
+
  02: HEMCO Input file        : HEMCO_Config.rc
03: HEMCO Input file        : HEMCO_Config.rc
+
  03: Switches for UCX        :---
  04:  => 1ppt MBL BRO Sim.?  : F
+
  04:  => Use CH4 emissions?  : F
05: Switches for UCX        :---
+
  05:  => Set init. strat. H2O: T
  06:  => Use CH4 emissions?  : F
+
  07:  => Turn on surface BCs :---
+
08:    => CH4?            : T
+
19:    => OCS?            : T
+
10:    => CFCs?            : T
+
11:    => Cl species?      : T
+
12:    => Br species?      : F
+
13:    => N2O?            : T
+
14:  => Set initial glob MRs:---
+
15:    => strat. H2O?      : T
+
16:  => CFC emission year  : 0
+
  
 
{| border=1 cellspacing=0 cellpadding=5  
 
{| border=1 cellspacing=0 cellpadding=5  
Line 446: Line 453:
 
|-valign="top"
 
|-valign="top"
 
|2
 
|2
|<tt>Input_Opt%LEMIS</tt>
 
|Set this to T to turn on emissions or F to turn off emissions.
 
|
 
 
|-valign="top"
 
|3
 
 
|<tt>Input_Opt%HcoConfigFile</tt>
 
|<tt>Input_Opt%HcoConfigFile</tt>
 
|The name of the HEMCO configuration file. The emission inventories that your simulation will use are set in this file.
 
|The name of the HEMCO configuration file. The emission inventories that your simulation will use are set in this file.
Line 457: Line 458:
  
 
|-valign="top"
 
|-valign="top"
|4
+
|3
|<tt>Input_Opt%LFIX_PBL_BrO</tt>
+
|Set this to T to set Bro concentrations in the PBL equal to 1 ppt during the day.
+
|
+
 
+
|-valign="top
+
!colspan="4" bgcolor="#CCFFFF"|The following lines contain settings specific to the [[UCX chemistry mechanism]].<br>You can turn all of these options off if your simulation does not use the UCX mechanism (e.g "tropchem", "complexSOA").
+
 
+
|-valign="top"
+
|5
+
 
|nothing
 
|nothing
|Header line. 
+
|Header Line
 
|
 
|
  
 
|-valign="top"
 
|-valign="top"
|6
+
|4
 
|<tt>Input_Opt%LCH4EMIS</tt>
 
|<tt>Input_Opt%LCH4EMIS</tt>
|Set this T to use online methane emissions.
+
|Set this T to use online methane emissions in the full-chemistry mechanism.
 
|
 
|
  
 
|-valign="top"
 
|-valign="top"
|7
+
|5
|nothing
+
|Header line
+
|
+
 
+
|-valign="top"
+
|8
+
|<tt>Input_Opt%LCH4SBC</tt>
+
|Set this T to fix surface mixing ratio of methane.
+
|
+
 
+
|-valign="top"
+
|9
+
|<tt>Input_Opt%LOCSEMIS</tt>
+
|Set this to T to fix surface mixing ratios of OCS.
+
|
+
 
+
|-valign="top"
+
|10
+
|<tt>Input_Opt%LCFCEMIS</tt>
+
|Set this to T to fix surface mixing ratios of CFCs, HCFCs, and halons to match WMO projections under the Montreal Protocol.
+
|
+
 
+
|-valign="top"
+
|11
+
|<tt>Input_Opt%LCLEMIS</tt>
+
|Set this to T to fix surface mixing ratios of other chlorinated carbon and inorganic chlorine species to match WMO projections under the Montreal Protocol.
+
|
+
 
+
|-valign="top"
+
|12
+
|<tt>Input_Opt%LBREMIS</tt>
+
|Set this to T to fix surface mixing ratios of bromine species. Not recommended if other bromine emissions are enabled.
+
|
+
 
+
|-valign="top"
+
|13
+
|<tt>Input_Opt%LN2OEMIS</tt>
+
|Set this to T to fix surface mixing ratios of N2O.
+
|
+
 
+
|-valign="top"
+
|14
+
|nothing
+
|Header line
+
|
+
 
+
|-valign="top"
+
|15
+
 
|<tt>Input_Opt%LSETH2O</tt>
 
|<tt>Input_Opt%LSETH2O</tt>
 
|Set this to T to initialize stratospheric H2O mixing ratios based on meteorology data for the first timestep, overriding any restart file values.
 
|Set this to T to initialize stratospheric H2O mixing ratios based on meteorology data for the first timestep, overriding any restart file values.
|
 
 
|-valign="top"
 
|16
 
|<tt>Input_Opt%CFCYEAR</tt>
 
|Specify the starting year for CFC emissions.
 
 
|
 
|
  
 
|}
 
|}
 
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 20:05, 9 December 2019 (UTC)
 
  
 
=== Aerosols ===
 
=== Aerosols ===
Line 672: Line 608:
 
|<tt>Input_Opt%LBCAE</tt>
 
|<tt>Input_Opt%LBCAE</tt>
 
|Set this to T to enhance black carbon (BC) absorption due to coating.
 
|Set this to T to enhance black carbon (BC) absorption due to coating.
|Added in [[GEOS-Chem 12#12.6.0|12.6.0]]
+
|<span style="color:darkgreen">'''Added in 12.6.0'''</span>
  
 
|-valign="top"
 
|-valign="top"
 
|23
 
|23
|<tt>Input_Opt%LBCAE_1</tt>
+
|<tt>Input_Opt%BCAE_1</tt>
 
|Specify the enhancement for hydrophilic BC.
 
|Specify the enhancement for hydrophilic BC.
|Added in [[GEOS-Chem 12#12.6.0|12.6.0]]
+
|<span style="color:darkgreen">'''Added in 12.6.0'''</span>
  
 
|-valign="top"
 
|-valign="top"
 
|24
 
|24
|<tt>Input_Opt%LBCAE_2</tt>
+
|<tt>Input_Opt%BCAE_2</tt>
 
|Specify the enhancement for hydrophobic BC.
 
|Specify the enhancement for hydrophobic BC.
|Added in [[GEOS-Chem 12#12.6.0|12.6.0]]
+
|<span style="color:darkgreen">'''Added in 12.6.0'''</span>
  
 
|-valign="top"
 
|-valign="top"
Line 690: Line 626:
 
|<tt>Input_Opt%hvAerNIT</tt>
 
|<tt>Input_Opt%hvAerNIT</tt>
 
|Set this to T to turn on photolysis of nitrate aerosol (it is off by default)
 
|Set this to T to turn on photolysis of nitrate aerosol (it is off by default)
|Added in [[GEOS-Chem 12#12.6.0|12.6.0]]
+
|<span style="color:darkgreen">'''Added in 12.6.0'''</span>
  
 
|-valign="top"
 
|-valign="top"
Line 696: Line 632:
 
|<tt>Input_Opt%hvAerNIT_JNITs</tt>
 
|<tt>Input_Opt%hvAerNIT_JNITs</tt>
 
|Define scale factor for JHNO3 photolyizing NITs aerosol
 
|Define scale factor for JHNO3 photolyizing NITs aerosol
|Added in [[GEOS-Chem 12#12.6.0|12.6.0]]
+
|<span style="color:darkgreen">'''Added in 12.6.0'''</span>
  
 
|-valign="top"
 
|-valign="top"
Line 702: Line 638:
 
|<tt>Input_Opt%hvAerNIT_JNIT</tt>
 
|<tt>Input_Opt%hvAerNIT_JNIT</tt>
 
|Define scale factor for JHNO3 photolyizing NIT aerosol
 
|Define scale factor for JHNO3 photolyizing NIT aerosol
|Added in [[GEOS-Chem 12#12.6.0|12.6.0]]
+
|<span style="color:darkgreen">'''Added in 12.6.0'''</span>
  
 
|-valign="top"
 
|-valign="top"
Line 708: Line 644:
 
|<tt>Input_Opt%JNITChanA</tt>
 
|<tt>Input_Opt%JNITChanA</tt>
 
|Define fraction for JNITs/NIT channel A (H2O2) for NITs photolysis
 
|Define fraction for JNITs/NIT channel A (H2O2) for NITs photolysis
|Added in [[GEOS-Chem 12#12.6.0|12.6.0]]
+
|<span style="color:darkgreen">'''Added in 12.6.0'''</span>
  
 
|-valign="top"
 
|-valign="top"
Line 714: Line 650:
 
|<tt>Input_Opt%JNITChanB</tt>
 
|<tt>Input_Opt%JNITChanB</tt>
 
|Define fraction for JNITs/NIT channel B (NO2) for NITs photolysis
 
|Define fraction for JNITs/NIT channel B (NO2) for NITs photolysis
|Added in [[GEOS-Chem 12#12.6.0|12.6.0]]
+
|<span style="color:darkgreen">'''Added in 12.6.0'''</span>
  
 
|-valign="top
 
|-valign="top
Line 763: Line 699:
  
 
|}
 
|}
 
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 20:31, 9 December 2019 (UTC)
 
  
 
=== Deposition ===
 
=== Deposition ===
Line 807: Line 741:
 
|<tt>Input_Opt%CO2_EFFECT</tt>
 
|<tt>Input_Opt%CO2_EFFECT</tt>
 
|Set this to T to turn on the [[Dry_deposition#Simple_parameterization_for_CO2_dependence_of_stomatal_resistance|simple parameterization for CO2 dependence on stomatal resistance]].
 
|Set this to T to turn on the [[Dry_deposition#Simple_parameterization_for_CO2_dependence_of_stomatal_resistance|simple parameterization for CO2 dependence on stomatal resistance]].
|Added in [[GEOS-Chem 12#12.6.0|12.6.0]]
+
|<span style="color:darkgreen">'''Added in 12.6.0'''</span>
  
 
|-valign="top"
 
|-valign="top"
Line 813: Line 747:
 
|<tt>Input_Opt%CO2_LEVEL</tt>
 
|<tt>Input_Opt%CO2_LEVEL</tt>
 
|Specify the CO2 level (in ppb) for the [[Dry_deposition#Simple_parameterization_for_CO2_dependence_of_stomatal_resistance|simple parameterization for CO2 dependence on stomatal resistance]]
 
|Specify the CO2 level (in ppb) for the [[Dry_deposition#Simple_parameterization_for_CO2_dependence_of_stomatal_resistance|simple parameterization for CO2 dependence on stomatal resistance]]
|Added in [[GEOS-Chem 12#12.6.0|12.6.0]]
+
|<span style="color:darkgreen">'''Added in 12.6.0'''</span>
  
 
|-valign="top"
 
|-valign="top"
Line 819: Line 753:
 
|<tt>Input_Opt%LWETD</tt>
 
|<tt>Input_Opt%LWETD</tt>
 
|Specify the reference CO2 level (ppb) for the [[Dry_deposition#Simple_parameterization_for_CO2_dependence_of_stomatal_resistance|simple parameterization for CO2 dependence on stomatal resistance]]
 
|Specify the reference CO2 level (ppb) for the [[Dry_deposition#Simple_parameterization_for_CO2_dependence_of_stomatal_resistance|simple parameterization for CO2 dependence on stomatal resistance]]
|Added in [[GEOS-Chem 12#12.6.0|12.6.0]]
+
|<span style="color:darkgreen">'''Added in 12.6.0'''</span>
  
 
|-valign="top"
 
|-valign="top"
Line 825: Line 759:
 
|<tt>Input_Opt%RA_Alt_Above_Sfc</tt>
 
|<tt>Input_Opt%RA_Alt_Above_Sfc</tt>
 
|Specify the altitude above the surface (in m) for the [[GEOS-Chem_chemistry_mechanisms#Correcting_ozone_from_the_height_of_the_lowest_model_level_to_10m|diagnostic that corrects O3 and HNO3 from the surface to a user-defined altitude (e.g. the ConcAboveSfc collection)]]
 
|Specify the altitude above the surface (in m) for the [[GEOS-Chem_chemistry_mechanisms#Correcting_ozone_from_the_height_of_the_lowest_model_level_to_10m|diagnostic that corrects O3 and HNO3 from the surface to a user-defined altitude (e.g. the ConcAboveSfc collection)]]
|Added in [[GEOS-Chem 12#12.6.0|12.6.0]]
+
|<span style="color:darkgreen">'''Added in 12.6.0'''</span>
  
 
|}
 
|}
 
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 20:45, 9 December 2019 (UTC)
 
  
 
=== Chemistry ===
 
=== Chemistry ===
Line 934: Line 866:
 
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 20:47, 9 December 2019 (UTC)
 
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 20:47, 9 December 2019 (UTC)
  
=== Planeflight diagnostic ===
+
=== Photolysis ===
  
<span style="color:red">'''''The planeflight diagnostic will be preserved for the time beingBut in [[GEOS-Chem 12#12.7.0|GEOS-Chem 12.7.0]] and later versions, you must compile GEOS-Chem with the BPCH_DIAG=y option if you wish to activate this diagnostic.'''''</span>
+
Line numbers are not part of the <tt>input.geos</tt> file, but have been included for reference.
 +
 
 +
  01: %%% PHOTOLYSIS MENU %%% :
 +
02: FAST-JX directory      : /path/to/ExtData/CHEM_INPUTS/FAST_JX/v2020-02/
 +
 
 +
{| border=1 cellspacing=0 cellpadding=5
 +
|-valign="top"
 +
!bgcolor="#CCCCCC" width="50px"|Line
 +
!bgcolor="#CCCCCC" width="250px"|What gets defined
 +
!bgcolor="#CCCCCC" width="600px"|Description
 +
!bgcolor="#CCCCCC" width="150px"|Added/Removed?
 +
 
 +
|-valign="top"
 +
|1
 +
|nothing
 +
|Header line
 +
|
 +
 
 +
|-valign="top"
 +
|2
 +
|<tt>Input_Opt%FAST_JX_DIR</tt>
 +
|Specify the directory containing input files (e.g. cross-sections, scattering weights, etc.) for the FAST-JX photolysis mechanism.  We have made this a configurable setting in order to preserve backwards compatibility with older GEOS-Chem versions.
 +
|
 +
 
 +
|}
 +
 
 +
=== Planeflight diagnostic ===
  
 
Line numbers are not part of the <tt>input.geos</tt> file, but have been included for reference.
 
Line numbers are not part of the <tt>input.geos</tt> file, but have been included for reference.
Line 1,042: Line 1,000:
 
|<tt>Input_Opt%ObsPack_SpcName</tt>
 
|<tt>Input_Opt%ObsPack_SpcName</tt>
 
|List the names of GEOS-Chem species that you wish to archive using the ObsPack diagnostic.  You can list individual species names (e.g <tt>NO CO O3, ...</tt>) or use the <tt>?ADV?</tt> wildcard if you wish to archive all advected species.
 
|List the names of GEOS-Chem species that you wish to archive using the ObsPack diagnostic.  You can list individual species names (e.g <tt>NO CO O3, ...</tt>) or use the <tt>?ADV?</tt> wildcard if you wish to archive all advected species.
|Added in [[GEOS-Chem 12#12.2.0|12.2.0]]
+
|Added in [[GEOS-Chem 12#12.2.0|12.2.0]];<br>Wildcard in [[GEOS-Chem 13.3.0|13.3.0]]
  
 
|}
 
|}
  
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 21:06, 9 December 2019 (UTC)
+
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 19:34, 28 September 2021 (UTC)
  
 
=== ND51 and ND51b diagnostics ===
 
=== ND51 and ND51b diagnostics ===
Line 1,437: Line 1,395:
 
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 21:20, 9 December 2019 (UTC)
 
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 21:20, 9 December 2019 (UTC)
  
=== POPs simulation menu ===
+
=== POPs simulation ===
  
 
This menu controls options for the persistent organic pollutants (POPs) simulation only. This is an optional menu and may be omitted from <tt>input.geos</tt> if you are not concerned with this simulation.  For more information, please see [[POPs simulation|our ''POPs simulation'' wiki page]].
 
This menu controls options for the persistent organic pollutants (POPs) simulation only. This is an optional menu and may be omitted from <tt>input.geos</tt> if you are not concerned with this simulation.  For more information, please see [[POPs simulation|our ''POPs simulation'' wiki page]].
Line 1,628: Line 1,586:
 
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 21:24, 9 December 2019 (UTC)
 
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 21:24, 9 December 2019 (UTC)
  
=== RRTMG ===
+
=== Radiation (RRTMG) ===
  
 
This menu controls options for GEOS-Chem simulations coupled to the RRTMG radiative transfer model.  This is an optional menu and may be omitted from <tt>input.geos</tt> if you are not concerned with this simulation.  For more information, please see [[Coupling GEOS-Chem with RRTMG|our ''Coupling GEOS-chem with RRTMG'' wiki page]].
 
This menu controls options for GEOS-Chem simulations coupled to the RRTMG radiative transfer model.  This is an optional menu and may be omitted from <tt>input.geos</tt> if you are not concerned with this simulation.  For more information, please see [[Coupling GEOS-Chem with RRTMG|our ''Coupling GEOS-chem with RRTMG'' wiki page]].
Line 1,728: Line 1,686:
  
 
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 21:28, 9 December 2019 (UTC)
 
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 21:28, 9 December 2019 (UTC)
 +
 +
== Deprecated menus in input.geos ==
 +
 +
Recent updates to GEOS-Chem have made several menus of <tt>input.geos</tt> obsolete.  Some of these menus (especially the diagnostic menus below) will only be read if you compile GEOS-Chem with the binary punch diagnostics turned on (i.e. with compile option <tt>BPCH_DIAG=y</tt>). We will list these menus here for further reference.
 +
 +
=== Emissions (prior to 12.9.0) ===
 +
 +
Line numbers are not part of the <tt>input.geos</tt> file, but have been included for reference.
 +
 +
01: %%% EMISSIONS MENU %%%  :
 +
02: Turn on emissions?      : T
 +
03: HEMCO Input file        : HEMCO_Config.rc
 +
04:  => 1ppt MBL BRO Sim.?  : F
 +
05: Switches for UCX        :---
 +
06:  => Use CH4 emissions?  : F
 +
07:  => Turn on surface BCs :---
 +
08:    => CH4?            : T
 +
19:    => OCS?            : T
 +
10:    => CFCs?            : T
 +
11:    => Cl species?      : T
 +
12:    => Br species?      : F
 +
13:    => N2O?            : T
 +
14:  => Set initial glob MRs:---
 +
15:    => strat. H2O?      : T
 +
16:  => CFC emission year  : 0
 +
 +
{| border=1 cellspacing=0 cellpadding=5
 +
|-valign="top"
 +
!bgcolor="#CCCCCC" width="50px"|Line
 +
!bgcolor="#CCCCCC" width="250px"|What gets defined
 +
!bgcolor="#CCCCCC" width="600px"|Description
 +
!bgcolor="#CCCCCC" width="150px"|Added/Removed?
 +
 +
|-valign="top"
 +
|1
 +
|nothing
 +
|Header Line
 +
|
 +
 +
|-valign="top"
 +
|2
 +
|<tt>Input_Opt%LEMIS</tt>
 +
|Set this to T to turn on emissions or F to turn off emissions.
 +
|<span style="color:red">'''Removed in 12.9.0'''</span>
 +
 +
 +
|-valign="top"
 +
|3
 +
|<tt>Input_Opt%HcoConfigFile</tt>
 +
|The name of the HEMCO configuration file. The emission inventories that your simulation will use are set in this file.
 +
|
 +
 +
|-valign="top"
 +
|4
 +
|<tt>Input_Opt%LFIX_PBL_BrO</tt>
 +
|Set this to T to set Bro concentrations in the PBL equal to 1 ppt during the day.
 +
|<span style="color:red">'''Removed in 12.9.0'''</span>
 +
 +
|-valign="top
 +
!colspan="4" bgcolor="#CCFFFF"|The following lines contain settings specific to the [[UCX chemistry mechanism]].<br>You can turn all of these options off if your simulation does not use the UCX mechanism (e.g "tropchem", "complexSOA").
 +
 +
|-valign="top"
 +
|5
 +
|nothing
 +
|Header line. 
 +
|
 +
 +
|-valign="top"
 +
|6
 +
|<tt>Input_Opt%LCH4EMIS</tt>
 +
|Set this T to use online methane emissions.
 +
|
 +
 +
|-valign="top"
 +
|7
 +
|nothing
 +
|Header line
 +
|<span style="color:red">'''Removed in 12.9.0'''</span>
 +
 +
|-valign="top"
 +
|8
 +
|<tt>Input_Opt%LCH4SBC</tt>
 +
|Set this T to fix surface mixing ratio of methane.
 +
|
 +
 +
|-valign="top"
 +
|9
 +
|<tt>Input_Opt%LOCSEMIS</tt>
 +
|Set this to T to fix surface mixing ratios of OCS.
 +
|<span style="color:red">'''Removed in 12.9.0'''</span>
 +
 +
|-valign="top"
 +
|10
 +
|<tt>Input_Opt%LCFCEMIS</tt>
 +
|Set this to T to fix surface mixing ratios of CFCs, HCFCs, and halons to match WMO projections under the Montreal Protocol.
 +
|<span style="color:red">'''Removed in 12.9.0'''</span>
 +
 +
|-valign="top"
 +
|11
 +
|<tt>Input_Opt%LCLEMIS</tt>
 +
|Set this to T to fix surface mixing ratios of other chlorinated carbon and inorganic chlorine species to match WMO projections under the Montreal Protocol.
 +
|<span style="color:red">'''Removed in 12.9.0'''</span>
 +
 +
|-valign="top"
 +
|12
 +
|<tt>Input_Opt%LBREMIS</tt>
 +
|Set this to T to fix surface mixing ratios of bromine species. Not recommended if other bromine emissions are enabled.
 +
|<span style="color:red">'''Removed in 12.9.0'''</span>
 +
 +
|-valign="top"
 +
|13
 +
|<tt>Input_Opt%LN2OEMIS</tt>
 +
|Set this to T to fix surface mixing ratios of N2O.
 +
|<span style="color:red">'''Removed in 12.9.0'''</span>
 +
 +
|-valign="top"
 +
|14
 +
|nothing
 +
|Header line
 +
|<span style="color:red">'''Removed in 12.9.0'''</span>
 +
 +
 +
|-valign="top"
 +
|15
 +
|<tt>Input_Opt%LSETH2O</tt>
 +
|Set this to T to initialize stratospheric H2O mixing ratios based on meteorology data for the first timestep, overriding any restart file values.
 +
|
 +
 +
|-valign="top"
 +
|16
 +
|<tt>Input_Opt%CFCYEAR</tt>
 +
|Specify the starting year for CFC emissions.
 +
|<span style="color:red">'''Removed in 12.9.0'''</span>
 +
 +
|}
 +
 +
=== GAMAP ===
 +
 +
Line numbers are not part of the <tt>input.geos</tt> file, but have been included for reference.
 +
 +
01: %%% GAMAP MENU %%%      :
 +
02: diaginfo.dat path      : diaginfo.dat
 +
03: tracerinfo.dat path    : tracerinfo.dat
 +
 +
{| border=1 cellspacing=0 cellpadding=5
 +
|-valign="top"
 +
!bgcolor="#CCCCCC" width="50px"|Line
 +
!bgcolor="#CCCCCC" width="250px"|What gets defined
 +
!bgcolor="#CCCCCC" width="600px"|Description
 +
!bgcolor="#CCCCCC" width="150px"|Notes
 +
 +
|-valign="top"
 +
|1
 +
|nothing
 +
|Header line
 +
|<span style="color:red">'''Deprecated in 12.7.0'''</span>
 +
 +
|-valign="top"
 +
|2
 +
|<tt>Input_Opt%GAMAP_DIAGINFO</tt>
 +
|Path name of the <tt>diaginfo.dat</tt> file for [http://acmg.seas.harvard.edu/gamap/ GAMAP]. GEOS-Chem will create this file, which will be customized to the particular simulation that is being done.  This may be either a relative path name or an absolute path name.
 +
|<span style="color:red">'''Deprecated in 12.7.0'''</span>
 +
|}
 +
 +
=== Output ===
 +
 +
Line numbers are not part of the <tt>input.geos</tt> file, but have been included for reference.
 +
 +
01: %%% OUTPUT MENU %%%    : 123456789.123456789.123456789.1--1=ZERO+2=BPCH
 +
02: Schedule output for JAN : 3000000000000000000000000000000
 +
03: Schedule output for FEB : 30000000000000000000000000000
 +
04: Schedule output for MAR : 3000000000000000000000000000000
 +
05: Schedule output for APR : 300000000000000000000000000000
 +
06: Schedule output for MAY : 3000000000000000000000000000000
 +
07: Schedule output for JUN : 300000000000000000000000000000
 +
08: Schedule output for JUL : 3000000000000000000000000000000
 +
09: Schedule output for AUG : 3000000000000000000000000000000
 +
10: Schedule output for SEP : 300000000000000000000000000000
 +
11: Schedule output for OCT : 3000000000000000000000000000000
 +
12: Schedule output for NOV : 300000000000000000000000000000
 +
13: Schedule output for DEC : 3000000000000000000000000000000
 +
 +
{| border=1 cellspacing=0 cellpadding=5
 +
|-valign="top"
 +
!bgcolor="#CCCCCC" width="50px"|Line
 +
!bgcolor="#CCCCCC" width="250px"|What gets defined
 +
!bgcolor="#CCCCCC" width="600px"|Description
 +
!bgcolor="#CCCCCC" width="150px"|Status
 +
 +
|-valign="top"
 +
|1
 +
|nothing
 +
|Header line
 +
|<span style="color:red">'''Deprecated in 12.7.0'''</span>
 +
 +
|-valign="top"
 +
|2
 +
|rowspan="12"|<tt>Input_Opt%NJDAY</tt>
 +
|Schedule diagnostic output for JANUARY. Place a 3 in the column corresponding to the day of the month (1-31) on which you want diagnostic output saved to the binary punch file.
 +
 +
In the example above, the columns which indicate January 1st and February 1st both have a 3 listed there. This will cause GEOS-Chem to archive diagnostic data for the entire month of January and then save it to disk at 0 GMT on February 1st. (GEOS-Chem is smart enough not to write anything to disk at 0 GMT on January 1st, since this is the starting time of the simulation.) If you would like to save daily diagnostic output to the binary punch file, put a 3 for each day of each month.
 +
 +
*NOTE: You must place a 3 in the location corresponding to the simulation end date. Otherwise, the GEOS-Chem simulation will crash immediately with the error No output scheduled on last day of run!
 +
|<span style="color:red">'''Deprecated in 12.7.0'''</span>
 +
 +
|-valign="top"
 +
|3
 +
|Schedule diagnostic output for FEBRUARY
 +
|<span style="color:red">'''Deprecated in 12.7.0'''</span>
 +
 +
|-valign="top"
 +
|4
 +
|Schedule diagnostic output for MARCH
 +
|<span style="color:red">'''Deprecated in 12.7.0'''</span>
 +
 +
|-valign="top"
 +
|5
 +
|Schedule diagnostic output for APRIL
 +
|<span style="color:red">'''Deprecated in 12.7.0'''</span>
 +
 +
|-valign="top"
 +
|6
 +
|Schedule diagnostic output for MAY
 +
|<span style="color:red">'''Deprecated in 12.7.0'''</span>
 +
 +
|-valign="top"
 +
|7
 +
|Schedule diagnostic output for JUNE
 +
|<span style="color:red">'''Deprecated in 12.7.0'''</span>
 +
 +
|-valign="top"
 +
|8
 +
|Schedule diagnostic output for JULY
 +
|<span style="color:red">'''Deprecated in 12.7.0'''</span>
 +
 +
|-valign="top"
 +
|9
 +
|Schedule diagnostic output for AUGUST
 +
|<span style="color:red">'''Deprecated in 12.7.0'''</span>
 +
 +
|-valign="top"
 +
|10
 +
|Schedule diagnostic output for SEPTEMBER
 +
|<span style="color:red">'''Deprecated in 12.7.0'''</span>
 +
 +
|-valign="top"
 +
|11
 +
|Schedule diagnostic output for OCTOBER
 +
|<span style="color:red">'''Deprecated in 12.7.0'''</span>
 +
 +
|-valign="top"
 +
|12
 +
|Schedule diagnostic output for NOVEMBER
 +
|<span style="color:red">'''Deprecated in 12.7.0'''</span>
 +
 +
|-valign="top"
 +
|13
 +
|Schedule diagnostic output for DECEMBER
 +
|<span style="color:red">'''Deprecated in 12.7.0'''</span>
 +
|}
 +
 +
=== Diagnostics (binary punch format) ===
 +
 +
<span style="color:red">'''This menu is now deprecated in 12.7.0 and later versions.'''</span>
 +
 +
This menu lets you specify which GEOS_Chem diagnostic quantities will be archived to disk as binary punch (aka bpch) format.  For a complete list of diagnostic settings, please see [[List of diagnostics archived to bpch format|our ''List of diagnostics archived to bpch format'' wiki page]].
 +
 +
Line numbers are not part of the <tt>input.geos</tt> file, but have been included for reference.
 +
 +
%%% DIAGNOSTIC MENU %%% :
 +
Binary punch file name  : trac_avg.geosfp_4x5_standard.YYYYMMDDhhmm
 +
Diagnostic Entries ---> :  L  Tracers to print out for each diagnostic
 +
ND01: Rn/Pb/Be source  :  0  all
 +
ND02: Rn/Pb/Be decay    :  0  all
 +
ND03: Hg emissions, P/L :  0  all
 +
ND04: CO2 Sources      :  0  all
 +
ND05: Sulfate prod/loss : 72  all
 +
ND06: Dust aer source  :  1  all
 +
ND07: Carbon aer source : 72  all
 +
ND08: Seasalt aer source:  1  all
 +
ND09: -                :  0  all
 +
ND10: -                :  0  all
 +
ND11: Acetone sources  :  1  all
 +
ND12: BL fraction      :  0  all
 +
ND13: Sulfur sources    : 72  all
 +
ND14: Cld conv mass flx :  0  all
 +
ND15: BL mix mass flx  :  0  all
 +
ND16: LS/Conv prec frac :  0  all
 +
ND17: Rainout fraction  :  0  all
 +
ND18: Washout fraction  :  0  all
 +
ND19: CH4 loss          :  0  all
 +
ND21: Optical depths    : 72  all
 +
ND22: J-Values          : 72  1 2 7 8 9 11 13 14 20 44 46 47 49 50 51 59 60 66 67 69 74 75 83 84 -1
 +
      => JV time range  :      11 13
 +
ND24: E/W transpt flx  :  0  all
 +
ND25: N/S transpt flx  :  0  all
 +
ND26: U/D transpt flx  :  0  all
 +
ND27: Strat NOx,Ox,HNO3 :  0  1 2 7
 +
ND28: Biomass emissions :  1  1 4 5 9 10 11 18 19 20 21 26 30 34 35 71
 +
ND29: CO sources        :  1  all
 +
ND30: Land Map          :  0  all
 +
ND31: Pressure edges    : 73  all
 +
ND32: NOx sources      :  1  all
 +
ND33: Column tracer    :  0  all
 +
ND34: Biofuel emissions :  1  1 4 5 9 10 11 18 19 20 21
 +
ND35: Tracers at 500 mb :  0  all
 +
ND36: Anthro emissions  :  1  1 2 4 5 7 9 10 11 18 19 20 21 71
 +
ND37: Updraft scav frac :  0  all
 +
ND38: Cld Conv scav loss: 72  all
 +
ND39: Wetdep scav loss  : 72  all
 +
ND41: Afternoon PBL ht  :  0  all
 +
ND42: SOA concentrations: 72  all
 +
ND43: Chem prod OH, HO2 : 72  all
 +
  ==> OH/HO2 time range :      0 24
 +
ND44: Drydep flx/vel    :  1  2 3 7 8 9 11 13 14 15 16 17 20 22 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 47 48 50  55 56 58 59 60 61 62 63 64 65 66 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 119 120 121 122 123 124 125
 +
ND45: Tracer Conc's    : 72  all
 +
  ==> ND45 Time range  :      0 24
 +
ND46: Biogenic emissions:  1  all
 +
ND47: 24-h avg trc conc :  0  all
 +
ND52: GAMMA HO2        :  0  all
 +
ND53: POPs Emissions    :  0  all
 +
ND54: Time in t'sphere  : 72  all
 +
ND55: Tropopause height : 72  all
 +
ND56: Lightning flashes :  0  all
 +
ND57: Potential T      :  0  all
 +
ND58: CH4 Emissions    :  0  all
 +
ND59: TOMAS aerosol emis:  0  all
 +
ND60: Wetland Frac      :  0  all
 +
ND61: TOMAS 3D rate    :  0  all
 +
ND62: Inst column maps  :  0  all
 +
ND64: Radiative flux    :  0  all
 +
ND66: DAO 3-D fields    : 72  all
 +
ND67: DAO 2-D fields    : 72  all
 +
ND68: Airmass/Boxheight : 72  all
 +
ND69: Surface area      :  1  all
 +
ND70: Debug output      :  0  all
 +
ND71: Hourly max ppbv  :  0  2
 +
ND72: Radiative output  :  0  all
 +
 +
== Menus recently removed from input.geos ==
 +
 +
The following menus were removed from recent GEOS-Chem 12.Y.Z versions:
 +
 +
=== Benchmark ===
 +
 +
Line numbers are not part of the <tt>input.geos</tt> file, but have been included for reference.
 +
 +
01: %%% BENCHMARK MENU %%%  :
 +
02: Save benchmark output?  : T
 +
03: File w/ initial Ox      : Ox.mass.initial
 +
04: File w/ final Ox        : Ox.mass.final
 +
 +
{| border=1 cellspacing=0 cellpadding=5
 +
|-valign="top"
 +
!bgcolor="#CCCCCC" width="50px"|Line
 +
!bgcolor="#CCCCCC" width="250px"|What gets defined
 +
!bgcolor="#CCCCCC" width="600px"|Description
 +
!bgcolor="#CCCCCC" width="150px"|Status
 +
 +
|-valign="top"
 +
|1
 +
|nothing
 +
|Header line
 +
|<span style="color:red">'''Removed in 12.7.0'''</span>
 +
 +
|-valign="top"
 +
|2
 +
|<tt>Input_Opt%LSTDRUN</tt>
 +
|Set this switch to T if you wish to save out benchmark diagnostics, or F otherwise. This option will save out initial and final tracer masses needed for the [http://acmg.seas.harvard.edu/gamap/doc/by_category/Benchmarking.html 1-month benchmark simulation plotting routines].
 +
|<span style="color:red">'''Removed in 12.7.0'''</span>
 +
 +
|-valign="top"
 +
|3
 +
|<tt>Input_Opt%STDRUN_INIT_FILE</tt>
 +
|Specify name of file (binary punch format) that will contain initial tracer mass.
 +
|<span style="color:red">'''Removed in 12.7.0'''</span>
 +
 +
|-valign="top"
 +
|4
 +
|<tt>Input_Opt%STDRUN_FINAL_FILE</tt>
 +
|Specify name of file (binary punch format) that will contain final tracer mass.
 +
|<span style="color:red">'''Removed in 12.7.0'''</span>
 +
 +
|}
 +
 +
=== ND48 diagnostic ===
 +
 +
Line numbers are not part of the <tt>input.geos</tt> file, but have been included for reference.
 +
 +
01: %%% ND48 MENU %%%      :
 +
02: Turn on ND48 stations  : F
 +
03: Station Timeseries file : stations.YYYYMMDD
 +
04: Frequency [sec]        : 3600
 +
05: Number of stations      : 1
 +
06: Station #1 (I,J,Lmax,N) : 133 29 15 2
 +
 +
{| border=1 cellspacing=0 cellpadding=5
 +
|-valign="top"
 +
!bgcolor="#CCCCCC" width="50px"|Line
 +
!bgcolor="#CCCCCC" width="250px"|What gets defined
 +
!bgcolor="#CCCCCC" width="600px"|Description
 +
!bgcolor="#CCCCCC" width="150px"|Status
 +
 +
|-valign="top"
 +
|1
 +
|nothing
 +
|Header line
 +
|<span style="color:red">'''Removed in 12.7.0'''</span>
 +
 +
|-valign="top"
 +
|2
 +
|<tt>Input_Opt%DO_ND48</tt>
 +
|Set this to T to turn on the ND48 station timeseries diagnostic. This allows you to save timeseries data of various quantities at specific grid boxes.
 +
|<span style="color:red">'''Removed in 12.7.0'''</span>
 +
 +
|-valign="top"
 +
|3
 +
|<tt>Input_Opt%ND48_FILE</tt>
 +
|The name of the file which will contain output from the ND48 station timeseries diagnostic. This file will be in binary punch format and can be read by GAMAP. You may use date & time tokens YYYY, MM, DD, hh, mm, ss and GEOS-Chem will replace these with the appropriate values.
 +
|<span style="color:red">'''Removed in 12.7.0'''</span>
 +
 +
|-valign="top"
 +
|4
 +
|<tt>Input_Opt%ND48_FREQ</tt>
 +
|The frequency in seconds at which data will be archived by the ND48 station timeseries diagnostic. Recommended values: 3600 sec (= 1 hour) or 7200 sec (=2 hours).
 +
|<span style="color:red">'''Removed in 12.7.0'''</span>
 +
 +
|-valign="top"
 +
|5
 +
|<tt>Input_Opt%ND48_N_STA</tt>
 +
|The number of ND48 stations at which timeseries data will be saved to disk.
 +
|<span style="color:red">'''Removed in 12.7.0'''</span>
 +
 +
|-valign="top"
 +
|6
 +
|<tt>Input_Opt%ND48_IARR</tt><br><tt>Input_Opt%ND48_JARR</tt><br><tt>Input_Opt%ND48_LARR</tt><br><tt>Input_Opt%ND48_NARR</tt>
 +
|For each ND48 station, you must provide the following information (separated by spaces):
 +
 +
*Longitude index
 +
*Latitude index
 +
*Number of levels to save
 +
**If you type 1, it will just save the surface level.
 +
**If you type 10, then it will save all levels from level 1 (surface) to level 10.
 +
*ND48 diagnostic quantity number(s)
 +
|<span style="color:red">'''Removed in 12.7.0'''</span>
 +
 +
|}
 +
 +
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 21:12, 9 December 2019 (UTC)
 +
 +
=== ND49 diagnostic ===
 +
 +
Line numbers are not part of the <tt>input.geos</tt> file, but have been included for reference.
 +
 +
01: %%% ND49 MENU %%%      :
 +
02: Turn on ND49 diagnostic : F
 +
03: Inst 3-D timeser. file  : tsYYYYMMDD.bpch
 +
04: Tracers to include      : 94
 +
05: Frequency [sec]        : 7200
 +
06: IMIN, IMAX of region    :  70  30
 +
07: JMIN, JMAX of region    :  23  46
 +
08: LMIN, LMAX of region    :  1  1
 +
 +
{| border=1 cellspacing=0 cellpadding=5
 +
|-valign="top"
 +
!bgcolor="#CCCCCC" width="50px"|Line
 +
!bgcolor="#CCCCCC" width="250px"|What gets defined
 +
!bgcolor="#CCCCCC" width="600px"|Description
 +
!bgcolor="#CCCCCC" width="150px"|Added/Removed?
 +
 +
|-valign="top"
 +
|1
 +
|nothing
 +
|Header line
 +
|<span style="color:red">'''Removed in 12.7.0'''</span>
 +
 +
|-valign="top"
 +
|2
 +
|<tt>Input_Opt%DO_ND49</tt>
 +
|Set this to T to turn on the ND49 instantaneous 3D timeseries diagnostic. This allows you to archive instantaneous timeseries data for various quantities from a 3D region of the globe.
 +
|<span style="color:red">'''Removed in 12.7.0'''</span>
 +
 +
|-valign="top"
 +
|3
 +
|<tt>Input_Opt%ND49_FILE</tt>
 +
|The name of the file which will contain output from the ND49 station timeseries diagnostic. This file will be in binary punch format and can be read by GAMAP. You may use date & time tokens YYYY, MM, DD, hh, mm, ss and GEOS-Chem will replace these with the appropriate values.
 +
|<span style="color:red">'''Removed in 12.7.0'''</span>
 +
 +
|-valign="top"
 +
|4
 +
|<tt>Input_Opt%ND49_TRACERS</tt>
 +
|The [[List_of_diagnostics_for_v11-01#ND49:_instantaneous_timeseries|ND49 diagnostic quantities]] that you wish to save to disk. Separate each number with a space.
 +
|<span style="color:red">'''Removed in 12.7.0'''</span>
 +
 +
|-valign="top"
 +
|5
 +
|<tt>Input_Opt%ND49_FREQ</tt>
 +
|The frequency (in minutes) at which ND49 will save data for a 3D region of the globe data to disk. Recommended value: 7200 min (= 2 hours) or 10800 min (= 3 hours). You may save data at a higher temporal resolution (e.g. every hour) but this will create HUGE data files!
 +
|<span style="color:red">'''Removed in 12.7.0'''</span>
 +
 +
|-valign="top"
 +
|6
 +
|<tt>Input_Opt%ND49_IMIN</tt><br><tt>Input_Opt%ND49_IMAX</tt>
 +
|The indices which determine the longitude extent of the 3D region of the globe. Note that these are indices and not actual longitude values. To specify all 360 degrees of longitude, type the following:
 +
 +
*For GMAO 4&deg; x 5&deg; grid: 1 72
 +
*For GMAO 2&deg; x 2.5&deg; grid: 1 144
 +
 +
Also, note you can wrap around the date line. In the example shown above, IMIN=70 and IMAX=30. This will create a 3D region (assuming 4x5 grid) which starts at 165° E longitude and extends across the date line to 35° W longitude.
 +
|<span style="color:red">'''Removed in 12.7.0'''</span>
 +
 +
|-valign="top"
 +
|7
 +
|<tt>Input_Opt%ND49_JMIN</tt><br><tt>Input_Opt%ND49_JMAX</tt>
 +
|The indices which determine the latitude extent of the 3D region of the globe. Note that these are indices and not actual latitude values. To specify all 180 degrees of latitude, type the following:
 +
 +
*For GMAO 4&deg; x 5&deg; grid: 1 46
 +
*For GMAO 2&deg; x 2.5&deg; grid: 1 91
 +
|<span style="color:red">'''Removed in 12.7.0'''</span>
 +
 +
|-valign="top"
 +
|8
 +
|<tt>Input_Opt%ND51_LMIN</tt><br><tt>Input_Opt%ND51_LMAX</tt>
 +
|The indices which determine the vertical extent of the 3D region of the globe.
 +
|<span style="color:red">'''Removed in 12.7.0'''</span>
 +
 +
|}
 +
 +
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 19:54, 9 December 2019 (UTC)
 +
 +
=== ND50 diagnostic ===
 +
 +
Line numbers are not part of the <tt>input.geos</tt> file, but have been included for reference.
 +
 +
01: %%% ND50 MENU %%%      :
 +
02: Turn on ND50 diagnostic : F
 +
03: 24-hr avg timeser. file : ts_24h_avg.YYYYMMDD.bpch
 +
04: Output as HDF5?        : F
 +
05: Tracers to include      : 82 83 84 85 86 87
 +
06: IMIN, IMAX of region    :  1  72
 +
07: JMIN, JMAX of region    :  1  46
 +
08: LMIN, LMAX of region    :  1  1
 +
 +
{| border=1 cellspacing=0 cellpadding=5
 +
|-valign="top"
 +
!bgcolor="#CCCCCC" width="50px"|Line
 +
!bgcolor="#CCCCCC" width="250px"|What gets defined
 +
!bgcolor="#CCCCCC" width="600px"|Description
 +
!bgcolor="#CCCCCC" width="150px"|Added/Removed?
 +
 +
|-valign="top"
 +
|1
 +
|nothing
 +
|Header line
 +
|<span style="color:red">'''Removed in 12.7.0'''</span>
 +
 +
|-valign="top"
 +
|2
 +
|<tt>Input_Opt%DO_ND50</tt>
 +
|Set this to T to turn on the ND50 24-hr average 3D timeseries diagnostic. This allows you to archive 24-hour time-averaged timeseries data for various quantities from a 3D region of the globe.
 +
|<span style="color:red">'''Removed in 12.7.0'''</span>
 +
 +
|-valign="top"
 +
|3
 +
|<tt>Input_Opt%ND50_FILE</tt>
 +
|The name of the file which will contain output from the ND50 station timeseries diagnostic. This file will be in binary punch format and can be read by GAMAP. You may use date & time tokens YYYY, MM, DD, hh, mm, ss and GEOS-Chem will replace these with the appropriate values.
 +
|<span style="color:red">'''Removed in 12.7.0'''</span>
 +
 +
|-valign="top"
 +
|4
 +
|nothing
 +
|OBSOLETE
 +
|<span style="color:red">'''Removed in 12.7.0'''</span>
 +
 +
|-valign="top"
 +
|5
 +
|<tt>Input_Opt%ND50_TRACERS</tt>
 +
|The [[List_of_diagnostics_for_v11-01#ND50:_instantaneous_timeseries|ND50 diagnostic quantities]] that you wish to save to disk. Separate each number with a space.
 +
|<span style="color:red">'''Removed in 12.7.0'''</span>
 +
 +
|-valign="top"
 +
|6
 +
|<tt>Input_Opt%ND50_IMIN</tt><br><tt>Input_Opt%ND50_IMAX</tt>
 +
|The indices which determine the longitude extent of the 3D region of the globe. Note that these are indices and not actual longitude values. To specify all 360 degrees of longitude, type the following:
 +
 +
*For GMAO 4&deg; x 5&deg; grid: 1 72
 +
*For GMAO 2&deg; x 2.5&deg; grid: 1 144
 +
 +
Also, note you can wrap around the date line.
 +
|<span style="color:red">'''Removed in 12.7.0'''</span>
 +
 +
|-valign="top"
 +
|7
 +
|<tt>Input_Opt%ND50_JMIN</tt><br><tt>Input_Opt%ND50_JMAX</tt>
 +
|The indices which determine the latitude extent of the 3D region of the globe. Note that these are indices and not actual latitude values. To specify all 180 degrees of latitude, type the following:
 +
 +
*For GMAO 4&deg; x 5&deg; grid: 1 46
 +
*For GMAO 2&deg; x 2.5&deg; grid: 1 91
 +
|<span style="color:red">'''Removed in 12.7.0'''</span>
 +
 +
|-valign="top"
 +
|8
 +
|<tt>Input_Opt%ND50_LMIN</tt><br><tt>Input_Opt%ND50_LMAX</tt>
 +
|The indices which determine the vertical extent of the 3D region of the globe.
 +
|<span style="color:red">'''Removed in 12.7.0'''</span>
 +
 +
|}
 +
 +
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 16:50, 20 March 2018 (UTC)
 +
 +
=== ND63 diagnostic ===
 +
 +
01: %%% ND63 MENU %%%      :
 +
02: Turn on ND63 diagnostic : F
 +
03: Inst 3-D timeser. file  : paranox_ts.YYYYMMDD.bpch
 +
04: Tracers to include      : 1
 +
05: Frequency [sec]        : 7200
 +
06: IMIN, IMAX of region    :  70  30
 +
07: JMIN, JMAX of region    :  23  46
 +
 +
{| border=1 cellspacing=0 cellpadding=5
 +
|-valign="top"
 +
!bgcolor="#CCCCCC" width="50px"|Line
 +
!bgcolor="#CCCCCC" width="250px"|What gets defined
 +
!bgcolor="#CCCCCC" width="600px"|Description
 +
!bgcolor="#CCCCCC" width="150px"|Added/Removed?
 +
 +
|-valign="top
 +
|1
 +
|nothing
 +
|Header line
 +
|<span style="color:red">'''Removed in 12.7.0'''</span>
 +
 +
|-valign="top"
 +
|2
 +
|<tt>Input_Opt%DO_ND63</tt>
 +
|Set this to T to turn on the ND63 ship timeseries diagnostic.
 +
|<span style="color:red">'''Removed in 12.7.0'''</span>
 +
 +
|-valign="top"
 +
|3
 +
|<tt>Input_Opt%ND63_FILE</tt>
 +
|Specify the name of the file which will contain output from the ND63 timeseries diagnostic. This file will be in binary punch format and can be read by GAMAP. You may use date & time tokens YYYY, MM, DD, hh, mm, ss and GEOS-Chem will replace these with the appropriate values.
 +
|<span style="color:red">'''Removed in 12.7.0'''</span>
 +
 +
|-valign="top"
 +
|4
 +
|<tt>Input_Opt%ND63_TRACERS</tt>
 +
|Specify the [[List_of_diagnostics_for_v11-01#ND63:_Ship_emission_diagnostics|ND63 diagnostic quantities]] that you wish to save to disk.  Separate each number with a space.
 +
|<span style="color:red">'''Removed in 12.7.0'''</span>
 +
 +
|-valign="top"
 +
|5
 +
|<tt>Input_Opt%ND63_FREQ</tt>
 +
|The frequency in seconds at which the ND63 ship diagnostics will be written to disk.
 +
|<span style="color:red">'''Removed in 12.7.0'''</span>
 +
 +
|-valign="top"
 +
|6
 +
|<tt>Input_Opt%ND63_IMIN<br>Input_Opt%ND63_IMAX</tt>
 +
|The indices which determine the longitude extent of the 3D region of the globe. Note that these are indices and not actual longitude values. To specify all 360 degrees of longitude, type the following:
 +
 +
*For GMAO 4&deg; x 5&deg; grid: 1 72
 +
*For GMAO 2&deg; x 2.5&deg; grid: 1 144
 +
 +
Also, note you can wrap around the date line.
 +
|<span style="color:red">'''Removed in 12.7.0'''</span>
 +
 +
|-valign="top"
 +
|7
 +
|<tt>Input_Opt%ND63_JMIN<br>Input_Opt%ND63_JMAX</tt>
 +
|The indices which determine the latitude extent of the 3D region of the globe. Note that these are indices and not actual latitude values. To specify all 180 degrees of latitude, type the following:
 +
 +
*For GMAO 4&deg; x 5&deg; grid: 1 46
 +
*For GMAO 2&deg; x 2.5&deg; grid: 1 91
 +
|<span style="color:red">'''Removed in 12.7.0'''</span>
 +
|}
 +
 +
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 19:58, 9 December 2019 (UTC)
 +
 +
=== Nested Grid Menu ===
 +
 +
NOTE: This menu controls options for the various GEOS-Chem nested grid simulations. This is an optional menu and may be omitted from <tt>input.geos</tt> if you are not concerned with these simulations.
 +
 +
Line numbers are not part of the <tt>input.geos</tt> file, but have been included for reference.
 +
 +
01: %%% NESTED GRID MENU %%%:
 +
02: Save TPCORE BC's        : F
 +
03: Input BCs at 2x2.5?    : F
 +
04: Over North America?    : F
 +
05: TPCORE NA BC directory  : BC_4x5_NA/
 +
06: Over Europe?            : F
 +
07: TPCORE EU BC directory  : BC_4x5_EU/
 +
08: Over China?            : F
 +
09: TPCORE CH BC directory  : BC_4x5_CH/
 +
10: Over Asia?              : F
 +
11: TPCORE AS BC directory  : BC_4x5_AS/
 +
12: Over Custom Region?    : F
 +
13: TPCORE BC directory    : BC_4x5/
 +
14: BC timestep [sec]      : 10800
 +
15: LL box of BC region    :  9  26
 +
16: UR box of BC region    :  29  41
 +
17: I0_W, J0_W, I0_E, J0_E  :  3  3  3  3
 +
 +
{| border=1 cellspacing=0 cellpadding=5
 +
|-valign="top"
 +
!bgcolor="#CCCCCC" width="50px"|Line
 +
!bgcolor="#CCCCCC" width="250px"|What gets defined
 +
!bgcolor="#CCCCCC" width="600px"|Description
 +
!bgcolor="#CCCCCC" width="150px"|Added/Removed?
 +
 +
|-valign="top"
 +
|1
 +
|nothing
 +
|Header line
 +
|<span style="color:red">'''Removed in 12.4.0'''</span>
 +
 +
|-valign="top"
 +
|2
 +
|<tt>Input_Opt%LWINDO</tt>
 +
|Set this to T if you wish to save out boundary conditions from a GEOS-Chem simulation, or F otherwise. Before you run at the nested-grid resolution, you must first save out boundary conditions from a global GEOS-Chem simulation (usually 2&deg; x 2.5&deg;).
 +
|<span style="color:red">'''Removed in 12.4.0'''</span>
 +
 +
|-valign="top"
 +
|3
 +
|<tt>Input_Opt%LWINDO2x25</tt>
 +
|Set this to T if you are using boundary conditions archived from a 2&deg; x 2.5&deg; GEOS-Chem simulation, or F otherwise.
 +
|<span style="color:red">'''Removed in 12.4.0'''</span>
 +
 +
|-valign="top"
 +
|4
 +
|<tt>Input_Opt%LWINDO_NA</tt>
 +
|Set this to T if you wish to perform a GEOS-Chem nested grid simulation over the North American nested domain.
 +
|<span style="color:red">'''Removed in 12.4.0'''</span>
 +
 +
|-valign="top"
 +
|5
 +
|<tt>Input_Opt%TPBC_DIR_NA</tt>
 +
|The directory path containing boundary conditions for your North American nested-grid simulation.
 +
|<span style="color:red">'''Removed in 12.4.0'''</span>
 +
 +
|-valign="top"
 +
|6
 +
|<tt>Input_Opt%LWINDO_EU</tt>
 +
|Set this to T if you wish to perform a GEOS-Chem nested grid simulation over the European nested domain.
 +
|<span style="color:red">'''Removed in 12.4.0'''</span>
 +
 +
|-valign="top"
 +
|7
 +
|<tt>Input_Opt%TPBC_DIR_EU</tt>
 +
|The directory path containing boundary conditions for your European nested-grid simulation.
 +
|<span style="color:red">'''Removed in 12.4.0'''</span>
 +
 +
|-valign="top"
 +
|8
 +
|<tt>Input_Opt%LWINDO_CH</tt>
 +
|Set this to T if you wish to perform a GEOS-Chem nested grid simulation over the China/SE Asia nested domain.
 +
|<span style="color:red">'''Removed in 12.4.0'''</span>
 +
 +
|-valign="top"
 +
|9
 +
|<tt>Input_Opt%TPBC_DIR_CH</tt>
 +
|Which is the directory path containing boundary conditions for your China/SE Asia nested-grid simulation.
 +
|<span style="color:red">'''Removed in 12.4.0'''</span>
 +
 +
|-valign="top"
 +
|10
 +
|<tt>Input_Opt%LWINDO_AS</tt>
 +
|Set this T if you wish to perform a GEOS-Chem nested grid simulation over the MERRA-2 extended Asia region.
 +
|<span style="color:red">'''Removed in 12.4.0'''</span>
 +
 +
|-valign="top"
 +
|11
 +
|<tt>Input_Opt%TPBC_DIR_AS</tt>
 +
|The directory path containing boundary conditions for your SE Asia nested-grid simulation.
 +
|<span style="color:red">'''Removed in 12.4.0'''</span>
 +
 +
|-valign="top"
 +
|12
 +
|<tt>Input_Opt%LWINDO_CU</tt>
 +
|Set this to T if you wish to perform a GEOS-Chem nested grid simulation a domain that you have customized yourself.
 +
|<span style="color:red">'''Removed in 12.4.0'''</span>
 +
 +
|-valign="top"
 +
|13
 +
|<tt>Input_Opt%TPBC_DIR_CU</tt>
 +
|which is the directory path containing the boundary conditions for your custom-domain nested-grid simulation.
 +
|<span style="color:red">'''Removed in 12.4.0'''</span>
 +
 +
|-valign="top"
 +
|14
 +
|<tt>Input_Opt%NESTED_TS</tt>
 +
|Specify the frequency in seconds at which the 2&deg; x 2.5&deg; or 4&deg; x 5&deg; boundary conditions will be saved to disk. Recommended value: 10800 sec (= 3 hours).
 +
|<span style="color:red">'''Removed in 12.4.0'''</span>
 +
 +
|-valign="top"
 +
|15
 +
|<tt>Input_Opt%NESTED_I1</tt><br><tt>Input_Opt%NESTED_J1</tt>
 +
|These are the longitude and latitude indices of the grid box at the LOWER LEFT CORNER of the window region in which boundary conditions are being saved.
 +
|<span style="color:red">'''Removed in 12.4.0'''</span>
 +
 +
|-valign="top"
 +
|16
 +
|<tt>Input_Opt%NESTED_I2</tt><br><tt>Input_Opt%NESTED_J2</tt>
 +
|These are the the longitude and latitude indices of the grid box at the UPPER RIGHT CORNER of the window region in which boundary conditions are being saved.
 +
|<span style="color:red">'''Removed in 12.4.0'''</span>
 +
 +
|-valign="top"
 +
|17
 +
|<tt>Input_Opt%NESTED_I0W</tt><br><tt>Input_Opt%NESTED_J0W</tt><br><tt>Input_Opt%NESTED_I0E</tt><br><tt>Input_Opt%NESTED_J0E</tt>
 +
|These are the nested grid longitude and latitude offsets (in # of boxes) of the which are used to define an inner window region in which transport is actually done. The region in which transport is done in the window is smaller than the actual size of them nested grid met fields in order to account for the boundary conditions. Please see the comments to the source code file <tt>tpcore_bc_mod.F</tt> for more information.
 +
 +
Recommended values:
 +
*<tt>Input_Opt%NESTED_I0W=3</tt> and <tt>Input_Opt%NESTED_J0W=3</tt>.
 +
*<tt>Input_Opt%NESTED_I0E=3</tt> and <tt>Input_Opt%NESTED_J0E=3</tt>.
 +
**But for some grids (e.g. SE Asia) you may want to use <tt>Input_Opt%NESTED_I0E=2</tt> and <tt>Input_Opt%NESTED_J0E=2</tt>.
 +
 +
For more information, please contact the [[Nested Model Working Group]].
 +
|<span style="color:red">'''Removed in 12.4.0'''</span>
 +
 +
|}
 +
 +
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 21:14, 9 December 2019 (UTC)
 +
 +
=== Prod and Loss diagnostic (binary punch format) ===
 +
 +
Line numbers are not part of the <tt>input.geos</tt> file, but have been included for reference.
 +
 +
01: %%% PROD & LOSS MENU %%%:
 +
02: Turn on P/L (ND65) diag?: T
 +
03: # of levels for ND65    : 72
 +
04: Save O3 P/L (ND20)?    : F
 +
 +
{| border=1 cellspacing=0 cellpadding=5
 +
 +
|-valign="top"
 +
!bgcolor="#CCCCCC" width="50px"|Line
 +
!bgcolor="#CCCCCC" width="250px"|What gets defined
 +
!bgcolor="#CCCCCC" width="600px"|Description
 +
!bgcolor="#CCCCCC" width="150px"|Added/Removed?
 +
 +
|-valign="top
 +
|1
 +
|nothing
 +
|Header line
 +
|<span style="color:red">'''Removed in in 13.0.0'''</span>
 +
 +
|-valign="top"
 +
|2
 +
|<tt>Input_Opt%DO_SAVE_PL</tt>
 +
|Set this switch to T if you wish to save out chemical production for family tracers (a.k.a. the ND65 diagnostic), or F otherwise.
 +
|<span style="color:red">'''Removed in in 13.0.0'''</span>
 +
 +
|-valign="top"
 +
|3
 +
|<tt>Input_Opt%ND65</tt>
 +
|Specify the number of levels to save for the chemical family production & loss diagnostic.
 +
*If you enter 1, it will just save the surface level.
 +
*If you enter 20, then it will save all levels from level 1 (surface) to level 20, etc.
 +
|<span style="color:red">'''Removed in in 13.0.0'''</span>
 +
 +
|-valign="top"
 +
|4
 +
|<tt>Input_Opt%DO_SAVE_O3</tt>
 +
|Set this switch to T if you wish to archive P(Ox) and L(Ox) rates from a full chemistry simulation into binary punch format, so that these rates can be used to drive a future tagged Ox simulation (a.k.a. ND20 diagnostic).
 +
|<span style="color:red">'''Removed in in 13.0.0'''</span>
 +
 +
|}
 +
 +
 +
----
 +
'''''[[GEOS-Chem configuration files|Previous]] | [[The HEMCO_Config.rc file|Next]] | [[Getting Started with GEOS-Chem]]'''''

Latest revision as of 19:35, 28 September 2021

Previous | Next | Getting Started with GEOS-Chem

  1. Minimum system requirements
  2. Installing required software
  3. Configuring your computational environment
  4. Downloading source code
  5. Downloading data directories
  6. Creating run directories
  7. Configuring runs
  8. Compiling
  9. Running
  10. Output files
  11. Python tools for use with GEOS-Chem
  12. Coding and debugging
  13. Further reading


The input.geos configuration file contains settings for most GEOS-Chem options (excluding emissions and History diagnostics)

Overview

An input.geos file ships with each GEOS-Chem run directory. We invite you to create the run directory for the simulation(s) that you are interested in and view the corresponding input.geos file. You will note that the input.geos file is grouped into menus. Each menu controls the options for a particular aspect of a GEOS-Chem simulation. The sections below contain a list of the menus and the options that they control.

Most of the information listed in input.geos will be stored as fields of the Input_Opt derived-type object.

Currently-used menus in input.geos

Simulation

Line numbers are not part of the input.geos file, but have been included for reference.

01: %%% SIMULATION MENU %%% :
02: Start YYYYMMDD, hhmmss  : 20190701 000000
03: End   YYYYMMDD, hhmmss  : 20190801 000000
04: Run directory           : ./
05: Root data directory     :  /path/to/data/
06: Met field               : MERRA2
07: Simulation name         : fullchem
08: Species database file   : ./species_database.yml
09: Turn on debug printout? : F
10: Use GC classic timers?  : F

Note: /path/to/data/ indicates the path to the root data folder on your system. If you don't know where this is, ask your IT staff.

Line What gets defined Description Added/Removed?
1 nothing Header line
2 Input_Opt%NYMDb
Input_Opt%NHMSb
The starting date and time of the GEOS-Chem simulation. The date must be in YYYYMMDD format (4-digit year, month, and day). The time must be in hhmmss format (hour, minute, and seconds).
  • Note that since the GEOS-Chem dynamic timestep (see Transport Menu) is usually 10, 15, or 30 minutes, you can always set the seconds to zero.
3 Input_Opt%NYMDe
Input_Opt%NHMSe
Specify the ending date (YYYYMMDD format) and time (hhmmss format) of the GEOS-Chem simulation.
4 Input_Opt%RUN_DIR The name of the GEOS-Chem run directory (e.g. where the executable file and input files reside).
  • NOTE: This can usually be set to the current directory (i.e. ./).
5 Input_Opt%DATA_DIR The the root-level data directory path. The various shared data inputs (e.g. emissions, offline OH, offline dust & aerosol concentrations, etc). are stored in subdirectories of Input_Opt%DATA_DIR. The met fields are also stored in subdirectories of Input_Opt%DATA_DIR.

For more information, please see Downloading GEOS-Chem data directories.

6 Input_Opt%MetField Specify the meteorology fields for your simulation. Current options are GEOS-FP or MERRA-2. Added in 12.6.0
7 Input_Opt%SimulationName Specify the name of the simulation. Please see our Guide to GEOS-Chem simulations for detailed information about each simulation. Allowable values (case-insensitive) are:
Full-chemistry    Specialry
simulations       simulations
--------------    ---------------
 fullchem         aerosol
 custom           CH4 (and tagCH4)
                  CO2 
                  Hg (and tagHg)
                  POPs
                  tagCO
                  tagO3
                  TransportTracers 
Added in 12.6.0
8 Input_Opt%SpcDatabaseFile Specify the path to the YAML file containing the GEOS-Chem species database. The species database file is placed in the GEOS-Chem run directory, so you should not have to modify this line. Added in 12.9.0
9 Input_Opt%LPRT Specify if additional debug information should be printed out to the log file. This was formerly toggled by the ND70 diagnostic. Added in 12.9.0
10 Input_Opt%UseTimers Specify if GEOS-Chem timing information should be printed out. Was formerly toggled by the Makefile option TIMERS=1. Added in 12.9.0

Grid

NOTE: The Grid Menu was introduced in GEOS-Chem 12.4.0. This menu is not read by GCHP or when running GEOS-Chem in an ESM.

Line numbers are not part of the input.geos file, but have been included for reference.

01: %%% GRID MENU %%%       :
02: Grid resolution         : 4.0x5.0
03: Longitude min/max       : -180.0 180.0
04: Latitude  min/max       : -90.0   90.0
05:  Half-sized polar boxes?: T
06: Number of levels        : 72
07: Nested grid simulation? : F
08:  Buffer zone (N S E W ) :  0  0  0  0
Line What gets defined Description Added/Removed?
1 nothing Header line
2 State_Grid%GridRes The horizontal grid resolution for your simulation. Current supported options are 4.0x5.0, 2.0x2.5, 0.5x0.625, and 0.25x0.3215.

GEOS-Chem will split this string and store values in State_Grid%DX and State_Grid%DY.

Added in 12.4.0
3 State_Grid%XMin
State_Grid%XMax
The minimum and maximum longitudes in decimal degrees that define your domain. For global simulations, this should be set to -180.0 180.0.

The number of grid boxes in the X dimension are computed from these bounds using:

State_Grid%NX = ( State_Grid%XMax - State_Grid%XMin ) / State_Grid%DX ).
Added in 12.4.0
4 State_Grid%YMin
State_Grid%YMax
The minimum and maximum latitude in decimal degrees that define your domain. For global simulations, this should be set to -90.0 90.0.

The number of grid boxes in the Y dimension are computed from these bounds using:

State_Grid%NY = ( State_Grid%YMax - State_Grid%YMin ) / State_Grid%DY ).
Added in 12.4.0
5 State_Grid%HalfPolar Set this to T to use half-sized polar grid boxes. This should always be set to T when using GMAO met fields (i.e. GEOS-FP, MERRA-2). Added in 12.4.0
6 State_Grid%NZ The number of vertical levels. Current supported options are 47 and 72. Added in 12.4.0
7 State_Grid%NestedGrid Set this to T when running a nested grid simulation or to F otherwise. Added in 12.4.0
8 State_Grid%NorthBuffer
State_Grid%SouthBuffer
State_Grid%EastBuffer
State_Grid%WestBuffer
The nested grid longitude and latitude offsets (in # of boxes) of the which are used to define an inner window region in which transport is actually done. The region in which transport is done in the window is smaller than the actual size of them nested grid met fields in order to account for the boundary conditions. Please see the comments to the source code file tpcore_bc_mod.F for more information. Recommended values are 3 3 3 3. Added in 12.4.0

Timestep

Line numbers are not part of the input.geos file, but have been included for reference.

01: %%% TIMESTEP MENU %%%   :
02: Tran/conv timestep [sec]: 600
03: Chem/emis timestep [sec]: 1200
Line What gets defined Description Added/Removed?
1 nothing Header line
2 Input_Opt%TS_DYN
Input_Opt%TS_CONV
The dynamic (aka "Heartbeat") timestep in seconds. This is the timestep at which transport, PBL mixing, cloud convection, and wet deposition occur.

Recommended values:

  • 300 sec (=5 min) for:
    • 0.25° x 0.3125° GEOS-FP nested-grid simulations
    • 0.5° x 0.625° MERRA-2 nested-grid simulations
  • 600 sec (=10 min) for:
    • 2° x 2.5° global simulations: 600 sec (=10 min)
    • 4° x 5° global simulations: 600 sec (=10 min)
Added in 12.0.0
3 Input_Opt%TS_CHEM
Input_Opt%TS_EMIS
The chemistry timestep in seconds. This is the timestep at which dry deposition, emissions, and chemistry occur.

Recommended values:

  • 600 sec (=10 min) for:
    • 0.25° x 0.3125° GEOS-FP nested-grid simulations
    • 0.5° x 0.625° MERRA-2 nested-grid simulations
  • 1200 sec (=20 min) for:
    • 2° x 2.5° global simulations: 600 sec (=10 min)
    • 4° x 5° global simulations: 600 sec (=10 min)
Added in 12.0.0
CAVEAT: Running GEOS-Chem with the recommended timesteps from Philip et al. (2016)] has been shown to increase run times by approximately a factor of 2. For tips on improving run time, please see our Speeding up GEOS-Chem wiki page.

Advected Species

Line numbers are not part of the input.geos file, but have been included for reference.

01: %%% ADVECTED SPECIES MENU %%%:
02: Type of simulation      : 3
03: Species Entries ------->: Name
04: Species #1              : NO
05: Species #2              : O3
06: Species #3              : PAN
07: Species #4              : CO
... etc not shown here ...
Line What gets defined Description Added/Removed?
1 nothing Header line
2 Input_Opt%SIM_TYPE The type of GEOS-Chem simulation that you wish to perform. The choices are:
  1. Rn-Pb-Be simulation
  2. UNUSED
  3. One of the NOx-Ox-Hydrocarbon-aerosol (aka "full chemistry") simulations
  4. UNUSED
  5. UNUSED
  6. Tagged O3 simulation
  7. Tagged CO simulation
  8. C2H6 simulation
  9. CH4 simulation
  10. Aerosol-only simulation
  11. Mercury simulation
  12. CO2 simulation
  13. UNUSED
  14. POPs simulation

NOTE: In this example, the ADVECTED SPECIES MENU is set up for a "Standard" full chemistry simulation. This is the simulation we use to generate the GEOS-Chem benchmark output.

Removed in in 12.6.0
3 nothing Header line Removed in in 12.6.0
4 - Input_Opt%AdvectSpc_Name A list of the advected species names. Place only one species name on each line. These entries are used to populate the species database.

Transport

Line numbers are not part of the input.geos file, but have been included for reference.

01: %%% TRANSPORT MENU %%%  :
02: Turn on Transport       : T
03:  => Fill Negative Values: T
04:  => IORD, JORD, KORD    : 3  3  7
Line What gets defined Description Added/Removed?
1 nothing Header line
2 Input_Opt%LTRAN Set this to T to turn on TPCORE transport, or set to F to turn off TPCORE transport.
3 Input_Opt%LFILL Set this to T to cause TPCORE to fill negative values with zeroes.
4 Input_Opt%TPCORE_IORD
Input_Opt%TPCORE_JORD
Input_Opt%TPCORE_KORD
These settings determine how TPCORE performs transport in the E/W, N/S, and vertical directions.
  • Recommended values are 3, 3, 7.

--Bob Yantosca (talk) 20:01, 9 December 2019 (UTC)

Convection

Line numbers are not part of the input.geos file, but have been included for reference.

01: %%% CONVECTION MENU %%% :
02: Turn on Cloud Conv?     : T
03: Turn on PBL Mixing?     : T
04:  => Use non-local PBL?  : T
Line What gets defined Description Added/Removed?
1 nothing Header line
2 Input_Opt%LCONV Set this to T to turn on cloud convection.
3 Input_Opt%LTURB Set this to T to turn on PBL mixing.
4 Input_Opt%LNLPBL The options are as follows:

NOTE: If Input_Opt%LTURB (Line 3) is set to F, then neither PBL mixing option will be executed, regardless of the setting of Input_Opt%LNLPBL.

CAVEAT: In this version, it has been noted that VDIFF (the non-local mixing option) does not strictly conserve mass. This will be more of a problem for long-lived species like CH4 and CO2. Therefore, if you are using the CH4 or CO2 specialty simulations, we recommend to use the full TURBDAY mixing by setting this Input_Opt%LNLPBL switch to F. For more information please see these wiki posts below.

--Bob Yantosca (talk) 20:03, 9 December 2019 (UTC)

Emissions (12.9.0 and later)

01: %%% EMISSIONS MENU %%%  :
02: HEMCO Input file        : HEMCO_Config.rc
03: Switches for UCX        :---
04:  => Use CH4 emissions?  : F
05:  => Set init. strat. H2O: T
Line What gets defined Description Added/Removed?
1 nothing Header Line
2 Input_Opt%HcoConfigFile The name of the HEMCO configuration file. The emission inventories that your simulation will use are set in this file.
3 nothing Header Line
4 Input_Opt%LCH4EMIS Set this T to use online methane emissions in the full-chemistry mechanism.
5 Input_Opt%LSETH2O Set this to T to initialize stratospheric H2O mixing ratios based on meteorology data for the first timestep, overriding any restart file values.

Aerosols

Line numbers are not part of the input.geos file, but have been included for reference.

01: %%% AEROSOL MENU %%%    :
02: Online SULFATE AEROSOLS : T
03:  => Metal cat. SO2 ox.? : T
04: Online CARBON  AEROSOLS : T
05:  => Use Brown Carbon?   : F
06: Online COMPLEX SOA      : T
07:  => Semivolatile POA?   : F
08: Spatial & seasonal OM/OC: F
09: Online DUST    AEROSOLS : T
10:  => Acidic uptake ?     : F
11: Online SEASALT AEROSOLS : T
12:  => SALA radius bin [um]: 0.01 0.5
13:  => SALC radius bin [um]: 0.5  8.0
14:  => MARINE ORG AEROSOLS : F
15: Settle strat. aerosols  : T
16: Online PSC AEROSOLS     : T
17: Allow homogeneous NAT?  : F
18: NAT supercooling req.(K): 3.0
19: Ice supersaturation req.: 1.2
20: Perform PSC het. chem.? : T
21: Calc. strat. aero. OD?  : T
22: Enhance BC Absorption?  : T
23:  => hydrophilic BC      : 1.5
24:  => hydrophobic BC      : 1.0
25: Photolyse nitrate aer.? : F
26:  => NITs Jscale (JHNO3) : 0.0
27:  => NIT  Jscale (JHNO3) : 0.0
28:  => % channel A (HONO)  : 66.667
29:  => % channel B (NO2)   : 33.333
Line What gets defined Description Added/Removed?
1 nothing Header line
2 Input_Opt%LSULF Set this to T to turn on chemistry for sulfate aerosols (DMS, SO2, SO4, MSA, NH3, NH4, NIT).
3 Input_Opt%LMETALCATSO2 Set this to T to turn on metal-catalyzed oxidation of SO2. This option is turned on by default.
4 Input_Opt%LCARB Set this to T to turn on chemistry for carbonaceous aerosols (BCPI, BCPO, OCPI, OCPO).
5 Input_Opt%LBRC Set this to T to turn on brown carbon aerosols.
6 Input_Opt%LSOA Set this to T to turn on the complex SOA chemistry option. (Default is to use the simple SOA option).
7 Input_Opt%LSVPOA Set this to T to use the semivolatile POA option.
8 Input_Opt%LOMOC Set this to T to make the ratios of Organic Matter to Organic Carbon (OM:OC) for SOA species vary by lon/lat location and season. The default is to set these to a single global parameter.
9 Input_Opt%LDUST Set this to T to turn on removal for mineral dust aerosol species (DST1, DST2, DST3, DST4)
10 Input_Opt%LDSTUP Set this to T to turn on acid uptake on dust aerosols.
11 Input_Opt%LSSALT Set this to T to turn on chemistry for sea salt aerosols (SALA, SALC).
12 Input_Opt%SALA_REDGE_um The bin edges (in microns) that denote accumulation mode sea salt species.
  • Recommended setting: 0.01 to 0.5 microns.
13 Input_Opt%SALC_REDGE_um The bin edges (in microns) that denote coarse mode sea salt tracer in microns.
  • Recommended setting: 0.5 to 8 microns.
14 Input_Opt%LMPOA Set this to T top turn on marine organic aerosols.
22 Input_Opt%LBCAE Set this to T to enhance black carbon (BC) absorption due to coating. Added in 12.6.0
23 Input_Opt%BCAE_1 Specify the enhancement for hydrophilic BC. Added in 12.6.0
24 Input_Opt%BCAE_2 Specify the enhancement for hydrophobic BC. Added in 12.6.0
25 Input_Opt%hvAerNIT Set this to T to turn on photolysis of nitrate aerosol (it is off by default) Added in 12.6.0
26 Input_Opt%hvAerNIT_JNITs Define scale factor for JHNO3 photolyizing NITs aerosol Added in 12.6.0
27 Input_Opt%hvAerNIT_JNIT Define scale factor for JHNO3 photolyizing NIT aerosol Added in 12.6.0
28 Input_Opt%JNITChanA Define fraction for JNITs/NIT channel A (H2O2) for NITs photolysis Added in 12.6.0
29 Input_Opt%JNITChanB Define fraction for JNITs/NIT channel B (NO2) for NITs photolysis Added in 12.6.0
The following lines contain settings specific to the UCX chemistry mechanism.
You can turn all of these options off if your simulation does not use the UCX mechanism (e.g "tropchem", "complexSOA").
15 Input_Opt%LGRAVSTRAT Set this to T to apply gravitational settling to stratospheric solid particulate aerosols (SPA, trapezoidal scheme) and stratospheric liquid aerosols (SLA, corrected Stokes' Law).
16 Input_Opt%LSOLIDPSC Set this to T to use solid polar stratospheric clouds (PSCs).
17 Input_Opt%LHOMNUCNAT Set this to T to allow NAT to form homogeneously from freezing of HNO3.
18 Input_Opt%T_NAT_SUPERCOOL The degrees Kelvin of cooling required for homogeneous NAT nucleation.
19 Input_Opt%P_ICE_SUPERSAT The supersaturation factor required for ice nucleation.
  • Recommended values: 1.2 for coarse grids; 1.5 for fine grids.
20 Input_Opt%LPSCCHEM Set this to T to allow heterogeneous chemistry on stratospheric aerosols.
21 Input_Opt%LSTRATOD Set this to T to include online stratospheric aerosols in extinction calculations for photolysis.

Deposition

Line numbers are not part of the input.geos file, but have been included for reference.

01: %%% DEPOSITION MENU %%% :
02: Turn on Dry Deposition? : T
03: Turn on Wet Deposition? : T
04: Turn on CO2 Effect?     : F
05: CO2 level               : 600.0
06: Reference CO2 level     : 380.0
07: Diag alt above sfc [m]  : 10
Line What gets defined Description Added/Removed?
1 nothing Header line
2 Input_Opt%LDRYD Set this to T to turn on dry deposition, or F to turn off dry deposition.
3 Input_Opt%LWETD Set this to T to turn on wet deposition, or F to turn off wet deposition.
4 Input_Opt%CO2_EFFECT Set this to T to turn on the simple parameterization for CO2 dependence on stomatal resistance. Added in 12.6.0
5 Input_Opt%CO2_LEVEL Specify the CO2 level (in ppb) for the simple parameterization for CO2 dependence on stomatal resistance Added in 12.6.0
6 Input_Opt%LWETD Specify the reference CO2 level (ppb) for the simple parameterization for CO2 dependence on stomatal resistance Added in 12.6.0
7 Input_Opt%RA_Alt_Above_Sfc Specify the altitude above the surface (in m) for the diagnostic that corrects O3 and HNO3 from the surface to a user-defined altitude (e.g. the ConcAboveSfc collection) Added in 12.6.0

Chemistry

Line numbers are not part of the input.geos file, but have been included for reference.

01: %%% CHEMISTRY MENU %%%  :
02: Turn on Chemistry?      : T
03: Use linear. strat. chem?: T
04:  => Use Linoz for O3?   : T
05: Use UCX strat. chem?    : T
06: Online CH4 chemistry?   : T
07: Active strat. H2O?      : T
08: Overhead O3 for FAST-JX :---
09:  => Online O3 from model: T
10:  => O3 from met fields  : T
11:  => TOMS/SBUV O3        : F
12: Gamma HO2               : 0.2
Line What gets defined Description Added/Removed?
1 nothing Header line
2 Input_Opt%LCHEM Set this to T to turn on chemistry, or F to turn off chemistry.
3 Input_Opt%LSCHEM Set this to T to turn on linearized stratospheric chemistry, or F to turn off stratospheric chemistry.
4 Input_Opt%LLINOZ Set this to T to use Linoz stratospheric ozone chemistry, otherwise Synoz will be used.
  • NOTE: If the UCX chemistry mechanism is used (see line 5), then Linoz is applied in the mesosphere.
5 Input_Opt%LUCX Set this to T to use the UCX chemistry mechanism. Otherwise online chemistry will only be applied in the troposphere.
6 Input_Opt%LCH4CHEM Set this to T to use online methane chemistry.
7 Input_Opt%LACTIVEH2O Set this to T to allow the stratospheric H2O tracer to influence specific humidity and relative humidity.
  • NOTE: To use this option, you must also turn on UCX (see line 5).
8 nothing Separator line
9 Input_Opt%USE_ONLINE_O3 Set this to T to use online O3 from GEOS-Chem in the extinction calculations for FAST-JX photolysis.
  • NOTE: This is the recommended option.
10 Input_Opt%USE_O3_FROM_MET Set this to T to use ozone columns from the met fields (e.g. TO3).
11 Input_Opt%USE_TOMS_O3 Set this to T to use online O3 from the TOMS/SBUV archive.
  • 'NOTE: We recommend that you set this to F for simulations with GEOS-FP and MERRA-2 meteorology.
12 Input_Opt%GAMMA_HO2 The recommended setting is 0.2.

--Bob Yantosca (talk) 20:47, 9 December 2019 (UTC)

Photolysis

Line numbers are not part of the input.geos file, but have been included for reference.

01: %%% PHOTOLYSIS MENU %%% :
02: FAST-JX directory       : /path/to/ExtData/CHEM_INPUTS/FAST_JX/v2020-02/
Line What gets defined Description Added/Removed?
1 nothing Header line
2 Input_Opt%FAST_JX_DIR Specify the directory containing input files (e.g. cross-sections, scattering weights, etc.) for the FAST-JX photolysis mechanism. We have made this a configurable setting in order to preserve backwards compatibility with older GEOS-Chem versions.

Planeflight diagnostic

Line numbers are not part of the input.geos file, but have been included for reference.

01: %%% PLANEFLIGHT MENU %%%:
02: Turn on plane flt diag? : F
03: Flight track info file  : Planeflight.dat.YYYYMMDD
04: Output file name        : plane.log.YYYYMMDD
Line What gets defined Description Added/Removed?
1 nothing Header line
2 Input_Opt%DO_PF Set this to T to turn on the planeflight diagnostic (aka ND40).
3 Input_Opt%PF_IFILE Specify the name of the input file (usually called Planeflight.dat.YYYYMMDD) for the plane flight diagnostic. This file is described below. You may use date & time tokens YYYY, MM, DD, hh, mm, ss and GEOS-Chem will replace these with the appropriate values.

If the plane flight diagnostic is turned on, then GEOS-Chem will look for a new Planeflight.dat.YYYYMMDD file for each YYYYMMDD date. Then it will save out various quantities along the flight track(s) defined within the Planeflight.dat.YYYYMMDD file.

4 Input_Opt%PF_OFILE Specify the name of the output file (usually called plane.log.YYYYMMDD) for the plane flight diagnostic. You may use date & time tokens YYYY, MM, DD, hh, mm, ss and GEOS-Chem will replace these with the appropriate values.

--Bob Yantosca (talk) 21:05, 9 December 2019 (UTC)

ObsPack diagnostic

Line numbers are not part of the input.geos file, but have been included for reference.

01: %%% OBSPACK MENU %%%:
02: Turn on ObsPack diag?   : F
03: Quiet logfile output    : F
04: ObsPack input file      : ./obspack_co2_1_OCO2MIP_2018-11-28.YYYYMMDD.nc
05: ObsPack output file     : GEOSChem.ObsPack.YYYYMMDD_hhmmz.nc4
06: ObsPack output species  : ?ADV?
Line What gets defined Description Added/Removed
1 nothing Header line
2 Input_Opt%Do_ObsPack Set this to T to turn on the ObsPack diagnostic. ObsPack is turned off by default. Added in 12.2.0
3 Input_Opt%ObsPack_Quiet Set this to T if you wish to suppress printing out information about which observations are being sampled on each timestep. This can be useful if you wish to reduce the amount of text that gets written to the log file. Added in 12.2.0
4 Input_Opt%ObsPack_InputFile Specify the input filename template for ObsPack. This file contains the coordinate information (longitude, latitude, altitude, and sampling strategy) that ObsPack will use in order to decide which grid boxes to sample on each timestep.

If the ObsPack diagnostic is turned on, then GEOS-Chem will look for a Added input file at the start of each new day. We recommend that you use date & time tokens YYYY, MM, DD, hh, mm, ss in the filename so that GEOS-Chem will replace these tokens with the appropriate values.

For more information about the input file format, please see our ObsPack diagnostic wiki page.

Added in 12.2.0
5 Input_Opt%ObsPack_OutputFile Specify the output filename template for ObsPack. This file contains data from GEOS-Chem sampled at each ObsPack location for the appropriate time range.

If the ObsPack diagnostic is turned on, then GEOS-Chem will create a new output file at the start of each new day. We recommend that you use date & time tokens YYYY, MM, DD, hh, mm, ss in the filename so that GEOS-Chem will replace these tokens with the appropriate values.

For more information about the input file format, please see our ObsPack diagnostic wiki page.

Added in 12.2.0
6 Input_Opt%ObsPack_SpcName List the names of GEOS-Chem species that you wish to archive using the ObsPack diagnostic. You can list individual species names (e.g NO CO O3, ...) or use the ?ADV? wildcard if you wish to archive all advected species. Added in 12.2.0;
Wildcard in 13.3.0

--Bob Yantosca (talk) 19:34, 28 September 2021 (UTC)

ND51 and ND51b diagnostics

The ND51 and ND51b satellite timeseries diagnostics will be preserved for the time being. But in GEOS-Chem 12.7.0 and later versions, you must compile GEOS-Chem with the BPCH_DIAG=y option if you wish to activate these diagnostics.

Line numbers are not part of the input.geos file, but have been included for reference.

01: %%% ND51 MENU %%%       :
02: Turn on ND51 diagnostic : F
03: LT avg timeseries file  : ts_satellite.YYYYMMDD.bpch
04: Output as HDF5?         : F
05: Tracers to include      : 82 83 84 85 86 87
06: GMT Hour for disk write :   0
07: Avg Period [LT hours]   :  10  12
08: IMIN, IMAX of region    :   1 151
09: JMIN, JMAX of region    :   1 121
10: LMIN, LMAX of region    :   1  40

01: %%% ND51b MENU %%%      :
02: Turn on ND51b diagnstic : F
03: LT avg timeseries file  : ts_13_15.NA.YYYYMMDD.h5
04: Output as HDF5?         : F
05: Tracers to include      : 1 4 20 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44
06: GMT Hour for disk write :  1
07: Avg Period [LT hours]   :  13  15
08: IMIN, IMAX of region    :   1  72
09: JMIN, JMAX of region    :   1  46
10: LMIN, LMAX of region    :   1   1
Line What gets defined Description Added/Removed?
1 nothing Header line
2 Input_Opt%DO_ND51
Input_Opt%DO_ND51b
Set this to T to turn on the ND51 and/or ND51b "satellite" 3D timeseries diagnostic. ND51 and/or ND51b allows you to archive 3D data blocks for various quantities which have been time-averaged between 2 local times. This is useful for comparing model data to sun-synchronous satellites such as GOME or MOPITT which have morning overpass times.

NOTE: The ND51 and ND51b diagnostics allow you to archive two separate time-averaged timeseries files simultaneously in GEOS-Chem. This is useful if you want to only run GEOS-Chem once, but create timeseries output corresponding to 2 different satellite instruments simultaneously.

3 Input_Opt%ND51_FILE
Input_Opt%ND51b_FILE
The name of the ND51 and/or ND51b files which will contain output from the ND51 and/or ND51b station timeseries diagnostic. This file will be in binary punch format and can be read by GAMAP. You may use date & time tokens YYYY, MM, DD, hh, mm, ss and GEOS-Chem will replace these with the appropriate values.
4 nothing OBSOLETE
5 Input_Opt%ND51_TRACERS
Input_Opt%ND51b_TRACERS
The ND51 and/or ND51b diagnostic quantities to save to disk. Separate each number with a space.
6 Input_Opt%ND51_HR_WRITE
Input_Opt%ND51b_HR_WRITE
The time of day (in GMT hours) at which the ND51 timeseries file will be written to disk. Recommended value: 0 GMT each day.
7 Input_Opt%ND51_HR_1
Input_Opt%ND51_HR2
Input_Opt%ND51b_HR_1
Input_Opt%ND51b_HR2
The ND51 and/or ND51b time averaging window (in local time hours). Only data from grid boxes where the local time falls within this window will be included in the diagnostic averaging process. Recommended values: 10:00 to 12:00 LT. This will cover both GOME and MOPITT overpasses.
8 Input_Opt%ND51_IMIN
Input_Opt%ND51_IMAX
Input_Opt%ND51b_IMIN
Input_Opt%ND51b_IMAX
The indices which determine the longitude extent of the 3D region of the globe. Note that these are indices and not actual longitude values. To specify all 360 degrees of longitude, type the following:
  • For GMAO 4° x 5° grid: 1 72
  • For GMAO 2° x 2.5° grid: 1 144

Also, note you can wrap around the date line.

9 Input_Opt%ND51_JMIN
Input_Opt%ND51_JMAX
Input_Opt%ND51b_JMIN
Input_Opt%ND51b_JMAX
The indices which determine the latitude extent of the 3D region of the globe. Note that these are indices and not actual latitude values. To specify all 180 degrees of latitude, type the following:
  • For GMAO 4° x 5° grid: 1 46
  • For GMAO 2° x 2.5° grid: 1 91
10 Input_Opt%ND51_LMIN
Input_Opt%ND51_LMAX
Input_Opt%ND51b_LMIN
Input_Opt%ND51b_LMAX
The indices which determine the vertical extent of the 3D region of the globe.

--Bob Yantosca (talk) 21:08, 9 December 2019 (UTC)

Passive Species Menu

Line numbers are not part of the input.geos file, but have been included for reference.

01: %%% PASSIVE SPECIES MENU %%%:
02: Passive species #1      : PASV1 1.0 -1 1.0e-7
03: Passive species #2      : PASV2 50.0 3600.0 1.0e-12
Line What gets defined Description Added/Removed?
1 nothing Header line
2-3 SpcName
SpcMW
SpcTau
SpcInitConc
For each passive species, you must provide the following information (separated by spaces):
  • Species name
  • Species molecular weight (g/mol)
  • Atmospheric lifetime (s)
    • Specify 0 or negative value for no loss
  • Default initial atmospheric concentration (v/v)
    • This value will only be used if the species is not found in the restart file.
  • OPTIONAL: Species long name
Updated in 12.2.0

There must be a matching entry in the advected species menu for every passive species defined in the passive species menu. If the two menus aren't consistent, you will get a species database error. For more information, see this wiki post on adding passive species.

NOTE: In GEOS-Chem 12.2.0 the line Number of passive spec. : 2 (stored in Input_Opt%NPASSIVE) was removed. This value is now determined when the input.geos file is read.

--Melissa Sulprizio (talk) 01:30, 26 February 2019 (UTC)
--Bob Yantosca (talk) 21:16, 9 December 2019 (UTC)

CH4 simulation

This menu controls options for the tagged CH4 simulation only. This is an optional menu and may be omitted from input.geos if you are not concerned with this simulation. For more information, please see our CH4 simulation wiki page.

Line numbers are not part of the input.geos file, but have been included for reference.

01: %%% CH4 MENU %%%        :
02: Compute CH4 budget?     : F
03: Use Gas & Oil emis?     : T
04: Use Coal Mine emis?     : T
05: Use Livestock emis?     : T
06: Use Waste emis?         : T
07: Use Biofuel emis?       : T
07: Use Rice emis?          : T
08: Use Ot. Anthro emis?    : T
09: Use Biomass emis?       : T
10: Use Wetlands emis?      : T
11: Use Soil Absorption?    : T
12: Use Ot. Natural?        : T
Line What gets defined Description Added/Removed?
1 nothing Header line
2 Input_Opt%LCH4BUD Set this to T to calculate a monthly budget for CH4.
  • NOTE: The CH4 budget is not working well, we recommend setting leaving this set to F.
3 Input_Opt%LGAO Set this to F to turn off CH4 emissions from gas and oil.
4 Input_Opt%LCOL Set this to F to turn off CH4 emissions from coal.
5 Input_Opt%LLIV Set this to F to turn off CH4 emissions from livestock.
6 Input_Opt%LWAST Set this to F to turn off CH4 emissions from waste.
7 Input_Opt%LBFCH4 Set this to F to turn off CH4 emissions from biofuels.
8 Input_Opt%LRICE Set this to F to turn off CH4 emissions from rice fields.
9 Input_Opt%LOTANT Set this to F to turn off other CH4 anthropogenic emissions.
10 Input_Opt%LBMCH4 Set this to F to turn off CH4 emissions from biomass burning.
11 Input_Opt%LWETL Set this to F to turn off CH4 emissions from wetlands.
12 Input_Opt%LSOABS Set this to F to turn off CH4 absorption by soils.
13 Input_Opt%LOTNAT Set this F to turn off other CH4 natural emissions.

--Bob Yantosca (talk) 21:17, 9 December 2019 (UTC)

CO2 simulation

This menu only controls options for the CO2 and tagged CO2 simulations. This is an optional menu and may be omitted from input.geos if you are not concerned with these simulations. For more information, please see:

  • Our CO2 simulation wiki page.
  • A more detailed account of all settings can be found in:
    • Nassar, R., D.B.A. Jones, P. Suntharalingam, J.M. Chen, R.J. Andres, K.J. Wecht, R.M. Yantosca, S.S. Kulawik, K.W. Bowman, J.R. Worden, T. Machida, and H. Matsueda, Modeling CO2 with improved emission inventories and CO2 production from the oxidation of other carbon species, Geoscientific Model Development, 3, 689-716, 2010.

Line numbers are not part of the input.geos file, but have been included for reference.

01: %%% CO2 SIM MENU %%%    :
02: Fossil Fuel Emissions   : T
03: Ocean Exchange          : T
04: Balanced Biosphere Exch : T
05: Net Terrestrial Exch    : T
06: Ship emissions          : T
07: Aviation emissions 3-D  : T
08: 3-D Chemical Oxid Source: T
09: Tagged CO2 runs         :---
10:  Save Fossil in Bckgrnd: F
11:  Tag Bio/Ocean CO2 reg : F
12:  Tag Land FF CO2 reg   : F
13:  Tag Global Ship CO2   : F
14:  Tag Global Plane CO2  : F
Line What gets defined Description Added/Removed?
1 nothing Header line
2 Input_Opt%LFOSSIL Set this to T to use fossil-fuel emissions of CO2 as computed by HEMCO.
3 Input_Opt%LOCEAN Set this to T to use ocean exchange of CO2 as as computed by HEMCO.
4 Input_Opt%LBIODIURNAL Set this to T to turn on the CASA model 3-hourly Net Ecosystem Production (balanced – no net annual flux) [Potter et al., 1993; Olsen and Randerson, 2004].
5 Input_Opt%LBIONETCLIM Set this to T to turn on Net Terrestrial Exchange (climatology) of -5.29 PgC/yr [Baker et al., 2006] adjusted for biomass/biofuel burning.
6 Input_Opt%LSHIP Set this to T to use on ship emissions of CO2 as computed by HEMCO.
7 Input_Opt%LPLANE Set this to T to turn on the aviation emission 3-D distribution from fuel burn (GEOS-Chem sulfate aerosol simulation) scaled to annual CO2 values for 1985-2002 [Sausen & Schumann, 2000; Kim et al., 2005; 2007; Wilkerson et al., 2010] and estimates for 2002-2009. An associated surface correction automatically removes domestic aviation emissions from the main fossil fuel source in continental size regions.
8 Input_Opt%LCHEMCO2 Set this to T to turn on the 3D CO2 chemical source from oxidation of CO, CH4 and NMHCs based on Suntharalingam et al. [2005], with appropriate surface emission corrections.
9 nothing Header line
10 Input_Opt%LFFBKGRD Set this to T to save CO2 background.
11 Input_Opt%LBIOSPHTAG Set this to T to tag biosphere regions (28), ocean regions (11) and the Rest of the World (ROW) as specified in the Regions_land.dat and Regions_ocean.dat files.
  • NOTE: Tagged tracers should be customized by each user and the present configuration will not work for resolutions other than 2x2.5.
12 Input_Opt%LFOSSILTAG Set this to T to tag fossil fuel regions (28) as specified in the Regions_land.dat file and ROW.
  • NOTE: Tagged tracers should be customized by each user and the present configuration will not work for resolutions other than 2x2.5.
13 Input_Opt%LSHIPTAG Set this to T to tag global ship emissions as a single tracer.
  • NOTE: Tagged tracers should be customized by each user and the present configuration will not work for resolutions other than 2x2.5.
14 Input_Opt%LPLANETAG Set this to T to Tag global aviation emissions as a single tracer.
  • NOTE: Tagged tracers should be customized by each user and the present configuration will not work for resolutions other than 2x2.5.

--Bob Yantosca (talk) 21:20, 9 December 2019 (UTC)

POPs simulation

This menu controls options for the persistent organic pollutants (POPs) simulation only. This is an optional menu and may be omitted from input.geos if you are not concerned with this simulation. For more information, please see our POPs simulation wiki page.

Line numbers are not part of the input.geos file, but have been included for reference.

01: %%% POPS MENU %%%       :
02: POP type [PHE,PYR,BAP]  : PHE
03: Chemistry processing on?: T
04: POP_XMW                 : 178.23d-3
05: POP_KOA                 : 4.37d7
06: POP_KBC                 : 1.0d10
07: POP_K_POPG_OH           : 2.7d-11
08: POP_K_POPG_O3A          : 0d0
09: POP_K_POPG_O3B          : 2.15d15
10: POP_HSTAR               : 1.74d-3
11: POP_DEL_H               : -74d3
12: POP_DEL_Hw              : 47d0
Line What gets defined Description Added/Removed?
1 nothing Header line
2 Input_Opt%POP_TYPE Current options are PHE (phenanthrene), PYR (pyrene), or BAP (benzo[a]pyrene).
3 Input_Opt%CHEM_PROCESS Set this to T to use POPs chemistry.
4 Input_Opt%POP_XMW The molecular weight of the POPs species in kg/mol.
5 Input_Opt%POP_KOA The POP octanol-water partition coefficient.
6 Input_Opt%POP_KBC The POP black carbon-air partition coefficient.
7 Input_Opt%POP_K_POPG_OH The POP reaction rate constant for reaction of gas phase POP with hydroxyl radical in cm3/molec/s.
8 Input_Opt%POP_K_POPP_O3A The POP reaction rate constant for reaction of particle phase POP with ozone in s-1.
9 Input_Opt%POP_K_POPP_O3B The POP reaction rate constant for reaction of particle phase POP with ozone in molec/cm3.
10 Input_Opt%POP_HSTAR The Henry's Law constant for the POPs species.
11 Input_Opt%POP_DEL_H The enthalpy of air-water exchange in J/mol.
12 Input_Opt%POP_DEL_Hw The enthalpy of phase transfer from gas phase to particle phase.

--Bob Yantosca (talk) 21:22, 9 December 2019 (UTC)

Hg simulation

This menu only controls options for the mercury simulation (with or without the Global Terrestrial Mercury Model). This is an optional menu and may be omitted from input.geos if you are not concerned with this simulation.

For more information, please see:

Line numbers are not part of the input.geos file, but have been included for reference.

01: %%% MERCURY MENU %%%    :
02: Use anthro Hg emiss for : 2006
03: Use future emissions?   : PRESENT
04: Error check tag/tot Hg? : F
05: Use dynamic ocean Hg?   : T
06: Preindustrial sim?      : F
07: Use GTMM soil model?    : F
08: GTMM Hg rst file (bpch) : GTM.totHg.YYYYMMDDhh
09: Use Arctic river Hg?    : T
10: Tie HgII(aq) red to UVB?: T
Line What gets defined Description Added/Removed?
1 nothing Header line
2 Input_Opt%ANTHRO_Hg_YEAR Baseline year of the anthropogenic mercury emissions that are used in the tagged mercury simulation. Current options are either 2006 or 2050.
3 Input_Opt%Hg_SCENARIO Future emissions are based on the four IPCC SRES scenarios. Current options are PRESENT, A1B, A2, B1, or B2.
4 Input_Opt%USE_CHECKS Set this to T to stop with an error message if the sum of tagged tracers does not equal the total tracer, or F otherwise. This is useful for debugging.
5 Input_Opt%LDYNOCEAN. Set this to T to use the online ocean mercury model (in source code file ocean_mercury_mod.F) or F to read ocean mercury concentrations from monthly mean files on disk.
6 Input_Opt%LPREINDHG Set to T if you want to run a preindustrial simulation (turn off anthropogenic emissions), to F otherwise.
8 Input_Opt%LGTMM Set to T if you want to run GTMM online in GEOS-Chem. Note, that to use GTMM online, you need to first run GTMM offline up to equilibrium and to compile GEOS-Chem with GTMM enabled. For more information, please refer to this document.
  • NOTE: The Global Terrestrial Mercury Model (GTMM) code has now become incompatible with the latest GEOS-Chem 12 version series. Please contact the Hg and POPs Working Group for assistance if you need to use the GTMM option.
8 Input_Opt%GTMM_RST_FILE If you are using the GTMM online, then you can specify the name of the GTMM mercury restart file. This file saves the monthly depositions of mercury tracers for continuing the run at a later stage. You may use date & time tokens YYYY, MM, DD, hh, mm, ss and GEOS-Chem will replace these with the appropriate values.
  • NOTE: The GTMM restart file will have to be converted from bpch to netCDF format.

--Bob Yantosca (talk) 21:24, 9 December 2019 (UTC)

Radiation (RRTMG)

This menu controls options for GEOS-Chem simulations coupled to the RRTMG radiative transfer model. This is an optional menu and may be omitted from input.geos if you are not concerned with this simulation. For more information, please see our Coupling GEOS-chem with RRTMG wiki page.

Line numbers are not part of the input.geos file, but have been included for reference.

01: %%% RADIATION MENU %%%  :
02: AOD Wavelength (nm)     : 550
03: Turn on RRTMG?          : F
04: Calculate LW fluxes?    : F
05: Calculate SW fluxes?    : F
06: Clear-sky flux?         : F
07: All-sky flux?           : F
08: Radiation Timestep [sec]: 10800
09: Species fluxes          : 0 0 0 0 0 0 0 0 0 1 0
10:  ---[O3,ME,SU,NI,AM,BC,OA,SS,DU,PM,ST]
Line What gets defined Description Added/Removed?
1 nothing Header line
2 WVSELECT Specify wavelength(s) for the aerosol optical properties. Up to three wavelengths can be output. The wavelengths should be entered in nm with a space between each entry. The specified wavelengths are used for the Fast-JX photolysis mechanism, regardless of whether the RRTMG radiative transfer model is used.
3 Input_Opt%LRAD Set this to T to turn on online radiative transfer using RRTMG, or F to turn off RRTMG.
4 Input_Opt%LLWRAD Set this to T to turn on longwave radiation calculation.
5 Input_Opt%LSWRAD Set this to T to turn on shortwave radiation calculation.
6 Input_Opt%LSYKRAD(1) Set this to T to turn turn on calculation for clear-sky fluxes. This option will perform radiative calculations without clouds.
7 Input_Opt%LSYKRAD(2) Set this to T to turn turn on calculation for all-sky fluxes. This option will perform radiative with clouds. Both clear sky and all-sky options can be turned on without signigicant increase to run time.
8 Input_Opt%TS_RAD Radiation timestep in seconds. In all cases, the radiation timesetp should be a multiple of the transport timestep. The RRTMG calculation is instantaneous (i.e. not averaged over the period selected) and is set to occur at half the radiation timestep. We recommend using a radiation timestep of 10800 sec = 3 hours (producing RRTMG calls at 01:30, 4:30, etc.).
9 LSPECRADMENU Specify the species for which radiative fluxes will be calculated. Set a value to 1 to calculate the radiative effect for that species, or 0 to turn off radiative calculations for that species. The first RRTMG call (the "baseline") contains all species switched on and each requested species calls RRTMG again with that species omitted, so that the difference can be calculated. The number of calls to RRTMG will be equal to the total sum of this line plus one (for the first "baseline" call), so this can substantially increase model run time.
  • NOTE: If you are using the UCX chemistry mechanism, then you will need to add an additional entry (0 or 1) at the end of this line for stratospheric aerosols for a total of 11 possible species.
Removed in 12.2.1
10 nothing This line lists species available for output from the flux calculations. This line is here for reference and is not actually read by GEOS-Chem. Available species are:
  • O3 (Ozone)
  • ME (Methane)
  • SU (Sulfate)
  • NI (Nitrate)
  • AM (Ammonium)
  • BC (Black carbon)
  • OA (Organic aerosol)
  • SS (Sea salt)
  • DU (Mineral dust)
  • PM (All particulate matter)
  • ST (Stratospheric aerosol, UCX simulation only)
Removed in 12.2.1

--Bob Yantosca (talk) 21:28, 9 December 2019 (UTC)

Deprecated menus in input.geos

Recent updates to GEOS-Chem have made several menus of input.geos obsolete. Some of these menus (especially the diagnostic menus below) will only be read if you compile GEOS-Chem with the binary punch diagnostics turned on (i.e. with compile option BPCH_DIAG=y). We will list these menus here for further reference.

Emissions (prior to 12.9.0)

Line numbers are not part of the input.geos file, but have been included for reference.

01: %%% EMISSIONS MENU %%%  :
02: Turn on emissions?      : T
03: HEMCO Input file        : HEMCO_Config.rc
04:  => 1ppt MBL BRO Sim.?  : F
05: Switches for UCX        :---
06:  => Use CH4 emissions?  : F
07:  => Turn on surface BCs :---
08:     => CH4?             : T
19:     => OCS?             : T
10:     => CFCs?            : T
11:     => Cl species?      : T
12:     => Br species?      : F
13:     => N2O?             : T
14:  => Set initial glob MRs:---
15:     => strat. H2O?      : T
16:  => CFC emission year   : 0
Line What gets defined Description Added/Removed?
1 nothing Header Line
2 Input_Opt%LEMIS Set this to T to turn on emissions or F to turn off emissions. Removed in 12.9.0


3 Input_Opt%HcoConfigFile The name of the HEMCO configuration file. The emission inventories that your simulation will use are set in this file.
4 Input_Opt%LFIX_PBL_BrO Set this to T to set Bro concentrations in the PBL equal to 1 ppt during the day. Removed in 12.9.0
The following lines contain settings specific to the UCX chemistry mechanism.
You can turn all of these options off if your simulation does not use the UCX mechanism (e.g "tropchem", "complexSOA").
5 nothing Header line.
6 Input_Opt%LCH4EMIS Set this T to use online methane emissions.
7 nothing Header line Removed in 12.9.0
8 Input_Opt%LCH4SBC Set this T to fix surface mixing ratio of methane.
9 Input_Opt%LOCSEMIS Set this to T to fix surface mixing ratios of OCS. Removed in 12.9.0
10 Input_Opt%LCFCEMIS Set this to T to fix surface mixing ratios of CFCs, HCFCs, and halons to match WMO projections under the Montreal Protocol. Removed in 12.9.0
11 Input_Opt%LCLEMIS Set this to T to fix surface mixing ratios of other chlorinated carbon and inorganic chlorine species to match WMO projections under the Montreal Protocol. Removed in 12.9.0
12 Input_Opt%LBREMIS Set this to T to fix surface mixing ratios of bromine species. Not recommended if other bromine emissions are enabled. Removed in 12.9.0
13 Input_Opt%LN2OEMIS Set this to T to fix surface mixing ratios of N2O. Removed in 12.9.0
14 nothing Header line Removed in 12.9.0


15 Input_Opt%LSETH2O Set this to T to initialize stratospheric H2O mixing ratios based on meteorology data for the first timestep, overriding any restart file values.
16 Input_Opt%CFCYEAR Specify the starting year for CFC emissions. Removed in 12.9.0

GAMAP

Line numbers are not part of the input.geos file, but have been included for reference.

01: %%% GAMAP MENU %%%      :
02: diaginfo.dat path       : diaginfo.dat
03: tracerinfo.dat path     : tracerinfo.dat
Line What gets defined Description Notes
1 nothing Header line Deprecated in 12.7.0
2 Input_Opt%GAMAP_DIAGINFO Path name of the diaginfo.dat file for GAMAP. GEOS-Chem will create this file, which will be customized to the particular simulation that is being done. This may be either a relative path name or an absolute path name. Deprecated in 12.7.0

Output

Line numbers are not part of the input.geos file, but have been included for reference.

01: %%% OUTPUT MENU %%%     : 123456789.123456789.123456789.1--1=ZERO+2=BPCH
02: Schedule output for JAN : 3000000000000000000000000000000
03: Schedule output for FEB : 30000000000000000000000000000
04: Schedule output for MAR : 3000000000000000000000000000000
05: Schedule output for APR : 300000000000000000000000000000
06: Schedule output for MAY : 3000000000000000000000000000000
07: Schedule output for JUN : 300000000000000000000000000000
08: Schedule output for JUL : 3000000000000000000000000000000
09: Schedule output for AUG : 3000000000000000000000000000000
10: Schedule output for SEP : 300000000000000000000000000000
11: Schedule output for OCT : 3000000000000000000000000000000
12: Schedule output for NOV : 300000000000000000000000000000
13: Schedule output for DEC : 3000000000000000000000000000000
Line What gets defined Description Status
1 nothing Header line Deprecated in 12.7.0
2 Input_Opt%NJDAY Schedule diagnostic output for JANUARY. Place a 3 in the column corresponding to the day of the month (1-31) on which you want diagnostic output saved to the binary punch file.

In the example above, the columns which indicate January 1st and February 1st both have a 3 listed there. This will cause GEOS-Chem to archive diagnostic data for the entire month of January and then save it to disk at 0 GMT on February 1st. (GEOS-Chem is smart enough not to write anything to disk at 0 GMT on January 1st, since this is the starting time of the simulation.) If you would like to save daily diagnostic output to the binary punch file, put a 3 for each day of each month.

  • NOTE: You must place a 3 in the location corresponding to the simulation end date. Otherwise, the GEOS-Chem simulation will crash immediately with the error No output scheduled on last day of run!
Deprecated in 12.7.0
3 Schedule diagnostic output for FEBRUARY Deprecated in 12.7.0
4 Schedule diagnostic output for MARCH Deprecated in 12.7.0
5 Schedule diagnostic output for APRIL Deprecated in 12.7.0
6 Schedule diagnostic output for MAY Deprecated in 12.7.0
7 Schedule diagnostic output for JUNE Deprecated in 12.7.0
8 Schedule diagnostic output for JULY Deprecated in 12.7.0
9 Schedule diagnostic output for AUGUST Deprecated in 12.7.0
10 Schedule diagnostic output for SEPTEMBER Deprecated in 12.7.0
11 Schedule diagnostic output for OCTOBER Deprecated in 12.7.0
12 Schedule diagnostic output for NOVEMBER Deprecated in 12.7.0
13 Schedule diagnostic output for DECEMBER Deprecated in 12.7.0

Diagnostics (binary punch format)

This menu is now deprecated in 12.7.0 and later versions.

This menu lets you specify which GEOS_Chem diagnostic quantities will be archived to disk as binary punch (aka bpch) format. For a complete list of diagnostic settings, please see our List of diagnostics archived to bpch format wiki page.

Line numbers are not part of the input.geos file, but have been included for reference.

%%% DIAGNOSTIC MENU %%% :
Binary punch file name  : trac_avg.geosfp_4x5_standard.YYYYMMDDhhmm
Diagnostic Entries ---> :  L   Tracers to print out for each diagnostic
ND01: Rn/Pb/Be source   :  0   all
ND02: Rn/Pb/Be decay    :  0   all
ND03: Hg emissions, P/L :  0   all
ND04: CO2 Sources       :  0   all
ND05: Sulfate prod/loss : 72   all
ND06: Dust aer source   :  1   all
ND07: Carbon aer source : 72   all
ND08: Seasalt aer source:  1   all
ND09: -                 :  0   all
ND10: -                 :  0   all
ND11: Acetone sources   :  1   all
ND12: BL fraction       :  0   all
ND13: Sulfur sources    : 72   all
ND14: Cld conv mass flx :  0   all
ND15: BL mix mass flx   :  0   all
ND16: LS/Conv prec frac :  0   all
ND17: Rainout fraction  :  0   all
ND18: Washout fraction  :  0   all
ND19: CH4 loss          :  0   all
ND21: Optical depths    : 72   all
ND22: J-Values          : 72   1 2 7 8 9 11 13 14 20 44 46 47 49 50 51 59 60 66 67 69 74 75 83 84 -1
      => JV time range  :      11 13
ND24: E/W transpt flx   :  0   all
ND25: N/S transpt flx   :  0   all
ND26: U/D transpt flx   :  0   all
ND27: Strat NOx,Ox,HNO3 :  0   1 2 7
ND28: Biomass emissions :  1   1 4 5 9 10 11 18 19 20 21 26 30 34 35 71
ND29: CO sources        :  1   all
ND30: Land Map          :  0   all
ND31: Pressure edges    : 73   all
ND32: NOx sources       :  1   all
ND33: Column tracer     :  0   all
ND34: Biofuel emissions :  1   1 4 5 9 10 11 18 19 20 21
ND35: Tracers at 500 mb :  0   all
ND36: Anthro emissions  :  1   1 2 4 5 7 9 10 11 18 19 20 21 71
ND37: Updraft scav frac :  0   all
ND38: Cld Conv scav loss: 72   all
ND39: Wetdep scav loss  : 72   all
ND41: Afternoon PBL ht  :  0   all
ND42: SOA concentrations: 72   all
ND43: Chem prod OH, HO2 : 72   all
  ==> OH/HO2 time range :       0 24
ND44: Drydep flx/vel    :  1   2 3 7 8 9 11 13 14 15 16 17 20 22 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 47 48 50  55 56 58 59 60 61 62 63 64 65 66 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 119 120 121 122 123 124 125
ND45: Tracer Conc's     : 72   all
  ==> ND45 Time range   :       0 24
ND46: Biogenic emissions:  1   all
ND47: 24-h avg trc conc :  0   all
ND52: GAMMA HO2         :  0   all
ND53: POPs Emissions    :  0   all
ND54: Time in t'sphere  : 72   all
ND55: Tropopause height : 72   all
ND56: Lightning flashes :  0   all
ND57: Potential T       :  0   all
ND58: CH4 Emissions     :  0   all
ND59: TOMAS aerosol emis:  0   all
ND60: Wetland Frac      :  0   all
ND61: TOMAS 3D rate     :  0   all
ND62: Inst column maps  :  0   all
ND64: Radiative flux    :  0   all
ND66: DAO 3-D fields    : 72   all
ND67: DAO 2-D fields    : 72   all
ND68: Airmass/Boxheight : 72   all
ND69: Surface area      :  1   all
ND70: Debug output      :  0   all
ND71: Hourly max ppbv   :  0   2
ND72: Radiative output  :  0   all

Menus recently removed from input.geos

The following menus were removed from recent GEOS-Chem 12.Y.Z versions:

Benchmark

Line numbers are not part of the input.geos file, but have been included for reference.

01: %%% BENCHMARK MENU %%%  :
02: Save benchmark output?  : T
03: File w/ initial Ox      : Ox.mass.initial
04: File w/ final Ox        : Ox.mass.final
Line What gets defined Description Status
1 nothing Header line Removed in 12.7.0
2 Input_Opt%LSTDRUN Set this switch to T if you wish to save out benchmark diagnostics, or F otherwise. This option will save out initial and final tracer masses needed for the 1-month benchmark simulation plotting routines. Removed in 12.7.0
3 Input_Opt%STDRUN_INIT_FILE Specify name of file (binary punch format) that will contain initial tracer mass. Removed in 12.7.0
4 Input_Opt%STDRUN_FINAL_FILE Specify name of file (binary punch format) that will contain final tracer mass. Removed in 12.7.0

ND48 diagnostic

Line numbers are not part of the input.geos file, but have been included for reference.

01: %%% ND48 MENU %%%       :
02: Turn on ND48 stations   : F
03: Station Timeseries file : stations.YYYYMMDD
04: Frequency [sec]         : 3600
05: Number of stations      : 1
06: Station #1 (I,J,Lmax,N) : 133 29 15 2
Line What gets defined Description Status
1 nothing Header line Removed in 12.7.0
2 Input_Opt%DO_ND48 Set this to T to turn on the ND48 station timeseries diagnostic. This allows you to save timeseries data of various quantities at specific grid boxes. Removed in 12.7.0
3 Input_Opt%ND48_FILE The name of the file which will contain output from the ND48 station timeseries diagnostic. This file will be in binary punch format and can be read by GAMAP. You may use date & time tokens YYYY, MM, DD, hh, mm, ss and GEOS-Chem will replace these with the appropriate values. Removed in 12.7.0
4 Input_Opt%ND48_FREQ The frequency in seconds at which data will be archived by the ND48 station timeseries diagnostic. Recommended values: 3600 sec (= 1 hour) or 7200 sec (=2 hours). Removed in 12.7.0
5 Input_Opt%ND48_N_STA The number of ND48 stations at which timeseries data will be saved to disk. Removed in 12.7.0
6 Input_Opt%ND48_IARR
Input_Opt%ND48_JARR
Input_Opt%ND48_LARR
Input_Opt%ND48_NARR
For each ND48 station, you must provide the following information (separated by spaces):
  • Longitude index
  • Latitude index
  • Number of levels to save
    • If you type 1, it will just save the surface level.
    • If you type 10, then it will save all levels from level 1 (surface) to level 10.
  • ND48 diagnostic quantity number(s)
Removed in 12.7.0

--Bob Yantosca (talk) 21:12, 9 December 2019 (UTC)

ND49 diagnostic

Line numbers are not part of the input.geos file, but have been included for reference.

01: %%% ND49 MENU %%%       :
02: Turn on ND49 diagnostic : F
03: Inst 3-D timeser. file  : tsYYYYMMDD.bpch
04: Tracers to include      : 94
05: Frequency [sec]         : 7200
06: IMIN, IMAX of region    :  70  30
07: JMIN, JMAX of region    :  23  46
08: LMIN, LMAX of region    :   1   1
Line What gets defined Description Added/Removed?
1 nothing Header line Removed in 12.7.0
2 Input_Opt%DO_ND49 Set this to T to turn on the ND49 instantaneous 3D timeseries diagnostic. This allows you to archive instantaneous timeseries data for various quantities from a 3D region of the globe. Removed in 12.7.0
3 Input_Opt%ND49_FILE The name of the file which will contain output from the ND49 station timeseries diagnostic. This file will be in binary punch format and can be read by GAMAP. You may use date & time tokens YYYY, MM, DD, hh, mm, ss and GEOS-Chem will replace these with the appropriate values. Removed in 12.7.0
4 Input_Opt%ND49_TRACERS The ND49 diagnostic quantities that you wish to save to disk. Separate each number with a space. Removed in 12.7.0
5 Input_Opt%ND49_FREQ The frequency (in minutes) at which ND49 will save data for a 3D region of the globe data to disk. Recommended value: 7200 min (= 2 hours) or 10800 min (= 3 hours). You may save data at a higher temporal resolution (e.g. every hour) but this will create HUGE data files! Removed in 12.7.0
6 Input_Opt%ND49_IMIN
Input_Opt%ND49_IMAX
The indices which determine the longitude extent of the 3D region of the globe. Note that these are indices and not actual longitude values. To specify all 360 degrees of longitude, type the following:
  • For GMAO 4° x 5° grid: 1 72
  • For GMAO 2° x 2.5° grid: 1 144

Also, note you can wrap around the date line. In the example shown above, IMIN=70 and IMAX=30. This will create a 3D region (assuming 4x5 grid) which starts at 165° E longitude and extends across the date line to 35° W longitude.

Removed in 12.7.0
7 Input_Opt%ND49_JMIN
Input_Opt%ND49_JMAX
The indices which determine the latitude extent of the 3D region of the globe. Note that these are indices and not actual latitude values. To specify all 180 degrees of latitude, type the following:
  • For GMAO 4° x 5° grid: 1 46
  • For GMAO 2° x 2.5° grid: 1 91
Removed in 12.7.0
8 Input_Opt%ND51_LMIN
Input_Opt%ND51_LMAX
The indices which determine the vertical extent of the 3D region of the globe. Removed in 12.7.0

--Bob Yantosca (talk) 19:54, 9 December 2019 (UTC)

ND50 diagnostic

Line numbers are not part of the input.geos file, but have been included for reference.

01: %%% ND50 MENU %%%       :
02: Turn on ND50 diagnostic : F
03: 24-hr avg timeser. file : ts_24h_avg.YYYYMMDD.bpch
04: Output as HDF5?         : F
05: Tracers to include      : 82 83 84 85 86 87
06: IMIN, IMAX of region    :   1  72
07: JMIN, JMAX of region    :   1  46
08: LMIN, LMAX of region    :   1   1
Line What gets defined Description Added/Removed?
1 nothing Header line Removed in 12.7.0
2 Input_Opt%DO_ND50 Set this to T to turn on the ND50 24-hr average 3D timeseries diagnostic. This allows you to archive 24-hour time-averaged timeseries data for various quantities from a 3D region of the globe. Removed in 12.7.0
3 Input_Opt%ND50_FILE The name of the file which will contain output from the ND50 station timeseries diagnostic. This file will be in binary punch format and can be read by GAMAP. You may use date & time tokens YYYY, MM, DD, hh, mm, ss and GEOS-Chem will replace these with the appropriate values. Removed in 12.7.0
4 nothing OBSOLETE Removed in 12.7.0
5 Input_Opt%ND50_TRACERS The ND50 diagnostic quantities that you wish to save to disk. Separate each number with a space. Removed in 12.7.0
6 Input_Opt%ND50_IMIN
Input_Opt%ND50_IMAX
The indices which determine the longitude extent of the 3D region of the globe. Note that these are indices and not actual longitude values. To specify all 360 degrees of longitude, type the following:
  • For GMAO 4° x 5° grid: 1 72
  • For GMAO 2° x 2.5° grid: 1 144

Also, note you can wrap around the date line.

Removed in 12.7.0
7 Input_Opt%ND50_JMIN
Input_Opt%ND50_JMAX
The indices which determine the latitude extent of the 3D region of the globe. Note that these are indices and not actual latitude values. To specify all 180 degrees of latitude, type the following:
  • For GMAO 4° x 5° grid: 1 46
  • For GMAO 2° x 2.5° grid: 1 91
Removed in 12.7.0
8 Input_Opt%ND50_LMIN
Input_Opt%ND50_LMAX
The indices which determine the vertical extent of the 3D region of the globe. Removed in 12.7.0

--Bob Yantosca (talk) 16:50, 20 March 2018 (UTC)

ND63 diagnostic

01: %%% ND63 MENU %%%       :
02: Turn on ND63 diagnostic : F
03: Inst 3-D timeser. file  : paranox_ts.YYYYMMDD.bpch
04: Tracers to include      : 1
05: Frequency [sec]         : 7200
06: IMIN, IMAX of region    :  70  30
07: JMIN, JMAX of region    :  23  46
Line What gets defined Description Added/Removed?
1 nothing Header line Removed in 12.7.0
2 Input_Opt%DO_ND63 Set this to T to turn on the ND63 ship timeseries diagnostic. Removed in 12.7.0
3 Input_Opt%ND63_FILE Specify the name of the file which will contain output from the ND63 timeseries diagnostic. This file will be in binary punch format and can be read by GAMAP. You may use date & time tokens YYYY, MM, DD, hh, mm, ss and GEOS-Chem will replace these with the appropriate values. Removed in 12.7.0
4 Input_Opt%ND63_TRACERS Specify the ND63 diagnostic quantities that you wish to save to disk. Separate each number with a space. Removed in 12.7.0
5 Input_Opt%ND63_FREQ The frequency in seconds at which the ND63 ship diagnostics will be written to disk. Removed in 12.7.0
6 Input_Opt%ND63_IMIN
Input_Opt%ND63_IMAX
The indices which determine the longitude extent of the 3D region of the globe. Note that these are indices and not actual longitude values. To specify all 360 degrees of longitude, type the following:
  • For GMAO 4° x 5° grid: 1 72
  • For GMAO 2° x 2.5° grid: 1 144

Also, note you can wrap around the date line.

Removed in 12.7.0
7 Input_Opt%ND63_JMIN
Input_Opt%ND63_JMAX
The indices which determine the latitude extent of the 3D region of the globe. Note that these are indices and not actual latitude values. To specify all 180 degrees of latitude, type the following:
  • For GMAO 4° x 5° grid: 1 46
  • For GMAO 2° x 2.5° grid: 1 91
Removed in 12.7.0

--Bob Yantosca (talk) 19:58, 9 December 2019 (UTC)

Nested Grid Menu

NOTE: This menu controls options for the various GEOS-Chem nested grid simulations. This is an optional menu and may be omitted from input.geos if you are not concerned with these simulations.

Line numbers are not part of the input.geos file, but have been included for reference.

01: %%% NESTED GRID MENU %%%:
02: Save TPCORE BC's        : F
03: Input BCs at 2x2.5?     : F
04: Over North America?     : F
05: TPCORE NA BC directory  : BC_4x5_NA/
06: Over Europe?            : F
07: TPCORE EU BC directory  : BC_4x5_EU/
08: Over China?             : F
09: TPCORE CH BC directory  : BC_4x5_CH/
10: Over Asia?              : F
11: TPCORE AS BC directory  : BC_4x5_AS/
12: Over Custom Region?     : F
13: TPCORE BC directory     : BC_4x5/
14: BC timestep [sec]       : 10800
15: LL box of BC region     :   9  26
16: UR box of BC region     :  29  41
17: I0_W, J0_W, I0_E, J0_E  :   3   3   3   3
Line What gets defined Description Added/Removed?
1 nothing Header line Removed in 12.4.0
2 Input_Opt%LWINDO Set this to T if you wish to save out boundary conditions from a GEOS-Chem simulation, or F otherwise. Before you run at the nested-grid resolution, you must first save out boundary conditions from a global GEOS-Chem simulation (usually 2° x 2.5°). Removed in 12.4.0
3 Input_Opt%LWINDO2x25 Set this to T if you are using boundary conditions archived from a 2° x 2.5° GEOS-Chem simulation, or F otherwise. Removed in 12.4.0
4 Input_Opt%LWINDO_NA Set this to T if you wish to perform a GEOS-Chem nested grid simulation over the North American nested domain. Removed in 12.4.0
5 Input_Opt%TPBC_DIR_NA The directory path containing boundary conditions for your North American nested-grid simulation. Removed in 12.4.0
6 Input_Opt%LWINDO_EU Set this to T if you wish to perform a GEOS-Chem nested grid simulation over the European nested domain. Removed in 12.4.0
7 Input_Opt%TPBC_DIR_EU The directory path containing boundary conditions for your European nested-grid simulation. Removed in 12.4.0
8 Input_Opt%LWINDO_CH Set this to T if you wish to perform a GEOS-Chem nested grid simulation over the China/SE Asia nested domain. Removed in 12.4.0
9 Input_Opt%TPBC_DIR_CH Which is the directory path containing boundary conditions for your China/SE Asia nested-grid simulation. Removed in 12.4.0
10 Input_Opt%LWINDO_AS Set this T if you wish to perform a GEOS-Chem nested grid simulation over the MERRA-2 extended Asia region. Removed in 12.4.0
11 Input_Opt%TPBC_DIR_AS The directory path containing boundary conditions for your SE Asia nested-grid simulation. Removed in 12.4.0
12 Input_Opt%LWINDO_CU Set this to T if you wish to perform a GEOS-Chem nested grid simulation a domain that you have customized yourself. Removed in 12.4.0
13 Input_Opt%TPBC_DIR_CU which is the directory path containing the boundary conditions for your custom-domain nested-grid simulation. Removed in 12.4.0
14 Input_Opt%NESTED_TS Specify the frequency in seconds at which the 2° x 2.5° or 4° x 5° boundary conditions will be saved to disk. Recommended value: 10800 sec (= 3 hours). Removed in 12.4.0
15 Input_Opt%NESTED_I1
Input_Opt%NESTED_J1
These are the longitude and latitude indices of the grid box at the LOWER LEFT CORNER of the window region in which boundary conditions are being saved. Removed in 12.4.0
16 Input_Opt%NESTED_I2
Input_Opt%NESTED_J2
These are the the longitude and latitude indices of the grid box at the UPPER RIGHT CORNER of the window region in which boundary conditions are being saved. Removed in 12.4.0
17 Input_Opt%NESTED_I0W
Input_Opt%NESTED_J0W
Input_Opt%NESTED_I0E
Input_Opt%NESTED_J0E
These are the nested grid longitude and latitude offsets (in # of boxes) of the which are used to define an inner window region in which transport is actually done. The region in which transport is done in the window is smaller than the actual size of them nested grid met fields in order to account for the boundary conditions. Please see the comments to the source code file tpcore_bc_mod.F for more information.

Recommended values:

  • Input_Opt%NESTED_I0W=3 and Input_Opt%NESTED_J0W=3.
  • Input_Opt%NESTED_I0E=3 and Input_Opt%NESTED_J0E=3.
    • But for some grids (e.g. SE Asia) you may want to use Input_Opt%NESTED_I0E=2 and Input_Opt%NESTED_J0E=2.

For more information, please contact the Nested Model Working Group.

Removed in 12.4.0

--Bob Yantosca (talk) 21:14, 9 December 2019 (UTC)

Prod and Loss diagnostic (binary punch format)

Line numbers are not part of the input.geos file, but have been included for reference.

01: %%% PROD & LOSS MENU %%%:
02: Turn on P/L (ND65) diag?: T
03: # of levels for ND65    : 72
04: Save O3 P/L (ND20)?     : F
Line What gets defined Description Added/Removed?
1 nothing Header line Removed in in 13.0.0
2 Input_Opt%DO_SAVE_PL Set this switch to T if you wish to save out chemical production for family tracers (a.k.a. the ND65 diagnostic), or F otherwise. Removed in in 13.0.0
3 Input_Opt%ND65 Specify the number of levels to save for the chemical family production & loss diagnostic.
  • If you enter 1, it will just save the surface level.
  • If you enter 20, then it will save all levels from level 1 (surface) to level 20, etc.
Removed in in 13.0.0
4 Input_Opt%DO_SAVE_O3 Set this switch to T if you wish to archive P(Ox) and L(Ox) rates from a full chemistry simulation into binary punch format, so that these rates can be used to drive a future tagged Ox simulation (a.k.a. ND20 diagnostic). Removed in in 13.0.0



Previous | Next | Getting Started with GEOS-Chem