refactor: re-label prescribed-flow 2D-simulation from Szumowski_et_al_1998 to utils/kinematic_2d (#1623)

Co-authored-by: Sylwester Arabas <sylwester.arabas@agh.edu.pl>

Author: AgnieszkaZaba

docs/bibliography.json

@@ -1,7 +1,8 @@
 {
   "https://doi.org/10.1007/978-1-935704-36-2_1": {
     "usages": [
-      "examples/docs/pysdm_examples_landing.md"
+      "examples/docs/pysdm_examples_landing.md",
+      "examples/PySDM_examples/utils/kinematic_2d/__init__.py"
     ],
     "label": "Kessler 1969 (Meteorol. Monogr. 10)",
     "title": "On the Distribution and Continuity of Water Substance in Atmospheric Circulations"
@@ -87,9 +88,9 @@
   "https://doi.org/10.1175/JAS3980": {
     "usages": [
       "examples/docs/pysdm_examples_landing.md",
-      "examples/PySDM_examples/Morrison_and_Grabowski_2007/fig_2.ipynb",
-      "examples/PySDM_examples/Morrison_and_Grabowski_2007/fig_3.ipynb",
-      "examples/PySDM_examples/Morrison_and_Grabowski_2007/__init__.py"
+      "examples/PySDM_examples/utils/kinematic_2d/__init__.py",
+      "examples/PySDM_examples/Morrison_and_Grabowski_2007/__init__.py",
+      "examples/PySDM_examples/Morrison_and_Grabowski_2007/fig_1.ipynb"
     ],
     "label": "Morrison & Grabowski 2007 (J. Atmos. Sci. 64)",
     "title": "Comparison of Bulk and Bin Warm-Rain Microphysics Models Using a Kinematic Framework"
@@ -255,7 +256,8 @@
       "examples/docs/pysdm_examples_landing.md",
       "examples/PySDM_examples/Arabas_et_al_2015/gui.ipynb",
       "PySDM/dynamics/displacement.py",
-      "PySDM/physics/particle_advection/implicit_in_space.py"
+      "PySDM/physics/particle_advection/implicit_in_space.py",
+      "examples/PySDM_examples/utils/kinematic_2d/__init__.py"
     ],
     "label": "Arabas et al. 2015 (Geosci. Model Dev. 2015)",
     "title": "libcloudph++ 1.0: a single-moment bulk, double-moment bulk, and particle-based warm-rain microphysics library in C++"
@@ -604,7 +606,7 @@
   },
   "https://doi.org/10.1016/S0169-8095(97)00082-3": {
     "usages": [
-      "examples/PySDM_examples/Szumowski_et_al_1998/__init__.py"
+      "examples/PySDM_examples/utils/kinematic_2d/__init__.py"
     ],
     "label": "Szumowski et al. 1998 (Atmos. Res. 45)",
     "title": "Simple two-dimensional kinematic framework designed to test warm rain microphysical models"

examples/PySDM_examples/Arabas_et_al_2015/example.py

@@ -1,6 +1,6 @@
 from open_atmos_jupyter_utils import TemporaryFile
 from PySDM_examples.Arabas_et_al_2015 import Settings, SpinUp
-from PySDM_examples.Szumowski_et_al_1998 import Simulation, Storage
+from PySDM_examples.utils.kinematic_2d import Simulation, Storage
 from PySDM_examples.utils import DummyController
 
 from PySDM import Formulae

examples/PySDM_examples/Arabas_et_al_2015/example_benchmark.py

@@ -2,7 +2,7 @@
 
 from matplotlib import pyplot as plt
 from PySDM_examples.Arabas_et_al_2015 import Settings
-from PySDM_examples.Szumowski_et_al_1998 import Simulation, Storage
+from PySDM_examples.utils.kinematic_2d import Simulation, Storage
 
 import PySDM.backends.impl_numba.conf
 from PySDM import Formulae

examples/PySDM_examples/Arabas_et_al_2015/gui.ipynb

@@ -64,7 +64,7 @@
     }
    ],
    "source": [
-    "from PySDM_examples.Szumowski_et_al_1998 import gui, Simulation, GUISettings, Storage\n",
+    "from PySDM_examples.utils.kinematic_2d import gui, Simulation, GUISettings, Storage\n",
     "from PySDM_examples.Arabas_et_al_2015 import Settings, SpinUp\n",
     "from PySDM import Formulae\n",
     "settings = GUISettings(Settings(Formulae()))\n",

examples/PySDM_examples/Arabas_et_al_2025/figs_10_and_11_and_animations.ipynb

@@ -66,7 +66,7 @@
     "from PySDM.dynamics import Freezing\n",
     "\n",
     "from PySDM_examples.Arabas_et_al_2015 import Settings\n",
-    "from PySDM_examples.Szumowski_et_al_1998 import Simulation, Storage\n",
+    "from PySDM_examples.utils.kinematic_2d import Simulation, Storage\n",
     "from PySDM_examples.Arabas_et_al_2025.commons import FREEZING_CONSTANTS, LOGNORMAL_MODE_SURF_A, LOGNORMAL_SGM_G"
    ]
   },
