Difference between revisions of "Creating run directories for GEOS-Chem 13.0.0 and later"

From Geos-chem
Jump to: navigation, search
(Example 1: Creating a run directory for a full-chemistry simulation)
 
(24 intermediate revisions by 2 users not shown)
Line 13: Line 13:
 
#[[Running GEOS-Chem|Running]]
 
#[[Running GEOS-Chem|Running]]
 
#[[GEOS-Chem output files|Output files]]
 
#[[GEOS-Chem output files|Output files]]
#[[Guide_to_visualization_and_analysis_tools_for_GEOS-Chem|Visualizing and processing output]]
+
#[[Python tools for use with GEOS-Chem]]
 
#[[GEOS-Chem_coding_and_debugging|Coding and debugging]]
 
#[[GEOS-Chem_coding_and_debugging|Coding and debugging]]
 
#[[GEOS-Chem_overview#Further_reading|Further reading]]
 
#[[GEOS-Chem_overview#Further_reading|Further reading]]
  
  
== Overview ==
+
This content has been migrated to the [https://geos-chem.readthedocs.io/en/latest/gcc-guide/02-build/create-rundir.html '''Create a run directory''' chapter of <tt>geos-chem.readthedocs.io</tt>].
 
+
We have greatly simplified run directory creation in [[GEOS-Chem 13.0.0]] and later versions.  You no longer need to download the separate [[GEOS-Chem Unit Tester]] repository any longer, but can create run directories from a script in the GEOS-Chem source code itself.
+
 
+
We have
+
 
+
 
+
== Example 1: Creating a run directory for a full-chemistry simulation ==
+
 
+
Let us walk through the process of creating a run directory for a global GEOS-Chem full-chemistry simulation.
+
 
+
'''1.''' Navigate to the <tt>GCClassic</tt> superproject folder and get a directory listing:
+
 
+
cd /path/to/your/GCClassic
+
ls -CF
+
 
+
You should see this output:
+
 
+
CMakeLists.txt  LICENSE  run@  src/
+
 
+
As mentioned previously, <tt>run@</tt> is a symbolic link.  It actually points to the to the <tt>src/GEOS-Chem/run/GCClassic</tt> folder.  This folder contains several scripts and template files for run directory creation. 
+
 
+
'''2.'''  Navigate to the <tt>run</tt> folder and get a directory listing:
+
 
+
cd run
+
ls -CF
+
 
+
and you should see this output:
+
 
+
archiveRun.sh*    gitignore                  HISTORY.rc.templates/  runScriptSamples/
+
createRunDir.sh*  HEMCO_Config.rc.templates/  input.geos.templates/
+
getRunInfo*      HEMCO_Diagn.rc.templates/  README
+
 
+
You can see several folders (highlighted in the directory display with <tt>/</tt>) and a few executable scripts (highlighted with <tt>*</tt>).  The script we are interested in is <tt>createRunDir.sh</tt>.
+
 
+
'''3.''' Run the createRunDir.sh script and answer the prompts:
+
 
+
Run the  <tt>/createRunDir.sh</tt> script by typing:
+
 
+
./createRunDir.sh
+
 
+
'''4.''' The script will start asking you to supply information about the type of run directory that you wish to create:
+
 
+
===========================================================
+
GEOS-CHEM RUN DIRECTORY CREATION
+
===========================================================
+
+
-----------------------------------------------------------
+
Choose simulation type:
+
-----------------------------------------------------------
+
    1. Full chemistry
+
    2. Aerosols only
+
    3. CH4
+
    4. CO2
+
    5. Hg
+
    6. POPs
+
    7. Tagged CH4
+
    8. Tagged CO
+
    9. Tagged O3
+
  10. TransportTracers
+
 
+
We would to create a run directory for a full-chemistry simulation, so type <tt>1</tt> followed by the <tt>ENTER</tt> key. 
+
 
+
'''5.''' The script will prompt you with the next menu.
+
 
+
-----------------------------------------------------------
+
Choose chemistry domain:
+
-----------------------------------------------------------
+
  1. Troposphere + stratosphere (Recommended)
+
  2. Troposphere only
+
 
+
We will select the recommended option (type <tt>1</tt> and then <tt>ENTER</tt>. 
+
 
+
'''6.''' The next menu will appear:
+
 
+
-----------------------------------------------------------
+
Choose additional simulation option:
+
-----------------------------------------------------------
+
  1. Standard
+
  2. Benchmark
+
  3. Complex SOA
+
  4. Marine POA
+
  5. Acid uptake on dust
+
  6. TOMAS
+
  7. APM
+
  8. RRTMG
+
 
+
In this menu, you can select among different full-chemistry options, such as adding the RRTMG radiative transfer model, microphysics models (APM or TOMAS), etc.  Here we will take the standard fullchem simulation, so type <tt>1</tt> and then <tt>ENTER</tt>.
+
 
+
'''7.''' The next menu will ask you to specify the type of meteorology that you wish to use (GEOS-FP or MERRA-2):
+
 
+
-----------------------------------------------------------
+
Choose meteorology source:
+
-----------------------------------------------------------
+
  1. MERRA-2 (Recommended)
+
  2. GEOS-FP
+
 
+
Let's select the recommended option, so type <tt>1</tt> followed by <tt>ENTER</tt>.
+
 
+
'''8.''' The next menu will prompt you for the horizontal resolution that you wish to use:
+
 
+
-----------------------------------------------------------
+
Choose horizontal resolution:
+
-----------------------------------------------------------
+
  1. 4.0  x 5.0
+
  2. 2.0  x 2.5
+
  3. 0.5  x 0.625
+
 
+
If you wish to set up global simulation, type either <tt>1</tt> or <tt>2</tt> followed by <tt>ENTER</tt>.
+
 
+
If you wish to set up a nested-grid simulation, type <tt>3</tt> and hit <tt>ENTER</tt>.  Then you will be followed by a nested-grid menu:
+
 
+
-----------------------------------------------------------
+
Choose horizontal grid domain:
+
-----------------------------------------------------------
+
  1. Global
+
  2. Asia
+
  3. Europe
+
  4. North America
+
  5. Custom
+
 
+
 
+
 
+
 
+
Let's select the 4&deg; x 5&deg; option, so type <tt>1</tt> and then <tt>ENTER</tt>.
+
 
+
'''8a.''' NOTE: If you want to create a nested-grid simulation instead of a global simulation, type <tt>
+
 
+
  
  
 
----
 
----
 
'''''[[Creating GEOS-Chem run directories|Previous]] | [[Creating run directories for GEOS-Chem 12.9.3 and prior|Next]] | [[Getting Started with GEOS-Chem]]'''''
 
'''''[[Creating GEOS-Chem run directories|Previous]] | [[Creating run directories for GEOS-Chem 12.9.3 and prior|Next]] | [[Getting Started with GEOS-Chem]]'''''

Latest revision as of 20:59, 3 August 2022

Previous | Next | Getting Started with GEOS-Chem

  1. Minimum system requirements
  2. Installing required software
  3. Configuring your computational environment
  4. Downloading source code
  5. Downloading data directories
  6. Creating GEOS-Chem run directories
  7. Configuring runs
  8. Compiling
  9. Running
  10. Output files
  11. Python tools for use with GEOS-Chem
  12. Coding and debugging
  13. Further reading


This content has been migrated to the Create a run directory chapter of geos-chem.readthedocs.io.



Previous | Next | Getting Started with GEOS-Chem