rft: heterogeneous ice nucleation

[haakon-e]

This pull request refactors to the IceNucleation.jl module, focusing on enhancing documentation, simplifying function signatures, and improving parameter handling. The changes clarify the scientific basis for each function, improve usability, and ensure more robust error handling. The most important changes are grouped below by theme.

Documentation and Scientific References

• Rewrote and expanded documentation for all major functions, including detailed descriptions, argument lists, return values, and scientific references (e.g., Mohler2006, China2017, Frostenberg2023, Koop2000). This makes the code much easier to understand and maintain. [1] [2]

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 92.26%. Comparing base (c909c1a) to head (69c2434).
⚠️ Report is 4 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #699      +/-   ##
==========================================
- Coverage   92.28%   92.26%   -0.03%     
==========================================
  Files          54       54              
  Lines        2269     2263       -6     
==========================================
- Hits         2094     2088       -6     
  Misses        175      175              

Components	Coverage Δ
src	93.26% <100.00%> (-0.02%)	⬇️
ext	69.47% <ø> (ø)

🚀 New features to boost your workflow:

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

[trontrytel]

Thank you!