Frequently asked questions about GEOS-Chem: Difference between revisions

From Geos-chem
Jump to navigation Jump to search
 
(10 intermediate revisions by the same user 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 ==
 
=== For new users ===


* [https://geos-chem.seas.harvard.edu/welcome.html I am a GEOS-Chem new user.  What is expected of me?]
* [https://geos-chem.seas.harvard.edu/welcome.html I am a GEOS-Chem new user.  What is expected of me?]
Line 17: Line 15:
* [https://geoschem.github.io/email-lists I see that there are several GEOS-Chem email lists.  How can I subscribe?]
* [https://geoschem.github.io/email-lists I see that there are several GEOS-Chem email lists.  How can I subscribe?]


=== Science questions ===
== Science questions ==


Where can I find information about ...
Where can I find information about ...
Line 31: Line 29:
* [https://geos-chem.readthedocs.io/en/latest/supplemental-guides/nested-grid-guide.html GEOS-Chem nested grid simulations]?
* [https://geos-chem.readthedocs.io/en/latest/supplemental-guides/nested-grid-guide.html GEOS-Chem nested grid simulations]?


=== Technical issues ===
== 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?]]
* [https://geos-chem.readthedocs.io/en/latest/gcclassic-user-guide/get-code.html How do I download the GEOS-Chem source code]
* [[Common GEOS-Chem error messages|What should I do when I encounter an error while running GEOS-Chem]]?
* [https://geos-chem.readthedocs.io/en/latest/gcclassic-user-guide/create-rundir.html How do I create run directories?]
* Do you have any information about [[Guide to GEOS-Chem performance|GEOS-Chem performance]] and [[GEOS-Chem scalability]]?
* [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]?
* [[GEOS-Chem Makefile Structure|Where can I learn more about the GEOS-Chem Makefiles?]]
* [https://github.com/geoschem/geos-chem/issues Is there a comprehensive list of GEOS-Chem bug reports?]
* [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]?
* 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]?


=== Parallelization issues ===
== 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>]]
* [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>]
* [[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?]]
* [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?]
* [[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?]]
* [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?]


=== High-Performance GEOS-Chem (GCHP) ===
== High-Performance GEOS-Chem (GCHP) ==


Please see the GCHP user manual at [https://gchp.readthedocs.io <tt>gchp.readthedocs.io</tt>]for more information.
Please see the GCHP user manual at [https://gchp.readthedocs.io <tt>gchp.readthedocs.io</tt>]for more information.
Line 51: Line 48:
== Where can I get restart files for GEOS-Chem? ==
== 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, [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].
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].


== Running GEOS-Chem ==
== Running GEOS-Chem ==


Please see our ''[[Running GEOS-Chem]]'' wiki page.
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.
 
=== How long does GEOS-Chem take to run? ===
 
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]].
 
=== GEOS-Chem seems to be running too slowly.  What can I do? ===
 
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).
 
== GEOS-Chem errors ==
 
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.
 
=== 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]]''.
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).