CTSM

The Community Land Model is the land model for the Community Earth System Model, which formalises and quantifies concepts of ecological climatology.
https://github.com/ESCOMP/CTSM

Category: Climate Change
Sub Category: Earth and Climate Modeling

Keywords

cesm climate clm ecosystem hydrology land land-surface-model ncar

Keywords from Contributors

climate-model climate-science datamodeling earth-system-model snl-applications e3sm nwp numerical-modeling community river

Last synced: about 13 hours ago
JSON representation

Repository metadata

Community Terrestrial Systems Model (includes the Community Land Model of CESM)

README.CHECKLIST.new_case.md

$CTSMROOT/README.CHECKLIST.new_case 03/01/2021

This is a check list of things to do when setting up a new case in order to help ensure everything is correct. There are lots of tiny details that need to be right and it's easy to get something wrong. So the first screening to make sure it's right is for you to carefully check through your case and make sure it's right.

The following assumes you have created a new case and are in its case directory.

General Checklist to always do:

  • Make sure CLM_ environment settings are correct: ./xmlquery -p CLM
  • Make sure you are using the correct CLM_PHYSICS_VERSION: ./xmlquery -p CLM_PHYSICS_VERSION
  • Make sure you are running the appropriate overall CLM vegetation model, i.e. the -bgc option of either Satellite Phenology (sp) or Full BioGeoChemistry (bgc) or FATES (fates): ./xmlquery -p CLM_BLDNML_OPTS
  • If you are running the bgc model, check to see if you should be running the prognostic crop model: option -crop in CLM_BLDNML_OPTS
  • Make sure the LND_TUNING_MODE is correct: ./xmlquery LND_TUNING_MODE
  • For an "I compset" make sure you are running over the correct forcing years: usually ./xmlquery -p DATM_YR
  • For an "I compset" make sure the DATM streams are operating over the correct years: look at the CaseDocs/datm.streams.xml file
  • First and align year for streams should be the start year of a historical simulation: ./xmlquery RUN_STARTDATE; grep stream_year_first CaseDocs/lnd_in; grep model_year_align CaseDocs/lnd_in
  • Last year for streams should be the last year you are going to run to (or beyond it): grep stream_year_last CaseDocs/lnd_in
  • Make sure you are starting from appropriate spunup initial conditions:
    • Check the run-type with: ./xmlquery RUN_TYPE
    • Check finidat for a startup or hybrid simulation: grep finidat CaseDocs/lnd_in
    • Check nrevsn for a branch simulation: grep nrevsn CaseDocs/lnd_in
  • Run for a month (or some short period) and go over the log files and especially the settings and files read in them: for an I case you especially want to look at the lnd.log and atm.log files

Some other suggestions on things that can be done:

  • Compare namelist files to an existing case if you are doing something almost the same as a previous simulation
  • Ask another collaborator to look over your case directory

Owner metadata


GitHub Events

Total
Last Year

Committers metadata

Last synced: 4 days ago

Total Commits: 14,215
Total Committers: 135
Avg Commits per committer: 105.296
Development Distribution Score (DDS): 0.738

Commits in past year: 1,997
Committers in past year: 33
Avg Commits per committer in past year: 60.515
Development Distribution Score (DDS) in past year: 0.698

Name Email Commits
Erik Kluzek e****k@u****u 3729
Sam Rabin s****n@g****m 2575
Samuel Levis s****g@g****m 2090
Bill Sacks s****s@u****u 1894
Gregory Lemieux g****x 584
Negin Sobhani n****3@g****m 504
Mariana Vertenstein m****s@u****u 319
Ryan Knox r****x@l****v 299
Keith Oleson o****n@u****u 272
Sean Swenson s****c@u****u 227
adrifoster a****t@u****u 167
wwieder w****r@u****u 166
Teagan King t****g@u****u 166
Jim Edwards j****s@u****u 140
mvdebolskiy n****l@g****m 93
Adrianna Foster a****r@u****u 76
chen693 y****g@p****v 56
Stefan Muszala m****a@u****u 54
Ben Andre a****e@u****u 51
sunnivin s****s@g****m 50
Joseph Hamman j****n@u****u 44
Danny M. Leung d****g@u****u 43
cathyxinchangli 5****i 33
rosiealice r****r@g****m 32
ckoven c****n@g****m 26
Daniel Kennedy d****0@c****u 23
Danica Lombardozzi d****l@t****u 21
ivanderkelen i****n@v****e 19
Mathew Rothstein m****r@u****u 19
Keith Oleson o****n@r****u 19
and 105 more...

Committer domains:


Issue and Pull Request metadata

Last synced: 6 days ago

Total issues: 1,259
Total pull requests: 932
Average time to close issues: about 1 year
Average time to close pull requests: 2 months
Total issue authors: 78
Total pull request authors: 58
Average comments per issue: 3.34
Average comments per pull request: 5.57
Merged pull request: 584
Bot issues: 0
Bot pull requests: 12

