Difference between revisions of "Getting Started with GEOS-Chem"

From Geos-chem
Jump to: navigation, search
(Overview)
(48 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 
__FORCETOC__
 
__FORCETOC__
'''''[[Main Page]]'''''
+
'''''[[Main_Page|GEOS-Chem Main Page]] | [[GEOS-Chem overview#GEOS-Chem Guides|GEOS-Chem Guides]]'''''
 +
<br>
 +
----
 +
<big><strong>The majority of content in this user manual has been migrated to https://geos-chem.readthedocs.io.<br>We will preserve the user manual content for GEOS-chem users who are still working with versions 13.4 and earlier.</strong></big>
 +
----
 +
<br>
  
 
== Overview ==
 
== Overview ==
  
On this page we provide information on getting started with GEOS-Chem "classic." Please see the [[Getting Started With GCHP]] page for information on the next generation of GEOS-Chem.
+
On this page we provide information on getting started with GEOS-Chem "Classic." (Much of this content is now at [https://geos-chem.readthedocs.io '''geos-chem.readthedocs.io''']).
  
== Quick Start Guide ==
+
Please see [http://gchp.readthedocs.io '''gchp.readthedocs.io'''] page for information about how to download and run GCHP.
  
#[[GEOS-Chem overview]]
+
Please see [http://hemco.readthedocs.io '''hemco.readthedocs.io'''] page for information about how to download and run HEMCO (if you want to run HEMCO in standalone mode).
#[[Minimum system requirements for GEOS-Chem|Minimum system requirements]]
+
 
 +
== Table of contents ==
 +
 
 +
#[[Minimum system requirements for GEOS-Chem|Minimum system requirements (and software installation)]]
 +
#[[Configuring your computational environment]]
 
#[[Downloading GEOS-Chem source code|Downloading source code]]
 
#[[Downloading GEOS-Chem source code|Downloading source code]]
 
#[[Downloading GEOS-Chem data directories|Downloading data directories]]
 
#[[Downloading GEOS-Chem data directories|Downloading data directories]]
 
#[[Creating GEOS-Chem run directories|Creating run directories]]
 
#[[Creating GEOS-Chem run directories|Creating run directories]]
#[[GEOS-Chem input files|Configuring runs]]
+
#[[GEOS-Chem configuration files|Configuring runs]]
 
#[[Compiling GEOS-Chem|Compiling]]
 
#[[Compiling GEOS-Chem|Compiling]]
 
#[[Running GEOS-Chem|Running]]
 
#[[Running GEOS-Chem|Running]]
 
#[[GEOS-Chem output files|Output files]]
 
#[[GEOS-Chem output files|Output files]]
#[[Guide_to_visualization_and_analysis_tools_for_GEOS-Chem|Visualizing and processing output]]
+
#[[Python tools for use with GEOS-Chem]]
 
#[[GEOS-Chem_coding_and_debugging|Coding and debugging]]
 
#[[GEOS-Chem_coding_and_debugging|Coding and debugging]]
#[[Getting_Started_with_GEOS-Chem#Getting_help|Getting help]]
+
#[[GEOS-Chem_overview#Further_reading|Further reading]]
#[[Getting_Started_with_GEOS-Chem#Further_reading|Further reading]]
+
 
 +
== Additional resources ==
 +
* [[GEOS-Chem overview]]
 +
* [[GEOS-Chem overview#GEOS-Chem Guides|GEOS-Chem Guides]]
 +
* [http://youtube.geos-chem.org GEOS-Chem YouTube Channel &mdash; contains tutorial videos]
 +
* HEMCO user manual ([https://hemco.readthedocs.io <tt>hemco.readthedocs.io</tt>])
 +
* GCHP user manual: ([https://gchp.readthedocs.io <tt>gchp.readthedocs.io</tt>]
  
 
== Getting help ==
 
== Getting help ==
 
 
* [[Frequently asked questions about GEOS-Chem]]
 
* [[Frequently asked questions about GEOS-Chem]]
* [[Common GEOS-Chem error messages]]
+
* ''[[Guide to GEOS-Chem error messages]]''
 
* [[Bugs_and_fixes|Recent bugs and fixes]]
 
* [[Bugs_and_fixes|Recent bugs and fixes]]
* [[GEOS-Chem coding and debugging#GEOS-Chem debugging tips|Tips on how to debug GEOS-Chem effectively]]
+
* [https://geos-chem.readthedocs.io/en/latest/geos-chem-shared-docs/supplemental-guides/debug-guide.html Debugging GEOS-Chem and HEMCO errors]
 
* [[Submitting GEOS-Chem support requests]]
 
* [[Submitting GEOS-Chem support requests]]
 
== Further reading ==
 
 
=== GEOS-Chem grids ===
 
*[[FlexGrid|FlexGrid: Defining custom horizontal and vertical grids]] '''(new in 12.4.0)'''
 
*[[GEOS-Chem horizontal grids]]
 
*[[GEOS-Chem vertical grids]]
 
 
=== Meteorology fields use in GEOS-Chem ===
 
* [[Overview of GMAO met data products]]
 
**[[Version history of GMAO met data products]]
 
 
=== GEOS-Chem species ===
 
*[[Species in GEOS-Chem]]
 
 
=== GEOS-Chem components ===
 
*[[GEOS-Chem emissions|Emissions]]
 
*[[GEOS-Chem chemistry mechanisms|Chemistry]]
 
*[[Advection scheme TPCORE|Advection]]
 
*[[Boundary layer mixing]]
 
*[[Cloud convection]]
 
*[[Dry deposition]]
 
**[[Leaf area indices in GEOS-Chem]]
 
**[[Olson land map]]
 
*[[Wet deposition]]
 
 
=== GEOS-Chem aerosols ===
 
*[[Carbonaceous aerosols]]
 
*[[Mineral dust aerosols]]
 
*[[Secondary organic aerosols]]
 
*[[Sea salt aerosols]]
 
*[[Sulfate aerosols]]
 
*[[Aerosol-only simulation]]
 
*[[Aerosol optical properties]]
 
*[[Aerosol thermodynamical equilibrium]]
 
*Aerosol Microphysics
 
**[[APM aerosol microphysics|APM]]
 
**[[TOMAS aerosol microphysics|TOMAS]]
 
 
=== GEOS-Chem diagnostics ===
 
*[[List of diagnostics archived to netCDF format]]
 
*[[List of diagnostics archived to bpch format]]
 
*[[ObsPack diagnostic]]
 
*[[Planeflight diagnostic]]
 
*[[The HEMCO User's Guide#Diagnostics|Archiving diagnostics from HEMCO]]
 
*[[Diagnostic time step]]
 
*[[Additional diagnostics]]
 
 
=== GEOS-Chem Validation ===
 
*[[GEOS-Chem benchmarking]]
 
*[[GEOS-Chem performance]]
 

Revision as of 16:30, 15 September 2022

GEOS-Chem Main Page | GEOS-Chem Guides


The majority of content in this user manual has been migrated to https://geos-chem.readthedocs.io.
We will preserve the user manual content for GEOS-chem users who are still working with versions 13.4 and earlier.



Overview

On this page we provide information on getting started with GEOS-Chem "Classic." (Much of this content is now at geos-chem.readthedocs.io).

Please see gchp.readthedocs.io page for information about how to download and run GCHP.

Please see hemco.readthedocs.io page for information about how to download and run HEMCO (if you want to run HEMCO in standalone mode).

Table of contents

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

Additional resources

Getting help