update documentation FAQ about setting resources and turning off output by DeniseWorthen · Pull Request #1608 · ufs-community/ufs-weather-model

DeniseWorthen · 2023-02-10T21:38:11Z

Description

Updates FAQ section of documentation to describe how to set resources for coupled model.

Top of commit queue on: TBD

Input data additions/changes

No changes are expected to input data.
There will be new input data.
Input data will be updated.

Anticipated changes to regression tests:

No changes are expected to any regression test.
Changes are expected to the following tests:

Subcomponents involved:

Combined with PR's (If Applicable):

Commit Queue Checklist:

Link PR's from all sub-components involved (N/A)
Confirm reviews completed in sub-component PR's
Add all appropriate labels to this PR.
Run full RT suite on either Hera/Cheyenne with both Intel/GNU compilers (N/A)
Add list of any failed regression tests to "Anticipated changes to regression tests" section. (N/A)

Linked PR's and Issues:

fixes add information about setting resources for coupled configuration to the documentation #1607

Test build can be seen here

Testing Day Checklist:

This PR is up-to-date with the top of all sub-component repositories except for those sub-components which are the subject of this PR.
Move new/updated input data on RDHPCS Hera and propagate input data changes to all supported systems.

Testing Log (for CM's):

RDHPCS
- Intel
  - Hera
  - Orion
  - Jet
  - Gaea
  - Cheyenne
- GNU
  - Hera
  - Cheyenne
WCOSS2
- Dogwood/Cactus
- Acorn
CI
- Completed
opnReqTest
- N/A
- Log attached to comment

DeniseWorthen · 2023-02-10T21:39:39Z

I just realized I skipped MOM6, so I will add that. I need to check w/ Jiande about what Jun's document had written.

DusanJovic-NOAA · 2023-02-10T21:55:59Z

-   * compute tasks = ``x layout * y layout * number of tiles``
-   * quilt tasks = ``write_groups * write_tasks_per_group`` if ``quilting==.true.``
+In the UFS WM, each component's MPI task information, including the
+starting task and end ending task numbers and the number of threads,


'starting task and end ending task numbers and the number of threads,'

extra 'end'

and I think instead of 'task numbers' it's better to say 'task ranks'

junwang-noaa · 2023-02-11T15:45:24Z

+FV3
+^^^
+FV3ATM consists of one or more forecast grid components and a write
+grid component.


write grid components

junwang-noaa · 2023-02-11T15:48:35Z

+
+   total tasks = number of forecast tasks + number of write grid component tasks
+
+If ESMF-managed threading is used, the total number of tasks for


the total number of PETs for

junwang-noaa · 2023-02-11T15:51:44Z

+::
+
+   ATM_petlist_bounds     0 total_tasks*number_of_threads-1
+   ATM_omp_num_threads    number_of_threads


Maybe it will be clearer if we use number_of_threads_amt? I see we have "number_of_threads" for atm/wave/cmeps, we may let user know what the number_of_threads could be different for each component.

DeniseWorthen · 2023-02-13T16:43:15Z

@junwang-noaa @DusanJovic-NOAA I've made changes based on your feedback. I'm probably still mis-using the task/ranks terminology (I find the terms a bit squidgy). I'm happy to try to be more precise, but I'll need a little guidance if I haven't got it quite right.

junwang-noaa

It looks good.

jiandewang · 2023-02-13T17:28:40Z

@DeniseWorthen : a question (may not related to this PR), under section
How do I select the file format for the model output (netCDF or NEMSIO)?
In your run directory, there is a file named model_configure. Change the variable output_file to 'netcdf' or 'nemsio'

are we still support nemsio ?

junwang-noaa · 2023-02-13T17:35:48Z

@jiandewang No the UFS does not support nemsio files any more.

…

On Mon, Feb 13, 2023 at 12:28 PM jiandewang ***@***.***> wrote: @DeniseWorthen <https://github.com/DeniseWorthen> : a question (may not related to this PR), under section How do I select the file format for the model output (netCDF or NEMSIO)? In your run directory, there is a file named model_configure. Change the variable output_file to 'netcdf' or 'nemsio' are we still support nemsio ? — Reply to this email directly, view it on GitHub <#1608 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AI7D6TOURWFHWMMSMM57EUDWXJVNHANCNFSM6AAAAAAUYIGRWQ> . You are receiving this because you were mentioned.Message ID: ***@***.***>

jiandewang · 2023-02-13T17:39:33Z

then we can take this chance to remove that in the doc

jkbk2004 · 2023-02-17T22:40:52Z

@DeniseWorthen I will ask @binli2337 to combine in this pr. You can directly create a pr to his branch. Can you update the branch?

DeniseWorthen · 2023-02-17T22:50:40Z

@jkbk2004 I've updated but will wait for @binli2337 to update before making a PR.

jkbk2004 · 2023-02-17T22:52:03Z

sure! I will leave a note to Bin's pr.

DeniseWorthen · 2023-02-21T15:37:14Z

Combined with #1597; closing

update FAQ about setting resources

743acb0

DeniseWorthen added the documentation Improvements or additions to documentation label Feb 10, 2023

DeniseWorthen requested review from BrianCurtis-NOAA, DusanJovic-NOAA and junwang-noaa February 10, 2023 21:38

DeniseWorthen requested review from MatthewMasarik-NOAA and jiandewang February 10, 2023 21:40

DusanJovic-NOAA reviewed Feb 10, 2023

View reviewed changes

junwang-noaa reviewed Feb 11, 2023

View reviewed changes

add mom6 settings, add more specific component info

1da8c5c

junwang-noaa approved these changes Feb 13, 2023

View reviewed changes

remove reference to nemsio in FAQ

96f5f44

BrianCurtis-NOAA approved these changes Feb 13, 2023

View reviewed changes

jiandewang approved these changes Feb 13, 2023

View reviewed changes

DeniseWorthen and others added 2 commits February 14, 2023 17:10

Merge branch 'ufs-community:develop' into docs/faqupdate

a5d8862

add section to FAQ about turning off I/O

b960f62

DeniseWorthen changed the title ~~update documentation FAQ about setting resources~~ update documentation FAQ about setting resources and turning off output Feb 14, 2023

jkbk2004 mentioned this pull request Feb 15, 2023

Update CDEPS component; update documentation FAQ about setting resources and turning off output; update FAQ documentation (was 1608); update drag suite intent mods (was 1612) #1597

Merged

37 tasks

DeniseWorthen added 2 commits February 15, 2023 08:22

clarify FV3 IO settings

822b8f1

clarify FV3 IO output options

4fa885f

Merge branch 'ufs-community:develop' into docs/faqupdate

b49a6fb

DeniseWorthen changed the title ~~update documentation FAQ about setting resources and turning off output~~ update documentation FAQ about setting resources and turning off output; update FAQ documentation (was 1608); update drag suite intent mods (was 1612) Feb 21, 2023

DeniseWorthen closed this Feb 21, 2023

DeniseWorthen changed the title ~~update documentation FAQ about setting resources and turning off output; update FAQ documentation (was 1608); update drag suite intent mods (was 1612)~~ update documentation FAQ about setting resources and turning off output Feb 21, 2023

DeniseWorthen self-assigned this Feb 22, 2025

DeniseWorthen deleted the docs/faqupdate branch November 7, 2025 11:37


		total tasks = number of forecast tasks + number of write grid component tasks

		If ESMF-managed threading is used, the total number of tasks for

Conversation

DeniseWorthen commented Feb 10, 2023

Description

Top of commit queue on: TBD

Input data additions/changes

Anticipated changes to regression tests:

Subcomponents involved:

Combined with PR's (If Applicable):

Commit Queue Checklist:

Linked PR's and Issues:

Testing Day Checklist:

Testing Log (for CM's):

Uh oh!

DeniseWorthen commented Feb 10, 2023

Uh oh!

DusanJovic-NOAA Feb 10, 2023

Choose a reason for hiding this comment

Uh oh!

junwang-noaa Feb 11, 2023

Choose a reason for hiding this comment

Uh oh!

junwang-noaa Feb 11, 2023 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

junwang-noaa Feb 11, 2023

Choose a reason for hiding this comment

Uh oh!

DeniseWorthen commented Feb 13, 2023

Uh oh!

junwang-noaa left a comment

Choose a reason for hiding this comment

Uh oh!

jiandewang commented Feb 13, 2023

Uh oh!

junwang-noaa commented Feb 13, 2023 via email

Uh oh!

jiandewang commented Feb 13, 2023

Uh oh!

jkbk2004 commented Feb 17, 2023

Uh oh!

DeniseWorthen commented Feb 17, 2023

Uh oh!

jkbk2004 commented Feb 17, 2023

Uh oh!

DeniseWorthen commented Feb 21, 2023

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

junwang-noaa Feb 11, 2023 •

edited

Loading