@@ -6221,7 +6221,6 @@
     "\n",
     "import argparse\n",
     "import json\n",
-    "from pathlib import Path\n",
     "from paraview import simple as pvs\n",
     "\n",
     "arg_parser = argparse.ArgumentParser()\n",

examples/PySDM_examples/Bartman_et_al_2021/demo.ipynb

@@ -44,8 +44,8 @@
    },
    "source": [
     "from PySDM_examples.Arabas_et_al_2015 import Settings, SpinUp\n",
-    "from PySDM_examples.Szumowski_et_al_1998 import Simulation, Storage\n",
-    "from PySDM_examples.Szumowski_et_al_1998.plots import _TimeseriesPlot, _ImagePlot\n",
+    "from PySDM_examples.utils.kinematic_2d import Simulation, Storage\n",
+    "from PySDM_examples.utils.kinematic_2d.plots import _TimeseriesPlot, _ImagePlot\n",
     "from PySDM_examples.utils import ProgBarController\n",
     "from PySDM_examples.utils.widgets import HTML, display\n",
     "import PySDM.products as PySDM_products\n",

examples/PySDM_examples/Bartman_et_al_2021/demo_fig2.ipynb

@@ -44,7 +44,7 @@
    },
    "source": [
     "from PySDM_examples.Arabas_et_al_2015 import Settings, SpinUp\n",
-    "from PySDM_examples.Szumowski_et_al_1998 import Simulation, Storage\n",
+    "from PySDM_examples.utils.kinematic_2d import Simulation, Storage\n",
     "from PySDM.exporters import NetCDFExporter\n",
     "from PySDM_examples.utils import ProgBarController\n",
     "from open_atmos_jupyter_utils import show_plot, TemporaryFile\n",

examples/PySDM_examples/Bartman_et_al_2021/demo_fig3.ipynb

@@ -46,7 +46,7 @@
     "from PySDM_examples.utils import ProgBarController\n",
     "from open_atmos_jupyter_utils import TemporaryFile, show_plot\n",
     "from PySDM.physics import si, convert_to\n",
-    "from PySDM_examples.Szumowski_et_al_1998 import Simulation, Storage\n",
+    "from PySDM_examples.utils.kinematic_2d import Simulation, Storage\n",
     "from PySDM_examples.Arabas_et_al_2015 import Settings, SpinUp\n",
     "from PySDM_examples.Bartman_et_al_2021.label import label\n",
     "from PySDM.exporters import NetCDFExporter\n",

examples/PySDM_examples/Morrison_and_Grabowski_2007/__init__.py

@@ -3,10 +3,6 @@
 prescribed-flow simulation settings data from
 [Morrison & Grabowski 2007 (JAS)](https://doi.org/10.1175/JAS3980)
 
-fig_2.ipynb:
-.. include:: ./fig_2.ipynb.badges.md
-
-fig_3.ipynb:
-.. include:: ./fig_3.ipynb.badges.md
+fig_1.ipynb:
+.. include:: ./fig_1.ipynb.badges.md
 """
-from .cumulus import Cumulus