Skip to content

Conversation

dayantur
Copy link

This PR created a complete analysis system to identify and catalog internal-only parameters.

Features:

  • analyze_internal_only_parameters.py: Automated script to scan data model files
  • internal_only_parameters_table.csv: CSV with param_name, file_location, in_sample_config
  • internal_only_parameters_report.md: Structured markdown report

Key findings:

  • 24 total internal-only parameters identified
  • 11 parameters present in sample_config.yml
  • 13 parameters not present
  • Parameters span state.py (22) and model.py (2)

Script automatically compares against sample_config.yml instead of benchmark1.yml and can be re-run as the data model evolves.

Addresses GitHub issue #555: Identify complete list of internal-only parameters.

dayantur and others added 5 commits July 25, 2025 14:39
- Created analyze_internal_only_parameters.py script to scan data model files
- Generated table comparing with sample_config.yml instead of benchmark1.yml
- Found 24 total internal-only parameters (11 in sample_config, 13 not)
- Provides CSV table and markdown report for analysis
- Script can be re-run as data model evolves

Key findings:
- 11 parameters present in sample_config.yml need review
- 13 parameters are true internal state variables
- Parameters span state.py (22) and model.py (2)

Addresses GitHub issue #555: Identify complete list of internal-only parameters

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
- Updated analyze_internal_only_parameters.py to exclude description from CSV
- Regenerated internal_only_parameters_table.csv with cleaner format
- Kept descriptions in markdown report for full analysis
- CSV now has: param_name, file_location, in_sample_config, sample_config_location, unit

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
- Updated script to remove descriptions from all tables in markdown report
- Simplified format: Parameter | In sample_config.yml | Unit
- Cleaner, more focused output for both CSV and markdown
- Maintains all essential information without verbose descriptions

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
- Removed unit column from all markdown tables
- Removed "Location in sample_config.yml" column from present parameters table
- Simplified format: Parameter | In sample_config.yml (main tables)
- Simplified format: Parameter | File (detailed tables)
- Much cleaner, focused output showing only essential information

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
Copy link

🤖 I've automatically formatted the code in this PR using:

  • Python: ruff v0.8.6
  • Fortran: fprettify v0.3.7

Please pull the latest changes before making further edits.

Copy link

Choose a reason for hiding this comment

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

Just a note - this is a temporary file – to be cleaned up upon wrapping up this work.

@sunt05
Copy link

sunt05 commented Jul 25, 2025

Some more audit trail - this field was first introduced in #439 .

@sunt05 sunt05 changed the title Add comprehensive internal-only parameters analysis for issue #555 [WIP] Add comprehensive internal-only parameters analysis for issue #555 Jul 25, 2025

## Parameters Present in sample_config.yml

These parameters are marked as internal-only but appear in the sample configuration:
Copy link

Choose a reason for hiding this comment

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

All of these can be moved out of the user-facing YAML.

@sunt05 sunt05 changed the title Add comprehensive internal-only parameters analysis for issue #555 [WIP] Add comprehensive internal-only parameters analysis for issue #555 Jul 25, 2025
- Document criteria for identifying internal-only parameters
- List all 24 currently identified internal parameters
- Provide recommendations for additional parameters (tair_av, hdd_id)
- Clarify which parameters should remain user-accessible (state, SPARTACUS, snowfallcum)
- Flag diagnose parameter for further discussion
- Include implementation notes for developers

Addresses #555
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.

2 participants