PySDM 2.89__tar.gz → 2.91__tar.gz

pysdm-2.91/.github/workflows/projects.yml

@@ -0,0 +1,19 @@
+name: Add new issues and pull requests to project board
+
+on:
+  issues:
+    types:
+      - opened
+  pull_request_target:
+    types:
+      - opened
+
+jobs:
+  add-to-project:
+    name: Add to project
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/add-to-project@v1.0.2
+        with:
+          project-url: https://github.com/orgs/open-atmos/projects/6
+          github-token: ${{ secrets.ADD_TO_PROJECT_PAT }}

{pysdm-2.89 → pysdm-2.91}/.github/workflows/pypi.yml

@@ -32,7 +32,9 @@ jobs:
 
       - run: pip install twine build
 
-      - run: |
+      - name: run python -m build to generate wheel files, check for warnings
+        run: |
+          set -x
           unset CI
           cd ${{ matrix.packages-dir }}
           python -m build 2>&1 | tee build.log
@@ -41,7 +43,11 @@ jobs:
             | grep -v "version of {dist_name} already set" \
             | grep -v -E "UserWarning: version of PySDM(-examples)? already set" \
             | wc -l`
-          twine check --strict dist/*
+      - run: twine check --strict ${{ matrix.packages-dir }}/dist/*
+      - name: check if version string does not contain PyPI-incompatible + char 
+        run: |
+          set -x
+          [ `ls ${{ matrix.packages-dir }}/dist | fgrep + | tee /dev/stderr | wc -l` -ne 0 ] && exit 1 || echo OK
 
       - uses: actions/upload-artifact@v4
         with:

{pysdm-2.89 → pysdm-2.91}/.github/workflows/tests.yml

@@ -14,7 +14,7 @@ on:
 
 jobs:
   precommit:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     steps:
       - uses: actions/checkout@v4.1.6
       - uses: actions/setup-python@v5.0.0
@@ -29,7 +29,7 @@ jobs:
         run: git diff
 
   pylint:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     steps:
     - uses: actions/checkout@v4.1.6
       with:
@@ -58,7 +58,7 @@ jobs:
         nbqa pylint --unsafe-load-any-extension=y --disable=fixme,duplicate-code,invalid-name,trailing-whitespace,line-too-long,missing-function-docstring,wrong-import-position,missing-module-docstring,wrong-import-order,ungrouped-imports,no-member,too-many-locals,unnecessary-lambda-assignment $(git ls-files '*.ipynb')
 
   devops:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     steps:
       - uses: actions/checkout@v4.1.6
         with:
@@ -70,7 +70,7 @@ jobs:
         run: pytest --durations=10 -v -s -We -p no:unraisableexception -k "not test_run_notebooks" tests/devops_tests
 
   zenodo_json:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     steps:
       - uses: actions/checkout@v4.1.6
       - uses: notiz-dev/github-action-json-property@release
@@ -80,7 +80,7 @@ jobs:
 
   nojit_and_codecov:
     needs: [precommit, pylint, devops, zenodo_json]
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     env:
       NUMBA_DISABLE_JIT: 1
     steps:
@@ -107,9 +107,9 @@ jobs:
     needs: [nojit_and_codecov]
     strategy:
       matrix:
-        platform: [ubuntu-latest, macos-13, macos-14, windows-latest]
+        platform: [ubuntu-24.04, macos-13, macos-14, windows-latest]
         python-version: ["3.9", "3.12"]
-        test-suite: ["unit_tests/!(dynamics)", "unit_tests/dynamics/!(condensation)", "unit_tests/dynamics/condensation", "smoke_tests/no_env", "smoke_tests/box", "smoke_tests/parcel_a", "smoke_tests/parcel_b", "smoke_tests/parcel_c", "smoke_tests/kinematic_1d", "smoke_tests/kinematic_2d", "tutorials_tests"]
+        test-suite: ["unit_tests/!(dynamics)", "unit_tests/dynamics/!(collisions)", "unit_tests/dynamics/collisions", "smoke_tests/no_env", "smoke_tests/box", "smoke_tests/parcel_a", "smoke_tests/parcel_b", "smoke_tests/parcel_c", "smoke_tests/parcel_d", "smoke_tests/kinematic_1d", "smoke_tests/kinematic_2d", "tutorials_tests"]
         exclude:
           - platform: "macos-14"
             python-version: "3.9"
@@ -120,13 +120,15 @@ jobs:
             test-suite: "smoke_tests/box"
           - platform: "macos-14"
             test-suite: "smoke_tests/parcel_a"
+          - platform: "macos-14"
+            test-suite: "smoke_tests/parcel_d"
           - platform: "macos-14"
             test-suite: "smoke_tests/kinematic_2d"
           - platform: "macos-14"
             test-suite: "unit_tests/!(dynamics)"
       fail-fast: false
     runs-on: ${{ matrix.platform }}
-    timeout-minutes: ${{ startsWith(matrix.platform, 'windows-') && 40 || 40 }}
+    timeout-minutes: ${{ startsWith(matrix.platform, 'windows-') && 35 || 30 }}
     steps:
       - uses: actions/checkout@v4.1.6
         with:
@@ -186,7 +188,7 @@ jobs:
           python-version: ${{ matrix.python-version }}
       - run: |
           echo pip_user_site=$(python -c "import sysconfig; print(sysconfig.get_path('purelib'))") >> $GITHUB_ENV
-          echo toml_ci_md5=$(cat pyproject.toml setup.py examples/pyproject.toml examples/setup.py tests/devops_tests/requirements.txt .github/workflows/tests+artifacts+pypi.yml \
+          echo toml_ci_md5=$(cat pyproject.toml setup.py examples/pyproject.toml examples/setup.py tests/devops_tests/requirements.txt .github/workflows/tests.yml \
           | python -c "import hashlib;print(hashlib.md5(open(0,'rb').read()).hexdigest())") >> $GITHUB_ENV
       - uses: actions/cache@v4
         id: cache
@@ -211,10 +213,10 @@ jobs:
       matrix:
         platform: [ubuntu-24.04, macos-13, windows-latest]
         python-version: ["3.9", "3.12"]
-        test-suite: [ "chemistry_freezing_isotopes", "condensation_a", "condensation_b", "coagulation", "breakup", "multi-process_a", "multi-process_b"]
+        test-suite: [ "chemistry_freezing", "isotopes", "condensation_a", "condensation_b", "condensation_c", "coagulation", "breakup", "multi-process_a", "multi-process_b", "multi-process_c", "multi-process_d", "multi-process_e"]
       fail-fast: false
     runs-on: ${{ matrix.platform }}
-    timeout-minutes: ${{ !startsWith(matrix.platform, 'ubuntu-') && 65 || 50 }}
+    timeout-minutes: 35
     steps:
       - uses: actions/checkout@v4.1.6
         with:
@@ -225,7 +227,7 @@ jobs:
           python-version: ${{ matrix.python-version }}
       - run: |
           echo pip_user_site=$(python -c "import sysconfig; print(sysconfig.get_path('purelib'))") >> $GITHUB_ENV
-          echo toml_ci_md5=$(cat pyproject.toml setup.py examples/pyproject.toml examples/setup.py tests/devops_tests/requirements.txt .github/workflows/tests+artifacts+pypi.yml \
+          echo toml_ci_md5=$(cat pyproject.toml setup.py examples/pyproject.toml examples/setup.py tests/devops_tests/requirements.txt .github/workflows/tests.yml \
           | python -c "import hashlib;print(hashlib.md5(open(0,'rb').read()).hexdigest())") >> $GITHUB_ENV
       - run: |
           rm -rf $pip_user_site
@@ -240,26 +242,27 @@ jobs:
       - if: startsWith(matrix.platform, 'ubuntu-')
         run: echo NUMBA_THREADING_LAYER=omp >> $GITHUB_ENV
 
-      - if: startsWith(matrix.platform, 'ubuntu-') && matrix.test-suite == 'multi-process_a'
+      - if: startsWith(matrix.platform, 'ubuntu-') && (matrix.test-suite == 'multi-process_a' || matrix.test-suite == 'multi-process_b')
         run: |
+          sudo apt-get update
           sudo apt-get install libegl1 libopengl0 ghostscript
           wget -nv "https://paraview.org/paraview-downloads/download.php?submit=Download&version=v5.13&type=binary&os=Linux&downloadFile=ParaView-5.13.1-egl-MPI-Linux-Python3.10-x86_64.tar.gz" -O paraview.tar.gz
           tar xzf paraview.tar.gz
           echo `pwd`/`dirname ParaView*/bin/pvpython` >> $GITHUB_PATH
           
-      - if: startsWith(matrix.platform, 'macos-') && matrix.test-suite == 'multi-process_a'
+      - if: startsWith(matrix.platform, 'macos-') && (matrix.test-suite == 'multi-process_a' || matrix.test-suite == 'multi-process_b')
         run: |
           brew install --cask paraview
           echo `dirname /Applications/ParaView-*.app/Contents/bin/pvpython | head -1` >> $GITHUB_PATH
           brew install ghostscript
 
-      - if: startsWith(matrix.platform, 'windows-') && matrix.test-suite == 'multi-process_a'
+      - if: startsWith(matrix.platform, 'windows-') && (matrix.test-suite == 'multi-process_a' || matrix.test-suite == 'multi-process_b')
         run: |
           curl "https://www.paraview.org/paraview-downloads/download.php?submit=Download&version=v5.13&type=binary&os=Windows&downloadFile=ParaView-5.13.1-Windows-Python3.10-msvc2017-AMD64.msi" -o paraview.msi
           msiexec //i paraview.msi //quiet //qn //norestart 
           echo "C:\\Program Files\\ParaView 5.13.1\\bin\\" >> $GITHUB_PATH
 
-      - if: matrix.test-suite == 'multi-process_a'
+      - if: matrix.test-suite == (matrix.test-suite == 'multi-process_a' || matrix.test-suite == 'multi-process_b')
         run: |
           pvpython --version
           pvpython -c "from paraview import simple"

{pysdm-2.89 → pysdm-2.91}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: PySDM
-Version: 2.89
+Version: 2.91
 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
@@ -38,7 +38,7 @@ Requires-Dist: pyrcel; extra == "tests"
 Requires-Dist: jupyter-core<5.0.0; extra == "tests"
 Requires-Dist: ipywidgets!=8.0.3; extra == "tests"
 
-# <img src="https://raw.githubusercontent.com/open-atmos/PySDM/main/.github/pysdm_logo.png" width=100 height=146 alt="pysdm logo">
+# <img src="https://raw.githubusercontent.com/open-atmos/PySDM/main/docs/logos/pysdm_logo.png" width=100 height=146 alt="pysdm logo">
 
 [![Python 3](https://img.shields.io/static/v1?label=Python&logo=Python&color=3776AB&message=3)](https://www.python.org/)
 [![LLVM](https://img.shields.io/static/v1?label=LLVM&logo=LLVM&color=gold&message=Numba)](https://numba.pydata.org)
@@ -57,7 +57,7 @@ Requires-Dist: ipywidgets!=8.0.3; extra == "tests"
 
 [![License: GPL v3](https://img.shields.io/badge/License-GPL%20v3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0.html)
 
-[![Github Actions Build Status](https://github.com/open-atmos/PySDM/workflows/tests+artifacts+pypi/badge.svg?branch=main)](https://github.com/open-atmos/PySDM/actions)
+[![Github Actions Build Status](https://github.com/open-atmos/PySDM/workflows/tests/badge.svg?branch=main)](https://github.com/open-atmos/PySDM/actions)
 [![Appveyor Build status](http://ci.appveyor.com/api/projects/status/github/open-atmos/PySDM?branch=main&svg=true)](https://ci.appveyor.com/project/slayoo/pysdm/branch/main)
 [![Coverage Status](https://codecov.io/gh/open-atmos/PySDM/branch/main/graph/badge.svg)](https://app.codecov.io/gh/open-atmos/PySDM)    
 [![PyPI version](https://badge.fury.io/py/PySDM.svg)](https://pypi.org/project/PySDM)
@@ -75,6 +75,8 @@ The package features a Pythonic high-performance implementation of the
   Super-Droplet Method (SDM) Monte-Carlo algorithm for representing collisional growth 
   ([Shima et al. 2009](https://rmets.onlinelibrary.wiley.com/doi/abs/10.1002/qj.441)), hence the name. 
 
+PySDM documentation is maintained at: [https://open-atmos.github.io/PySDM](https://open-atmos.github.io/PySDM) 
+
 There is a growing set of [example Jupyter notebooks](https://open-atmos.github.io/PySDM/PySDM_examples.html) exemplifying how to perform 
   various types of calculations and simulations using PySDM.
 Most of the example notebooks reproduce results and plot from literature, see below for 
@@ -105,14 +107,6 @@ For an overview of PySDM features (and the preferred way to cite PySDM in papers
 PySDM includes an extension of the SDM scheme to represent collisional breakup described in [de Jong, Mackay et al. 2023](10.5194/gmd-16-4193-2023).   
 For a list of talks and other materials on PySDM as well as a list of published papers featuring PySDM simulations, see the [project wiki](https://github.com/open-atmos/PySDM/wiki).
 
-A [pdoc-generated](https://pdoc.dev/) documentation of PySDM public API is maintained at: [https://open-atmos.github.io/PySDM](https://open-atmos.github.io/PySDM) 
-
-## Example Jupyter notebooks (reproducing results from literature):
-
-See [PySDM-examples README](https://github.com/open-atmos/PySDM/blob/main/examples/README.md).
-
-![animation](https://github.com/open-atmos/PySDM/wiki/files/kinematic_2D_example.gif)
-
 ## Dependencies and Installation
 
 PySDM dependencies are: [Numpy](https://numpy.org/), [Numba](http://numba.pydata.org/), [SciPy](https://scipy.org/), 

{pysdm-2.89 → pysdm-2.91}/PySDM/products/displacement/flow_velocity_component.py

@@ -1,6 +1,5 @@
 """
-reports on the maximum Courant field value for each cell (maximum of
-absolute values of Courant number on all edges of a cell)
+reports on the flow velocity
 """
 
 import numpy as np

{pysdm-2.89 → pysdm-2.91}/PySDM/products/size_spectral/size_standard_deviation.py

@@ -27,20 +27,21 @@ class _SizeStandardDeviation(MomentProduct, ActivationFilteredProduct):
         ActivationFilteredProduct.__init__(
             self, count_activated=count_activated, count_unactivated=count_unactivated
         )
+        self.tmp = None
 
     def register(self, builder):
         builder.request_attribute(self.attr)
         for base_class in (ActivationFilteredProduct, MomentProduct):
             base_class.register(self, builder)
+        self.tmp = np.empty_like(self.buffer)
 
     def _impl(self, **kwargs):
         ActivationFilteredProduct.impl(self, attr=self.attr, rank=1)
-        tmp = np.empty_like(self.buffer)
-        tmp[:] = -self.buffer**2
+        self.tmp[:] = -self.buffer**2
         ActivationFilteredProduct.impl(self, attr=self.attr, rank=2)
-        tmp[:] += self.buffer
-        tmp[:] = np.sqrt(tmp)
-        return tmp
+        self.tmp[:] += self.buffer
+        self.tmp[:] = np.sqrt(self.tmp)
+        return self.tmp
 
 
 RadiusStandardDeviation = register_product()(_SizeStandardDeviation)

{pysdm-2.89 → pysdm-2.91}/PySDM.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: PySDM
-Version: 2.89
+Version: 2.91
 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
@@ -38,7 +38,7 @@ Requires-Dist: pyrcel; extra == "tests"
 Requires-Dist: jupyter-core<5.0.0; extra == "tests"
 Requires-Dist: ipywidgets!=8.0.3; extra == "tests"
 
-# <img src="https://raw.githubusercontent.com/open-atmos/PySDM/main/.github/pysdm_logo.png" width=100 height=146 alt="pysdm logo">
+# <img src="https://raw.githubusercontent.com/open-atmos/PySDM/main/docs/logos/pysdm_logo.png" width=100 height=146 alt="pysdm logo">
 
 [![Python 3](https://img.shields.io/static/v1?label=Python&logo=Python&color=3776AB&message=3)](https://www.python.org/)
 [![LLVM](https://img.shields.io/static/v1?label=LLVM&logo=LLVM&color=gold&message=Numba)](https://numba.pydata.org)
@@ -57,7 +57,7 @@ Requires-Dist: ipywidgets!=8.0.3; extra == "tests"
 
 [![License: GPL v3](https://img.shields.io/badge/License-GPL%20v3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0.html)
 
-[![Github Actions Build Status](https://github.com/open-atmos/PySDM/workflows/tests+artifacts+pypi/badge.svg?branch=main)](https://github.com/open-atmos/PySDM/actions)
+[![Github Actions Build Status](https://github.com/open-atmos/PySDM/workflows/tests/badge.svg?branch=main)](https://github.com/open-atmos/PySDM/actions)
 [![Appveyor Build status](http://ci.appveyor.com/api/projects/status/github/open-atmos/PySDM?branch=main&svg=true)](https://ci.appveyor.com/project/slayoo/pysdm/branch/main)
 [![Coverage Status](https://codecov.io/gh/open-atmos/PySDM/branch/main/graph/badge.svg)](https://app.codecov.io/gh/open-atmos/PySDM)    
 [![PyPI version](https://badge.fury.io/py/PySDM.svg)](https://pypi.org/project/PySDM)
@@ -75,6 +75,8 @@ The package features a Pythonic high-performance implementation of the
   Super-Droplet Method (SDM) Monte-Carlo algorithm for representing collisional growth 
   ([Shima et al. 2009](https://rmets.onlinelibrary.wiley.com/doi/abs/10.1002/qj.441)), hence the name. 
 
+PySDM documentation is maintained at: [https://open-atmos.github.io/PySDM](https://open-atmos.github.io/PySDM) 
+
 There is a growing set of [example Jupyter notebooks](https://open-atmos.github.io/PySDM/PySDM_examples.html) exemplifying how to perform 
   various types of calculations and simulations using PySDM.
 Most of the example notebooks reproduce results and plot from literature, see below for 
@@ -105,14 +107,6 @@ For an overview of PySDM features (and the preferred way to cite PySDM in papers
 PySDM includes an extension of the SDM scheme to represent collisional breakup described in [de Jong, Mackay et al. 2023](10.5194/gmd-16-4193-2023).   
 For a list of talks and other materials on PySDM as well as a list of published papers featuring PySDM simulations, see the [project wiki](https://github.com/open-atmos/PySDM/wiki).
 
-A [pdoc-generated](https://pdoc.dev/) documentation of PySDM public API is maintained at: [https://open-atmos.github.io/PySDM](https://open-atmos.github.io/PySDM) 
-
-## Example Jupyter notebooks (reproducing results from literature):
-
-See [PySDM-examples README](https://github.com/open-atmos/PySDM/blob/main/examples/README.md).
-
-![animation](https://github.com/open-atmos/PySDM/wiki/files/kinematic_2D_example.gif)
-
 ## Dependencies and Installation
 
 PySDM dependencies are: [Numpy](https://numpy.org/), [Numba](http://numba.pydata.org/), [SciPy](https://scipy.org/), 

{pysdm-2.89 → pysdm-2.91}/PySDM.egg-info/SOURCES.txt

@@ -12,12 +12,11 @@ setup.py
 .binder/postBuild
 .binder/requirements.txt
 .github/dependabot.yml
-.github/pysdm_logo.png
-.github/pysdm_logo.svg
 .github/workflows/cancel.yml
 .github/workflows/joss.yml
 .github/workflows/joss_paper.yml
 .github/workflows/pdoc.yml
+.github/workflows/projects.yml
 .github/workflows/pypi.yml
 .github/workflows/readme_snippets.yml
 .github/workflows/stale.yml
@@ -413,6 +412,8 @@ PySDM/products/size_spectral/size_standard_deviation.py
 PySDM/products/size_spectral/total_particle_concentration.py
 PySDM/products/size_spectral/total_particle_specific_concentration.py
 PySDM/products/size_spectral/water_mixing_ratio.py
+docs/logos/pysdm_logo.png
+docs/logos/pysdm_logo.svg
 docs/markdown/pysdm_landing.md
 docs/templates/README.md
 docs/templates/custom.css
@@ -722,21 +723,13 @@ tests/smoke_tests/parcel_a/lowe_et_al_2019/test_surface_tension_models.py
 tests/smoke_tests/parcel_a/lowe_et_al_2019/test_zero_forg.py
 tests/smoke_tests/parcel_a/pyrcel/__init__.py
 tests/smoke_tests/parcel_a/pyrcel/test_parcel_example.py
-tests/smoke_tests/parcel_a/rozanski_and_sonntag_1982/__init__.py
-tests/smoke_tests/parcel_a/rozanski_and_sonntag_1982/test_figs_4_5_6.py
-tests/smoke_tests/parcel_a/seeding/__init__.py
-tests/smoke_tests/parcel_a/seeding/test_hello_world.py
-tests/smoke_tests/parcel_a/seeding/test_seeding_no_collisions.py
+tests/smoke_tests/parcel_b/__init__.py
 tests/smoke_tests/parcel_b/arabas_and_shima_2017/__init__.py
 tests/smoke_tests/parcel_b/arabas_and_shima_2017/test_conservation.py
 tests/smoke_tests/parcel_b/arabas_and_shima_2017/test_displacement.py
 tests/smoke_tests/parcel_b/arabas_and_shima_2017/test_event_rates.py
 tests/smoke_tests/parcel_b/arabas_and_shima_2017/test_initialisation.py
 tests/smoke_tests/parcel_b/arabas_and_shima_2017/test_vs_scipy.py
-tests/smoke_tests/parcel_b/yang_et_al_2018/__init__.py
-tests/smoke_tests/parcel_b/yang_et_al_2018/test_displacement.py
-tests/smoke_tests/parcel_b/yang_et_al_2018/test_initialisation.py
-tests/smoke_tests/parcel_b/yang_et_al_2018/test_just_do_it.py
 tests/smoke_tests/parcel_c/abade_and_albuquerque_2024/__init__.py
 tests/smoke_tests/parcel_c/abade_and_albuquerque_2024/test_fig_2.py
 tests/smoke_tests/parcel_c/abdul_razzak_ghan_2000/__init__.py
@@ -752,20 +745,30 @@ tests/smoke_tests/parcel_c/grabowski_and_pawlowska_2023/test_ripening_rate.py
 tests/smoke_tests/parcel_c/graf_et_al_2019/__init__.py
 tests/smoke_tests/parcel_c/graf_et_al_2019/test_fig_4.py
 tests/smoke_tests/parcel_c/graf_et_al_2019/test_table_1.py
-tests/smoke_tests/parcel_c/jensen_and_nugent_2017/__init__.py
-tests/smoke_tests/parcel_c/jensen_and_nugent_2017/test_fig_1.py
-tests/smoke_tests/parcel_c/jensen_and_nugent_2017/test_fig_3_and_tab_4_upper_rows.py
-tests/smoke_tests/parcel_c/jensen_and_nugent_2017/test_fig_4_and_7_and_tab_4_bottom_rows.py
-tests/smoke_tests/parcel_c/jensen_and_nugent_2017/test_fig_5.py
-tests/smoke_tests/parcel_c/jensen_and_nugent_2017/test_fig_6.py
-tests/smoke_tests/parcel_c/jensen_and_nugent_2017/test_table_3.py
-tests/smoke_tests/parcel_c/kreidenweis_et_al_2003/__init__.py
-tests/smoke_tests/parcel_c/kreidenweis_et_al_2003/test_fig_1.py
-tests/smoke_tests/parcel_c/kreidenweis_et_al_2003/test_ionic_strength.py
-tests/smoke_tests/parcel_c/kreidenweis_et_al_2003/test_spectrum_at_t_0.py
-tests/smoke_tests/parcel_c/kreidenweis_et_al_2003/test_table_3.py
-tests/smoke_tests/parcel_c/niedermeier_et_al_2013/__init__.py
-tests/smoke_tests/parcel_c/niedermeier_et_al_2013/test_temperature_profile.py
+tests/smoke_tests/parcel_d/__init__.py
+tests/smoke_tests/parcel_d/jensen_and_nugent_2017/__init__.py
+tests/smoke_tests/parcel_d/jensen_and_nugent_2017/test_fig_1.py
+tests/smoke_tests/parcel_d/jensen_and_nugent_2017/test_fig_3_and_tab_4_upper_rows.py
+tests/smoke_tests/parcel_d/jensen_and_nugent_2017/test_fig_4_and_7_and_tab_4_bottom_rows.py
+tests/smoke_tests/parcel_d/jensen_and_nugent_2017/test_fig_5.py
+tests/smoke_tests/parcel_d/jensen_and_nugent_2017/test_fig_6.py
+tests/smoke_tests/parcel_d/jensen_and_nugent_2017/test_table_3.py
+tests/smoke_tests/parcel_d/kreidenweis_et_al_2003/__init__.py
+tests/smoke_tests/parcel_d/kreidenweis_et_al_2003/test_fig_1.py
+tests/smoke_tests/parcel_d/kreidenweis_et_al_2003/test_ionic_strength.py
+tests/smoke_tests/parcel_d/kreidenweis_et_al_2003/test_spectrum_at_t_0.py
+tests/smoke_tests/parcel_d/kreidenweis_et_al_2003/test_table_3.py
+tests/smoke_tests/parcel_d/niedermeier_et_al_2013/__init__.py
+tests/smoke_tests/parcel_d/niedermeier_et_al_2013/test_temperature_profile.py
+tests/smoke_tests/parcel_d/rozanski_and_sonntag_1982/__init__.py
+tests/smoke_tests/parcel_d/rozanski_and_sonntag_1982/test_figs_4_5_6.py
+tests/smoke_tests/parcel_d/seeding/__init__.py
+tests/smoke_tests/parcel_d/seeding/test_hello_world.py
+tests/smoke_tests/parcel_d/seeding/test_seeding_no_collisions.py
+tests/smoke_tests/parcel_d/yang_et_al_2018/__init__.py
+tests/smoke_tests/parcel_d/yang_et_al_2018/test_displacement.py
+tests/smoke_tests/parcel_d/yang_et_al_2018/test_initialisation.py
+tests/smoke_tests/parcel_d/yang_et_al_2018/test_just_do_it.py
 tests/tutorials_tests/__init__.py
 tests/tutorials_tests/conftest.py
 tests/tutorials_tests/test_run_notebooks.py

{pysdm-2.89 → pysdm-2.91}/README.md

@@ -1,4 +1,4 @@
-# <img src="https://raw.githubusercontent.com/open-atmos/PySDM/main/.github/pysdm_logo.svg" width=100 height=146 alt="pysdm logo">
+# <img src="https://raw.githubusercontent.com/open-atmos/PySDM/main/docs/logos/pysdm_logo.svg" width=100 height=146 alt="pysdm logo">
 
 [![Python 3](https://img.shields.io/static/v1?label=Python&logo=Python&color=3776AB&message=3)](https://www.python.org/)
 [![LLVM](https://img.shields.io/static/v1?label=LLVM&logo=LLVM&color=gold&message=Numba)](https://numba.pydata.org)
@@ -17,7 +17,7 @@
 
 [![License: GPL v3](https://img.shields.io/badge/License-GPL%20v3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0.html)
 
-[![Github Actions Build Status](https://github.com/open-atmos/PySDM/workflows/tests+artifacts+pypi/badge.svg?branch=main)](https://github.com/open-atmos/PySDM/actions)
+[![Github Actions Build Status](https://github.com/open-atmos/PySDM/workflows/tests/badge.svg?branch=main)](https://github.com/open-atmos/PySDM/actions)
 [![Appveyor Build status](http://ci.appveyor.com/api/projects/status/github/open-atmos/PySDM?branch=main&svg=true)](https://ci.appveyor.com/project/slayoo/pysdm/branch/main)
 [![Coverage Status](https://codecov.io/gh/open-atmos/PySDM/branch/main/graph/badge.svg)](https://app.codecov.io/gh/open-atmos/PySDM)    
 [![PyPI version](https://badge.fury.io/py/PySDM.svg)](https://pypi.org/project/PySDM)
@@ -35,6 +35,8 @@ The package features a Pythonic high-performance implementation of the
   Super-Droplet Method (SDM) Monte-Carlo algorithm for representing collisional growth 
   ([Shima et al. 2009](https://rmets.onlinelibrary.wiley.com/doi/abs/10.1002/qj.441)), hence the name. 
 
+PySDM documentation is maintained at: [https://open-atmos.github.io/PySDM](https://open-atmos.github.io/PySDM) 
+
 There is a growing set of [example Jupyter notebooks](https://open-atmos.github.io/PySDM/PySDM_examples.html) exemplifying how to perform 
   various types of calculations and simulations using PySDM.
 Most of the example notebooks reproduce results and plot from literature, see below for 
@@ -65,14 +67,6 @@ For an overview of PySDM features (and the preferred way to cite PySDM in papers
 PySDM includes an extension of the SDM scheme to represent collisional breakup described in [de Jong, Mackay et al. 2023](10.5194/gmd-16-4193-2023).   
 For a list of talks and other materials on PySDM as well as a list of published papers featuring PySDM simulations, see the [project wiki](https://github.com/open-atmos/PySDM/wiki).
 
-A [pdoc-generated](https://pdoc.dev/) documentation of PySDM public API is maintained at: [https://open-atmos.github.io/PySDM](https://open-atmos.github.io/PySDM) 
-
-## Example Jupyter notebooks (reproducing results from literature):
-
-See [PySDM-examples README](https://github.com/open-atmos/PySDM/blob/main/examples/README.md).
-
-![animation](https://github.com/open-atmos/PySDM/wiki/files/kinematic_2D_example.gif)
-
 ## Dependencies and Installation
 
 PySDM dependencies are: [Numpy](https://numpy.org/), [Numba](http://numba.pydata.org/), [SciPy](https://scipy.org/), 

{pysdm-2.89/.github → pysdm-2.91/docs/logos}/pysdm_logo.svg

@@ -1 +1 @@
-<?xml version="1.0" encoding="UTF-8"?><svg id="Warstwa_2" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 153 222.59"><defs><style>.cls-1{fill:#13a4de;}</style></defs><g id="Warstwa_4"><g><g><path class="cls-1" d="m48.45,57.44c0,8.04-6.82,14.56-15.23,14.56s-15.23-6.52-15.23-14.56c0-14.56,15.23-33.97,15.23-33.97,0,0,15.23,19.41,15.23,33.97Z"/><path class="cls-1" d="m63,22.22c0,5.26-4.46,9.52-9.96,9.52s-9.96-4.26-9.96-9.52c0-9.52,9.96-22.22,9.96-22.22,0,0,9.96,12.7,9.96,22.22Z"/></g><path class="cls-1" d="m90,0s-45,57.6-45,100.8c0,23.86,20.15,43.2,45,43.2s45-19.34,45-43.2C135,57.6,90,0,90,0Zm29.37,131.64c-19.14,16.75-34.42,5.24-37.26-6.95-2.84-12.19,6.42-41.71,8.5-50.63s4.38-30.39-6.36-28.46-12.2,18.32-9.98,27.76c2.22,9.45,14.98,52.01-9.23,44.17-22.97-7.44-13.86-45.93-13.86-45.93,0,0-2.53,30.62,13.12,35.08,11.1,3.16,9.97-15.47,6.64-28.6-3.33-13.12-12.86-29.48-1.93-43.03,10.94-13.55,27.62-17.48,35.24-9.51,7.62,7.97-1.92,29.94-5.9,42.22s-6.42,26.66-6.74,34.82c-.32,8.17,3.88,23.62,16.36,20.47s16.08-22.73,12.4-34.06c-3.67-11.33-6.57-10.6-10.97-20.55-.91-2.06-.8-3.68-.2-4.69-.69-1.05-2.6-1.33-2.6-1.33,1.21-.26,1.17-.14,1.75-.12-.02-.22-.14-1.21-.14-1.21.6.45,1.08,1.89,1.21,2.33.58-.72,1.46-1,2.35-.74,2.09.61,5.09,2.78,5.81,3.03,1.9.67,3.8,1.45,4.82,2.38,2.87,2.62,3.31,3.95,4.34,6.3,1.77,4.05,16.99,35.94-7.37,57.25Z"/><path class="cls-1" d="m119.37,68.87s1.13.6,1.53.85.95.69,1.61,1.2c-1.38.17-2.07-.06-2.42-.38-.49-.44-.73-1.67-.73-1.67Z"/></g><g><path class="cls-1" d="m1.14,213.6c-.32,0-.58-.11-.8-.33-.22-.22-.33-.49-.33-.8v-30.81c0-.35.11-.63.33-.85.22-.22.49-.33.8-.33h12.68c2.46,0,4.61.39,6.44,1.16,1.83.77,3.25,1.94,4.26,3.5,1.01,1.56,1.51,3.51,1.51,5.84s-.5,4.32-1.51,5.85c-1.01,1.53-2.43,2.67-4.26,3.43-1.83.76-3.98,1.14-6.44,1.14h-7.05v11.07c0,.32-.1.58-.31.8-.21.22-.48.33-.83.33H1.14Zm5.54-17.46h6.91c1.83,0,3.23-.43,4.21-1.3.98-.87,1.47-2.15,1.47-3.86,0-1.58-.46-2.85-1.37-3.81s-2.35-1.44-4.31-1.44h-6.91v10.41Z"/><path class="cls-1" d="m35.07,222.59c-.25,0-.47-.09-.66-.28-.19-.19-.28-.41-.28-.66,0-.13,0-.24.02-.36.02-.11.07-.24.17-.4l3.69-8.76-9.09-21.44c-.13-.31-.19-.54-.19-.66.03-.28.14-.53.33-.73.19-.2.43-.31.71-.31h3.83c.38,0,.66.09.85.28.19.19.33.39.43.62l6.29,15.48,6.48-15.48c.09-.25.24-.47.43-.64.19-.17.47-.26.85-.26h3.79c.25,0,.48.09.69.28.2.19.31.41.31.66,0,.19-.06.44-.19.76l-13.39,31c-.13.25-.28.47-.47.64-.19.17-.47.26-.85.26h-3.74Z"/><path class="cls-1" d="m69.85,214.07c-2.93,0-5.39-.43-7.36-1.3-1.97-.87-3.47-2-4.5-3.41s-1.57-2.88-1.63-4.43c0-.28.1-.52.28-.71.19-.19.43-.28.71-.28h4.21c.41,0,.72.09.92.26.2.17.39.39.54.64.19.6.55,1.19,1.09,1.77.54.58,1.27,1.06,2.2,1.44.93.38,2.11.57,3.53.57,2.27,0,3.97-.38,5.09-1.14,1.12-.76,1.68-1.78,1.68-3.08,0-.92-.3-1.65-.9-2.2-.6-.55-1.52-1.06-2.77-1.51-1.25-.46-2.89-.94-4.95-1.44-2.37-.57-4.35-1.25-5.94-2.06-1.59-.8-2.79-1.82-3.6-3.05-.8-1.23-1.21-2.79-1.21-4.69s.5-3.45,1.49-4.87c.99-1.42,2.41-2.54,4.26-3.36,1.85-.82,4.05-1.23,6.6-1.23,2.05,0,3.86.28,5.44.83,1.58.55,2.89,1.28,3.93,2.18s1.84,1.86,2.39,2.89.84,2.03.88,3.01c0,.25-.09.48-.26.69-.17.21-.42.31-.73.31h-4.4c-.25,0-.5-.06-.76-.19-.25-.13-.46-.36-.62-.71-.19-.98-.8-1.81-1.85-2.51-1.04-.69-2.38-1.04-4.02-1.04s-3.08.31-4.12.95c-1.04.63-1.56,1.61-1.56,2.93,0,.88.26,1.62.78,2.2.52.58,1.36,1.1,2.51,1.54,1.15.44,2.67.92,4.57,1.42,2.68.6,4.87,1.29,6.58,2.08,1.7.79,2.95,1.79,3.74,3.01.79,1.22,1.18,2.75,1.18,4.61,0,2.08-.56,3.86-1.68,5.32-1.12,1.47-2.69,2.6-4.71,3.38-2.02.79-4.37,1.18-7.05,1.18Z"/><path class="cls-1" d="m89.87,213.6c-.32,0-.58-.11-.8-.33-.22-.22-.33-.49-.33-.8v-30.81c0-.35.11-.63.33-.85.22-.22.49-.33.8-.33h11.55c3.19,0,5.81.49,7.88,1.47,2.07.98,3.63,2.43,4.69,4.35,1.06,1.92,1.6,4.28,1.63,7.05.06,1.39.09,2.62.09,3.69s-.03,2.29-.09,3.64c-.06,2.93-.6,5.36-1.61,7.26-1.01,1.91-2.53,3.33-4.57,4.26-2.04.93-4.63,1.4-7.79,1.4h-11.78Zm5.44-5.44h6.11c1.77,0,3.2-.25,4.31-.76,1.1-.5,1.92-1.32,2.44-2.44.52-1.12.8-2.59.83-4.43.03-.95.05-1.77.07-2.48.02-.71.02-1.42,0-2.13-.02-.71-.04-1.52-.07-2.44-.06-2.59-.71-4.5-1.94-5.73-1.23-1.23-3.19-1.85-5.87-1.85h-5.87v22.24Z"/><path class="cls-1" d="m123.19,213.6c-.35,0-.63-.11-.85-.33-.22-.22-.33-.49-.33-.8v-30.81c0-.35.11-.63.33-.85.22-.22.5-.33.85-.33h3.74c.44,0,.77.12.99.35.22.24.36.42.43.54l9.13,17.04,9.23-17.04c.06-.13.21-.31.43-.54.22-.24.55-.35.99-.35h3.69c.35,0,.63.11.85.33s.33.5.33.85v30.81c0,.32-.11.58-.33.8-.22.22-.5.33-.85.33h-3.98c-.35,0-.62-.11-.83-.33-.21-.22-.31-.49-.31-.8v-20.49l-6.63,12.64c-.16.28-.36.53-.62.73-.25.21-.58.31-.99.31h-1.94c-.44,0-.78-.1-1.02-.31s-.43-.45-.59-.73l-6.63-12.64v20.49c0,.32-.11.58-.33.8s-.49.33-.8.33h-3.97Z"/></g></g></svg>
+<?xml version="1.0" encoding="UTF-8"?><svg id="Warstwa_2" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 153 222.59"><defs><style>.cls-1{fill:#13a4de;}</style></defs><g id="Warstwa_4"><g><g><path class="cls-1" d="m48.45,57.44c0,8.04-6.82,14.56-15.23,14.56s-15.23-6.52-15.23-14.56c0-14.56,15.23-33.97,15.23-33.97,0,0,15.23,19.41,15.23,33.97Z"/><path class="cls-1" d="m63,22.22c0,5.26-4.46,9.52-9.96,9.52s-9.96-4.26-9.96-9.52c0-9.52,9.96-22.22,9.96-22.22,0,0,9.96,12.7,9.96,22.22Z"/></g><path class="cls-1" d="m90,0s-45,57.6-45,100.8c0,23.86,20.15,43.2,45,43.2s45-19.34,45-43.2C135,57.6,90,0,90,0Zm29.37,131.64c-19.14,16.75-34.42,5.24-37.26-6.95-2.84-12.19,6.42-41.71,8.5-50.63s4.38-30.39-6.36-28.46-12.2,18.32-9.98,27.76c2.22,9.45,14.98,52.01-9.23,44.17-22.97-7.44-13.86-45.93-13.86-45.93,0,0-2.53,30.62,13.12,35.08,11.1,3.16,9.97-15.47,6.64-28.6-3.33-13.12-12.86-29.48-1.93-43.03,10.94-13.55,27.62-17.48,35.24-9.51,7.62,7.97-1.92,29.94-5.9,42.22s-6.42,26.66-6.74,34.82c-.32,8.17,3.88,23.62,16.36,20.47s16.08-22.73,12.4-34.06c-3.67-11.33-6.57-10.6-10.97-20.55-.91-2.06-.8-3.68-.2-4.69-.69-1.05-2.6-1.33-2.6-1.33,1.21-.26,1.17-.14,1.75-.12-.02-.22-.14-1.21-.14-1.21.6.45,1.08,1.89,1.21,2.33.58-.72,1.46-1,2.35-.74,2.09.61,5.09,2.78,5.81,3.03,1.9.67,3.8,1.45,4.82,2.38,2.87,2.62,3.31,3.95,4.34,6.3,1.77,4.05,16.99,35.94-7.37,57.25Z"/><path class="cls-1" d="m119.37,68.87s1.13.6,1.53.85.95.69,1.61,1.2c-1.38.17-2.07-.06-2.42-.38-.49-.44-.73-1.67-.73-1.67Z"/></g><g><path class="cls-1" d="m1.14,213.6c-.32,0-.58-.11-.8-.33-.22-.22-.33-.49-.33-.8v-30.81c0-.35.11-.63.33-.85.22-.22.49-.33.8-.33h12.68c2.46,0,4.61.39,6.44,1.16,1.83.77,3.25,1.94,4.26,3.5,1.01,1.56,1.51,3.51,1.51,5.84s-.5,4.32-1.51,5.85c-1.01,1.53-2.43,2.67-4.26,3.43-1.83.76-3.98,1.14-6.44,1.14h-7.05v11.07c0,.32-.1.58-.31.8-.21.22-.48.33-.83.33H1.14Zm5.54-17.46h6.91c1.83,0,3.23-.43,4.21-1.3.98-.87,1.47-2.15,1.47-3.86,0-1.58-.46-2.85-1.37-3.81s-2.35-1.44-4.31-1.44h-6.91v10.41Z"/><path class="cls-1" d="m35.07,222.59c-.25,0-.47-.09-.66-.28-.19-.19-.28-.41-.28-.66,0-.13,0-.24.02-.36.02-.11.07-.24.17-.4l3.69-8.76-9.09-21.44c-.13-.31-.19-.54-.19-.66.03-.28.14-.53.33-.73.19-.2.43-.31.71-.31h3.83c.38,0,.66.09.85.28.19.19.33.39.43.62l6.29,15.48,6.48-15.48c.09-.25.24-.47.43-.64.19-.17.47-.26.85-.26h3.79c.25,0,.48.09.69.28.2.19.31.41.31.66,0,.19-.06.44-.19.76l-13.39,31c-.13.25-.28.47-.47.64-.19.17-.47.26-.85.26h-3.74Z"/><path class="cls-1" d="m69.85,214.07c-2.93,0-5.39-.43-7.36-1.3-1.97-.87-3.47-2-4.5-3.41s-1.57-2.88-1.63-4.43c0-.28.1-.52.28-.71.19-.19.43-.28.71-.28h4.21c.41,0,.72.09.92.26.2.17.39.39.54.64.19.6.55,1.19,1.09,1.77.54.58,1.27,1.06,2.2,1.44.93.38,2.11.57,3.53.57,2.27,0,3.97-.38,5.09-1.14,1.12-.76,1.68-1.78,1.68-3.08,0-.92-.3-1.65-.9-2.2-.6-.55-1.52-1.06-2.77-1.51-1.25-.46-2.89-.94-4.95-1.44-2.37-.57-4.35-1.25-5.94-2.06-1.59-.8-2.79-1.82-3.6-3.05-.8-1.23-1.21-2.79-1.21-4.69s.5-3.45,1.49-4.87c.99-1.42,2.41-2.54,4.26-3.36,1.85-.82,4.05-1.23,6.6-1.23,2.05,0,3.86.28,5.44.83,1.58.55,2.89,1.28,3.93,2.18s1.84,1.86,2.39,2.89.84,2.03.88,3.01c0,.25-.09.48-.26.69-.17.21-.42.31-.73.31h-4.4c-.25,0-.5-.06-.76-.19-.25-.13-.46-.36-.62-.71-.19-.98-.8-1.81-1.85-2.51-1.04-.69-2.38-1.04-4.02-1.04s-3.08.31-4.12.95c-1.04.63-1.56,1.61-1.56,2.93,0,.88.26,1.62.78,2.2.52.58,1.36,1.1,2.51,1.54,1.15.44,2.67.92,4.57,1.42,2.68.6,4.87,1.29,6.58,2.08,1.7.79,2.95,1.79,3.74,3.01.79,1.22,1.18,2.75,1.18,4.61,0,2.08-.56,3.86-1.68,5.32-1.12,1.47-2.69,2.6-4.71,3.38-2.02.79-4.37,1.18-7.05,1.18Z"/><path class="cls-1" d="m89.87,213.6c-.32,0-.58-.11-.8-.33-.22-.22-.33-.49-.33-.8v-30.81c0-.35.11-.63.33-.85.22-.22.49-.33.8-.33h11.55c3.19,0,5.81.49,7.88,1.47,2.07.98,3.63,2.43,4.69,4.35,1.06,1.92,1.6,4.28,1.63,7.05.06,1.39.09,2.62.09,3.69s-.03,2.29-.09,3.64c-.06,2.93-.6,5.36-1.61,7.26-1.01,1.91-2.53,3.33-4.57,4.26-2.04.93-4.63,1.4-7.79,1.4h-11.78Zm5.44-5.44h6.11c1.77,0,3.2-.25,4.31-.76,1.1-.5,1.92-1.32,2.44-2.44.52-1.12.8-2.59.83-4.43.03-.95.05-1.77.07-2.48.02-.71.02-1.42,0-2.13-.02-.71-.04-1.52-.07-2.44-.06-2.59-.71-4.5-1.94-5.73-1.23-1.23-3.19-1.85-5.87-1.85h-5.87v22.24Z"/><path class="cls-1" d="m123.19,213.6c-.35,0-.63-.11-.85-.33-.22-.22-.33-.49-.33-.8v-30.81c0-.35.11-.63.33-.85.22-.22.5-.33.85-.33h3.74c.44,0,.77.12.99.35.22.24.36.42.43.54l9.13,17.04,9.23-17.04c.06-.13.21-.31.43-.54.22-.24.55-.35.99-.35h3.69c.35,0,.63.11.85.33s.33.5.33.85v30.81c0,.32-.11.58-.33.8-.22.22-.5.33-.85.33h-3.98c-.35,0-.62-.11-.83-.33-.21-.22-.31-.49-.31-.8v-20.49l-6.63,12.64c-.16.28-.36.53-.62.73-.25.21-.58.31-.99.31h-1.94c-.44,0-.78-.1-1.02-.31s-.43-.45-.59-.73l-6.63-12.64v20.49c0,.32-.11.58-.33.8s-.49.33-.8.33h-3.97Z"/></g></g></svg>

{pysdm-2.89 → pysdm-2.91}/docs/markdown/pysdm_landing.md

@@ -1,6 +1,6 @@
 # Introduction
 
-<img align="left" src="https://raw.githubusercontent.com/open-atmos/PySDM/main/.github/pysdm_logo.svg" width=150 height=219 alt="pysdm logo" style="padding-right:1em">
+<img align="left" src="https://raw.githubusercontent.com/open-atmos/PySDM/main/docs/logos/pysdm_logo.svg" width=150 height=219 alt="pysdm logo" style="padding-right:1em">
 
 PySDM offers a set of building blocks for development of atmospheric cloud
 simulation systems revolving around the particle-based microphysics modelling concept

{pysdm-2.89 → pysdm-2.91}/docs/templates/index.html.jinja2

@@ -24,25 +24,32 @@
     <main class="pdoc">
         <div style="display: flex; align-items: center;">
             <a href="https://open-atmos.github.io/PySDM/index.html">
-                <img src="https://raw.githubusercontent.com/open-atmos/PySDM/main/.github/pysdm_logo.svg" style="height:10em" alt="PySDM logo">
+                <img src="https://raw.githubusercontent.com/open-atmos/PySDM/main/docs/logos/pysdm_logo.svg" style="height:10em" alt="PySDM logo">
             </a>
             <h1 style="padding-left: 0.5em; color: #13A4DE; font-weight: normal ">Documentation</h1>
     </div>
     <div style="padding-top: 2em">
         <h2>What is PySDM?</h2>
         <p>
-            PySDM is a package for simulating the dynamics of population of particles.
-            It is intended to serve as a building block for simulation systems modelling fluid flows involving a dispersed phase, with PySDM being responsible for representation of the dispersed phase.
-            Currently, the development is focused on atmospheric cloud physics applications, in particular on modelling the dynamics of particles immersed in moist air using the particle-based (a.k.a. super-droplet) approach to represent aerosol/cloud/rain microphysics.
-            The package features a Pythonic high-performance implementation of the Super-Droplet Method (SDM) Monte-Carlo algorithm for representing collisional growth 
-            (<a href="https://doi.org/10.1002/qj.441">Shima et al. 2009</a>), hence the name.
+            <video controls style="float:right; width:40%">
+                <source src="https://github.com/open-atmos/PySDM/wiki/files/animation_save.mp4" type="video/mp4">
+                Your browser does not support the video tag.
+            </video>
+            PySDM is a package for simulating the <mark>dynamics of population of particles undergoing diffusional and collisional growth (and breakage)</mark>.
+            The package features a Pythonic high-performance (multi-threaded CPU &amp; CUDA GPU) implementation of the <mark>Super-Droplet Method (SDM) Monte-Carlo algorithm</mark> 
+              for representing collisional growth (<a href="https://doi.org/10.1002/qj.441">Shima et al. 2009</a>), hence the name.
+            It is intended to serve as a building block for simulation systems modelling <mark>fluid flows involving a dispersed phase</mark>,
+               with PySDM being responsible for representation of the dispersed phase.
+            Currently, the development is focused on atmospheric <mark>cloud physics applications</mark>, in particular on modelling the dynamics of 
+              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.
         </p>
     </div>
     <div style="padding-top: 0.5em">
         <h2>What is the difference between PySDM and PySDM-examples?</h2>
         <p>
-            PySDM is a Python package that provides the implementation of the Super-Droplet Method (SDM) Monte-Carlo algorithm.
-            It is a library that can be used in your own projects.
+            PySDM is a Python package that provides the implementation of SDM that can be used in your own projects.
         </p>
         <p>
             PySDM-examples is a Python package that provides examples of how to use PySDM.
@@ -159,7 +166,7 @@ jupyter-notebook PySDM/examples</code></pre>
         </p>
         <p>
           Development of PySDM was supported by:
-          <ul>
+          <ul style="list-style:square; margin-left:1em;">
             <li><a href="https://www.fnp.org.pl/en/">Foundation for Polish Science</a> (grant no. POIR.04.04.00-00-5E1C/18 co-financed by the European Union under the European Regional Development Fund)</li>
             <li><a href="https://ncn.gov.pl/en">Polish National Science Centre</a> (grant no. 2020/39/D/ST10/01220)</li>
             <li><a href="https://science.energy.gov">US Department of Energy</a> via the <a href="https://www.krellinst.org/csgf/">Computational Science Graduate Fellowship</a> and via the <a href="https://asr.science.energy.gov/">Atmospheric System Research Program</a> (grant no. DE-SC0021034)</li>

{pysdm-2.89 → pysdm-2.91}/examples/PySDM_examples/Arabas_et_al_2015/gui.ipynb

@@ -19,11 +19,11 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 3,
+   "execution_count": 1,
    "metadata": {
     "ExecuteTime": {
-     "end_time": "2024-02-01T07:20:48.271051Z",
-     "start_time": "2024-02-01T07:20:48.265608Z"
+     "end_time": "2024-12-16T17:34:09.974590Z",
+     "start_time": "2024-12-16T17:34:09.970558Z"
     }
    },
    "outputs": [],
@@ -37,25 +37,27 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 4,
+   "execution_count": 2,
    "metadata": {
-    "pycharm": {
-     "name": "#%%\n"
-    },
     "ExecuteTime": {
      "end_time": "2024-02-01T07:20:49.033295Z",
      "start_time": "2024-02-01T07:20:48.277874Z"
+    },
+    "pycharm": {
+     "name": "#%%\n"
     }
    },
    "outputs": [
     {
      "data": {
-      "text/plain": "Tab(children=(VBox(children=(HBox(children=(FloatProgress(value=0.0, max=1.0), Button(description='start simul…",
       "application/vnd.jupyter.widget-view+json": {
+       "model_id": "b7b03e5eb4bf402d9223b46970bf4632",
        "version_major": 2,
-       "version_minor": 0,
-       "model_id": "aed710d458cd4076bdb94f3085778500"
-      }
+       "version_minor": 0
+      },
+      "text/plain": [
+       "Tab(children=(VBox(children=(HBox(children=(FloatProgress(value=0.0, max=1.0), Button(description='start simul…"
+      ]
      },
      "metadata": {},
      "output_type": "display_data"
@@ -88,9 +90,9 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.8.9"
+   "version": "3.12.8"
   }
  },
  "nbformat": 4,
- "nbformat_minor": 2
+ "nbformat_minor": 4
 }