Skip to content

v2026.01release Repository Changes - #72

Merged
mcallic2 merged 62 commits into
NOAA-GFDL:mainfrom
mcallic2:v2026.01release
Jul 16, 2026
Merged

v2026.01release Repository Changes#72
mcallic2 merged 62 commits into
NOAA-GFDL:mainfrom
mcallic2:v2026.01release

Conversation

@mcallic2

@mcallic2 mcallic2 commented Jul 16, 2026

Copy link
Copy Markdown
Collaborator

Summary

This pull request introduces the v2026.01 repository update, focused on improving repository organization, modernizing the build and runtime infrastructure, and enhancing maintainability while preserving existing functionality. In addition to restructuring the project layout, this release expands compiler and platform support, reorganizes runtime scripts, improves documentation, and incorporates updates to the tracker source code.

Collectively, these changes provide a more intuitive repository structure, simplify the build process, and establish a cleaner foundation for future development.

Major Changes

Repository Reorganization

  • Reorganized the repository into a more intuitive directory structure.
  • Moved source code into a dedicated compile/src_code/ hierarchy.
  • Consolidated documentation under a new docs/ directory.
  • Reorganized runtime assets and initialization files for improved discoverability.
  • Archived historical tropical cyclone vitals into a dedicated directory while preserving existing datasets.

Build System Improvements

  • Introduced a new top-level compilation workflow (compiletrkr.sh).
  • Removed legacy machine-specific build scripts and setup utilities.
  • Reorganized CMake configuration to align with the updated source layout.
  • Simplified compiler configuration and improved maintainability of the build system.

Platform and Environment Support

  • Added standardized compiler environment scripts for multiple supported HPC systems.
  • Expanded support for both GCC and Intel compiler environments.
  • Updated existing platform configurations where necessary to maintain compatibility with the new repository structure.

Runtime Script Refactoring

  • Replaced the previous monolithic runtime workflow with modular scripts.

  • Added dedicated setup scripts for:

    • GRIB workflows
    • NetCDF workflows
    • I/O configuration
    • Namelist generation
    • Tracker execution
    • Runtime variable configuration
  • Improved separation of responsibilities throughout the runtime pipeline, making individual components easier to understand and maintain.

Tracker Source Updates

  • Updated tracker source code and supporting CMake configuration.
  • Modified portions of the tracker implementation to support the updated runtime and build architecture.
  • Preserved and reorganized unit tests within the new source tree.

Documentation

  • Moved existing documentation into a dedicated docs/ directory.
  • Improved repository organization to make documentation easier to locate.
  • Updated documentation paths to match the new project structure.

Repository Cleanup

  • Removed obsolete machine setup scripts.
  • Removed deprecated build utilities and legacy runtime scripts.
  • Eliminated unused binaries and outdated helper programs.
  • Updated GitHub workflow configuration and repository housekeeping files.

Testing

  • Verified successful compilation using the updated build system.
  • Confirmed compatibility of the reorganized runtime workflow.
  • Preserved existing tracker unit tests within the updated repository structure.
  • Validated repository organization and build configuration after restructuring.

Notes for Reviewers

The majority of file movement in this pull request is due to repository reorganization rather than functional modifications. Reviewing commits individually or viewing the diff with file renames enabled may make the functional changes easier to identify.

Particular attention is recommended for:

  • Build system updates
  • Runtime workflow refactoring
  • Tracker source code modifications
  • Platform-specific environment configurations

Overall Impact

This release modernizes the repository by improving its organization, simplifying compilation and runtime workflows, reducing legacy infrastructure, and establishing a more maintainable foundation for future development while maintaining compatibility with existing tracker functionality.

TimMarchok-NOAA and others added 30 commits April 24, 2026 09:40
While running the tracker in genesis mode for certain models, I realized
that some models only include RH in the output and not q.  I need to
have q for one of the optional genesis diagnostics of 850 mb moisture
divergence.  I added code that reads in RH and T at 850 mb and converts
to q via Tetens formula.  The read routines & data arrays for GRIB1,
GRIB2 and NetCDF have been modified.  There is also a change to the
namelist for this.
@mcallic2
mcallic2 marked this pull request as ready for review July 16, 2026 20:33
@mcallic2
mcallic2 merged commit c6183f6 into NOAA-GFDL:main Jul 16, 2026
1 check passed
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