Skip to content

Replace cheyenne references with derecho throughout#3838

Open
slevis-lmwg wants to merge 6 commits intoESCOMP:b4b-devfrom
slevis-lmwg:cheyenne_refs_to_derecho
Open

Replace cheyenne references with derecho throughout#3838
slevis-lmwg wants to merge 6 commits intoESCOMP:b4b-devfrom
slevis-lmwg:cheyenne_refs_to_derecho

Conversation

@slevis-lmwg
Copy link
Contributor

@slevis-lmwg slevis-lmwg commented Mar 24, 2026

Description of changes

Specific notes

Contributors other than yourself, if any:

CTSM Issues Fixed (include github issue #):
Fixes #2223

Are answers expected to change (and if so in what way)?
No

Any User Interface Changes (namelist or namelist defaults changes)?
No

Does this create a need to change or add documentation? Did you do so?
That's the main focus of this PR

Testing performed, if any:
Changes here affect python files, so I ran these tests before opening the PR (see #2223) and will likely rerun before merging to b4b-dev:

  • make black and lint
  • ./run_ctsm_py_tests -u and -s
  • ./run_sys_tests -s clm_pymods -c ctsm5.4.025 --skip-generate

@slevis-lmwg slevis-lmwg changed the title Cheyenne refs to derecho Replace cheyenne references with derecho throughout Mar 24, 2026
@slevis-lmwg slevis-lmwg self-assigned this Mar 24, 2026
@slevis-lmwg slevis-lmwg added documentation additions or edits to user-facing documentation or its infrastructure bfb bit-for-bit docs:update Significant update or fix needed to existing documentation docs-loc:users-guide Relates to User's Guide (using CTSM/tools) docs-loc:other Relates to documentation somewhere not covered by the other docs-loc labels. docs-loc:lilac Relates to LILAC documentation labels Mar 24, 2026
@github-project-automation github-project-automation bot moved this to Ready to start (or start again) in CTSM: Upcoming tags Mar 24, 2026
@slevis-lmwg slevis-lmwg moved this to In Progress in CLM documentation Mar 24, 2026
@slevis-lmwg slevis-lmwg moved this from Ready to start (or start again) to In progress - b4b-dev in CTSM: Upcoming tags Mar 24, 2026
@slevis-lmwg slevis-lmwg moved this from Todo to In Progress in LMWG: Sprint Planning Board Mar 24, 2026
@slevis-lmwg slevis-lmwg linked an issue Mar 24, 2026 that may be closed by this pull request
@slevis-lmwg slevis-lmwg added this to the ctsm6.0.0 (code freeze) milestone Mar 24, 2026
Note, that when running with ``PTS_MODE`` the number of processors is automatically set to one. When running a single grid point you can only use a single processor. You might also want to set the ``env_build.xml`` variable: ``MPILIB=mpi-serial`` to ``TRUE`` so that you can also run interactively without having to use MPI to start up your job.

On many machines, batch queues have a minimum number of nodes or processors that can be used. On these machines you may have to change the queue and possibly the time-limits of the job, to get it to run in the batch queue. On the NCAR machine, cheyenne, this is done for you automatically, and the "share" or "caldera" queue is used for such single-processor simulations. For single point mode you also may want to consider using a smaller workstation or cluster, rather than a super-computer, because you can't take advantage of the multi-processing power of the super-computer anyway.
On many machines, batch queues have a minimum number of nodes or processors that can be used. On these machines you may have to change the queue and possibly the time-limits of the job, to get it to run in the batch queue. On the NCAR machine, derecho, this is done for you automatically, and the "xxx" queue is used for such single-processor simulations. For single point mode you also may want to consider using a smaller workstation or cluster, rather than a super-computer, because you can't take advantage of the multi-processing power of the super-computer anyway.
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@ekluzek here I changed cheyenne to derecho, but what should I put in place of "xxx" and/or should parts of this be removed altogether?

mpiexec_mpt ./wrf.exe

(See :numref:`runtime-environment-variables` for a description of the need to set ``MPI_TYPE_DEPTH`` on ``Cheyenne``.)
(See :numref:`runtime-environment-variables` for a description of the need to set ``MPI_TYPE_DEPTH`` on ``derecho``.)
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@ekluzek here I changed cheyenne to derecho, but does the comment still apply?

========================================================

With the MPT MPI library (which is the default MPI library on NCAR's cheyenne machine), it is important to set the environment variable ``MPI_TYPE_DEPTH`` to 16 when running CTSM (this setting is required by the Parallel IO library). Typically you should set this variable in your job submission script, using either:
With the MPT MPI library (which is the default MPI library on NCAR's derecho machine), it is important to set the environment variable ``MPI_TYPE_DEPTH`` to 16 when running CTSM (this setting is required by the Parallel IO library). Typically you should set this variable in your job submission script, using either:
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@ekluzek does this comment still apply?

},
),
"hobart": MachineDefaults(
"thorodin": MachineDefaults(
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@ekluzek as far as I know, hobart is unavailable and thorodin is available, but does it make sense that I replaced the former with the latter here?

@slevis-lmwg slevis-lmwg requested a review from ekluzek March 24, 2026 22:39
@slevis-lmwg slevis-lmwg moved this from In Progress to In review in CLM documentation Mar 24, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

bfb bit-for-bit docs:update Significant update or fix needed to existing documentation docs-loc:lilac Relates to LILAC documentation docs-loc:other Relates to documentation somewhere not covered by the other docs-loc labels. docs-loc:users-guide Relates to User's Guide (using CTSM/tools) documentation additions or edits to user-facing documentation or its infrastructure

Projects

Status: In review
Status: In progress - b4b-dev
Status: In Progress

Development

Successfully merging this pull request may close these issues.

Docs: Change Cheyenne references to Derecho

1 participant