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

From Geos-chem
Jump to: navigation, search
(GEOS-Chem died with an error. What can I do?)
(How long does GEOS-Chem take to run?)
(4 intermediate revisions by the same user not shown)
Line 42: Line 42:
 
* [[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 [[GEOS-Chem_performance#GEOS-Chem_scalability|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?]]
 
* [[Bugs and fixes|Is there a comprehensive list of GEOS-Chem bugs and how they were fixed?]]
Line 74: Line 74:
 
=== 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-Chem_performance#7-day_time_tests|7-day time test simulations]].
+
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 84: Line 84:
 
== GEOS-Chem errors ==
 
== GEOS-Chem errors ==
  
Please also see our ''[[Guide to GEOS-Chem error messages]]''.
+
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? ===
Line 91: Line 91:
  
 
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 14:40, 17 June 2019 (UTC)
 
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 14:40, 17 June 2019 (UTC)
 
=== Where does GEOS-Chem error output get printed? ===
 
 
GEOS-Chem, like all Unix programs, sends its output to two streams:
 
 
# stdout
 
# stderr
 
 
==== The stdout stream ====
 
 
Most GEOS-Chem output will go to the '''stdout''' stream, which takes I/O from the Fortran WRITE and PRINT commands.  If you run GEOS-Chem by just typing the executable name at the Unix prompt:
 
 
geos
 
 
then the stdout stream will be printed to the terminal window.  You can also redirect the stdout stream to a log file with the Unix redirect command:
 
 
geos > log
 
 
We recommend that you create GEOS-Chem log files so that you can reexamine the output from your run at a later time.
 
 
Most GEOS-Chem errors will be printed to stdout (and hence, to the log file).  Most errors flagged by GEOS-Chem use a standard error message format, such as:
 
 
==============================================================
 
GEOS-CHEM ERROR: No output scheduled on last day of run!
 
STOP at IS_LAST_DAY_GOOD ("input_mod.f")
 
==============================================================
 
 
==== The stderr stream ====
 
 
The '''stderr''' stream takes I/O from various Unix system commands, including <tt>exit</tt>.  If your GEOS-Chem run died as a result of a system problem (i.e. you ran up against a system time or memory limit, you are over disk quota, etc.), then the error message will more than likely go to stderr instead of stdout.  As a result, these error messages will not be printed to the GEOS-Chem log file output.
 
 
If you use a queue system then the stderr output may be printed to a file.  For example, if you submit a GEOS-Chem job to the SGE queue system, and your job script is named <tt>run.geos</tt>, SGE will send the stderr output to a file named <tt>run.geos.oXXXXX</tt> (where XXXXX is the job ID #).
 
 
--[[User:Bmy|Bob Y.]] 15:44, 8 November 2010 (EST)
 

Revision as of 19:42, 25 June 2019

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

Basic information about GEOS-Chem

For new users

--Bob Yantosca (talk) 17:45, 2 January 2019 (UTC)

Science questions

Where can I find information about ...

--Bob Yantosca (talk) 17:45, 2 January 2019 (UTC)

Technical issues

--Bob Yantosca (talk) 17:45, 2 January 2019 (UTC)

Parallelization issues

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