Skip to content

Stricter control of ECF_ variables in suite-definition files#932

Merged
maddenp-cu merged 8 commits into
ufs-community:mainfrom
maddenp-cu:ecf-vars
Jun 16, 2026
Merged

Stricter control of ECF_ variables in suite-definition files#932
maddenp-cu merged 8 commits into
ufs-community:mainfrom
maddenp-cu:ecf-vars

Conversation

@maddenp-cu

Copy link
Copy Markdown
Collaborator

Synopsis

In ecFlow suitedef vars blocks, accept:

  • Arbitrary user-defined variables if they do not start with ECF_
  • A fixed set of ECF_ vars accepted in ecFlow suite-definition files.

I've tried to define the correct set of ECF_ variables based on the ecFlow documentation, but I'm not certain the docs are complete or correct, so we may need to update this as we learn more.

Note that, as stated here, variables automatically generated by ecFlow are permitted to be overwritten by users in suite definitions. So, these variables appear in the new schema in addition to those defined here explicitly as suite-definition variables.

Type

  • Enhancement (adds new functionality)

Impact

  • This is a non-breaking change (existing functionality continues to work as expected)

Checklist

  • I have added myself and any co-authors to the PR's Assignees list.
  • I have reviewed the documentation and have made any updates necessitated by this change.
  • Where helpful, I have written comments in this PR's Files changed view to assist reviewers.

@maddenp-cu maddenp-cu self-assigned this Jun 16, 2026
@maddenp-cu maddenp-cu requested review from AnnaSmoot-NOAA and Copilot and removed request for Copilot June 16, 2026 00:10
@maddenp-cu maddenp-cu marked this pull request as ready for review June 16, 2026 00:11

@christinaholtNOAA christinaholtNOAA left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

I think the code changes look great, but should we have this information in the docs?

Note that, as stated here, variables automatically generated by ecFlow are permitted to be overwritten by users in suite definitions. So, these variables appear in the new schema in addition to those defined here explicitly as suite-definition variables.

@maddenp-cu

Copy link
Copy Markdown
Collaborator Author

I think the code changes look great, but should we have this information in the docs?

Note that, as stated here, variables automatically generated by ecFlow are permitted to be overwritten by users in suite definitions. So, these variables appear in the new schema in addition to those defined here explicitly as suite-definition variables.

Good idea. I think we could (and probably should) link to the ecFlow docs for these details, but I wouldn't want to restate them. Let me see what I can add.

@maddenp-cu maddenp-cu merged commit 09c498f into ufs-community:main Jun 16, 2026
2 of 3 checks passed
@maddenp-cu maddenp-cu deleted the ecf-vars branch June 16, 2026 17:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants