PySDM 2.105__tar.gz → 2.107__tar.gz

{pysdm-2.105 → pysdm-2.107}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
-Name: PySDM
-Version: 2.105
+Name: pysdm
+Version: 2.107
 Summary: Pythonic particle-based (super-droplet) warm-rain/aqueous-chemistry cloud microphysics package with box, parcel & 1D/2D prescribed-flow examples in Python, Julia and Matlab
 Home-page: https://github.com/open-atmos/PySDM
 Author: https://github.com/open-atmos/PySDM/graphs/contributors

{pysdm-2.105 → pysdm-2.107}/docs/bibliography.json

@@ -126,7 +126,7 @@
   },
   "https://doi.org/10.5194/acp-11-12945-2011": {
     "usages": [
-      "examples/PySDM_examples/Arabas_et_al_2023/aida.ipynb"
+      "examples/PySDM_examples/Arabas_et_al_2025/aida.ipynb"
     ],
     "label": "Steinke et al. 2011 (Atmos. Chem. Phys. 11)",
     "title": "Ice nucleation properties of fine ash particles from the Eyjafjallajökull eruption in April 2010 "
@@ -689,9 +689,16 @@
     "label": "Hoyle et al. 2016 (Atmos. Chem. Phys. 16)",
     "title": "Aqueous phase oxidation of sulphur dioxide by ozone in cloud droplets"
   },
