Skip to content

Check for parameter and options consistency, add parameters docs - #784

Draft
trontrytel wants to merge 2 commits into
mainfrom
aj/parameters_docs
Draft

trontrytel wants to merge 2 commits into
mainfrom
aj/parameters_docs

Conversation

@trontrytel

Copy link
Copy Markdown
Member

No description provided.

trontrytel and others added 2 commits September 4, 2026 15:36
Move the option/parameter consistency check from Microphysics1M to
Utilities.consistent_params so MicrophysicsNonEq can use it too, and
apply it to every process method that reads mp.process_params:

- 1M: the six accretion methods and the three cloud liquid freezing
  options (the single freezing arms also accept the combined
  HomogeneousAndHeterogeneous parameters)
- NonEq: CloudLiquidFormation, ConstantTimescale, TemperatureDependent

NamedTuple parameter sets are matched by key set rather than by
NamedTuple type, since ClimaParams.get_parameter_values does not
preserve the name_map order.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
New "Parameters interface" section in the docs:

- Parameters.md: how parameter structs are built from ClimaParams,
  the 1M process options, overriding values, the packaged override
  TOML files, usage logging, and how to add a new parameter.
- generate_parameters_reference.jl: run from make.jl, it parses the
  constructors in src/parameters, constructs each one to record the
  parameters it actually reads (ClimaParams "used_in" tags), and
  writes a reference page mapping every ClimaParams parameter to the
  struct fields it feeds, with defaults and descriptions. A name_map
  entry that the code does not read fails the docs build.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
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.

1 participant