feat: p3 simulation with liquid-ice collisions

[haakon-e]

This pull request introduces support for a new combined precipitation scheme, Precipitation2M_P3, which integrates a two-moment rain scheme with a P3-based ice precipitation scheme. The changes include new type definitions, updates to initialization and auxiliary computation functions, and the implementation of collision and advection tendencies for the new scheme. This enables more physically detailed modeling of mixed-phase precipitation processes.

New Precipitation Scheme Implementation

• Added new structs IcePrecipitationP3 and Precipitation2M_P3 to represent the P3 ice scheme and the combined two-moment rain + P3 ice scheme, respectively, and exported them in equation_types.jl. [1] [2]

Initialization and State Handling

• Updated initialization logic in helper_functions.jl, initial_condition.jl, and ode_utils.jl to handle state variables and auxiliary variables required by Precipitation2M_P3 and IcePrecipitationP3. This includes new fields for riming and distribution parameters. [1] [2] [3] [4] [5]

Auxiliary Computations

• Implemented precompute_aux_thermo!, precompute_aux_precip!, and related functions for the new precipitation types, ensuring derived quantities and terminal velocities are calculated for both rain and ice components. [1] [2]

Source Terms and Tendencies

• Added collision source term calculations and tendency updates for the combined scheme (precip_sources_tendency!), including bulk liquid-ice collision logic and updates to all relevant state variables.
• Implemented advection tendencies for IcePrecipitationP3 and Precipitation2M_P3, handling the transport of ice-related quantities.

Integration and Output

• Updated driver and model integration code to support the new precipitation scheme, including output folder naming and main RHS function logic. [1] [2] [3]

These changes collectively enable detailed simulation of mixed-phase precipitation processes, combining established rain and advanced ice microphysics.

[haakon-e]

This change is part of the following stack:

• fix: z_max cannot be greater than z_2 #209
  • rft: improve error handling #210
    • rft: Modularize 2M precompute_aux_precip_sources! #211
      • rft(rm): unused path arg in override_toml_dict #212
        • Type-stable initial condition #220
          • fix folder paths + bikeshedding #221
            • rft: simplify field initialization #225
              • rft: make it easier to debug run_KiD_simulation.jl #230
                • rft: simplify two instances of advection_tendency! #226
                  • fix: rain number adjustment bug #238
                  • feat(2M): limit vap->liq mass transfer for small N_liq #239
                  • rft: improve error handling #240
                  • feat: p3 simulation with liquid-ice collisions #229 ◀

_{Change managed by git-spice.}

[codecov]

Codecov Report

❌ Patch coverage is 4.44444% with 86 lines in your changes missing coverage. Please review.
✅ Project coverage is 63.85%. Comparing base (944d99e) to head (9594689).

Files with missing lines	Patch %	Lines
src/Common/tendency.jl	2.50%	39 Missing ⚠️
src/K1DModel/tendency.jl	0.00%	25 Missing ⚠️
src/Common/ode_utils.jl	14.28%	12 Missing ⚠️
src/Common/helper_functions.jl	11.11%	8 Missing ⚠️
src/Common/equation_types.jl	0.00%	2 Missing ⚠️

Additional details and impacted files

@@                        Coverage Diff                        @@
##           he/rft-improve-error-handling     #229      +/-   ##
=================================================================
- Coverage                          67.93%   63.85%   -4.09%     
=================================================================
  Files                                 19       19              
  Lines                               1310     1397      +87     
=================================================================
+ Hits                                 890      892       +2     
- Misses                               420      505      +85     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.