Difference between revisions of "Obtaining a GCHP Run Directory"
(→Step 1: Create Run Directory) |
(→Step 1: Create Run Directory) |
||
| Line 22: | Line 22: | ||
During the course of script execution you will be asked a series of questions: | During the course of script execution you will be asked a series of questions: | ||
| − | ==== ExtData directory path ==== | + | ==== Enter ExtData directory path ==== |
The first time you create a GCHP run directory on your system you will be prompted for a path to GEOS-Chem shared data directories. The path should include the name of your <code>ExtData</code> directory and should not contain symbolic links. The path you enter will be stored in file <code>.geoschem/config</code> in your home directory as environment variable <code>GC_DATA_ROOT</code>. If that file does not already exist it will be created for you. When creating additional run directories you will only be prompted again if the file is missing or if the path within it is not valid. | The first time you create a GCHP run directory on your system you will be prompted for a path to GEOS-Chem shared data directories. The path should include the name of your <code>ExtData</code> directory and should not contain symbolic links. The path you enter will be stored in file <code>.geoschem/config</code> in your home directory as environment variable <code>GC_DATA_ROOT</code>. If that file does not already exist it will be created for you. When creating additional run directories you will only be prompted again if the file is missing or if the path within it is not valid. | ||
| Line 30: | Line 30: | ||
----------------------------------------------------------- | ----------------------------------------------------------- | ||
| − | ==== | + | ====Choose simulation type==== |
Enter the integer number that is next to the simulation type you want to use. | Enter the integer number that is next to the simulation type you want to use. | ||
| Line 54: | Line 54: | ||
8. RRTMG | 8. RRTMG | ||
| − | ==== | + | ====Choose meteorology source==== |
Enter the integer number that is next to the input meteorology source you would like to use. | Enter the integer number that is next to the input meteorology source you would like to use. | ||
| Line 64: | Line 64: | ||
2. GEOS-FP | 2. GEOS-FP | ||
| − | ==== | + | ====Enter run directory path==== |
Enter the target path where the run directory will be stored. You will be prompted to enter a new path if the one you enter does not exist. | Enter the target path where the run directory will be stored. You will be prompted to enter a new path if the one you enter does not exist. | ||
| Line 72: | Line 72: | ||
----------------------------------------------------------- | ----------------------------------------------------------- | ||
| − | ==== | + | ====Enter run directory name==== |
Enter the run directory name, or accept the default. You will be prompted for a new name if a run directory of the same name already exists at the target path. | Enter the run directory name, or accept the default. You will be prompted for a new name if a run directory of the same name already exists at the target path. | ||
| Line 80: | Line 80: | ||
----------------------------------------------------------- | ----------------------------------------------------------- | ||
| − | ==== | + | ====Optionally apply version control==== |
Enter whether you would like your run directory tracked with git version control. With version control you can keep track of exactly what you changed relative to the original settings. | Enter whether you would like your run directory tracked with git version control. With version control you can keep track of exactly what you changed relative to the original settings. | ||
Revision as of 19:07, 20 October 2020
Previous | Next | Getting Started with GCHP | GCHP Main Page
- Hardware and Software Requirements
- Downloading Source Code and Data Directories
- Obtaining a Run Directory
- Setting Up the GCHP Environment
- Compiling
- Running GCHP: Basics
- Running GCHP: Configuration
- Output Data
- Developing GCHP
- Run Configuration Files
Contents
Step 1: Create Run Directory
Navigate to the run/ subdirectory of the source code and create a run directory using shell script createRunDir.sh.
$ cd ~/GCHPctm/run $ ./createRunDir.sh
During the course of script execution you will be asked a series of questions:
Enter ExtData directory path
The first time you create a GCHP run directory on your system you will be prompted for a path to GEOS-Chem shared data directories. The path should include the name of your ExtData directory and should not contain symbolic links. The path you enter will be stored in file .geoschem/config in your home directory as environment variable GC_DATA_ROOT. If that file does not already exist it will be created for you. When creating additional run directories you will only be prompted again if the file is missing or if the path within it is not valid.
----------------------------------------------------------- Enter path for ExtData: -----------------------------------------------------------
Choose simulation type
Enter the integer number that is next to the simulation type you want to use.
----------------------------------------------------------- Choose simulation type: ----------------------------------------------------------- 1. Full chemistry 2. TransportTracers
If creating a full chemistry run directory you will be given additional options. Enter the integer number that is next to the simulation option you want to run.
----------------------------------------------------------- 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
Choose meteorology source
Enter the integer number that is next to the input meteorology source you would like to use.
----------------------------------------------------------- Choose meteorology source: ----------------------------------------------------------- 1. MERRA2 (Recommended) 2. GEOS-FP
Enter run directory path
Enter the target path where the run directory will be stored. You will be prompted to enter a new path if the one you enter does not exist.
----------------------------------------------------------- Enter path where the run directory will be created: -----------------------------------------------------------
Enter run directory name
Enter the run directory name, or accept the default. You will be prompted for a new name if a run directory of the same name already exists at the target path.
----------------------------------------------------------- Enter run directory name, or press return to use default: -----------------------------------------------------------
Optionally apply version control
Enter whether you would like your run directory tracked with git version control. With version control you can keep track of exactly what you changed relative to the original settings.
----------------------------------------------------------- Do you want to track run directory changes with git? (y/n) -----------------------------------------------------------
Step 2: Set Environment
Set the gchp.env symbolic link to your GCHP environment file using shell script setEnvironment.
cd /home/gchp_fullchem ./setEnvironment /home/envs/gchp_ifort19_openmpi4.env
Tips:
- You can keep your environment file anywhere on your system for reuse across multiple run directories.
- Always source
gchp.envprior to building and running GCHP. - Include
source gchp.envat the top of your run scripts.
Additional information
A new run directory should be created for each different version of GEOS-Chem you use. Version information per run directory is located in file rundir.version.
Previous | Next | Getting Started with GCHP | GCHP Main Page