Past year issues: 243
Past year pull requests: 168
Past year average time to close issues: 16 days
Past year average time to close pull requests: 9 days
Past year issue authors: 17
Past year pull request authors: 26
Past year average comments per issue: 2.22
Past year average comments per pull request: 3.2
Past year merged pull request: 61
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/ESCOMP/CTSM

Top Issue Authors

  • ekluzek (419)
  • samsrabin (290)
  • billsacks (116)
  • slevis-lmwg (105)
  • wwieder (93)
  • olyson (49)
  • rgknox (24)
  • glemieux (24)
  • adrifoster (14)
  • mvdebolskiy (7)
  • djk2120 (6)
  • jedwards4b (6)
  • lifang0209 (6)
  • dlawrenncar (5)
  • mvertens (5)

Top Pull Request Authors

  • samsrabin (274)
  • slevis-lmwg (167)
  • ekluzek (126)
  • rgknox (56)
  • olyson (39)
  • glemieux (33)
  • adrifoster (26)
  • wwieder (24)
  • jedwards4b (21)
  • billsacks (19)
  • mvdebolskiy (15)
  • TeaganKing (13)
  • swensosc (13)
  • dependabot[bot] (12)
  • dmleung (7)

Top Issue Labels

  • enhancement (266)
  • bug (219)
  • bfb (207)
  • science (158)
  • documentation (108)
  • priority: low (103)
  • testing (100)
  • type: enhancement (92)
  • type: bug (85)
  • usability (74)
  • code health (71)
  • closed: wontfix (63)
  • next (59)
  • priority: high (53)
  • type: code cleanup (47)
  • good first issue (42)
  • done (36)
  • type: tests (35)
  • docs-loc:users-guide (34)
  • devops (33)
  • investigation (32)
  • docs-loc:tech-note (31)
  • tag: next (31)
  • size: small (29)
  • external (24)
  • type: documentation (23)
  • non-bfb (23)
  • blocked: dependency (22)
  • test: python (22)
  • tag: simple bfb (21)

Top Pull Request Labels

  • bfb (280)
  • enhancement (182)
  • type: enhancement (84)
  • science (75)
  • bug (69)
  • PR status: ready (68)
  • documentation (57)
  • priority: high (47)
  • test: aux_clm (47)
  • devops (45)
  • tag: simple bfb (44)
  • testing (42)
  • code health (38)
  • non-bfb (35)
  • tag: enh - new science (34)
  • size: small (32)
  • blocked: dependency (31)
  • test: python (28)
  • usability (27)
  • PR status: needs testing (26)
  • priority: Immediate (25)
  • next (24)
  • type: tests (22)
  • PR status: awaiting review (22)
  • blocker (22)
  • test: fates (22)
  • b4b (21)
  • docs-loc:tech-note (19)
  • tag: bfb (19)
  • FATES update requiring an API change (17)

Dependencies

lilac/Dockerfile docker
  • jhamman/esmf latest build
lilac/docker-compose.yml docker
lilac/docs/requirements.txt pypi
  • numpy *
  • sphinx ==1.6.7
  • sphinx-fortran *
python/pyproject.toml pypi
.github/workflows/docker-image-get-version.yml actions
  • actions/checkout 11bd71901bbe5b1630ceea73d27597364c9af683 composite
.github/workflows/fleximod_test.yaml actions
  • actions/checkout v4 composite
.github/workflows/docker-image-build-publish.yml actions
  • actions/attest-build-provenance e8998f949152b193b063cb0ec769d69d929409be composite
  • actions/checkout 11bd71901bbe5b1630ceea73d27597364c9af683 composite
  • docker/build-push-action 471d1dc4e07e5cdedd4c2171150001c434f0b7a4 composite
  • docker/login-action 65b78e6e13532edd9afa3aa52ac7964289d1a9c1 composite
  • docker/setup-buildx-action b5ca514318bd6ebac0fb2aedd5d36ec1b5c232a2 composite
.github/workflows/docs-common.yml actions
  • actions/cache 2f8e54208210a422b2efd51efaa6bd6d7ca8920f composite
  • actions/checkout 11bd71901bbe5b1630ceea73d27597364c9af683 composite
  • actions/setup-python a26af69be951a213d495a4c3e4e4022e16d87065 composite
  • conda-incubator/setup-miniconda 2defc80cc6f4028b1780c50faf08dd505d698976 composite
.github/workflows/docs-update-doc-builder.yml actions
  • actions/checkout 11bd71901bbe5b1630ceea73d27597364c9af683 composite
.github/workflows/docs.yml actions
  • actions/checkout 11bd71901bbe5b1630ceea73d27597364c9af683 composite
doc/ctsm-docs_container/requirements.txt pypi
  • myst-parser ==5.0.0
  • rst2pdf ==0.103.1
  • sphinx ==8.2.3
  • sphinx_rtd_theme ==3.0.2
  • sphinxcontrib_programoutput ==0.18
