Difference between revisions of "Sandbox"

From Geos-chem
Jump to: navigation, search
 
(70 intermediate revisions by 2 users not shown)
Line 1: Line 1:
== feel free to experiment here ==
+
== Instructions for adding tracers to GEOS-Chem ==
  
{|border="1" width="1000px" bordercolor="#000000" cellspacing="0" cellpadding="5" align="center"
+
'''''By [mailto:mpayer@seas.harvard.edu Melissa Payer]'''''
  
|-valign="middle" height="80" bgcolor="#0099FF" align="center"
+
These instructions describe how to add advected tracers to GEOS-Chem.  Advected tracers are carried in the <tt>STT</tt> array (which is declared in <tt>GeosCore/tracer_mod.F</tt>), and are transported by the winds. 
|<p><font color="#FFFFFF" size="+3">'''GEOS&#150;Chem Wiki'''</font></p>
+
  
|}
+
NOTE: Some advected tracers are also chemical species, which comprise GEOS-Chem's NOx-Ox-HC-aerosol chemistry mechanism.
  
{|border="0" width="1000px" bordercolor="#FFFFFF" cellspacing="0" cellpadding="5" align="center"
+
#<p>Add tracers to input.geos under Tracer Menu</p>
 +
##<p>Increase “Number of tracers” accordingly</p>
 +
##<p>Add tracer number, name, molecular weight, and emitted species to end of tracer list</p>
 +
#<p>Add tracer(s) to restart file – see separate instructions</p>
 +
#<p>Modify the following source code routines:</p>
 +
##<p><tt>Headers/CMN_SIZE_mod.F</tt></p>
 +
###<p>Increase <tt>NNPAR</tt> by number of tracers being added</p>
 +
###<p>If the species have anthropogenic emissions, increase NEMPARA accordingly</p>
 +
###<p>If the species have biogenic emissions, increase NEMPARB accordingly</p>
 +
###<p>If the species have biomass burning emissions, increase NBIOMAX accordingly</p>
 +
##<p><tt>GeosCore/tracerid_mod.F</tt></p>
 +
###<p>Increase <tt>NNNTRID</tt> by the number of tracers being added NOTE: <tt>NNNTRID</tt> must be equal to <tt>NNPAR</tt> in <tt>CMN_SIZE_mod.F</tt></p>
 +
###<p>Define tracer IDs as needed:</p>
 +
####<p>IDxxxx – ID for SMVGEAR species</p>
 +
####<p>IDTxxxx – GEOS-Chem tracer ID</p>
 +
####<p>IDExxxx – GEOS-Chem emission ID</p>
 +
####<p>IDBFxxxx – GEOS-Chem biofuel ID</p>
 +
####<p>IDBxxxx – GEOS-Chem biomass ID</p>
 +
###<p>In subroutine <tt>TRACERID</tt>,</p>
 +
####<p>Under “Assign tracer, biomass, biofuel, and anthro emission ID’s,” add case for added tracers to initialize IDTxxxx, IDBFxxxx, IDBxxxx</p>
 +
####<p>Under “Initialize the IDExxx flags,” add IF statement for added tracer IDs and initialize IDExxxx</p>
 +
####<p>Under “Fill IDEMS with appropriate tracer ID #’s,” add IF statement for added tracers</p>
 +
####<p>Under “Print additional information,” add WRITE statements for added tracers</p>
 +
###<p>In subroutine SETTRACE  (NOTE: Only do the following if species is included in SMVGEAR chemical mechanism<p>
 +
####<p>Add IF statement, to initialize IDxxxx</p>
 +
####<p>In subroutine INIT_TRACERID,</p>
 +
####<p>Zero all IDs added (IDxxxx, IDTxxxx, IDExxxx, etc.)</p>
 +
##<p>Other modules that may need to be updated include:</p>
 +
###<p>wetscav_mod.F</p>
 +
###<p>drydep_mod.F</p>
 +
###<p>emissions_mod.F</p>
 +
###<p>biomass_mod.F</p>
 +
###<p>biofuel_mod.F</p> etc.
  
|-valign="top"
 
|
 
The [http://acmg.seas.harvard.edu/geos/ GEOS–Chem model] is a global 3-D model of atmospheric composition driven by assimilated meteorological observations from the Goddard Earth Observing System (GEOS) of the [http://gmao.gsfc.nasa.gov/ NASA Global Modeling and Assimilation Office]. It is applied by [http://acmg.seas.harvard.edu/geos/geos_people.html research groups around the world] to a wide range of atmospheric composition problems, Central management and support of the model is provided by the [http://acmg.seas.harvard.edu/index.html Atmospheric Chemistry Modeling Group at Harvard University.]
 
  
This wiki is meant to facilitate communication between GEOS-Chem users and developers. If this is '''your first time here''', check out [[Features of the GEOS-Chem public wiki|the features page]]. If you would like to contribute to the wiki, please register as a user by clicking ''create account'' at the top right corner of this page.
 
  
New information is continually being added to the wiki, so please check back here often, or even better, [[Features_of_the_GEOS-Chem_public_wiki#Let_the_GEOS-Chem_wiki_inform_you_of_recent_changes.21|subscribe to the recent changes' RSS feed]]: you will not miss a discussion!
+
Instructions for adding species to GEOS-Chem
  
|}
+
Modify run directory files
  
{|border="1" width="1000px" bordercolor="#000000" cellspacing="0" cellpadding="5" align="center"
+
1) Add tracers to input.geos under Tracer Menu
 +
c) Increase “Number of tracers” accordingly
 +
d) Add tracer number, name, molecular weight, and emitted species to end of tracer list
  
|-valign="top" align="center"
+
2) Add tracer(s) to restart file – see separate instructions
|width="334px"|'''Getting started w/ GEOS-Chem:'''
+
|width="333px"|'''[[GEOS-Chem welcome letter for new users|Welcome letter for new users]]'''
+
|width="333px"|'''[[GEOS-Chem basics]]'''
+
  
