https://github.com/open-atmos/PySDM

What's Changed

• bump actions versions to avoid Node.js warnings by @slayoo in https://github.com/open-atmos/PySDM/pull/1293
• speeding up the parcel-noisy-supersaturation test (slowest unit test to date) + cleanups by @slayoo in https://github.com/open-atmos/PySDM/pull/1296
• add ventilation coefficient (Pruppacher & Rasmussen 1979 & Froessling 1938) + Reynolds number attr + air dynamic viscosity formulae + unit tests (incl. drop size changes upon ventilation-in-parcel-below-cloud vs. no-ventilation) + refactor of env vars __getitem__ logic by @kaitlyn-loftus in https://github.com/open-atmos/PySDM/pull/1282

New Contributors

• @kaitlyn-loftus made their first contribution in https://github.com/open-atmos/PySDM/pull/1282

Full Changelog: https://github.com/open-atmos/PySDM/compare/v2.46...v2.47

What's Changed

• add Colab headers to J&N notebooks + some plotting code additions by @slayoo in https://github.com/open-atmos/PySDM/pull/1280
• test_efficiencies refactor for speedup (was taking 10 min. of CI unit test runs) by @slayoo in https://github.com/open-atmos/PySDM/pull/1290
• print top 10 test durations on Appveyor by @slayoo in https://github.com/open-atmos/PySDM/pull/1289
• Bump pypartmc from 1.1.0 to 1.1.2 by @dependabot in https://github.com/open-atmos/PySDM/pull/1286
• add --no-warn-script-location option for pip on Appveyor CI to avoid lots of unrelated warnings by @slayoo in https://github.com/open-atmos/PySDM/pull/1292
• introducing Formulae::flatten and leveraging it in a Numba condensation methods refactor: >100 LoC less (in preparation for introducing ventilation) by @slayoo in https://github.com/open-atmos/PySDM/pull/1291

Full Changelog: https://github.com/open-atmos/PySDM/compare/v2.45...v2.46

What's Changed

• Jensen & Nugent 2017 GCCN example: Figs 1, 3, 4, 5 & 6 (incl. Grabowski et al. diffusion thermics) by @bhiogade in https://github.com/open-atmos/PySDM/pull/1267

Full Changelog: https://github.com/open-atmos/PySDM/compare/v2.44...v2.45

What's Changed

• coalescence-only single-column test case ("deJong_Azimi" based on S&H); power-law terminal velocity; initialisation of particles in part of the domain in 1D kinematic env by @edejong-caltech in https://github.com/open-atmos/PySDM/pull/1221
• move parcel displacement product to parcel subfolder by @slayoo in https://github.com/open-atmos/PySDM/pull/1278
• Bump pypartmc from 1.0.3 to 1.1.0 by @dependabot in https://github.com/open-atmos/PySDM/pull/1277

Full Changelog: https://github.com/open-atmos/PySDM/compare/v2.43...v2.44

What's Changed

• Lowe et al. 2019 Fig S2 (+smoke tests); new optical formulae and products (optical depth & albedo); LWP product; activation-filtered r_eff product; cleanups by @claresinger in https://github.com/open-atmos/PySDM/pull/1256
• speeding up Appveyor 32bit unit test runs by avoiding multiple pkg downloads thanks to pinned versions of dependencies by @slayoo in https://github.com/open-atmos/PySDM/pull/1276

Full Changelog: https://github.com/open-atmos/PySDM/compare/v2.42...v2.43

What's Changed

• adding new isotope equil. fractionation factor formulae for ice-vap 2H (LambEtAl2017, EllehojEtAl2013) + new example notebook (Fig. 4 from Lamb et al. 2017, PNAS) by @slayoo in https://github.com/open-atmos/PySDM/pull/1271
• instruct dependabot to also check PySDM-examples dependencies. closes #1224 by @slayoo in https://github.com/open-atmos/PySDM/pull/1270
• Bump pypartmc from 1.0.2 to 1.0.3 by @dependabot in https://github.com/open-atmos/PySDM/pull/1268

Full Changelog: https://github.com/open-atmos/PySDM/compare/v2.41...v2.42

What's Changed

