Difference between revisions of "Frequently asked questions about GEOS-Chem"
(→How long does GEOS-Chem take to run?) |
|||
(19 intermediate revisions by 2 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. | ||
Line 14: | Line 7: | ||
* [[GEOS-Chem welcome letter for new users|I am a GEOS-Chem new user. What is expected of me?]] | * [[GEOS-Chem welcome letter for new users|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?]] | * [[Minimum system requirements for GEOS-Chem|On what types of machines can I run GEOS-Chem?]] | ||
+ | * [http://cloud.geos-chem.org Can I use GEOS-Chem on cloud-computing platforms?] | ||
* [[Species in GEOS-Chem|What types of simulations can I run with GEOS-Chem?]] | * [[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? | * 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?]] | * [[Overview of GMAO met data products|Which meteorological data fields can be used by GEOS-Chem?]] | ||
− | * [[GEOS-Chem | + | * [[Submitting GEOS-Chem support requests|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_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?] | * [http://acmg.seas.harvard.edu/geos/geos_working_groups.html What do the GEOS-Chem Working Groups do?] | ||
* [[GEOS-Chem Support Team|What does the GEOS-Chem Support Team 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?]] | * [[Subscribing_to_the_GEOS-Chem_email_lists|I see that there are several GEOS-Chem email lists. How can I subscribe?]] | ||
+ | |||
+ | --[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 17:45, 2 January 2019 (UTC) | ||
=== Science questions === | === Science questions === | ||
Line 29: | Line 25: | ||
* [[GEOS-Chem chemistry mechanisms|the available chemical mechanisms in GEOS-Chem?]] | * [[GEOS-Chem chemistry mechanisms|the available chemical mechanisms in GEOS-Chem?]] | ||
* [[Bromine chemistry mechanism|the bromine chemistry mechanism in GEOS-Chem?]] | * [[Bromine chemistry mechanism|the bromine chemistry mechanism in GEOS-Chem?]] | ||
− | * [[ | + | * [[FlexChem|the KPP chemical solver?]] |
* [[Linoz stratospheric ozone chemistry|the Linoz stratospheric ozone chemistry scheme?]] | * [[Linoz stratospheric ozone chemistry|the Linoz stratospheric ozone chemistry scheme?]] | ||
* [[GEOS-Chem_chemistry_mechanisms#Stratospheric_chemistry|the stratospheric chemistry mechanism?]] | * [[GEOS-Chem_chemistry_mechanisms#Stratospheric_chemistry|the stratospheric chemistry mechanism?]] | ||
− | * [[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?]] | ||
Line 39: | Line 35: | ||
* 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]]? | * [[GEOS-Chem nested grid simulations]]? | ||
+ | |||
+ | --[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 17:45, 2 January 2019 (UTC) | ||
=== 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?]] | * [[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 performance]] and [[ | + | * 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?]] | * [[Bugs and fixes|Is there a comprehensive list of GEOS-Chem bugs and how they were fixed?]] | ||
* [[GEOS-Chem basics|I am new to programming. Do you have any online resources or tutorials?]] | * [[GEOS-Chem basics|I am new to programming. Do you have any online resources or tutorials?]] | ||
− | + | * Are there any [[Floating point math issues|numerical issues]] that I should be aware of? | |
− | * Are there any [[Floating point math issues|numerical | + | |
* Do you have any tools that would help me [[Debugging with the GEOS-Chem unit tester|debug GEOS-Chem more efficiently?]] | * Do you have any tools that would help me [[Debugging with the GEOS-Chem unit tester|debug GEOS-Chem more efficiently?]] | ||
+ | |||
+ | --[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 17:45, 2 January 2019 (UTC) | ||
=== Parallelization issues === | === Parallelization issues === | ||
Line 58: | Line 56: | ||
* [[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?]] | * [[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?]] | ||
− | + | --[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 17:45, 2 January 2019 (UTC) | |
− | + | === High-Performance GEOS-Chem (GCHP) === | |
− | + | Please see the [[GCHP_Main_Page|GCHP main wiki page]] for information about GCHP. | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
== 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, please see [[GEOS-Chem_basics#Restart_files|the ''Restart Files'' section of our ''GEOS-Chem basics'' wiki page]]. | For instructions on how to obtain a set of sample restart files that you can use to spin up your own simulations, please see [[GEOS-Chem_basics#Restart_files|the ''Restart Files'' section of our ''GEOS-Chem basics'' wiki page]]. | ||
Line 80: | Line 68: | ||
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 16:24, 6 January 2017 (UTC) | --[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 16:24, 6 January 2017 (UTC) | ||
− | == | + | == Running GEOS-Chem == |
− | + | Please see our ''[[Running GEOS-Chem]]'' wiki page. | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
=== How long does GEOS-Chem take to run? === | === 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- | + | 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? === | === GEOS-Chem seems to be running too slowly. What can I do? === | ||
Line 109: | Line 80: | ||
You should be aware of [[GEOS-Chem Makefile Structure#Compile-time options that can slow down GEOS-Chem|several compile-time options that will slow down GEOS-Chem]]. Use these options only for debugging, but not in your production runs. | You should be aware of [[GEOS-Chem Makefile Structure#Compile-time options that can slow down GEOS-Chem|several compile-time options that will slow down GEOS-Chem]]. Use these options only for debugging, but not in your production runs. | ||
− | + | 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 == | == GEOS-Chem errors == | ||
− | Please also see our [[ | + | Please also see our ''[[Guide to GEOS-Chem error messages]]'' and ''[[Debugging GEOS-Chem]]'' pages. |
=== GEOS-Chem died with an error. What can I do? === | === 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]]''. | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | --[[User:Bmy|Bob | + | --[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 14:40, 17 June 2019 (UTC) |
Revision as of 19:42, 25 June 2019
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?
- On what types of machines can I run GEOS-Chem?
- 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?
--Bob Yantosca (talk) 17:45, 2 January 2019 (UTC)
Science questions
Where can I find information about ...
- the available chemical mechanisms in GEOS-Chem?
- the bromine chemistry mechanism in GEOS-Chem?
- the KPP chemical solver?
- the Linoz stratospheric ozone chemistry scheme?
- the stratospheric chemistry mechanism?
- 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) 17:45, 2 January 2019 (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 bugs and how they were fixed?
- I am new to programming. Do you have any online resources or tutorials?
- Are there any numerical issues that I should be aware of?
- Do you have any tools that would help me debug GEOS-Chem more efficiently?
--Bob Yantosca (talk) 17:45, 2 January 2019 (UTC)
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?
--Bob Yantosca (talk) 17:45, 2 January 2019 (UTC)
High-Performance GEOS-Chem (GCHP)
Please see the GCHP main wiki page for information about GCHP.
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 see the Restart Files section of our GEOS-Chem basics wiki page.
--Bob Yantosca (talk) 16:24, 6 January 2017 (UTC)
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?
You should be aware of several compile-time options that will slow down GEOS-Chem. Use these options only for debugging, but not in your production runs.
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 Debugging GEOS-Chem 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.
--Bob Yantosca (talk) 14:40, 17 June 2019 (UTC)