Difference between revisions of "Frequently asked questions about GEOS-Chem"
(→Specific questions) |
(→Science questions) |
||
(96 intermediate revisions by 3 users not shown) | |||
Line 5: | Line 5: | ||
=== For new users === | === For new users === | ||
− | * [ | + | * [https://geos-chem.seas.harvard.edu/geos-welcome 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:// | + | * [http://cloud.geos-chem.org Can I use GEOS-Chem on cloud-computing platforms?] |
− | * What is the [ | + | * [[Species in GEOS-Chem|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? |
− | * [[GEOS-Chem | + | * [[Overview of GMAO met data products|Which meteorological data fields can be used by GEOS-Chem?]] |
− | * [ | + | * [[Submitting GEOS-Chem support requests|To whom can I direct GEOS-Chem-related questions?]] |
− | * [ | + | * [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 ... | ||
− | * [[ | + | * [[Guide to GEOS-Chem simulations|types of GEOS-Chem simulations that I can run?]] |
− | + | * [[Bromine chemistry mechanism|bromine chemistry?]] | |
− | + | * [[FlexChem|the KPP chemical solver?]] | |
− | * [[Bromine chemistry mechanism| | + | |
− | * [[ | + | |
* [[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|Other chemistry simulations such as CO2, CH4, Hg, etc.?]] |
− | * [[ | + | * [[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 | + | --[[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?]] | ||
− | |||
* [[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 | + | * 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?]] | ||
− | * [ | + | * [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]? |
− | + | ||
− | + | ||
− | == | + | === 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?]] | ||
− | === | + | === High-Performance GEOS-Chem (GCHP) === |
− | + | Please see the GCHP user manual at [https://gchp.readthedocs.io <tt>gchp.readthedocs.io</tt>]for 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, [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]. | |
− | + | == 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 [[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]]''. |
Revision as of 18:06, 20 September 2022
On this page we shall answer some commonly asked questions about GEOS-Chem.
Contents
Basic information about GEOS-Chem
For new users
- I am a GEOS-Chem new user. What is expected of me?
- Where can I find user manuals for GEOS-Chem and related software?
- Can I use GEOS-Chem on cloud-computing platforms?
- What types of simulations can I run with GEOS-Chem?
- What is the horizontal resolution and vertical resolution of GEOS-Chem?
- Which meteorological data fields can be used by GEOS-Chem?
- To whom can I direct GEOS-Chem-related questions?
- What does the GEOS-Chem Steering Committee do?
- What do the GEOS-Chem Working Groups do?
- What does the GEOS-Chem Support Team do?
- I see that there are several GEOS-Chem email lists. How can I subscribe?
Science questions
Where can I find information about ...
- types of GEOS-Chem simulations that I can run?
- bromine chemistry?
- the KPP chemical solver?
- the Linoz stratospheric ozone chemistry scheme?
- Other chemistry simulations such as CO2, CH4, Hg, etc.?
- emissions options in GEOS-Chem?
- the advection scheme in GEOS-Chem?
- the boundary layer mixing schemes in GEOS-Chem?
- the cloud convection schemes in GEOS-Chem?
- The Dry deposition and Wet deposition schemes in GEOS-Chem?
- GEOS-Chem nested grid simulations?
--Bob Yantosca (talk) 18:06, 20 September 2022 (UTC)
Technical issues
- How do I download the GEOS-Chem source code and run directories?
- What should I do when I encounter an error while running GEOS-Chem?
- Do you have any information about GEOS-Chem performance and GEOS-Chem scalability?
- Where can I learn more about the GEOS-Chem Makefiles?
- Is there a comprehensive list of GEOS-Chem bug reports?
- Do you have any information on how I can debug GEOS-Chem or HEMCO errors?
Parallelization issues
- How can I tell if a variable has to be declared with !$OMP PRIVATE or !$OMP SHARED?
- How many CPUs may I use for my GEOS-Chem simulation?
- Why is GEOS-Chem not using all the CPUs that I requested?
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.