Main Page: Difference between revisions

From Geos-chem
Jump to navigation Jump to search
No edit summary
(513 intermediate revisions by 14 users not shown)
Line 1: Line 1:
<!-- ======================================================== -->
__NOTOC__
<!-- ===== TOP TITLE                                    ===== -->
{|border="1" width="925px" bordercolor="#000000" cellspacing="0" cellpadding="5"
<!-- ======================================================== -->
<table width="100%" border="1" bordercolor="#000000" cellspacing="0" cellpadding=5" align="center">
|-valign="middle" height="80" bgcolor="##4494cc;" align="center"
<tr bgcolor="#FF0000">
|<p><font color="#FFFFFF" size="+3">'''GEOS&#150;Chem Wiki'''</font></p>
<th colspan="2" height="80" valign="middle"><p><font color="#FFFFFF" size="+3">GEOS&#150;Chem Wiki</font></p></th>
</tr>
</table>


<blockquote><p align="justify">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.]</p></blockquote>
|}


<blockquote><p align="justify">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.</p></blockquote>
{|border="0" width="925px" bordercolor="#FFFFFF" cellspacing="0" cellpadding="5"


<blockquote><p align="justify">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!</p></blockquote>
|-valign="top"
|


<!-- ======================================================== -->
----
<!-- ===== GENERAL INFO ABOUT GEOS-CHEM                ===== -->
<!-- ======================================================== -->
<p>&nbsp;</p>
<table width="100%" border="1" bordercolor="#000000" cellspacing="0" cellpadding="5" align="center">


<tr bgcolor="#00AAAA">
<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>
<th colspan="2" height="50" valign="middle"><p><font color="#FFFFFF" size="+2">General information about GEOS&#150;Chem</font></p></th>
</tr>


<!-- ======================================================== -->
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 [https://geoschem.github.io/geos-chem-people-projects-map/ research groups around the world] to a wide range of atmospheric composition problems. Central management and support of the model is provided by the [https://acmg.seas.harvard.edu/ Atmospheric Chemistry Modeling Group at Harvard University] and by the [https://sites.wustl.edu/acag/ Atmospheric Composition Analysis Group at Washington University].
<!-- ===== GENERAL INFO : FIRST ROW                    ===== -->
<!-- ======================================================== -->


<!-- Header title -->
|}
<tr bgcolor="#cccccc">
<th width="50%"scope="col"><big>Introduction and overview</big></th>
<th width="50%"scope="col"><big>Steering Committee And Working Groups</big></th>
</tr>


<tr>
{|border="1" width="925px" bordercolor="#000000" cellspacing="0" cellpadding="5"


<!-- Introduction & Overview: Links -->
|-valign="top"
<td width="50%" valign="top">
|colspan="3" align="center" bgcolor="#CCCCCC"|'''<font size="+2">[[GEOS-Chem overview]]</font>'''
* [[Features of the GEOS-Chem public wiki]]
|-valign="top"
* [[GEOS-Chem welcome letter for new users]]
|width="225px" align="center"|<font size="+2">[[GEOS-Chem versions|Past releases]]</font>
* [http://acmg.seas.harvard.edu/geos/geos_overview.html GEOS-Chem Overview]
|width="450px" align="center" bgcolor="#CCFFFF"|<font size="+2">[[GEOS-Chem 14.4.0|'''Current release: GEOS-Chem 14.4.0''']]</font>
* [http://acmg.seas.harvard.edu/geos/geos_people.html GEOS-Chem People & Projects]
|width="225px" align="center"|<font size="+2">[[GEOS-Chem model development_priorities|Future releases]]</font>
* [http://acmg.seas.harvard.edu/geos/word_pdf_docs/resources_guidelines_tips.pdf User Resources, Code Development Guidelines, and Debugging Tips]
* [[GEOS-Chem programming staff]]
* [[GEOS-Chem newsletters]]
</td>


<!-- Steering Committee and Working Groups: Links -->
|}
<td width="50%" valign="top">
* [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_overview:_projects_and_developments|Aerosols Working Group]]
** [[Carbon Gases and Organics Working Group]]
** [[Emissions Working Group]]
** [[Chemistry Issues|Oxidants and Chemistry Working Group]]
** [[Regional Air Quality Working Group]]
</td>


</tr>
== News ==
*31 May 2024: [[GEOS-Chem 14.4.0]] is now available!
*02 Feb 2024: Read the [https://drive.google.com/file/d/1v0cHAf6S8EMpUZNb7eVqvcRwbIAIxpRI/view?usp=sharing GEOS-Chem Newsletter 2024, Issue #1]
*A [https://scholar.google.com/citations?user=ho-sNj4AAAAJ GEOS-Chem Google Scholar page] is now available!
**Click 'Follow' to be notified of new publications.
**Contact [mailto:rebekah.horner.20@ucl.ac.uk Bex Horner] with issues or questions.
*The GEOS-Chem Youtube Channel has 350+ subscribers and a new URL: <tt>'''https://www.youtube.com/~geoschem'''</tt>
*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


<!-- ======================================================== -->
For access to all past GEOS-Chem newsletters, visit [[GEOS-Chem newsletters|this page]].
<!-- ===== GENERAL INFO : SECOND ROW                    ===== -->
<!-- ======================================================== -->


<!-- Header title -->
== Documentation ==
<tr bgcolor="#cccccc">
<th width="50%"scope="col"><big>Getting Started With GEOS-Chem</big></th>
<th width="50%"scope="col"><big>General Technical Information</big></th>
</tr>


<tr>
=== GEOS-Chem manuals and tutorials ===


<!-- Getting Started With GEOS-Chem: Links -->
Read [https://geos-chem.readthedocs.io/en/latest/geos-chem-shared-docs/supplemental-guides/related-docs.html '''user manuals'''] for GEOS-Chem 14 and related software.  Also see our [[GEOS-Chem in CESM]] wiki page for more information about running GEOS-Chem in the NCAR CESM Earth System Model.
<td width="50%" valign="top">
* [[Minimum system requirements for GEOS-Chem]]
* [[GEOS-Chem supported platforms and compilers]]
* [[Downloading GEOS-Chem source code and data]]
* [[GEOS-Chem code development cycle]]
* [[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]
* [[Running GEOS-Chem with TESTRUN]]
</td>


<!-- General Technical Information: Links -->
Also see our list of [[Software_maintained_by_GEOS-Chem_community_members|'''software tools maintained by GEOS-Chem users''']].
<td width="50%" valign="top">
* [[Initial conditions for GEOS-Chem]]
* [[GEOS-Chem Debugging Tips|Tips on how to debug GEOS-Chem effectively]]
* [[Reporting GEOS-Chem bugs]]
* [[Parallelizing GEOS-Chem]] with the OpenMP directives
* [[Common GEOS-Chem error messages]]
* [http://acmg.seas.harvard.edu/geos/geos_search.html GEOS-Chem Search Engines]
</td>


</tr>
The user manual for GEOS-Chem 13.4.1 and prior versions may be found '''[[Getting Started with GEOS-Chem|HERE]]'''.
</table>


<!-- ======================================================== -->
=== General information about GEOS-Chem ===
<!-- ===== CODE DEVELOPER'S FORUMS: TITLE              ===== -->
<!-- ======================================================== -->
<p>&nbsp;</p>
<table width="100%" border="1" bordercolor="#000000" cellspacing="0" cellpadding="5" align="center">


<tr bgcolor="#00AAAA">
The table below lists where you can find general information about GEOS-Chem.
<th colspan="2" height="50" valign="middle"><p><font color="#FFFFFF" size="+2">GEOS&#150;Chem Code Developers' Forums</font></p></th>
</tr>


<!-- ======================================================== -->
{| border=1 cellpadding=5 cellspacing=0
<!-- ===== CODE DEVELOPER'S FORUMS : FIRST ROW          ===== -->
<!-- ======================================================== -->
<tr bgcolor="#cccccc">
<th width="50%"scope="col"><big>Coding</big></th>
<th width="50%"scope="col"><big>Diagnostics</big></th>
</tr>


<tr>
|-valign="top"
!width="200px" bgcolor="#CCCCCC"|Item
!width="360px" bgcolor="#CCCCCC"|Link
!width="365px" bgcolor="#CCCCCC"|Description


<!-- Coding: Links -->
|-valign="top"
<td width="50%" valign="top">
|'''GEOS-Chem website'''
* [[GEOS-Chem versions under development]]
|[http://www.geos-chem.org geos-chem.org]
* [[Machine issues & portability]]
|Website that links to GEOS-Chem information and resources
* [[Floating point math issues]]
* [[Bugs and fixes|List of GEOS-Chem bugs and in which version they were resolved]]
</td>


<!-- Diagnostics: Links -->
|-valign="top"
<td width="50%" valign="top">
|'''Welcome Letter'''
* [http://acmg.seas.harvard.edu/geos/doc/man/appendix_5.html Overview of diagnostics characteristics]
|[http://geos-chem.org/welcome.html geos-chem.org/welcome.html]
* [[Mass Flux (ND24/25/26)]]
|A welcome letter for new users of GEOS-Chem
* [[Additional diagnostics]]
</td>


</tr>
|-valign="top"
|'''GEOS-Chem Overview'''
|[[GEOS-Chem overview]] (wiki page)
|A page with linking to many GEOS-Chem topics.


<!-- ======================================================== -->
|-valign="top"
<!-- ===== CODE DEVELOPER'S FORUMS : SECOND ROW        ===== -->
|'''GEOS-Chem Narrative'''
<!-- ======================================================== -->
|[http://geos-chem.org/narrative.html geos-chem.org/narrative.html]
|A narrative descrption of GEOS-Chem that you can include in scientific papers (plus instructions for citing GEOS-Chem)


<!-- Header title -->
|-valign="top"
<tr bgcolor="#cccccc">
|'''GEOS-Chem New Developments'''
<th width="50%"scope="col"><big>Emissions</big></th>
|[http://geos-chem.org/new-developments.html geos-chem.org/new-developments.html]
<th width="50%"scope="col"><big>Chemistry</big></th>
|A list of significant GEOS-Chem updates and the developers who worked on them
</tr>


<tr>
|-valign="top"
|'''GEOS-Chem Steering Committee (GCSC)'''
|[http://geos-chem.org/steering-committee.html geos-chem.org/steering-committee.html]
|A listing of current GCSC members and minutes from GCSC meetings


<!-- Emissions: Links -->
|-valign="top"
<td width="50%" valign="top">
|'''GEOS-Chem Working Groups'''
* [[Overview]]
|[http://geos-chem.org/working-groups geos-chem.org/working-groups.html]  
* [[Aircraft emissions]]
|A listing of GEOS-Chem Working Groups and Working Group Co-Chairs
* [[Anthropogenic emissions]]
** [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]
** [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]  
** [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]]
</td>


<!-- Chemistry Links -->
|-valign="top"
<td width="50%" valign="top">
|'''GEOS-Chem Versions'''
* [[Chemistry Issues]]
|[[GEOS-Chem versions]] (wiki page)
* [[NOx-Ox-HC-aerosol|NOx-Ox-hydrocarbon-aerosol (aka "full-chemistry") simulation]]
|A listing of GEOS-Chem versions (with links for more information)
* [[Photolysis mechanism]]
* [[Mercury|Mercury simulation]]
* [[Tagged CO simulation]]
* [[KPP solvers FAQ]]
* [[Isoprene]]
* [[Linoz stratospheric ozone chemistry]]
</td>


</tr>
|-valign="top"
|'''GEOS-Chem Species List'''
|[https://geos-chem.readthedocs.io/en/latest/geos-chem-shared-docs/supplemental-guides/species-guide.html View GEOS-Chem Species properties] (ReadTheDocs page)
|A listing of the species used in the GEOS-Chem chemistry mechanisms


<!-- ======================================================== -->
|-valign="top"
<!-- ===== CODE DEVELOPER'S FORUMS : THIRD ROW          ===== -->
|'''GEOS-Chem Guides'''
<!-- ======================================================== -->
|[[GEOS-Chem_overview#GEOS-Chem_Guides|GEOS-Chem Guides (wiki page)]]
<tr bgcolor="#cccccc">
|List of several user guides explaining topics in-depth
<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>
|-valign="top"
|'''Requesting Support'''
|[https://geos-chem.readthedocs.io/en/latest/help-and-reference/SUPPORT.html GEOS-Chem support guidelines]
|ReadTheDocs page with instructions for creating GEOS-Chem support requests using the Github issue trackers


<!-- Nested Grid Simulations: Links -->
|-valign="top"
<td width="50%" valign="top">
|'''Submitting code or data'''
* [[GEOS-Chem nested grid simulations]]
|[https://geos-chem.readthedocs.io/en/latest/help-and-reference/CONTRIBUTING.html GEOS-Chem contributing guidelines]
* [[Available met data for nested grid simulations]]
|ReadTheDocs page with instructions for submitting new source code or data updates to be included into GEOS-Chem.
** [http://acmg.seas.harvard.edu/geos/wiki_docs/nested_grids/geos_data_downloads.pdf Protocol for nested-grid data downloads]
</td>


<!-- Met Fields: Links -->
|}
<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 : FOURTH ROW        ===== -->
<!-- ======================================================== -->
<tr bgcolor="#cccccc">
<th width="50%"scope="col"><big>Related Projects</big></th>
<th width="50%"scope="col"><big></big></th>
</tr>
 
<tr>
 
<!-- Related Projects: Links -->
<td width="50%" valign="top">
* [[GEOS-Chem column code]]
* [[GEOS-Chem Adjoint]]
* [[GEOS-Chem Near-Real-Time Simulations]]
</td>
 
<!-- Diagnostics: Links -->
<td width="50%" valign="top">
 
</td>
 
</tr>
</table>
 
<!-- ======================================================== -->
<!-- ===== CODE DEVELOPER'S FORUMS: 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: Visualization, Analysis, and Wiki</font></p></th>
</tr>
 
<!-- ======================================================== -->
<!-- ===== VISUALIZATION : 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.ittvis.com/ ITT Visualization (vendor)]
* [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]]
**[[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>
 
<!-- ======================================================== -->
<!-- ===== VISUALIZATION: SECOND ROW                    ===== -->
<!-- ======================================================== -->
 
<!-- Header title -->
<tr bgcolor="#cccccc">
<th width="50%"scope="col"><big>Wiki Documentation</big></th>
<th width="50%"scope="col"><big></big></th>
</tr>
 
<tr>
 
<!-- Wiki Documentation: Links -->
<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>
 
<!-- Spaceholder-->
<td width="50%" valign="top">
 
</td>
 
</tr>
</table>

Revision as of 15:59, 24 June 2024

GEOS&#150;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 14.4.0 Future releases

News

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

Documentation

GEOS-Chem manuals and tutorials

Read user manuals for GEOS-Chem 14 and related software. Also see our GEOS-Chem in CESM wiki page for more information about running GEOS-Chem in the NCAR CESM Earth System Model.

Also see our list of software tools maintained by GEOS-Chem users.

The user manual for GEOS-Chem 13.4.1 and prior versions may be found HERE.

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.org/welcome.html 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.org/narrative.html 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.org/new-developments.html A list of significant GEOS-Chem updates and the developers who worked on them
GEOS-Chem Steering Committee (GCSC) geos-chem.org/steering-committee.html A listing of current GCSC members and minutes from GCSC meetings
GEOS-Chem Working Groups geos-chem.org/working-groups.html 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 View GEOS-Chem Species properties (ReadTheDocs page) A listing of the species used in the GEOS-Chem chemistry mechanisms
GEOS-Chem Guides GEOS-Chem Guides (wiki page) List of several user guides explaining topics in-depth
Requesting Support GEOS-Chem support guidelines ReadTheDocs page with instructions for creating GEOS-Chem support requests using the Github issue trackers
Submitting code or data GEOS-Chem contributing guidelines ReadTheDocs page with instructions for submitting new source code or data updates to be included into GEOS-Chem.