Added example based on Loftus and Wordsworth 2021 figure 2

PySDM/environments/parcel.py

@@ -106,7 +106,7 @@ def advance_parcel_vars(self):
         T = self["T"][0]
         p = self["p"][0]
 
-        dz_dt = self.w((self.particulator.n_steps + 1 / 2) * dt)  # "mid-point"
+        dz_dt = self._compute_dz_dt(dt)
         water_vapour_mixing_ratio = (
             self["water_vapour_mixing_ratio"][0]
             - self.delta_liquid_water_mixing_ratio / 2
@@ -133,6 +133,9 @@ def advance_parcel_vars(self):
             (self._tmp["rhod"][0] + self["rhod"][0]) / 2, self.mass_of_dry_air
         )
 
+    def _compute_dz_dt(self, dt):
+        return self.w((self.particulator.n_steps + 1 / 2) * dt)  # "mid-point"
+
     def get_thd(self):
         return self["thd"]
 

PySDM/physics/terminal_velocity/__init__.py

@@ -1,4 +1,6 @@
-"""terminal velocity formulae"""
+"""
+terminal velocity formulae
+"""
 
 from .rogers_yau import RogersYau
 from .gunn_kinzer_1949 import GunnKinzer1949

docs/bibliography.json

@@ -925,5 +925,12 @@
     ],
     "title": "A physically constrained classical description of the homogeneous nucleation of ice in water",
     "label": "Koop and Murray 2016 (J. Chem. Phys. 145)"
+  },
+  "https://doi.org/10.1029/2020JE006653": {
+    "usages": [
+      "examples/PySDM_examples/Loftus_and_Wordsworth_2021/__init__.py"
+    ],
+    "title": "The Physics of Falling Raindrops in Diverse Planetary Atmospheres",
+    "label": "Kaitlyn Loftus, Robin D. Wordsworth (JGR Planets 2021)"
   }
 }

examples/PySDM_examples/Loftus_and_Wordsworth_2021/__init__.py

@@ -0,0 +1,9 @@
+# pylint: disable=line-too-long
+"""
+The Physics of Falling Raindrops in Diverse Planetary Atmospheres
+[Loftus, K., & Wordsworth, R. D. 2021 (Journal of Geophysical Research: Planets, 126)](https://doi.org/10.1029/2020JE006653)
+
+"""
+
+from .settings import Settings
+from .simulation import Simulation