• add libgl1 to .binder/apt.txt to workaround vtk missing shared lib issue. hopefully closes #1230 by @slayoo in https://github.com/open-atmos/PySDM/pull/1245
• fix Colab package install header in collision tutorial by @slayoo in https://github.com/open-atmos/PySDM/pull/1244
• new issue numbers and documentation of failed tests by @claresinger in https://github.com/open-atmos/PySDM/pull/1248
• CI: bump upper Python version to 3.11 (and address numerous deprecation warnings from dependencies) by @slayoo in https://github.com/open-atmos/PySDM/pull/1235
• code formatting changes to comply with black v24.1 by @slayoo in https://github.com/open-atmos/PySDM/pull/1257
• install pyrcel for ci and extend smoke-test timeout by @claresinger in https://github.com/open-atmos/PySDM/pull/1253
• add mention of CLEO to the README by @slayoo in https://github.com/open-atmos/PySDM/pull/1260
• Adding Missing View-Notebook badge; fix myBinder URL; fix CI version constraint logic by @bhiogade in https://github.com/open-atmos/PySDM/pull/1261
• Bump pypartmc from 1.0.1 to 1.0.2 by @dependabot in https://github.com/open-atmos/PySDM/pull/1263
• Missing urls and Badge by @bhiogade in https://github.com/open-atmos/PySDM/pull/1264
• freezing: convergence analysis notebook update; adding typical output file extensions to .gitignore by @slayoo in https://github.com/open-atmos/PySDM/pull/1137

Full Changelog: https://github.com/open-atmos/PySDM/compare/v2.40...v2.41

What's Changed

• new README file for tutorials (+ removal of leftover __init__.py files) by @claresinger in https://github.com/open-atmos/PySDM/pull/1242
• ARG example fix (ensuring water_molar_volume in kappa() is consistent with formulae constants) + smoke tests; analogous changes in other examples using dry aerosol initialisation logic by @claresinger in https://github.com/open-atmos/PySDM/pull/1226

Full Changelog: https://github.com/open-atmos/PySDM/compare/v2.39...v2.40

What's Changed

• Table 1 notebook for the Graf example + smoke test + cleanup in isotopic fractionation formulae by @bhiogade in https://github.com/open-atmos/PySDM/pull/1239
• README updates by @slayoo in https://github.com/open-atmos/PySDM/pull/1241

Full Changelog: https://github.com/open-atmos/PySDM/compare/v2.38...v2.39

What's Changed

• Graf et al. 2019 Fig 4 example draft (parcel, condensation, isotopes) including the move of reusable notebook_vars() into PySDM_examples/utils by @bhiogade in https://github.com/open-atmos/PySDM/pull/1222
• fixing whitespace issue (pre-commit) that preveted pypi upload of the previous release by @slayoo in https://github.com/open-atmos/PySDM/pull/1232

Full Changelog: https://github.com/open-atmos/PySDM/compare/v2.37...v2.37.1

What's Changed

• link to tutorials within README.md; fix badge urls; fix mybinder init logic (.binder/postBuild script that now deletes everything but examples and tutorials folders) by @bhiogade in https://github.com/open-atmos/PySDM/pull/1228
• Add a test that checks parcel equilibrium supersaturation does not depend on dz by @claresinger in https://github.com/open-atmos/PySDM/pull/1225

Full Changelog: https://github.com/open-atmos/PySDM/compare/v2.36...v2.37

What's Changed

• introducing PySDM tutorials with first two based on collision and condensation classroom notebooks by @claresinger in https://github.com/open-atmos/PySDM/pull/1164

Full Changelog: https://github.com/open-atmos/PySDM/compare/v2.35...v2.36

What's Changed

• add render-on-github badge to Kreidenweis example notebook by @bhiogade in https://github.com/open-atmos/PySDM/pull/1210
• clarify notebook execution commands by @slayoo in https://github.com/open-atmos/PySDM/pull/1211
• replace nbviewer badge with render-on-github for Merlivat & Nief 1967 example by @bhiogade in https://github.com/open-atmos/PySDM/pull/1213
• update package metadata (urls changes reflecting the move of PySDM-examples into the PySDM repo) by @bhiogade in https://github.com/open-atmos/PySDM/pull/1215
• Add render-on-github badge and fix my binder link by @bhiogade in https://github.com/open-atmos/PySDM/pull/1214
• improve SimpleGeometric kernel docstring by @bhiogade in https://github.com/open-atmos/PySDM/pull/1223

New Contributors

• @bhiogade made their first contribution in https://github.com/open-atmos/PySDM/pull/1210

Full Changelog: https://github.com/open-atmos/PySDM/compare/v2.34...v2.35

What's Changed