|-valign="top" bgcolor="#CCFFFF" align="center"
+
3) Modify globchem.dat to include additional species, kinetic reactions (including emissions and drydep), or photolysis reactions
|'''Current public release:'''
+
NOTE: If you modify globchem.dat and plan to run GEOS-Chem using the KPP chemical solver, you will need to generate new gckpp*.F90 files. For more information see the following wiki pages:
|'''[[GEOS-Chem v10-01]]'''
+
http://wiki.seas.harvard.edu/geos-chem/index.php/KPP_solvers_FAQ#What_are_the_cons_of_using_KPP.3F
|'''[[GEOS-Chem v10-01 benchmark history|v10-01 benchmark history]]'''
+
http://wiki.seas.harvard.edu/geos-chem/index.php/Interfacing_GEOS-Chem_with_KPP#Generating_KPP_input_files_from_GEOS-Chem_globchem.dat
  
|-valign="top" align="center"
+
4) If necessary, modify:
|'''Version in development:'''
+
a) ratj.d – contains species names and branching ratios for FAST–JX photolysis species
|'''[[GEOS-Chem v11-01]]'''
+
For more information: http://acmg.seas.harvard.edu/geos/doc/man/chapter_5.html#5.4.1
|'''[[GEOS-Chem v11-01 benchmark history|v11-01 benchmark history]]'''
+
b) jv_spec.dat – contains cross-sections and quantum yields for FAST–JX photolysis species
 
+
For more information: http://acmg.seas.harvard.edu/geos/doc/man/chapter_5.html#5.4.3
|-valign="top" align="center"
+
|'''Version for high-performance<br>computing (HPC) environments:'''
+
|'''[[GEOS-Chem HP]]'''
+
|'''[[GEOS-Chem HP Dev Kit]]'''
+
 
+
|-valign="top" align="center"
+
|'''List of publications:'''
+
|'''[http://acmg.seas.harvard.edu/geos/geos_pub.html Refer to this page]'''
+
|
+
 
+
|}
+
 
+
<br>
+
 
