Skip to content

Latest commit

 

History

23 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

kmELM (Kilometer-scale E3SM Land Model)

Overview

The kilometer-scale E3SM Land Model (ELM) is a high-resolution version of the land surface component of the Energy Exascale Earth System Model (E3SM), designed to capture fine-scale terrestrial processes such as hydrology, vegetation dynamics, and carbon-nutrient cycles with unprecedented spatial detail. By resolving sub-grid heterogeneity at the kilometer scale, ELM improves the representation of complex land-atmosphere interactions, such as topographically driven water redistribution, localized land use changes, and ecosystem responses to climate variability. This high-resolution modeling capability enables more accurate simulations of regional and global land surface processes, supporting applications in climate change assessment, extreme event prediction, and resource management.

Supported Systems and Recommended Environments

Frontier at ORNL

Perlmutter at NERSC

Baseline at ORNL

Repo Configuration


git clone git@github.com:daliwang/kmELM.git
cd kmELM
export kmELM_home=$PWD
git submodule update --init --recursive

Build and Run

E3SM land developer testing (Frontier)

Full procedure: docs/e3sm_land_developer_testing_procedure.md.
Results (campaign 1 complete; campaign 2 in progress): docs/e3sm_land_developer_testing_results.md.

create_test compiles on the login node and submits Slurm jobs for the runs. Launch the driver with setsid nohup so logout does not kill compile/submit. Do not wrap the whole suite in one sbatch script. On maint-3.0, generate/compare apply a local overlay (craygnu + Lmod wrapper); do not commit those E3SM files to the science branch. Overlay, what is mergeable, and whether to open a separate machines PR: docs/frontier_maint-3.0_testing_overlay.md.

Active campaign (2026-08-17) is maint-3.0 gold 34bd782d18 vs branch lnd/port-clm-cryosphere-fixes-maint-3.0. Settings: scripts/e3sm_land_developer.conf.sh. Campaign 1 gold baselines/a899004464/ is kept and not reused.

cd /lustre/orion/cli115/world-shared/wangd/kmELM/scripts

# Step 1: generate gold files from parent maint-3.0
setsid nohup ./e3sm_land_developer_generate.sh \
  > ../docs/e3sm_land_developer_generate_34bd782d18.nohup.log 2>&1 < /dev/null &

# Wait until generate jobs finish (queue empty and cs.status is clean), then:
# Step 2: compare the maint-3.0 development branch
setsid nohup ./e3sm_land_developer_compare.sh \
  > ../docs/e3sm_land_developer_compare_3c77ed78f3.nohup.log 2>&1 < /dev/null &

Monitor:

tail -f /lustre/orion/cli115/world-shared/wangd/kmELM/docs/e3sm_land_developer_generate_34bd782d18.nohup.log
module load cray-python/3.11.7
/lustre/orion/cli115/proj-shared/wangd/e3sm_scratch/cs.status.34bd782d18   # generate (campaign 2)
# /lustre/orion/cli115/proj-shared/wangd/e3sm_scratch/cs.status.3c77ed78f3   # compare (after generate)
# campaign 1 (complete):
# /lustre/orion/cli115/proj-shared/wangd/e3sm_scratch/cs.status.a899004464
# /lustre/orion/cli115/proj-shared/wangd/e3sm_scratch/cs.status.fbfcc93f52

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

4 watching

Forks

Releases

Packages

Contributors

Languages