Difference between revisions of "Main Page"

From Geos-chem
Jump to: navigation, search
(General Information about GEOS-Chem)
 
(465 intermediate revisions by 14 users not shown)
Line 1: Line 1:
<big>'''GEOS-Chem Wiki'''</big>
+
__NOTOC__
 +
{|border="1" width="925px" bordercolor="#000000" cellspacing="0" cellpadding="5"
 +
 +
|-valign="middle" height="80" bgcolor="##4494cc;" align="center"
 +
|<p><font color="#FFFFFF" size="+3">'''GEOS&#150;Chem Wiki'''</font></p>
  
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://www.as.harvard.edu 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.
+
{|border="0" width="925px" bordercolor="#FFFFFF" cellspacing="0" cellpadding="5"
  
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!
+
|-valign="top"
 +
|
  
text
+
----
  
== Code Developers' Forums ==
+
<p align="center"><big>'''GEOS-Chem Community Mission: to advance understanding of human and natural influences on the environment<br>through a comprehensive, state-of-the-science, readily accessible global model of atmospheric composition.'''</big></p>
  
These pages contain more specific information about coding issues, emissions, chemistry, met fields, version history, and other aspects of GEOS-Chem. GEOS-Chem users and developers should feel free to contribute to these pages and to initiate discussion on the various topics listed here.
+
The [http://geos-chem.org 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] and by the [https://sites.wustl.edu/acag/ Atmospheric Composition Analysis Group at Washington University].
  
=== Coding ===
+
|}
* [[GEOS-Chem versions under development]]
+
* [[Machine issues & portability]]
+
* [[Floating point math issues]]
+
* [[Bugs and fixes]]
+
* [[Outstanding issues yet to be resolved]]
+
  
=== Diagnostics ===
+
{|border="1" width="925px" bordercolor="#000000" cellspacing="0" cellpadding="5"
* [http://acmg.seas.harvard.edu/geos/doc/man/appendix_5.html Overview of diagnostics characteristics]
+
* [[Mass Flux (ND24/25/26)]]
+
* [[Additional diagnostics]]
+
  
=== Emissions ===
+
|-valign="top"
* [[Overview]]
+
|colspan="3" align="center" bgcolor="#CCCCCC"|'''<font size="+2">[[GEOS-Chem overview]]</font>'''
* [[Aircraft emissions]]
+
|-valign="top"
* [[Anthropogenic emissions]]
+
|width="225px" align="center"|<font size="+2">[[GEOS-Chem versions|Past releases]]</font>
** [http://acmg.seas.harvard.edu/geos/word_pdf_docs/emissions_v8_02_03.pdf Description of anthropogenic emissions inventories in GEOS-Chem v8-02-03]
+
|width="450px" align="center" bgcolor="#CCFFFF"|<font size="+2">[[GEOS-Chem 13.4.1|'''Current release: GEOS-Chem 13.4.1''']]</font>
** [http://wiki.seas.harvard.edu/geos-chem/images/Anth_emiss_gc_v8-01-04.pdf Description of anthropogenic emissions inventories in GEOS-Chem v8-01-04]
+
|width="225px" align="center"|<font size="+2">[[GEOS-Chem model development_priorities|Future releases]]</font>
** [http://acmg.seas.harvard.edu/geos/word_pdf_docs/INVENTORY_GC_public-pre_v8.pdf Table of available anthropogenic emissions inventories for use w/ GEOS-Chem (pre-v8)]
+
* [[Biofuel emissions]]
+
* [[Biogenic emissions]]
+
* [[Biomass burning emissions]]
+
* [[Lightning NOx emissions]]
+
  
=== Chemistry ===
+
|}
* [[Chemistry Issues]]
+
* [[NOx-Ox-HC-aerosol|NOx-Ox-hydrocarbon-aerosol (aka "full-chemistry") simulation]]
+
* [[Photolysis mechanism]]
+
* [[Mercury|Mercury simulation]]
+
* [[Tagged CO simulation]]
+
* [[KPP solvers FAQ]]
+
* [[Isoprene]]
+
  
=== Aerosols ===
+
== News ==
* [[Aerosols overview: projects and developments]]
+
*'''19 May 2022:''' [[GEOS-Chem 13.4.1]] is now available!
* [[Aerosol-only simulation]]
+
*'''24 Feb 2022:''' Read the [[Media:GEOS-Chem_Newsletter_2022_Issue_1.pdf|GEOS-Chem Newsletter 2022, Issue #1]]
* [[Aerosol thermodynamical equilibrium]]
+
*'''11 Dec 2020:''' A [https://scholar.google.com/citations?user=ho-sNj4AAAAJ GEOS-Chem Google Scholar page] is now available!
* [[Secondary organic aerosols]]
+
**Click 'Follow' to be notified of new publications.
* [[Sea salt aerosols]]
+
**Contact [mailto:gxl642@student.bham.ac.uk Gongda Lu] with issues or questions.
* [[Sulfate aerosols]]
+
*'''02 Apr 2020:''' The GEOS-Chem Youtube Channel has 100+ subscribers and a new URL: <tt>'''https://youtube.com/c/geoschem'''</tt>
 +
*'''03 Feb 2020:''' View our GEOS-Chem "dry-run" tutorial at our [http://youtube.geos-chem.org GEOS-Chem Youtube channel]
 +
*'''17 Sep 2019:''' NASA/GMAO is now producing [https://gmao.gsfc.nasa.gov/weather_prediction/GEOS-CF/ GEOS chemical forecasts (GEOS-CF)] using GEOS-Chem coupled to the NASA/GEOS ESM
  
=== Met Fields ===
+
For access to all past GEOS-Chem newsletters, visit [[GEOS-Chem newsletters|this page]].
* [[GCAP]]
+
* GMAO GEOS-5
+
** [[List of GEOS-5 met fields]]
+
** [[GEOS-5 issues]]
+
** [[GEOS-5 met field reprocessing]]
+
* [http://acmg.seas.harvard.edu/geos/doc/man/appendix_4.html GEOS-Chem Met Fields (from website)]
+
** [[Notes regarding GEOS vertical grids]]
+
  
=== Nested Grid Simulations ===
+
== Documentation ==
* [[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]
+
  
=== Earth System Model Framework ===
+
=== GEOS-Chem manuals and tutorials ===
* [[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]
+
  
=== Related Projects ===
+
The table below lists the various manual pages for GEOS-Chem and its related software packages.
* [[GEOS-Chem column code]]
+
* [[GEOS-Chem Adjoint]]
+
* [[GEOS-Chem Near-Real-Time Simulations]]
+
  
== Data Visualization and Analysis ==
+
{| border=1 cellpadding=5 cellspacing=0
  
=== IDL ===
+
|-valign="top"
* [http://www.ittvis.com/ ITT Visualization (vendor)]
+
!width="200px" bgcolor="#CCCCCC"|Item
* [http://idlastro.gsfc.nasa.gov/idl_html_help/Structures.html Structures in IDL]
+
!width="360px" bgcolor="#CCCCCC"|Link
* [http://idlastro.gsfc.nasa.gov/idl_html_help/Pointers.html Pointers in IDL]
+
!width="375px" bgcolor="#CCCCCC"|Description
* [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]]
+
  
=== GAMAP ===
+
|-valign="top"
* [http://acmg.seas.harvard.edu/gamap/ GAMAP web page]
+
|'''GEOS-Chem Classic'''
* [http://acmg.seas.harvard.edu/gamap/doc/ GAMAP on-line users' guide]
+
|[[Getting Started with GEOS-Chem]] (wiki page)
* [[GAMAP bugs and fixes]]
+
*NOTE: In the process of being ported to<br>[https://geos-chem.readthedocs.io geos-chem.readthedocs.io]
* [[GAMAP tips and tricks]]
+
|GEOS-Chem single-node implementation<br>(using 1-64 computational cores)
**[[General GAMAP usage]]
+
**[[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]]
+
  
== Wiki Documentation ==
+
|-valign="top"
* [[Sandbox]]
+
|'''GCHP'''
* [http://www.mediawiki.org/wiki/Manual:FAQ MediaWiki FAQ]
+
|[https://gchp.readthedocs.io gchp.readthedocs.io]
* [http://meta.wikimedia.org/wiki/Help:Contents MediaWiki User's Guide]
+
|GEOS-Chem multi-node "high performance" implementation<br>(using 100's - 1000's of computational cores)
* [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]
+
|-valign="top"
* [http://www.mediawiki.org/wiki/Manual:Configuration_settings Configuration Settings list]
+
|'''GEOS-Chem on the cloud'''
* [http://lists.wikimedia.org/mailman/listinfo/mediawiki-announce MediaWiki release mailing list]
+
|[http://cloud.geos-chem.org cloud.geos-chem.org]
 +
|Instructions for running GEOS-Chem on the Amazon Web Services EC2 cloud-computing platform
 +
 
 +
|-valign="top"
 +
|'''WRF-GC'''
 +
|[http://wrf.geos-chem.org wrf.geos-chem.org]
 +
[https://wrfgc.readthedocs.io wrfgc.readthedocs.io]
 +
|GEOS-Chem coupled to the WRF weather model
 +
 
 +
|-valign="top"
 +
|'''HEMCO'''
 +
|[https://hemco.readthedocs.io hemco.readthedocs.io]
 +
|The Harmonized Emissions Component
 +
 
 +
|-valign="top"
 +
|'''GCPy'''
 +
|[https://gcpy.readthedocs.io gcpy.readthedocs.io]
 +
|The GEOS-Chem Python Toolkit
 +
 
 +
|-valign="top"
 +
|'''KPP-for-GEOS-Chem'''
 +
|[https://kpp.readthedocs.io kpp.readthedocs.io]
 +
|The Kinetic PreProcessor (KPP), customized for GEOS-Chem
 +
 
 +
|-valign="top"
 +
|'''GEOS-Chem Adjoint'''
 +
|[[GEOS-Chem Adjoint]] (wiki page)
 +
|The GEOS-Chem adjoint model<br> (NOTE: maintained separately from GEOS-Chem)
 +
 
 +
|-valign="top"
 +
|'''GEOS-Chem Videos'''
 +
|[https://youtube.com/c/geos-chem youtube.com/c/geos-chem]
 +
|Tutorial videos for GEOS-Chem, GCHP, HEMCO, GCPy, etc., and recordings of GEOS-Chem meeting sessions
 +
 
 +
|-valign="top"
 +
|'''GEOS-Chem Guides'''
 +
|[[GEOS-Chem overview#GEOS-Chem Guides|GEOS-Chem Guides]] (wiki page)
 +
|Short manuals giving a deeper dive into various GEOS-Chem topics (such as compilers, netCDF, diagnostics, etc.)
 +
 
 +
|}
 +
 
 +
=== General information about GEOS-Chem ===
 +
 
 +
The table below lists where you can find general information about GEOS-Chem.
 +
 
 +
{| border=1 cellpadding=5 cellspacing=0
 +
 
 +
|-valign="top"
 +
!width="200px" bgcolor="#CCCCCC"|Item
 +
!width="360px" bgcolor="#CCCCCC"|Link
 +
!width="365px" bgcolor="#CCCCCC"|Description
 +
 
 +
|-valign="top"
 +
|'''GEOS-Chem website'''
 +
|[http://www.geos-chem.org geos-chem.org]
 +
|Website that links to GEOS-Chem information and resources
 +
 
 +
|-valign="top"
 +
|'''Welcome Letter'''
 +
|[[GEOS-Chem welcome letter for new users]] (wiki page)
 +
|A welcome letter for new users of GEOS-Chem
 +
 
 +
|-valign="top"
 +
|'''GEOS-Chem Overview'''
 +
|[[GEOS-Chem overview]] (wiki page)
 +
|A page with linking to many GEOS-Chem topics.
 +
 
 +
|-valign="top"
 +
|'''GEOS-Chem Narrative'''
 +
|[https://geos-chem.seas.harvard.edu/geos-chem-narrative geos-chem.seas.harvard.edu/geos-chem-narrative]
 +
|A narrative descrption of GEOS-Chem that you can include in scientific papers (plus instructions for citing GEOS-Chem)
 +
 
 +
|-valign="top"
 +
|'''GEOS-Chem New Developments'''
 +
|[https://geos-chem.seas.harvard.edu/geos-new-developments geos-chem.seas.harvard.edu/geos-new-developments]
 +
|A list of significant GEOS-Chem updates and the developers who worked on them
 +
 
 +
|-valign="top"
 +
|'''GEOS-Chem Steering Committee (GCSC)'''
 +
|[http://geos-chem.seas.harvard.edu/geos-steering-cmte geos-chem.seas.harvard.edu/geos-steering-cmte]
 +
|A listing of current GCSC members and minutes from GCSC meetings
 +
 
 +
|-valign="top"
 +
|'''GEOS-Chem Working Groups'''
 +
|[https://geos-chem.seas.harvard.edu/geos-working-groups geos-chem.seas.harvard.edu/geos-working-groups]  
 +
|A listing of GEOS-Chem Working Groups and Working Group Co-Chairs
 +
 
 +
|-valign="top"
 +
|'''GEOS-Chem Versions'''
 +
|[[GEOS-Chem versions]] (wiki page)
 +
|A listing of GEOS-Chem versions (with links for more information)
 +
 
 +
|-valign="top"
 +
|'''GEOS-Chem Species List'''
 +
|[[Guide to species in GEOS-Chem]] (wiki page)
 +
|A listing of the species used in the GEOS-Chem chemistry mechanisms
 +
 
 +
|-valign="top"
 +
|'''Requesting Support'''
 +
|[[Submitting GEOS-Chem support requests]] (wiki page)
 +
|Instructions for creating GEOS-Chem support requests using the Github issue trackers
 +
 
 +
|-valign="top"
 +
|'''Submitting code or data'''
 +
|[[Submitting updates for inclusion in GEOS-Chem]] (wiki page)
 +
|Instructions for submitting new source code or data updates to be included into GEOS-Chem.
 +
 
 +
|}

Latest revision as of 17:15, 21 June 2022

GEOS–Chem Wiki


GEOS-Chem Community Mission: to advance understanding of human and natural influences on the environment
through a comprehensive, state-of-the-science, readily accessible global model of atmospheric composition.

The 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 NASA Global Modeling and Assimilation Office. It is applied by research groups around the world to a wide range of atmospheric composition problems. Central management and support of the model is provided by the Atmospheric Chemistry Modeling Group at Harvard University and by the Atmospheric Composition Analysis Group at Washington University.

GEOS-Chem overview
Past releases Current release: GEOS-Chem 13.4.1 Future releases

News

For access to all past GEOS-Chem newsletters, visit this page.

Documentation

GEOS-Chem manuals and tutorials

The table below lists the various manual pages for GEOS-Chem and its related software packages.

Item Link Description
GEOS-Chem Classic Getting Started with GEOS-Chem (wiki page) GEOS-Chem single-node implementation
(using 1-64 computational cores)
GCHP gchp.readthedocs.io GEOS-Chem multi-node "high performance" implementation
(using 100's - 1000's of computational cores)
GEOS-Chem on the cloud cloud.geos-chem.org Instructions for running GEOS-Chem on the Amazon Web Services EC2 cloud-computing platform
WRF-GC wrf.geos-chem.org

wrfgc.readthedocs.io

GEOS-Chem coupled to the WRF weather model
HEMCO hemco.readthedocs.io The Harmonized Emissions Component
GCPy gcpy.readthedocs.io The GEOS-Chem Python Toolkit
KPP-for-GEOS-Chem kpp.readthedocs.io The Kinetic PreProcessor (KPP), customized for GEOS-Chem
GEOS-Chem Adjoint GEOS-Chem Adjoint (wiki page) The GEOS-Chem adjoint model
(NOTE: maintained separately from GEOS-Chem)
GEOS-Chem Videos youtube.com/c/geos-chem Tutorial videos for GEOS-Chem, GCHP, HEMCO, GCPy, etc., and recordings of GEOS-Chem meeting sessions
GEOS-Chem Guides GEOS-Chem Guides (wiki page) Short manuals giving a deeper dive into various GEOS-Chem topics (such as compilers, netCDF, diagnostics, etc.)

General information about GEOS-Chem

The table below lists where you can find general information about GEOS-Chem.

Item Link Description
GEOS-Chem website geos-chem.org Website that links to GEOS-Chem information and resources
Welcome Letter GEOS-Chem welcome letter for new users (wiki page) A welcome letter for new users of GEOS-Chem
GEOS-Chem Overview GEOS-Chem overview (wiki page) A page with linking to many GEOS-Chem topics.
GEOS-Chem Narrative geos-chem.seas.harvard.edu/geos-chem-narrative A narrative descrption of GEOS-Chem that you can include in scientific papers (plus instructions for citing GEOS-Chem)
GEOS-Chem New Developments geos-chem.seas.harvard.edu/geos-new-developments A list of significant GEOS-Chem updates and the developers who worked on them
GEOS-Chem Steering Committee (GCSC) geos-chem.seas.harvard.edu/geos-steering-cmte A listing of current GCSC members and minutes from GCSC meetings
GEOS-Chem Working Groups geos-chem.seas.harvard.edu/geos-working-groups A listing of GEOS-Chem Working Groups and Working Group Co-Chairs
GEOS-Chem Versions GEOS-Chem versions (wiki page) A listing of GEOS-Chem versions (with links for more information)
GEOS-Chem Species List Guide to species in GEOS-Chem (wiki page) A listing of the species used in the GEOS-Chem chemistry mechanisms
Requesting Support Submitting GEOS-Chem support requests (wiki page) Instructions for creating GEOS-Chem support requests using the Github issue trackers
Submitting code or data Submitting updates for inclusion in GEOS-Chem (wiki page) Instructions for submitting new source code or data updates to be included into GEOS-Chem.