+
{|border="1" width="1000px" bordercolor="#000000" cellspacing="0" cellpadding="5" align="center"
+
 
+
|-height="50" bgcolor="#00AAAA" align="center"
+
|colspan="2"|<p><font color="#FFFFFF" size="+2">'''General information about GEOS-Chem'''</font></p>
+
 
+
|-valign="top" bgcolor="#CCCCCC"
+
!width="500px"|<big>Introduction and overview</big>
+
!width="500px"|<big>Steering Committee and working groups</big>
+
 
+
|-valign="top"
+
| <!-- Intro and overview -->
+
* [[GEOS-Chem welcome letter for new users]]
+
* [[GEOS-Chem basics]]
+
* [[Features of the GEOS-Chem public wiki]]
+
* [[Customizing your GEOS-Chem Wiki Settings]]
+
* [http://acmg.seas.harvard.edu/geos/geos_overview.html GEOS-Chem Overview]
+
* [http://acmg.seas.harvard.edu/geos/geos_people.html GEOS-Chem People & Projects]
+
* [http://acmg.seas.harvard.edu/geos/word_pdf_docs/resources_guidelines_tips.pdf User Resources, Code Development Guidelines, and Debugging Tips]
+
* [[GEOS-Chem Support Team]]
+
* [[GEOS-Chem newsletters]]
+
* [http://acmg.seas.harvard.edu/geos/geos_search.html GEOS-Chem Search Engines]
+
* [http://acmg.seas.harvard.edu/geos/geos_new_developments.html Recommendations for offering co-authorships to GEOS-Chem developers]
+
* [http://acmg.seas.harvard.edu/geos/geos_dev_history.html GEOS-Chem code development history]
+
| <!-- Steering committee etc -->
+
* [http://acmg.seas.harvard.edu/geos/geos_steering_cmte.html GEOS-Chem Steering Committee]
+
** [[GEOS-Chem model development priorities]]
+
* [http://acmg.seas.harvard.edu/geos/geos_working_groups.html GEOS-Chem Working Groups]
+
** [[GEOS-Chem Adjoint|Adjoint Model and Data Assimilation Working Group]]
+
** [[Aerosols Working Group]]
+
** [[Carbon Cycle Working Group]]
+
** [[Chemistry-Climate Working Group]]
+
** [[GEOS-Chem High Performance Working Group]]
+
** [[Hg and POPs Working Group]]
+
** [[Organics Working Group]]
+
** [[Chemistry Issues|Oxidants and Chemistry Working Group]]
+
** [[Nested Model Working Group]]
+
** [[Sources and Sinks Working Group|Sources and Surface Uptake Working Group]]
+
** [[Transport Working Group]]
+
 
+
|-valign="top" bgcolor="#CCCCCC"
+
!width="500px"|<big>Getting started with GEOS-Chem</big>
+
!width="500px"|<big>General technical information</big>
+
 
+
|-valign="top"
+
|
+
* [[Frequently asked questions about GEOS-Chem]]
+
* [[Minimum system requirements for GEOS-Chem]]
+
* [[GEOS-Chem supported platforms and compilers]]
+
* [[Downloading GEOS-Chem source code and data]]
+
* [[Creating GEOS-Chem run directories]]
+
* [[GEOS-Chem programming resources]] (e.g. tutorials, user guides, etc.)
+
* [http://acmg.seas.harvard.edu/geos/doc/man/appendix_7.html GEOS-Chem Programming Style Guide]
+
|
+
* [[Initial conditions for GEOS-Chem]]
+
* [[Centralized chemistry time step]]
+
* [[GEOS-Chem coding and debugging#GEOS-Chem debugging tips|Tips on how to debug GEOS-Chem effectively]]
+
* [[Reporting GEOS-Chem bugs]]
+
* [[Debugging with the GEOS-Chem unit tester]]
+
* [[Parallelizing GEOS-Chem]] with the OpenMP directives
+
* [[Common GEOS-Chem error messages]]
+
* [[Adding tracers to GEOS-Chem|Adding advected tracers and chemical species to GEOS-Chem]]
+
* [[Adding Passive Tracers|Adding passive (CO-like) tracers to GEOS-Chem]]
+
|}
+
 
+
<br>
+
 
+
{|border="1" width="1000px" bordercolor="#000000" cellspacing="0" cellpadding="5" align="center"
+
 
+
|-height="50" bgcolor="#00AAAA" align="center"
+
|colspan="2"|<p><font color="#FFFFFF" size="+2">'''GEOS-Chem Code Developers' Forums'''</font></p>
+
 
+
|-valign="top" bgcolor="#CCCCCC"
+
!width="500px"|<big>Coding</big>
+
!width="500px"|<big>Diagnostics</big>
+
 
+
|-valign="top"
+
| <!-- Coding -->
+
* [[GEOS-Chem versions under development]]
+
* [[Bugs and fixes|List of GEOS-Chem bugs and in which version they were resolved]]
+
* [[Currently unresolved issues in GEOS-Chem]]
+
* [[Common GEOS-Chem error messages]]
+
* [[Known issues caused by compiler bugs|Known GEOS-Chem issues caused by compiler bugs]]
+
* [[GEOS-Chem performance]]
+
* [[Machine issues and portability]]
+
* [[Passing array arguments efficiently in GEOS-Chem]]
+
* [[Floating point math issues]]
+
* [[Version control with Git]]
+
| <!-- Diagnostics -->
+
* [http://acmg.seas.harvard.edu/geos/doc/man/appendix_5.html Overview of diagnostics characteristics]
+
* [[Diagnostic time step]]
+
* [[Mass Flux (ND24/25/26)]]
+
* [[Additional diagnostics]]
+
 
+
|-valign="top" bgcolor="#CCCCCC"
+
!width="500px"|<big>Emissions</big>
+
!width="500px"|<big><Chemistry/big>
+
 
+
|-valign="top"
+
|
+
 
+
|
+
 
+
|-valign="top" bgcolor="#CCCCCC"
+
!width="500px"|<big></big>
+
!width="500px"|<big></big>
+
 
+
|-valign="top"
+
| <!-- Intro and overview -->
+
 
+
| <!-- Steering committee etc -->
+
 
+
 
+
|-valign="top" bgcolor="#CCCCCC"
+
!width="500px"|<big></big>
+
!width="500px"|<big></big>
+
 
+
|-valign="top"
+
|<!-- Emissions -->
+
* [[HEMCO|HEMCO emissions component]]
+
* [[HEMCO data directories]]
+
* [[Aerosol emissions]]
+
* [[Aircraft emissions]]
+
* [[Anthropogenic emissions]]
+
* [[Scale factors for anthropogenic emissions]]
+
* [[Biofuel emissions]]
+
* [[Biogenic emissions]]
+
* [[Biomass burning emissions]]
+
* [[Lightning NOx emissions]]
+
* [[Ship emissions]]
+
* [[Soil NOx emissions]]
+
* [[Volcanic SO2 emissions from Aerocom|Volcanic emissions]]
+
* [[Historical and Future Emissions|Historical and future emissions]]
+
|<!-- Chemistry -->
+
* [[GEOS-Chem chemistry mechanisms]]
+
* [[GEOS-Chem chemistry mechanisms#Stratospheric chemistry|Stratopsheric chemistry options]]
+
* [[GEOS-Chem chemistry mechanisms#Specialty simulations|Specialty simulations (aka "offline simulations")]]
+
* Other resources
+
** [[Chemistry Issues]]
+
** [[Process Analysis Diagnostics]]
+
** [[Photolysis mechanism|Photolysis mechanisms used in GEOS-Chem]]
+
** [[DSMACC chemical box model]]
+
** [[Isoprene|List of recent papers about isoprene]]
+
** [[Linking GEOS-Chem to CMAQ]]
+
** [[Coupling GEOS-Chem with RRTMG]]
+
*[[GEOS-Chem species database]] <span style="color:red">'''(NEW in [[GEOS-Chem v11-01|v11-01]]!)'''</span>
+
*[[Physical properties of GEOS-Chem species]] <span style="color:red">'''(NEW in [[GEOS-Chem v11-01|v11-01]]!)'''</span>
+
*[[Species_indexing_in_GEOS-Chem|Species and tracer indexing in GEOS-Chem]] <span style="color:red">'''(NEW in [[GEOS-Chem v11-01|v11-01]]!)'''</span>
+
 
+
|-valign="top" bgcolor="#CCCCCC"
+
!width="500px"|<big></big>
+
!width="500px"|<big></big>
+
 
+
|-valign="top"
+
| <!-- Intro and overview -->
+
 
+
| <!-- Steering committee etc -->
+
 
+
 
+
|-valign="top" bgcolor="#CCCCCC"
+
!width="500px"|<big></big>
+
!width="500px"|<big></big>
+
 
+
|-valign="top"
+
|
+
 
+
|
+
 
+
|-valign="top" bgcolor="#CCCCCC"
+
!width="500px"|<big></big>
+
!width="500px"|<big></big>
+
 
+
|-valign="top"
+
| <!-- Intro and overview -->
+
 
+
| <!-- Steering committee etc -->
+
 
+
 
+
|-valign="top" bgcolor="#CCCCCC"
+
!width="500px"|<big></big>
+
!width="500px"|<big></big>
+
 
+
|-valign="top"
+
|
+
 
+
|
+
 
+
 
+
 
+
 
+
|}
+
 
+
 
+
 
+
 
+
<!-- ======================================================== -->
+
<!-- ===== CODE DEVELOPER'S FORUMS: TITLE              ===== -->
+
<!-- ======================================================== -->
+
<p>&nbsp;</p>
+
<table width="100%" border="1" bordercolor="#000000" cellspacing="0" cellpadding="5" align="center">
+
 
+
 
+
 
+
 
+
</tr>
+
 
+
<!-- ======================================================== -->
+
<!-- ===== CODE DEVELOPER'S FORUMS : SECOND ROW        ===== -->
+
<!-- ======================================================== -->
+
 
+
<!-- Header title -->
+
<tr bgcolor="#cccccc">
+
<th width="50%"scope="col"><big>Emissions</big></th>
+
<th width="50%"scope="col"><big>Chemistry</big></th>
+
</tr>
+
 
+
<tr>
+
 
+
<!-- Emissions: Links -->
+
<td width="50%" valign="top">
+
 
+
</td>
+
 
+
<!-- Chemistry Links -->
+
<td width="50%" valign="top">
+
 
+
</tr>
+
 
+
<!-- ======================================================== -->
+
<!-- ===== CODE DEVELOPER'S FORUMS : THIRD ROW        ===== -->
+
<!-- ======================================================== -->
+
 
+
<!-- Header title -->
+
<tr bgcolor="#cccccc">
+
<th width="50%"scope="col"><big>Dynamics</big></th>
+
<th width="50%"scope="col"><big>Deposition</big></th>
+
</tr>
+
 
+
<tr>
+
 
+
<!-- Dynamics: Links -->
+
<td width="50%" valign="top">
+
* [[Advection scheme TPCORE]]
+
* [[Boundary layer mixing]]
+
* [[Cloud convection]]
+
* [[Dynamic tropopause]]
+
</td>
+
 
+
<!-- Deposition: Links -->
+
<td width="50%" valign="top">
+
* [[Dry deposition]]
+
**[[Leaf area indices in GEOS-Chem]]
+
* [[Wet deposition]]
+
</td>
+
 
+
</tr>
+
 
+
<!-- ======================================================== -->
+
<!-- ===== CODE DEVELOPER'S FORUMS : FOURTH ROW        ===== -->
+
<!-- ======================================================== -->
+
 
+
<!-- Header title -->
+
<tr bgcolor="#cccccc">
+
<th width="50%"scope="col"><big>Aerosols</big></th>
+
<th width="50%"scope="col"><big>Met Fields</big></th>
+
</tr>
+
 
+
<tr>
+
 
+
<!-- Aerosols: Links -->
+
<td width="50%" valign="top">
+
* [[Aerosols overview: projects and developments|Aerosols working group]]
+
* [[Aerosol-only simulation]]
+
* [[Aerosol optical properties]]
+
* [[Aerosol thermodynamical equilibrium]]
+
* [[Carbonaceous aerosols]]
+
* [[Mineral dust aerosols]]
+
* [[Secondary organic aerosols]]
+
* [[Sea salt aerosols]]
+
* [[Sulfate aerosols]]
+
* Aerosol Microphysics
+
** [[APM aerosol microphysics|APM]]
+
** [[TOMAS aerosol microphysics|TOMAS]]
+
</td>
+
 
+
<!-- Met Fields: Links -->
+
<td width="50%" valign="top">
+
* [[GCAP]]
+
** [[List of GCAP met fields|List of GCAP met fields used by GEOS-Chem]]
+
* [[Overview of GMAO met data products]]
+
* [[Version history of GMAO met data products]]
+
* [[GMAO GEOS-4]]
+
** [[List of GEOS-4 met fields|List of GEOS-4 met fields used by GEOS-Chem]]
+
* [[GEOS-5|GMAO GEOS-5.2.0]]
+
** [[List of GEOS-5 met fields|List of GEOS-5.2.0 met fields used by GEOS-Chem]]
+
** [[GEOS-5 issues|Issues with GEOS-5.2.0 met data]]
+
* [[MERRA|GMAO MERRA "reanalysis"]]
+
** [[List of MERRA met fields|List of MERRA met fields used by GEOS-Chem]]
+
** [[MERRA implementation details|Implementing MERRA into GEOS-Chem]]
+
* [[GEOS-FP|GMAO GEOS-FP]]
+
** [[List of GEOS-FP met fields|List of GEOS-FP met fields used by GEOS-Chem]]
+
** [[GEOS-FP implementation details|Implementing GEOS-FP into GEOS-Chem]]
+
* [[MERRA-2|GMAO MERRA-2]]
+
** [[List of MERRA-2 met fields|List of MERRA-2 met fields used by GEOS-Chem]]
+
** [[MERRA-2 implementation details|Implementing MERRA-2 into GEOS-Chem]]
+
* [[Notes regarding GEOS vertical grids]]
+
* [[Available met data for nested grid simulations]]
+
* [[List of reprocessed met fields]]
+
</td>
+
 
+
</tr>
+
 
+
<!-- ======================================================== -->
+
<!-- ===== CODE DEVELOPER'S FORUMS : FIFTH ROW          ===== -->
+
<!-- ======================================================== -->
+
<tr bgcolor="#cccccc">
+
<th width="50%"scope="col"><big>Nested Grid Simulations</big></th>
+
<th width="50%"scope="col"><big>Earth System Model Framework</big></th>
+
</tr>
+
 
+
<tr>
+
 
+
<!-- Nested Grid Simulations: Links -->
+
<td width="50%" valign="top">
+
* [[GEOS-Chem nested grid simulations]]
+
* [[Setting up GEOS-Chem nested grid simulations]]
+
* [[Available met data for nested grid simulations]]
+
* [http://acmg.seas.harvard.edu/geos/wiki_docs/nested_grids/geos_data_downloads.pdf Protocol for nested-grid data downloads]
+
* [[Steps to setup new nested domains]]
+
* [[GEOS-Chem nested model publications]]
+
</td>
+
 
+
<!-- Libraries -->
+
<td width="50%" valign="top">
+
* [[Installing ESMF and other required libraries]]
+
* [[Code development with the Earth System Model Framework]]
+
* [[Automatic documentation with protex|Generating automatic LaTeX documentation with protex]]
+
** [http://frodo.elon.edu/tutorial/tutorial/tutorial.html Web-based LaTeX tutorial]
+
</td>
+
 
+
</tr>
+
 
+
<!-- ======================================================== -->
+
<!-- ===== CODE DEVELOPER'S FORUMS : SIXTH ROW          ===== -->
+
<!-- ======================================================== -->
+
<tr bgcolor="#cccccc">
+
<th width="50%"scope="col"><big>Benchmarking and Evaluation</big></th>
+
<th width="50%"scope="col"><big>Related Projects</big></th>
+
</tr>
+
 
+
<tr>
+
 
+
<!-- Diagnostics: Links -->
+
<td width="50%" valign="top">
+
* [http://acmg.seas.harvard.edu/geos/geos_benchmark.html General info about GEOS-Chem benchmark simulations]
+
* [http://acmg.seas.harvard.edu/geos/geos_1yr_plots.html List of GEOS-Chem 1-year benchmark simulations]
+
* [[Mean OH lifetime in GEOS-Chem]]
+
* [ftp://ftp.as.harvard.edu/gcgrid/geos-chem/1yr_benchmarks/ FTP site with output from 1-year GEOS-Chem benchmark simulations]
+
* [[GEOS-Chem participation in community intercomparisons]]
+
* [[Satellite_Specifications_Table|Satellite Instrument Specifications Table]]
+
</td>
+
 
+
<!-- Related Projects: Links -->
+
<td width="50%" valign="top">
+
* [[Grid-independent GEOS-Chem]]
+
* [[GEOS-Chem Adjoint]]
+
* [[GEOS-Chem Near-Real-Time Simulations]]
+
* [[FlexAOD]]
+
</td>
+
 
+
</tr>
+
</table>
+
 
+
<!-- ======================================================== -->
+
<!-- ===== REFERENCE: TITLE                            ===== -->
+
<!-- ======================================================== -->
+
<p>&nbsp;</p>
+
<table width="100%" border="1" bordercolor="#000000" cellspacing="0" cellpadding="5" align="center">
+
 
+
<tr bgcolor="#00AAAA">
+
<th colspan="2" height="50" valign="middle"><p><font color="#FFFFFF" size="+2">Reference Section</font></p></th>
+
</tr>
+
 
+
<!-- ======================================================== -->
+
<!-- ===== REFERENCE: FIRST ROW                        ===== -->
+
<!-- ======================================================== -->
+
<tr bgcolor="#cccccc">
+
<th width="50%"scope="col"><big>IDL</big></th>
+
<th width="50%"scope="col"><big>GAMAP</big></th>
+
</tr>
+
 
+
<tr>
+
 
+
<!-- IDL: Links -->
+
<td width="50%" valign="top">
+
* [http://www.exelisvis.com/ Exelis Visual Information Solutions (vendor)]
+
* [http://www.exelisvis.com/docs/routines-1.html Online IDL Reference Manual @ Exelis website]
+
* [http://idlastro.gsfc.nasa.gov/idl_html_help/Structures.html Structures in IDL]
+
* [http://idlastro.gsfc.nasa.gov/idl_html_help/Pointers.html Pointers in IDL]
+
* [http://idlastro.gsfc.nasa.gov/idl_html_help/Overview_of_Mathematics_in_IDL.html Overview of Mathematics in IDL]
+
* [http://www.dfanning.com/ Coyote's Guide to IDL Programming (David Fanning's Web Site)] - Lots of tips on how to accomplish programming tasks
+
* [http://www.mpimet.mpg.de/en/misc/software/idl IDL Page at Max Planck Institute for Meteorology]
+
* [http://www.mpimet.mpg.de/en/misc/software/idl/doc/mgs_script.pdf Martin Schultz's IDL Tutorial (PDF Format)]
+
* [http://idlastro.gsfc.nasa.gov/homepage.html IDL Astronomy User's Library]
+
* [http://fermi.jhuapl.edu/s1r/idl/idl.html JHU/APL/S1R IDL routines page]
+
* [http://cow.physics.wisc.edu/~craigm/idl/idl.html Craig Markwardt's IDL library]
+
* [http://cimss.ssec.wisc.edu/~gumley/doc/idltips.pdf The Underground Guide to IDL by Liam Gumley (PDF)]
+
* [[Reading binary files in IDL]]
+
</td>
+
 
+
<!-- Diagnostics: Links -->
+
<td width="50%" valign="top">
+
* [http://acmg.seas.harvard.edu/gamap/ GAMAP web page]
+
* [http://acmg.seas.harvard.edu/gamap/doc/ GAMAP on-line users' guide]
+
* [[GAMAP bugs and fixes]]
+
* [[GAMAP tips and tricks]]
+
**[[General GAMAP usage]]
+
**[[TVMAP cheat sheet]]
+
**[[File I/O with GAMAP]]
+
***[http://acmg.seas.harvard.edu/gamap/doc/timeseries_brief_tutorial.pdf Working with timeseries output in GAMAP]
+
**[[Color and graphics with GAMAP]]
+
*** [http://acmg.seas.harvard.edu/geos/wiki_docs/gamap/gamap_color_table_file.pdf Loading Color Tables in GAMAP v2.12]
+
*** [http://acmg.seas.harvard.edu/forum_files/cdh_ColorInIDL.pdf Working with color in IDL by Chris Holmes]
+
**[[Regridding with GAMAP]]
+
**[[Date and time computations with GAMAP]]
+
**[[Text manipulation with GAMAP]]
+
</td>
+
 
+
</tr>
+
 
+
<!-- ======================================================== -->
+
<!-- ===== REFERENCE: SECOND ROW                        ===== -->
+
<!-- ======================================================== -->
+
 
+
<!-- Header title -->
+
<tr bgcolor="#cccccc">
+
<th width="50%"scope="col"><big>Fortran</big></th>
+
<th width="50%"scope="col"><big>Perl</big></th>
+
</tr>
+
 
+
<tr>
+
 
+
<!-- Fortran: Links -->
+
<td width="50%" valign="top">
+
* [[Intel Fortran Compiler]]
+
** [http://acmg.seas.harvard.edu/geos/wiki_docs/compilers/main_for_lin_v11.pdf Version 11.1]
+
** [http://acmg.seas.harvard.edu/geos/wiki_docs/compilers/main_for_lin_v12.pdf Version 12.1]
+
** [https://nf.nci.org.au/facilities/software/intel-ct/13.2.146/Documentation/en_US/compiler_f/main_for/index.htm#GUID-81DC012F-20D6-46B1-A524-BFAC4B6F7747.htm#GUID-81DC012F-20D6-46B1-A524-BFAC4B6F7747 Version XE 13.1]
+
** [https://software.intel.com/en-us/compiler_15.0_ug_f Version 15.0]
+
* [[PGI Fortran compiler]]
+
**[http://acmg.seas.harvard.edu/geos/wiki_docs/compilers/pgiug.pdf User Guide]
+
**[http://acmg.seas.harvard.edu/geos/wiki_docs/compilers/pgifortref.pdf Reference Guide]
+
* [[GNU Fortran compiler]]
+
* [http://www-01.ibm.com/software/awdtools/fortran/xlfortran/ IBM XL Fortran]
+
* [http://docs.sun.com/app/docs/doc/819-3686 Sun Studio 11 Fortran Compiler]
+
* [http://www.liv.ac.uk/HPC/HTMLF90Course/HTMLF90CourseSlides.html Modular Programming w/ Fortran 90 (U. Liverpool)]
+
* [http://www.liv.ac.uk/HPC/F90page.html Other University of Liverpool F90 tutorials and courses]
+
* [http://sunsite.unc.edu/pub/languages/fortran/index.html User Notes on FORTRAN Programming]
+
* [http://www.nsc.liu.se/~boein/f77to90/f77to90.html Fortran 90 for the FORTRAN 77 Programmer]
+
* [http://www.kcl.ac.uk/kis/support/cc/fortran/f90home.html#1.0 Fortran 90 Home Page at King's College, London]
+
* [http://www.cs.rpi.edu/~szymansk/oof90.html Object Oriented Fortran 90 Programming]
+
</td>
+
 
+
<!-- Perl: Links  -->
+
<td width="50%" valign="top">
+
* [http://www.perl.com Perl.com]
+
* [http://www.perl.org/books/beginning-perl/ ''Beginning Perl'' by Simon Cozens (free online book)]
+
* [http://backpan.perl.org/authors/id/Q/QU/QUONG/perlin20.html Perl in 20 pages]
+
* [http://www.enginsite.com/Library-Robert%27s-Perl-Tutorial.htm MediaWiki User's Guide]
+
* [http://www.cpan.org/ Comprehensive Perl Archive Network (CPAN.org)]
+
</td>
+
 
+
</tr>
+
 
+
<!-- Header title -->
+
<tr bgcolor="#cccccc">
+
<th width="50%"scope="col"><big>R</big></th>
+
<th width="50%"scope="col"><big>Python</big></th>
+
</tr>
+
 
+
<tr>
+
 
+
<!-- R: links -->
+
<td width="50%" valign="top">
+
*[http://www.r-project.org/ The R project for statistical computing]
+
*[http://journal.r-project.org/ The R journal]
+
*[http://www.mayin.org/ajayshah/KB/R/index.html R by example]
+
*[[Using R to analyze GEOS-Chem data]]
+
</td>
+
 
+
<!-- Python: links -->
+
<td width="50%" valign="top">
+
*[[Python code for GEOS-Chem]]
+
*[http://www.python.org Python.org]: Main site for all things Python
+
*[http://docs.python.org/2/tutorial/ Python.org Tutorial]
+
*[http://wiki.python.org/moin/BeginnersGuide/Programmers PythonWiki.org: List of tutorials and resources]
+
*[https://developers.google.com/edu/python/ Google's Python tutorial]
+
</td>
+
 
+
</tr>
+
 
+
<!-- Header title -->
+
<tr bgcolor="#cccccc">
+
<th width="50%"scope="col"><big>NCAR Command Language (NCL)</big></th>
+
<th width="50%"scope="col"><big>Wiki Documentation</big></th>
+
</tr>
+
 
+
<tr>
+
 
+
<!-- Wiki Documentation: Links -->
+
<td width="50%" valign="top">
+
* [http://www.ncl.ucar.edu/ NCL main page]
+
* [http://www.ncl.ucar.edu/Applications/ NCL applications]
+
* [http://www.ncl.ucar.edu/Document/ NCL documentation]
+
* [http://www.ncl.ucar.edu/Support/email_lists.shtml Sign up for NCL-Talk email list]
+
* [[NCL_tools_for_GEOS-Chem|NCL4GC: NCL tools for GEOS-Chem]]
+
</td>
+
<td width="50%" valign="top">
+
* [[Sandbox]]
+
* [http://www.mediawiki.org/wiki/Manual:FAQ MediaWiki FAQ]
+
* [http://meta.wikimedia.org/wiki/Help:Contents MediaWiki User's Guide]
+
* [http://meta.wikimedia.org/wiki/Help:Wikitext Examples of Wiki markup text]
+
* [http://meta.wikimedia.org/wiki/Help:Reference_card One-page editing reference card]
+
* [http://www.mediawiki.org/wiki/Manual:Configuration_settings Configuration Settings list]
+
* [http://lists.wikimedia.org/mailman/listinfo/mediawiki-announce MediaWiki release mailing list]
+
</td>
+
 
+
</tr>
+
 
+
</table>
+

Latest revision as of 21:25, 10 May 2023

Instructions for adding tracers to GEOS-Chem

By Melissa Payer

These instructions describe how to add advected tracers to GEOS-Chem. Advected tracers are carried in the STT array (which is declared in GeosCore/tracer_mod.F), and are transported by the winds.

NOTE: Some advected tracers are also chemical species, which comprise GEOS-Chem's NOx-Ox-HC-aerosol chemistry mechanism.

  1. Add tracers to input.geos under Tracer Menu

    1. Increase “Number of tracers” accordingly

    2. Add tracer number, name, molecular weight, and emitted species to end of tracer list

  2. Add tracer(s) to restart file – see separate instructions

  3. Modify the following source code routines:

    1. Headers/CMN_SIZE_mod.F

      1. Increase NNPAR by number of tracers being added

      2. If the species have anthropogenic emissions, increase NEMPARA accordingly

      3. If the species have biogenic emissions, increase NEMPARB accordingly

      4. If the species have biomass burning emissions, increase NBIOMAX accordingly

    2. GeosCore/tracerid_mod.F

      1. Increase NNNTRID by the number of tracers being added NOTE: NNNTRID must be equal to NNPAR in CMN_SIZE_mod.F

      2. Define tracer IDs as needed:

        1. IDxxxx – ID for SMVGEAR species

        2. IDTxxxx – GEOS-Chem tracer ID

        3. IDExxxx – GEOS-Chem emission ID

        4. IDBFxxxx – GEOS-Chem biofuel ID

        5. IDBxxxx – GEOS-Chem biomass ID

      3. In subroutine TRACERID,

        1. Under “Assign tracer, biomass, biofuel, and anthro emission ID’s,” add case for added tracers to initialize IDTxxxx, IDBFxxxx, IDBxxxx

        2. Under “Initialize the IDExxx flags,” add IF statement for added tracer IDs and initialize IDExxxx

        3. Under “Fill IDEMS with appropriate tracer ID #’s,” add IF statement for added tracers

        4. Under “Print additional information,” add WRITE statements for added tracers

      4. In subroutine SETTRACE (NOTE: Only do the following if species is included in SMVGEAR chemical mechanism<p>

        1. <p>Add IF statement, to initialize IDxxxx

        2. In subroutine INIT_TRACERID,

        3. Zero all IDs added (IDxxxx, IDTxxxx, IDExxxx, etc.)

    3. Other modules that may need to be updated include:

      1. wetscav_mod.F

      2. drydep_mod.F

      3. emissions_mod.F

      4. biomass_mod.F

      5. biofuel_mod.F

        etc.


Instructions for adding species to GEOS-Chem

Modify run directory files

1) Add tracers to input.geos under Tracer Menu c) Increase “Number of tracers” accordingly d) Add tracer number, name, molecular weight, and emitted species to end of tracer list

2) Add tracer(s) to restart file – see separate instructions

3) Modify globchem.dat to include additional species, kinetic reactions (including emissions and drydep), or photolysis reactions NOTE: If you modify globchem.dat and plan to run GEOS-Chem using the KPP chemical solver, you will need to generate new gckpp*.F90 files. For more information see the following wiki pages: http://wiki.seas.harvard.edu/geos-chem/index.php/KPP_solvers_FAQ#What_are_the_cons_of_using_KPP.3F http://wiki.seas.harvard.edu/geos-chem/index.php/Interfacing_GEOS-Chem_with_KPP#Generating_KPP_input_files_from_GEOS-Chem_globchem.dat

4) If necessary, modify: a) ratj.d – contains species names and branching ratios for FAST–JX photolysis species For more information: http://acmg.seas.harvard.edu/geos/doc/man/chapter_5.html#5.4.1 b) jv_spec.dat – contains cross-sections and quantum yields for FAST–JX photolysis species For more information: http://acmg.seas.harvard.edu/geos/doc/man/chapter_5.html#5.4.3