• stable water isotopologues:

  • new base attributes: Moles1H, Moles16O, MolesLightWater + havy isotopes via make_mole_amount_factory (previously developed for Hoppel gap)
  • new derived attributes: isotopic deltas (via new make_delta_factory)
  • backend isotope methods: isotopic_delta via physics.trivia (both CPU and GPU)
  • sketch of IsotopicFractionation dynamic (attribite dependencies, trigerring delta calculation)
  • VSMOW constants
  • isotope-related physics formulae:
    • isotope_equilibrium_fractionation_factors: BarkanAndLuz2005 (Oxygen 17, liquid), HoritaAndWesolowski1994 (Oxygen 18 and Deuterium, liquid), Majoube1970 (Oxygen 18, ice), Majoube1971 (Oxygen 18, liquid), MerlivatAndNief1967 (Deuterium, liquid & ice), VanHook1968 (D, T, O18, O17; liquid & ice)
    • isotope_meteoric_water_line_excess: Dansgaard1964 (Oxygen 18 vs. Deuterium), BarkanAndLuz2007 (Oxygen 17 vs. Oxygen 18); Craig 1961 Fig 1 and Barkan & Luz 2007 Fig 4 unit tests
    • isotope_ratio_evolution: MerlivatAndJouzel1979 (differential), RayleighDistillation (integral) + test checking when these two match
  • trivia formulae: isotopic_delta_2_ratio, isotopic_ratio_2_delta, isotopic_enrichment_to_delta_SMOW, mixing_ratio_to_specific_content
  • new examples (all environment-free, depicting formulae):
    • Bolot_et_al_2013: Fig 1 (incl. unit tests)
    • Merlivat_and_Nief_1967: Fig 2 (incl. unit tests)
    • Pierchala_et_al_2022: Fig 3 & 4 (incl. smoke tests)
    • Van_Hook_1968: Fig 1

• formulae machinery:

  • constants_defaults: all calculations logic moved to compute_derived_values function called from Formulae ctor
  • PPM, PER_CENT, PER_MEG, PER_MILLE
  • dry-air molar mass derived from NIST N2, O2, Ar and C composition ratios
  • water molar mass derived from VSMOW isotopic ratios

• CI:

  • run git diff on pre-commit jpb failure
  • bump pypartmc from 1.0.0 to 1.0.1 by @dependabot in https://github.com/open-atmos/PySDM/pull/1204
  • cleanup precommit workflow (https://github.com/open-atmos/PySDM/pull/1205)

Full Changelog: https://github.com/open-atmos/PySDM/compare/v2.33...v2.34

What's Changed

• Bump pypartmc from 0.7.1 to 0.9.5 by @dependabot in https://github.com/open-atmos/PySDM/pull/1195
• rename test_coalescence into test_lwc_constant + switch from returns to pytest.skip() by @slayoo in https://github.com/open-atmos/PySDM/pull/1192
• Bump pypartmc from 0.9.5 to 1.0.0 by @dependabot in https://github.com/open-atmos/PySDM/pull/1202
• Pass environment to Builder constructor by @abulenok in https://github.com/open-atmos/PySDM/pull/1178

Full Changelog: https://github.com/open-atmos/PySDM/compare/v2.32...v2.33

What's Changed

• Bump pypartmc from 0.6.4 to 0.7.1 by @dependabot in https://github.com/open-atmos/PySDM/pull/1186
• sort out pkg_resources deprecation using importlib.metadata (requires Python 3.8) by @slayoo in https://github.com/open-atmos/PySDM/pull/1194
• split packaging and publishing into separate jobs; enforce setuptools[-scm] versions that work by @slayoo in https://github.com/open-atmos/PySDM/pull/1199

Full Changelog: https://github.com/open-atmos/PySDM/compare/v2.31...v2.32

• added argument-range checks for GunnKinzer1949 interpolation of terminal velocities (thanks @bradybhalla for reporting and identifying the issue, thanks @abulenok for providing the fix)
• failing Particulator instantiation if user supplies values for a derived attribute
• simplifcations/cleanups in dry_volume & acidity attributes code
• disabling multi-threading on arm64 until we have a fix for atomic operations (thanks @jtbuch and @pb475 for reporting the problem and help with debugging it!)

• mass instead of volume as base attribute (incl. introduction of physics.particle_shape_and_density) #1147
• new cases for test_attribute_update_single_breakup (#1158)
• compatibility fixes for newer versions of setuptools_scm
• docstring cleanups

thanks @abulenok, @AgnieszkaMakulska & @Delcior

• added CPU vs. GPU performance comparison for the Srivastava_1978 setup
• removed spurious index copying in attributes

• refactor in GPU backend using @cached_property instead of lengthy ctors in methods classes (results in a lazy evaluation bonus)
• dropping support for Python 3.7 (due to @cached_property, and in line with 3.7 end of life)
• C code syntax fixes & cleanups in GPU backend
• atomicAdd workaround for double precision type on older CUDA (#1138)