.github/workflows/docs-omnibus.yml actions
  • actions/checkout 11bd71901bbe5b1630ceea73d27597364c9af683 composite
  • conda-incubator/setup-miniconda 2defc80cc6f4028b1780c50faf08dd505d698976 composite
doc/ctsm-docs_container/Dockerfile docker
  • python 3.13.2-alpine build
.github/workflows/docker-image-build.yml actions
.github/workflows/docs-build-and-deploy.yml actions
  • actions/checkout 11bd71901bbe5b1630ceea73d27597364c9af683 composite
  • actions/configure-pages 983d7736d9b0ae728b81ab479565c72886d7745b composite
  • actions/deploy-pages f33f41b675f0ab2dc5a6863c9a170fe83af3571e composite
  • actions/upload-pages-artifact 0252fc4ba7626f0298f0cf00902a25c6afc77fa8 composite
.github/workflows/python-tests.yml actions
  • actions/checkout 11bd71901bbe5b1630ceea73d27597364c9af683 composite
  • conda-incubator/setup-miniconda 2defc80cc6f4028b1780c50faf08dd505d698976 composite
.lib/git-fleximod/pyproject.toml pypi
  • fsspec ^2023.12.2
  • gitpython ^3.1.0
  • pre-commit 4.3.0
  • pyfakefs ^5.3.5
  • pytest ^8.0.0
  • python >=3.9
  • sphinx ^5.0.0
  • wheel ^0.42.0
  • wrapt >=2.0.0
.github/workflows/check-clm6-aliases.yml actions
  • actions/checkout 11bd71901bbe5b1630ceea73d27597364c9af683 composite
.github/workflows/docker-image-common.yml actions
  • actions/checkout 11bd71901bbe5b1630ceea73d27597364c9af683 composite
  • docker/build-push-action 471d1dc4e07e5cdedd4c2171150001c434f0b7a4 composite
  • docker/login-action 65b78e6e13532edd9afa3aa52ac7964289d1a9c1 composite
  • docker/metadata-action 9ec57ed1fcdbf14dcef7dfbe97b2010124a938b7 composite
.github/workflows/docs-update-ctsm_pylib.yml actions
  • JasonEtco/create-an-issue 1b14a70e4d8dc185e5cc76d3bec9eab20257b2c5 composite
  • actions/checkout 11bd71901bbe5b1630ceea73d27597364c9af683 composite
.github/workflows/docs-update-dependency-common.yml actions
  • actions/checkout 11bd71901bbe5b1630ceea73d27597364c9af683 composite
  • conda-incubator/setup-miniconda 2defc80cc6f4028b1780c50faf08dd505d698976 composite
.github/workflows/xml-check.yml actions
  • actions/checkout 11bd71901bbe5b1630ceea73d27597364c9af683 composite
  • actions/setup-python a26af69be951a213d495a4c3e4e4022e16d87065 composite
lilac/ci/environment.yml conda
  • cmake >=3
  • python 3.6
.lib/git-fleximod/poetry.lock pypi
  • alabaster 0.7.16
  • babel 2.17.0
  • certifi 2025.11.12
  • cfgv 3.4.0
  • charset-normalizer 3.4.4
  • colorama 0.4.6
  • distlib 0.4.0
  • docutils 0.19
  • exceptiongroup 1.3.1
  • filelock 3.19.1
  • fsspec 2023.12.2
  • gitdb 4.0.12
  • gitpython 3.1.45
  • identify 2.6.15
  • idna 3.11
  • imagesize 1.4.1
  • importlib-metadata 8.7.0
  • iniconfig 2.1.0
  • jinja2 3.1.6
  • markupsafe 3.0.3
  • nodeenv 1.9.1
  • packaging 25.0
  • platformdirs 4.4.0
  • pluggy 1.6.0
  • pre-commit 4.3.0
  • pyfakefs 5.10.2
  • pygments 2.19.2
  • pytest 8.4.2
  • pyyaml 6.0.3
  • requests 2.32.5
  • smmap 5.0.2
  • snowballstemmer 3.0.1
  • sphinx 5.3.0
  • sphinxcontrib-applehelp 2.0.0
  • sphinxcontrib-devhelp 2.0.0
  • sphinxcontrib-htmlhelp 2.1.0
  • sphinxcontrib-jsmath 1.0.1
  • sphinxcontrib-qthelp 2.0.0
  • sphinxcontrib-serializinghtml 2.0.0
  • tomli 2.3.0
  • typing-extensions 4.15.0
  • urllib3 2.5.0
  • virtualenv 20.35.4
  • wheel 0.42.0
  • wrapt 2.0.1
  • zipp 3.23.0
.github/workflows/docs-pr-failure-post-comment.yml actions
  • actions/download-artifact v4 composite

Score: 12.115354406609217