-  "https://doi.org/10.48550/arXiv.2308.05015": {
-    "usages": ["examples/PySDM_examples/Arabas_et_al_2023/__init__.py"],
-    "label": "Arabas et al. 2023 (arXiv:2308.05015)",
+  "https://doi.org/10.1029/2024MS004770": {
+    "usages": [
+      "examples/PySDM_examples/Arabas_et_al_2025/__init__.py",
+      "examples/PySDM_examples/Arabas_et_al_2025/fig_2.ipynb",
+      "examples/PySDM_examples/Arabas_et_al_2025/fig_A2.ipynb",
+      "examples/PySDM_examples/Arabas_et_al_2025/figs_10_and_11_and_animations.ipynb",
+      "examples/PySDM_examples/Arabas_et_al_2025/figs_3_and_7_and_8.ipynb",
+      "examples/PySDM_examples/Arabas_et_al_2025/figs_5_and_6.ipynb"
+    ],
+    "label": "Arabas et al. 2025 (JAMES)",
     "title": "Immersion freezing in particle-based aerosol-cloud microphysics: a probabilistic perspective on singular and time-dependent models"
   },
   "https://archive.org/details/physicsofclouds0000maso": {

{pysdm-2.105 → pysdm-2.107}/docs/markdown/pysdm_landing.md

@@ -680,12 +680,14 @@ See [README.md](https://github.com/open-atmos/PySDM/tree/main/README.md)
   https://github.com/emmacware/droplets.jl
 - LacmoPy (Python/Numba)
   https://github.com/JanKBohrer/LacmoPy/blob/master/collision/all_or_nothing.py
-- McSnow (FORTRAN):
+- McSnow (FORTRAN)
   https://gitlab.dkrz.de/mcsnow/mcsnow/-/blob/master/src/mo_coll.f90
+- Particula (Python)
+  https://github.com/uncscode/particula/blob/main/particula/dynamics/coagulation/particle_resolved_step/super_droplet_method.py
 
 ### non-SDM probabilistic particle-based coagulation solvers
 
-- PartMC (Fortran):
+- PartMC (Fortran with a <a href="https://open-atmos.github.io/PyPartMC">Python interface</a>):
   https://github.com/compdyn/partmc
 
 ### Python models with discrete-particle (moving-sectional) representation of particle size spectrum
@@ -694,7 +696,7 @@ See [README.md](https://github.com/open-atmos/PySDM/tree/main/README.md)
 - PyBox: https://github.com/loftytopping/PyBox
 - py-cloud-parcel-model: https://github.com/emmasimp/py-cloud-parcel-model
 
-### non-Python cloud microphysics open-source software
+### Open-source models with other than discrete-particle representations of coagulation
 
-- CloudMicrophysics.jl: https://github.com/CliMA/CloudMicrophysics.jl
-- McSnow: https://gitlab.dkrz.de/mcsnow/mcsnow
+- DustPy: https://stammler.github.io/dustpy
+- Cloudy.jl: https://github.com/CliMA/Cloudy.jl

{pysdm-2.105 → pysdm-2.107}/docs/templates/index.html.jinja2

@@ -44,6 +44,10 @@
               particles immersed in moist air using the particle-based (a.k.a. super-droplet) approach to represent aerosol/cloud/rain microphysics.
             The key goal of PySDM is to enable rapid development and independent reproducibility of simulations in cloud microphysics
               while being free from the two-language barrier commonly separating prototype and high-performance research code.
+            PySDM ships with a set of examples reproducing results from literature and serving as tutorials. 
+            The animation shown here depicts a flow-coupled simulation in which the flow is reolved using PySDM's sibling project: <a href="https://open-atmos.github.io/PyMPDATA/">PyMPDATA</a>.
+            The examples include also single-column setups (with PyMPDATA used for advection) as well as adiabatic cloud parcel model setups
+              (with <mark>PySDM alone sufficient to constitute a microphysics-resolving cloud parcel model in Python</mark>).
         </p>
     </div>
     <div style="padding-top: 0.5em">

{pysdm-2.105/examples/PySDM_examples/Arabas_et_al_2023 → pysdm-2.107/examples/PySDM_examples/Arabas_et_al_2025}/__init__.py

@@ -1,6 +1,6 @@
 """
 box-model and 2D prescribed-flow immersion-freezing examples based on
-[Arabas et al. 2023](https://doi.org/10.48550/arXiv.2308.05015)
+[Arabas et al. 2025](https://doi.org/10.1029/2024MS004770)
 
 aida.ipynb:
 .. include:: ./aida.ipynb.badges.md

{pysdm-2.105/examples/PySDM_examples/Arabas_et_al_2023 → pysdm-2.107/examples/PySDM_examples/Arabas_et_al_2025}/aida.ipynb

@@ -9,9 +9,9 @@
     }
    },
    "source": [
-    "[![preview notebook](https://img.shields.io/static/v1?label=render%20on&logo=github&color=87ce3e&message=GitHub)](https://github.com/open-atmos/PySDM/blob/main/examples/PySDM_examples/Arabas_et_al_2023/aida.ipynb)\n",
-    "[![launch on mybinder.org](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/open-atmos/PySDM.git/main?urlpath=lab/tree/examples/PySDM_examples/Arabas_et_al_2023/aida.ipynb)\n",
-    "[![launch on Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/open-atmos/PySDM/blob/main/examples/PySDM_examples/Arabas_et_al_2023/aida.ipynb)"
+    "[![preview notebook](https://img.shields.io/static/v1?label=render%20on&logo=github&color=87ce3e&message=GitHub)](https://github.com/open-atmos/PySDM/blob/main/examples/PySDM_examples/Arabas_et_al_2025/aida.ipynb)\n",
+    "[![launch on mybinder.org](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/open-atmos/PySDM.git/main?urlpath=lab/tree/examples/PySDM_examples/Arabas_et_al_2025/aida.ipynb)\n",
+    "[![launch on Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/open-atmos/PySDM/blob/main/examples/PySDM_examples/Arabas_et_al_2025/aida.ipynb)"
    ]
   },
   {

{pysdm-2.105/examples/PySDM_examples/Arabas_et_al_2023 → pysdm-2.107/examples/PySDM_examples/Arabas_et_al_2025}/copula_hello.ipynb

@@ -4,16 +4,16 @@
    "metadata": {},
    "cell_type": "markdown",
    "source": [
-    "[![preview notebook](https://img.shields.io/static/v1?label=render%20on&logo=github&color=87ce3e&message=GitHub)](https://github.com/open-atmos/PySDM/blob/main/examples/PySDM_examples/Arabas_et_al_2023/copula_hello.ipynb)\n",
-    "[![launch on mybinder.org](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/open-atmos/PySDM.git/main?urlpath=lab/tree/examples/PySDM_examples/Arabas_et_al_2023/copula_hello.ipynb)\n",
-    "[![launch on Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/open-atmos/PySDM/blob/main/examples/PySDM_examples/Arabas_et_al_2023/copula_hello.ipynb)"
+    "[![preview notebook](https://img.shields.io/static/v1?label=render%20on&logo=github&color=87ce3e&message=GitHub)](https://github.com/open-atmos/PySDM/blob/main/examples/PySDM_examples/Arabas_et_al_2025/copula_hello.ipynb)\n",
+    "[![launch on mybinder.org](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/open-atmos/PySDM.git/main?urlpath=lab/tree/examples/PySDM_examples/Arabas_et_al_2025/copula_hello.ipynb)\n",
+    "[![launch on Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/open-atmos/PySDM/blob/main/examples/PySDM_examples/Arabas_et_al_2025/copula_hello.ipynb)"
    ],
    "id": "b17de2cda126ff4f"
   },
   {
    "metadata": {},
    "cell_type": "markdown",
-   "source": "# TODO #1417",
+   "source": "A proof-of-concept example of initialisation of super-droplet attributes using a copula model",
    "id": "5aec9c0198c091d5"
   },
   {

{pysdm-2.105/examples/PySDM_examples/Arabas_et_al_2023 → pysdm-2.107/examples/PySDM_examples/Arabas_et_al_2025}/fig_2.ipynb

@@ -10,15 +10,15 @@
     }
    },
    "source": [
-    "[![preview notebook](https://img.shields.io/static/v1?label=render%20on&logo=github&color=87ce3e&message=GitHub)](https://github.com/open-atmos/PySDM/blob/main/examples/PySDM_examples/Arabas_et_al_2023/fig_2.ipynb)\n",
-    "[![launch on mybinder.org](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/open-atmos/PySDM.git/main?urlpath=lab/tree/examples/PySDM_examples/Arabas_et_al_2023/fig_2.ipynb)\n",
-    "[![launch on Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/open-atmos/PySDM/blob/main/examples/PySDM_examples/Arabas_et_al_2023/fig_2.ipynb)"
+    "[![preview notebook](https://img.shields.io/static/v1?label=render%20on&logo=github&color=87ce3e&message=GitHub)](https://github.com/open-atmos/PySDM/blob/main/examples/PySDM_examples/Arabas_et_al_2025/fig_2.ipynb)\n",
+    "[![launch on mybinder.org](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/open-atmos/PySDM.git/main?urlpath=lab/tree/examples/PySDM_examples/Arabas_et_al_2025/fig_2.ipynb)\n",
+    "[![launch on Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/open-atmos/PySDM/blob/main/examples/PySDM_examples/Arabas_et_al_2025/fig_2.ipynb)"
    ]
   },
   {
    "metadata": {},
    "cell_type": "markdown",
-   "source": "TODO #1417 informations about this notebook",
+   "source": "Fig. 2 from [Arabas et al. 2025 (JAMES)](https://doi.org/10.1029/2024MS004770)",
    "id": "f85560654c25e11f"
   },
   {
@@ -55,8 +55,8 @@
     "from matplotlib import pyplot\n",
     "from open_atmos_jupyter_utils import show_plot\n",
     "from PySDM import Formulae\n",
-    "from PySDM_examples.Arabas_et_al_2023.curved_text import CurvedText\n",
-    "from PySDM_examples.Arabas_et_al_2023.commons import FREEZING_CONSTANTS, COOLING_RATES, TEMP_RANGE\n",
+    "from PySDM_examples.Arabas_et_al_2025.curved_text import CurvedText\n",
+    "from PySDM_examples.Arabas_et_al_2025.commons import FREEZING_CONSTANTS, COOLING_RATES, TEMP_RANGE\n",
     "import numpy as np\n",
     "import pint\n",
     "si = pint.UnitRegistry()\n",

{pysdm-2.105/examples/PySDM_examples/Arabas_et_al_2023 → pysdm-2.107/examples/PySDM_examples/Arabas_et_al_2025}/fig_A2.ipynb

@@ -5,9 +5,9 @@
    "id": "1371df7e-3c6e-4bdd-91b7-49c20ebe33c5",
    "metadata": {},
    "source": [
-    "[![preview notebook](https://img.shields.io/static/v1?label=render%20on&logo=github&color=87ce3e&message=GitHub)](https://github.com/open-atmos/PySDM/blob/main/examples/PySDM_examples/Arabas_et_al_2023/fig_A2.ipynb)\n",
-    "[![launch on mybinder.org](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/open-atmos/PySDM.git/main?urlpath=lab/tree/examples/PySDM_examples/Arabas_et_al_2023/fig_A2.ipynb)\n",
-    "[![launch on Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/open-atmos/PySDM/blob/main/examples/PySDM_examples/Arabas_et_al_2023/fig_A2.ipynb)"
+    "[![preview notebook](https://img.shields.io/static/v1?label=render%20on&logo=github&color=87ce3e&message=GitHub)](https://github.com/open-atmos/PySDM/blob/main/examples/PySDM_examples/Arabas_et_al_2025/fig_A2.ipynb)\n",
+    "[![launch on mybinder.org](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/open-atmos/PySDM.git/main?urlpath=lab/tree/examples/PySDM_examples/Arabas_et_al_2025/fig_A2.ipynb)\n",
+    "[![launch on Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/open-atmos/PySDM/blob/main/examples/PySDM_examples/Arabas_et_al_2025/fig_A2.ipynb)"
    ]
   },
   {
@@ -15,7 +15,7 @@
    "id": "c6f48049ea08fe2e",
    "metadata": {},
    "source": [
-    "# TODO #1417"
+    "Fig. A2 in [Arabas et al. 2025 (JAMES)](https://doi.org/10.1029/2024MS004770)"
    ]
   },
   {