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

From Geos-chem
Jump to: navigation, search
(→‎How long does a GEOS-Chem job take?)
(→‎Science questions)
 
(91 intermediate revisions by 3 users not shown)
Line 5: Line 5:
 
=== For new users ===
 
=== For new users ===
  
−
* [[GEOS-Chem welcome letter for new users|I am a GEOS-Chem new user.  What is expected of me?]]
+
* [https://geos-chem.seas.harvard.edu/geos-welcome I am a GEOS-Chem new user.  What is expected of me?]
−
* [[Minimum system requirements for GEOS-Chem|On what types of machines can I run GEOS-Chem?]]
+
* [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://acmg.seas.harvard.edu/geos/doc/man/appendix_1.html What kind of simulations can I run with GEOS-Chem?]
+
* [http://cloud.geos-chem.org Can I use GEOS-Chem on cloud-computing platforms?]
−
* 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?
+
* [[Species in GEOS-Chem|What types of simulations can I run with GEOS-Chem?]]
−
* [http://acmg.seas.harvard.edu/geos/doc/man/appendix_4.html Which meteorological data fields can be used by GEOS-Chem?]
+
* What is the [[GEOS-Chem horizontal grids|horizontal resolution]] and [[GEOS-Chem vertical grids|vertical resolution]] of GEOS-Chem?
−
* [[GEOS-Chem programming staff|To whom can I direct GEOS-Chem-related questions?]]
+
* [[Overview of GMAO met data products|Which meteorological data fields can be used by GEOS-Chem?]]
−
* [http://acmg.seas.harvard.edu/geos/geos_steering_cmte.html What does the GEOS-Chem Steering Committee do?]
+
* [[Submitting GEOS-Chem support requests|To whom can I direct GEOS-Chem-related questions?]]
−
* [http://acmg.seas.harvard.edu/geos/geos_working_groups.html What do the GEOS-Chem Working Groups do?]
+
* [https://geos-chem.seas.harvard.edu/geos-steering-cmte What does the GEOS-Chem Steering Committee do?]
 +
* [https://geos-chem.seas.harvard.edu/geos-working-groups What do the GEOS-Chem Working Groups do?]
 +
* [[GEOS-Chem Support Team|What does the GEOS-Chem Support Team do?]]
 +
* [[Subscribing_to_the_GEOS-Chem_email_lists|I see that there are several GEOS-Chem email lists.  How can I subscribe?]]
  
 
=== Science questions ===
 
=== Science questions ===
Line 18: Line 21:
 
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?]]
+
* [[FlexChem|the KPP chemical solver?]]
−
* [[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?]]
−
* [[Offline chemistry simulations|offline chemistry simulations?]]
+
* [[Offline chemistry simulations|Other chemistry simulations such as CO2, CH4, Hg, etc.?]]
−
* [[Emissions overview|emissions options in GEOS-Chem?]]
+
* [[HEMCO data directories|emissions options in GEOS-Chem?]]
 
* [[Advection scheme TPCORE|the advection scheme in GEOS-Chem?]]
 
* [[Advection scheme TPCORE|the advection scheme in GEOS-Chem?]]
 
* [[Boundary layer mixing|the boundary layer mixing schemes in GEOS-Chem?]]
 
* [[Boundary layer mixing|the boundary layer mixing schemes in GEOS-Chem?]]
 
* [[Cloud convection|the cloud convection schemes in GEOS-Chem?]]
 
* [[Cloud convection|the cloud convection schemes in GEOS-Chem?]]
 
* The [[Dry deposition]] and [[Wet deposition]] schemes in GEOS-Chem?
 
* The [[Dry deposition]] and [[Wet deposition]] schemes in GEOS-Chem?
 +
* [[GEOS-Chem nested grid simulations]]?
  
−
=== Technical questions ===
+
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 18:06, 20 September 2022 (UTC)
 +
 
 +
=== Technical issues ===
  
 
* [[Using Git with GEOS-Chem#Downloading a new GEOS-Chem version|How do I download the GEOS-Chem source code and run directories?]]
 
* [[Using Git with GEOS-Chem#Downloading a new GEOS-Chem version|How do I download the GEOS-Chem source code and run directories?]]
−
* [[Downloading GEOS-Chem source code and data#Data Directory Access|How do I download the GEOS-Chem data directories?]]
 
 
* [[Common GEOS-Chem error messages|What should I do when I encounter an error while running GEOS-Chem]]?
 
* [[Common GEOS-Chem error messages|What should I do when I encounter an error while running GEOS-Chem]]?
−
* Do you have any information about [[GEOS-Chem supported platforms and compilers|GEOS-Chem performance]] and [[GEOS-Chem performance|GEOS-Chem Scalability]]?
+
* Do you have any information about [[Guide to GEOS-Chem performance|GEOS-Chem performance]] and [[GEOS-Chem scalability]]?
 
* [[GEOS-Chem Makefile Structure|Where can I learn more about the GEOS-Chem Makefiles?]]
 
* [[GEOS-Chem Makefile Structure|Where can I learn more about the GEOS-Chem Makefiles?]]
−
* [[Bugs and fixes|Is there a comprehensive list of GEOS-Chem bugs and how they were fixed?]]
+
* [https://github.com/geoschem/geos-chem/issues Is there a comprehensive list of GEOS-Chem bug reports?]
−
* [[GEOS-Chem programming resources|I am new to programming.  Do you have any online resources or tutorials?]]
+
* 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]?
−
* [http://acmg.seas.harvard.edu/geos/doc/man/appendix_7.html Is there a recommended programming style that I should use?]
+
−
* Are there any [[Floating point math issues|numerical issues]] or [[Machine issues & portability|machine-dependent issues]] that I should be aware of?
+
  
−
== Specific questions ==
+
=== Parallelization issues ===
 +
* [[Parallelizing_GEOS-Chem#How_can_I_tell_if_a_variable_has_to_be_declared_with_PRIVATE_or_SHARED.3F|How can I tell if a variable has to be declared with <tt>!$OMP PRIVATE</tt> or <tt>!$OMP SHARED?</tt>]]
 +
* [[Parallelizing_GEOS-Chem#How_many_CPUs_may_I_use_in_my_GEOS-Chem_simulation.3F|How many CPUs may I use for my GEOS-Chem simulation?]]
 +
* [[Parallelizing_GEOS-Chem#Why_is_GEOS-Chem_is_not_using_all_the_CPUs_I_requested.3F|Why is GEOS-Chem not using all the CPUs that I requested?]]
  
−
=== How long does a GEOS-Chem take to run? ===
+
=== High-Performance GEOS-Chem (GCHP) ===
  
−
It depends on your particular machine.  We have posted several timing results from GEOS-Chem [[GEOS-Chem supported platforms and compilers|4&deg; x 5&deg; (1-month benchmark)]] and [[GEOS-Chem supported platforms and compilers#Performance of 2 x 2.5 simulations|2&deg; x 2.5&deg; (1-year benchmark)]] simulations.
+
Please see the GCHP user manual at [https://gchp.readthedocs.io <tt>gchp.readthedocs.io</tt>]for more information.
  
−
=== My GEOS-Chem job seems to be running too slowly.  What can I do? ===
+
== Where can I get restart files for GEOS-Chem? ==
  
−
You should be aware of [[GEOS-Chem Makefile Structure#Compile-time options that can slow down GEOS-Chem|several compile-time options that can potentially slow down GEOS-Chem]].
+
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/gcc-guide/04-data/restart-files-gc.html#where-can-i-get-a-restart-file-for-my-simulation please visit this link].
  
−
Also, the following run-time options may also slow down GEOS-Chem:
+
== Running GEOS-Chem ==
  
−
; "Normal" diagnostics: (e.g. saved out to the ctm.bpch file): The more diagnostic quantities you choose to archive, the more memory and disk I/O operations this will require.
+
Please see our ''[[Running GEOS-Chem]]'' wiki page.
−
; "Timeseries" diagnostics (ND48, ND49, ND50, ND51, ND51b): If you choose to archive many diagnostic quantities at hourly or bi-hourly intervals, then the increased memory and disk I/O usage can slow down GEOS-Chem.
+
  
−
To speed up GEOS-Chem, you can try to reduce the number of diagnostics that you are saving to disk.
+
=== How long does GEOS-Chem take to run? ===
  
−
=== Can I run two GEOS-Chem jobs simultaneously? ===
+
It depends on your particular computing environment.  We have posted several timing results from GEOS-Chem [[GEOS-Chem 7-day timing tests|7-day time test simulations]].
  
−
'''''[mailto:timmyf@prl.res.in Timmy Francis] wrote:'''''
+
=== GEOS-Chem seems to be running too slowly. What can I do? ===
  
−
: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?
+
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].  
  
−
'''''[mailto:yantosca@seas.harvard.edu Bob Yantosca] replied:'''''
+
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).
  
−
: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.
+
== GEOS-Chem errors ==
  
−
: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).
+
Please also see our ''[[Guide to GEOS-Chem error messages]]'' and ''[https://geos-chem.readthedocs.io/en/latest/geos-chem-shared-docs/supplemental-guides/debug-guide.html Debug GEOS-Chem and HEMCO errors]'' pages.
  
−
: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.
+
=== GEOS-Chem died with an error.  What can I do? ===
  
−
--[[User:Bmy|Bob Y.]] 15:44, 8 November 2010 (EST)
+
Please see ''[[Understanding the different categories of errors]]'' section of our ''[[Guide to GEOS-Chem error messages]]''.

Latest revision as of 18:06, 20 September 2022

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

Basic information about GEOS-Chem

For new users

Science questions

Where can I find information about ...

--Bob Yantosca (talk) 18:06, 20 September 2022 (UTC)

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 our Running GEOS-Chem wiki page.

How long does GEOS-Chem take to run?

It depends on your particular computing environment. We have posted several timing results from GEOS-Chem 7-day time test simulations.

GEOS-Chem seems to be running too slowly. What can I do?

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).

GEOS-Chem errors

Please also see our Guide to GEOS-Chem error messages and Debug GEOS-Chem and HEMCO errors pages.

GEOS-Chem died with an error. What can I do?

Please see Understanding the different categories of errors section of our Guide to GEOS-Chem error messages.

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