-
Notifications
You must be signed in to change notification settings - Fork 11
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Update versions of linked repos; removed code and comments related to…
… Haswell nodes Baselibs: v7.16.0 ESMA_env: v4.23.0 ESMA_cmake: v3.36.0 GMAO_Shared: v1.9.6 GEOS_Util: v2.0.3 MAPL: v2.42.1
- Loading branch information
Showing
4 changed files
with
20 additions
and
22 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -4,7 +4,7 @@ This document explains how to build, set up, and run the GEOS land modeling and | |
|
||
## How to Build GEOSldas | ||
|
||
### Step 1: Load the Build Modules | ||
### Step 1: Load the Build Modules | ||
|
||
Load the `GEOSenv` module provided by the GMAO Software Infrastructure team. It contains the latest `git`, `CMake`, and `mepo` modules and must be loaded in any interactive window that is used to check out and build the model. | ||
|
||
|
@@ -13,7 +13,7 @@ module use -a (path) | |
module load GEOSenv | ||
``` | ||
|
||
where `(path)` depends on the computer and operating system: | ||
where `(path)` depends on the computer and operating system: | ||
|
||
| System | Path | | ||
| ------------- |---------------------------------------------------| | ||
|
@@ -28,7 +28,7 @@ For development work, clone the _entire_ repository and use the `develop` branch | |
``` | ||
git clone -b develop [email protected]:GEOS-ESM/GEOSldas.git | ||
``` | ||
For science runs, you can also obtain a specific tag or branch _only_ (as opposed to the _entire_ repository), e.g.: | ||
For science runs, you can also obtain a specific tag or branch _only_ (as opposed to the _entire_ repository), e.g.: | ||
``` | ||
git clone -b v17.9.1 --single-branch [email protected]:GEOS-ESM/GEOSldas.git | ||
``` | ||
|
@@ -40,10 +40,10 @@ To build the model in a single step, do the following: | |
``` | ||
cd ./GEOSldas | ||
parallel_build.csh | ||
``` | ||
from a head node. Doing so will check out all the external repositories of the model (albeit only on the first run, [see subsection on mepo below](#mepo)!) and build the model. When done, the resulting model build will be found in `build/` and the installation will be found in `install/`, with setup scripts like `ldas_setup` in `install/bin`. | ||
``` | ||
from a head node. Doing so will check out all the external repositories of the model (albeit only on the first run, [see subsection on mepo below](#mepo)!) and build the model. When done, the resulting model build will be found in `build-SLES12/` and the installation will be found in `install-SLES12/`, with setup scripts like `ldas_setup` in `install-SLES12/bin`. | ||
|
||
To obtain a build that is suitable for debugging, use `parallel_build.csh -debug`, which will build in `build-Debug/` and install in `install-Debug/`. There is also an option for aggressive optimization. For details, see [GEOSldas Wiki](https://github.com/GEOS-ESM/GEOSldas/wiki). | ||
To obtain a build that is suitable for debugging, use `parallel_build.csh -debug`, which will build in `build-Debug-SLES12/` and install in `install-Debug-SLES12/`. There is also an option for aggressive optimization. For details, see [GEOSldas Wiki](https://github.com/GEOS-ESM/GEOSldas/wiki). | ||
|
||
See below for how to build the model in multiple steps. | ||
|
||
|
@@ -57,7 +57,7 @@ a) Set up the job as follows: | |
cd (build_path)/GEOSldas/install/bin | ||
source g5_modules [for bash or zsh: source g5_modules.[z]sh] | ||
./ldas_setup setup [-v] (exp_path) ("exe"_input_filename) ("bat"_input_filename) | ||
``` | ||
``` | ||
|
||
where | ||
|
||
|
@@ -70,14 +70,14 @@ where | |
|
||
The three arguments for `ldas_setup` are positional and must be ordered as indicated above. | ||
|
||
The latter two files contain essential information about the experiment setup. | ||
The latter two files contain essential information about the experiment setup. | ||
Sample files can be generated as follows: | ||
``` | ||
``` | ||
ldas_setup sample --exeinp > YOUR_exeinp.txt | ||
ldas_setup sample --batinp > YOUR_batinp.txt | ||
``` | ||
|
||
Edit these sample files following the examples and comments within the sample files. | ||
Edit these sample files following the examples and comments within the sample files. | ||
|
||
The ldas_setup script creates a run directory and other directories at: | ||
`[exp_path]/[exp_name]` | ||
|
@@ -156,7 +156,7 @@ and CMake will install there. | |
``` | ||
make -j6 install | ||
``` | ||
If you are at NCCS, you **should** run `make -j6 install` on an interactive _compute_ node. | ||
If you are at NCCS, you **should** run `make -j6 install` on an interactive _compute_ node. | ||
|
||
|
||
## Contributing | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters