Difference between revisions of "Frequently asked questions about GEOS-Chem"

From Geos-chem
Jump to: navigation, search
(→‎GEOS-Chem basics)
(→‎Parallelization issues)
 
(122 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
On this page we shall answer some commonly asked questions about GEOS-Chem.
 
On this page we shall answer some commonly asked questions about GEOS-Chem.
  
−
== Basic information about GEOS-Chem ==
+
== For new users ==
  
−
=== GEOS-Chem basics ===
+
* [https://geos-chem.seas.harvard.edu/welcome.html I am a GEOS-Chem new user.  What is expected of me?]
 +
* [https://geos-chem.readthedocs.io/en/latest/geos-chem-shared-docs/supplemental-guides/related-docs.html Where can I find user manuals for GEOS-Chem and related software?]
 +
* [http://cloud.geos-chem.org Can I use GEOS-Chem on cloud-computing platforms?]
 +
* [[Guide to GEOS-Chem simulations|What types of simulations can I run with GEOS-Chem?]]
 +
* What is the [[GEOS-Chem horizontal grids|horizontal resolution]] and [[GEOS-Chem vertical grids|vertical resolution]] of GEOS-Chem?
 +
* [[Overview of GMAO met data products|Which meteorological data fields can be used by GEOS-Chem?]]
 +
* [https://geos-chem.readthedocs.io/en/latest/help-and-reference/SUPPORT.html To whom may I direct GEOS-Chem-related questions?]
 +
* [https://geoschem.github.io/steering-cmte.html What does the GEOS-Chem Steering Committee do?]
 +
* [https://geoschem.github.io/working-groups.html What do the GEOS-Chem Working Groups do?]
 +
* [https://geoschem.github.io/support-team What does the GEOS-Chem Support Team do?]
 +
* [https://geoschem.github.io/email-lists I see that there are several GEOS-Chem email lists.  How can I subscribe?]
  
−
* [[GEOS-Chem welcome letter for new users|I am a GEOS-Chem new user.  What is expected of me?]]
+
== Science questions ==
−
* [[Minimum system requirements for GEOS-Chem|On what types of machines can I run GEOS-Chem?]]
+
−
* [http://acmg.seas.harvard.edu/geos/doc/man/appendix_1.html What kind of simulations can I run with GEOS-Chem?]
+
−
* What is the [http://acmg.seas.harvard.edu/geos/doc/man/appendix_2.html horizontal resolution] and [http://acmg.seas.harvard.edu/geos/doc/man/appendix_3.html vertical resolution] of GEOS-Chem?
+
−
* [http://acmg.seas.harvard.edu/geos/doc/man/appendix_4.html Which meteorological data fields can be used by GEOS-Chem?]
+
−
* [[GEOS-Chem programming staff|To whom can I direct GEOS-Chem-related questions?]]
+
−
* [http://acmg.seas.harvard.edu/geos/geos_steering_cmte.html What does the GEOS-Chem Steering Committee do?]
+
−
* [http://acmg.seas.harvard.edu/geos/geos_working_groups.html What do the GEOS-Chem Working Groups do?]
+
−
 
+
−
=== Chemistry mechanisms ===
+
  
 
Where can I find information about ...
 
Where can I find information about ...
  
−
* [[Chemistry Issues|the Standard chemistry mechanism in GEOS-Chem?]]
+
* [[Guide to GEOS-Chem simulations|types of GEOS-Chem simulations that I can run?]]
−
* [[Dicarbonyls simulation|the Dicarbonyls mechanism in GEOS-Chem?]]
+
* [[Bromine chemistry mechanism|bromine chemistry?]]
−
* [[New isoprene scheme|the Caltech isoprene mechanism as implemented in GEOS-Chem?]]
+
* [https://kpp.readthedocs.io The chemical solver used in GEOS-Chem?]
−
* [[Bromine chemistry mechanism|the bromine chemistry mechanism in GEOS-Chem?]]
+
−
* [[KPP solvers FAQ|the KPP chemical solver?]]
+
 
* [[Linoz stratospheric ozone chemistry|the Linoz stratospheric ozone chemistry scheme?]]
 
* [[Linoz stratospheric ozone chemistry|the Linoz stratospheric ozone chemistry scheme?]]
 +
* [[Advection scheme TPCORE|the advection scheme in GEOS-Chem?]]
 +
* [[Boundary layer mixing|the boundary layer mixing schemes in GEOS-Chem?]]
 +
* [[Cloud convection|the cloud convection schemes in GEOS-Chem?]]
 +
* The [[Dry deposition]] and [[Wet deposition]] schemes in GEOS-Chem?
 +
* [https://geos-chem.readthedocs.io/en/latest/supplemental-guides/nested-grid-guide.html GEOS-Chem nested grid simulations]?
  
−
=== Questions about errors ===
+
== Technical issues ==
−
 
+
−
* What should I do [[Common GEOS-Chem error messages|when I encounter an error while running GEOS-Chem]]?
+
  
−
== Specific questions ==
+
* [https://geos-chem.readthedocs.io/en/latest/gcclassic-user-guide/get-code.html How do I download the GEOS-Chem source code]
 +
* [https://geos-chem.readthedocs.io/en/latest/gcclassic-user-guide/create-rundir.html How do I create run directories?]
 +
* [https://geos-chem.readthedocs.io/en/latest/geos-chem-shared-docs/supplemental-guides/error-guide.html What should I do when I encounter an error while running GEOS-Chem]?
 +
* [https://github.com/geoschem/geos-chem/issues Is there a comprehensive list of GEOS-Chem bug reports?]
 +
* Do you have any information on how I can [https://geos-chem.readthedocs.io/en/latest/geos-chem-shared-docs/supplemental-guides/debug-guide.html debug GEOS-Chem or HEMCO errors]?
  
−
=== Can I run two GEOS-Chem jobs simultaneously? ===
+
== Parallelization issues ==
 +
* [https://geos-chem.readthedocs.io/en/latest/geos-chem-shared-docs/supplemental-guides/parallel-guide.html#how-can-i-tell-what-should-go-into-the-omp-private-clause How can I tell if a variable has to be declared with <tt>!$OMP PRIVATE</tt> or <tt>!$OMP SHARED?</tt>]
 +
* [https://geos-chem.readthedocs.io/en/latest/geos-chem-shared-docs/supplemental-guides/parallel-guide.html#how-many-cores-may-i-use-for-geos-chem-or-hemco How many CPU cores may I use for my GEOS-Chem Classic simulation?]
 +
* [https://geos-chem.readthedocs.io/en/latest/geos-chem-shared-docs/supplemental-guides/parallel-guide.html#why-is-geos-chem-is-not-using-all-the-cores-i-requested Why is GEOS-Chem Classic not using all the CPU cores that I requested?]
  
−
'''''[mailto:timmyf@prl.res.in Timmy Francis] wrote:'''''
+
== High-Performance GEOS-Chem (GCHP) ==
  
−
:I would like to know if I can run more than one executables (.geos) by renaming them as .geos1, .geos2 etc. For example using the same restart file, I want to run two simulations, one 'with chemistry' and the other 'without chemistry' after make and rename the executables to geos1 and geos2 and run these in two terminals. Will they interfere with each other and affect the result?
+
Please see the GCHP user manual at [https://gchp.readthedocs.io <tt>gchp.readthedocs.io</tt>]for more information.
  
−
'''''[mailto:yantosca@seas.harvard.edu Bob Yantosca] replied:'''''
+
== Where can I get restart files for GEOS-Chem? ==
  
−
:I recommend creating separate run directories for each executable.  You can place the identical restart file and input files into each run directory.  Then in one run directory you can turn on chemistry in input.geos, and then in the other run directory, you turn off chemistry in input.geos. If you run the GEOS-Chem executables in two separate directories, you will ensure that one executable will not overwrite the files that the other executable creates.
+
For instructions on how to obtain a set of sample restart files that you can use to spin up your own simulations, [https://geos-chem.readthedocs.io/en/latest/gcclassic-user-guide/restart-files-gc.html#where-can-i-get-a-restart-file-for-my-simulation please visit this link].
  
−
:In theory, you should be able to run two simultaneous GEOS-Chem executables in two separate run directories.  However, I don't know much about your particular machine.  You might find that there is not enough memory to run two simulations at the same time.  That is not a problem with GEOS-Chem, but with your system (and is something that the GEOS-Chem Support Team wouldn't be able to help you with).
+
== Running GEOS-Chem ==
  
−
:I would recommend talking with your local IT department to find out how much memory etc. is available to you, and if you would be able to run two simulations at the same time. I think a 4x5 full chemistry simulation takes 2-3 GB of memory, and a 2x2.5 simulation can take up to 8GB of memory.
+
Please see the [https://geos-chem.readthedocs.io/en/latest/gcclassic-user-guide/run.html Run your simulation] section of [https://geos-chem.readthedocs.io <tt>geos-chem.readthedocs.io.</tt>]. for more information.
  
−
--[[User:Bmy|Bob Y.]] 16:58, 3 November 2010 (EDT)
+
There are several ways to [https://geos-chem.readthedocs.io/en/latest/gcc-guide/05-run/run-speedup.html speed up a slow GEOS-Chem simulation].  If you are archiving many diagnostic quantities are a high temporal resolution (e.g. every hour), then this will increase the run time of your simulation.  You can try saving out less diagnostic quantities, or archiving at a lower temporal resolution (e.g. every day).

Latest revision as of 17:02, 23 May 2024

On this page we shall answer some commonly asked questions about GEOS-Chem.

For new users

Science questions

Where can I find information about ...

Technical issues

Parallelization issues

High-Performance GEOS-Chem (GCHP)

Please see the GCHP user manual at gchp.readthedocs.iofor more information.

Where can I get restart files for GEOS-Chem?

For instructions on how to obtain a set of sample restart files that you can use to spin up your own simulations, please visit this link.

Running GEOS-Chem

Please see the Run your simulation section of geos-chem.readthedocs.io.. for more information.

There are several ways to speed up a slow GEOS-Chem simulation. If you are archiving many diagnostic quantities are a high temporal resolution (e.g. every hour), then this will increase the run time of your simulation. You can try saving out less diagnostic quantities, or archiving at a lower temporal resolution (e.g. every day).

Retrieved from "https://wiki.seas.harvard.edu/geos-chem/index.php?title=Frequently_asked_questions_about_GEOS-Chem&oldid=53736"