PySDM 2.85__py3-none-any.whl → 2.87__py3-none-any.whl

PySDM/physics/constants_defaults.py

@@ -428,3 +428,12 @@ one_kelvin = 1 * si.K
 bulk_phase_partitioning_T_cold = 235 * si.K
 bulk_phase_partitioning_T_warm = 273 * si.K
 bulk_phase_partitioning_exponent = np.nan
+
+
+BOLIN_ISOTOPE_TIMESCALE_COEFF_C1 = np.nan * si.dimensionless
+"""
+Coeffitient c1 used in [Bolin 1958](https://https://digitallibrary.un.org/record/3892725)
+for the falling drop evaporation timescale of equilibration with ambient air void of a given
+isotopologue; in the paper timescale is calculated for tritium with assumption of no tritium
+in the environment around the drop (Table 1).
+"""

PySDM/physics/dimensional_analysis.py

@@ -1,12 +1,12 @@
 """
-A context manager (for use with the `with` statement)
-for use in unit tests which disables Numba and enables Pint
+A context manager (for use with the `with` statement) which
+enables Pint physical-units checks and disables Numba in `PySDM.formulae.Formulae`
 """
 
 from importlib import reload
 
 from PySDM import formulae
-
+from PySDM import physics
 from . import constants, constants_defaults
 from .impl import flag
 
@@ -17,9 +17,11 @@ class DimensionalAnalysis:
         reload(constants)
         reload(constants_defaults)
         reload(formulae)
+        reload(physics)
 
     def __exit__(*_):  # pylint: disable=no-method-argument,no-self-argument
         flag.DIMENSIONAL_ANALYSIS = False
         reload(constants)
         reload(constants_defaults)
         reload(formulae)
+        reload(physics)

PySDM/physics/isotope_relaxation_timescale/__init__.py

@@ -4,3 +4,4 @@ isotope relaxation timescale formulae
 
 from PySDM.impl.null_physics_class import Null
 from .miyake_et_al_1968 import MiyakeEtAl1968
+from .bolin_1958 import Bolin1958

PySDM/physics/isotope_relaxation_timescale/bolin_1958.py

@@ -0,0 +1,17 @@
+""" Timescale derived for tritium with assumption of zero ambient concentration - see text above
+    Table 1 [Bolin 1958](https://digitallibrary.un.org/record/3892725) """
+
+import numpy as np
+
+
+class Bolin1958:  # pylint: disable=too-few-public-methods
+    """Implementation of timescale used by Bolin 1958"""
+
+    def __init__(self, const):
+        assert np.isfinite(const.BOLIN_ISOTOPE_TIMESCALE_COEFF_C1)
+
+    @staticmethod
+    # pylint: disable=too-many-arguments
+    def tau(const, radius, r_dr_dt):
+        """timescale for evaporation of a falling drop with tritium"""
+        return (-3 / radius**2 * r_dr_dt * const.BOLIN_ISOTOPE_TIMESCALE_COEFF_C1) ** -1

{PySDM-2.85.dist-info → PySDM-2.87.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: PySDM
-Version: 2.85
+Version: 2.87
 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
@@ -75,7 +75,7 @@ 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. 
 
-There is a growing set of example Jupyter notebooks exemplifying how to perform 
+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 
   a list of examples and links to the notebooks (which can be either executed or viewed 
@@ -134,7 +134,7 @@ Conda users may use ``pip`` as well, see the [Installing non-conda packages](htt
 For development purposes, we suggest cloning the repository and installing it using ``pip -e``.
 Test-time dependencies can be installed with ``pip -e .[tests]``.
 
-PySDM examples constitute the [``PySDM-examples``](https://github.com/open-atmos/PySDM-examples) package.
+PySDM examples constitute the [``PySDM-examples``](https://github.com/open-atmos/PySDM/blob/main/examples) package.
 The examples have additional dependencies listed in [``PySDM_examples`` package ``setup.py``](https://github.com/open-atmos/PySDM/blob/main/examples/setup.py) file.
 Running the example Jupyter notebooks requires the ``PySDM_examples`` package to be installed.
 The suggested install and launch steps are:
@@ -189,7 +189,8 @@ To run all pre-commit hooks, run `pre-commit run --all-files`.
 The `.pre-commit-config.yaml` file can be modified in case new hooks are to be added or
   existing ones need to be altered.  
 
-Further hints addressed at PySDM developers are maintained in the [open-atmos/python-dev-hints Wiki](https://github.com/open-atmos/python-dev-hints/wiki).
+Further hints addressed at PySDM developers are maintained in the [open-atmos/python-dev-hints Wiki](https://github.com/open-atmos/python-dev-hints/wiki)
+  and in [PySDM HOWTOs](https://github.com/open-atmos/PySDM/tree/main/examples/PySDM_examples/_HOWTOS).
 
 Issues regarding any incorrect, unintuitive or undocumented bahaviour of
 PySDM are best to be reported on the [GitHub issue tracker](https://github.com/open-atmos/PySDM/issues/new).

{PySDM-2.85.dist-info → PySDM-2.87.dist-info}/RECORD

@@ -200,8 +200,8 @@ PySDM/initialisation/spectra/sum.py,sha256=SaxepweOdCozWlUkxCfr6Udo-KjGKWXgrdS0a
 PySDM/initialisation/spectra/top_hat.py,sha256=xmBr_IrctsnguPNgX-jR7JnQnQl1qzIaEyz75fvAJho,563
 PySDM/physics/__init__.py,sha256=cHgdLJl631R3bkiqq-t_FNZXAq6jdLor34uLr5LESAY,1890
 PySDM/physics/constants.py,sha256=ETbcdk-nhrVtjHidTREjHiUkAemNBNrSBWED3XjCXb8,1333
-PySDM/physics/constants_defaults.py,sha256=o3dcweOvCcI84tpvIWcy3cSWsqFfYH83tM6SKe_y_JM,14240
-PySDM/physics/dimensional_analysis.py,sha256=6_myMgc_eKhcbuNr7RqiQGj0OKNQ1TNqEMRb6Kzsqj0,688
+PySDM/physics/constants_defaults.py,sha256=VoZpbxBNyOfIwT6keyokmRJjsgND2UoaSEeAxNSFgrw,14633
+PySDM/physics/dimensional_analysis.py,sha256=Zk6ZHq9eTuOxoETgxyvg-0s0Tv4FDYbyFKCRFqVlCU0,790
 PySDM/physics/trivia.py,sha256=gAF0fUKTGFZbt95D2G_MwnDfAgVymGDWMawncKAMOG0,4048
 PySDM/physics/air_dynamic_viscosity/__init__.py,sha256=cLemG7DDSvwWv0mDwotzIUMHdiVhlLP_OrFENOnD8RM,90
 PySDM/physics/air_dynamic_viscosity/zografos_et_al_1987.py,sha256=51X3jHzkhx8w9KtYwbG_TEUbYJ9QpiLfXEiBqlrXFqw,620
@@ -271,7 +271,8 @@ PySDM/physics/isotope_ratio_evolution/__init__.py,sha256=w_8J7rh-c6RGDLMyYoNADrE
 PySDM/physics/isotope_ratio_evolution/gedzelman_and_arnold_1994.py,sha256=x0MlfJ219ApaUhLImIiI71A4uv0MyeOVdFRguv4CC-4,534
 PySDM/physics/isotope_ratio_evolution/merlivat_and_jouzel_1979.py,sha256=OQnkJ7UB_9H2KHuRwXNhmTJINrw7m_erNJmWPQpdDTk,531
 PySDM/physics/isotope_ratio_evolution/rayleigh_distillation.py,sha256=lQ-2AeYuyQRnuDHre3ZlplPbMHD9aObipXcf7Kfqqhw,344
-PySDM/physics/isotope_relaxation_timescale/__init__.py,sha256=wzfxFHo0sJBeCSsAhDLNwwujFHIMk1d42GC1b22pXrU,140
+PySDM/physics/isotope_relaxation_timescale/__init__.py,sha256=gYZSTFs9ZfTDEEjTCRVd9E0LQMwKMokzG6_8ePF6x_8,174
+PySDM/physics/isotope_relaxation_timescale/bolin_1958.py,sha256=fO7iRGb-X6RnKk_hKG54gD5p5U7LrWe6zdZ1uwZLsnM,666
 PySDM/physics/isotope_relaxation_timescale/miyake_et_al_1968.py,sha256=SgUfJulJhlan3knUUhGsgc3mDxmfXtzZHCnYrwZpees,456
 PySDM/physics/latent_heat/__init__.py,sha256=3edHhiH1wOwL84k_JubNQIDLZI8042plRafGreFSBck,185
 PySDM/physics/latent_heat/constant.py,sha256=pw39hru5vvSd-95-gVnYwr8vac1XhU8mLnPiNN4sKb8,263
@@ -383,8 +384,8 @@ PySDM/products/size_spectral/size_standard_deviation.py,sha256=A7fSj_keQi_bHW41P
 PySDM/products/size_spectral/total_particle_concentration.py,sha256=K7sO2jgUpYOwWvBK3jXp9KUxLRXk_Ve6ooOdY5q5jd0,470
 PySDM/products/size_spectral/total_particle_specific_concentration.py,sha256=isLZt5j2vJGr-FrzYFcUNPHZqMKhOtl51za1Hogh6hQ,476
 PySDM/products/size_spectral/water_mixing_ratio.py,sha256=PP54hfMy4SPDQDJgV4RNzVP03lmL1THZPa2KXrdgoQ4,1324
-PySDM-2.85.dist-info/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-PySDM-2.85.dist-info/METADATA,sha256=aekk57uDTAzRx120yu4rck8gkRyRk4EowiGPi0ljEEQ,17155
-PySDM-2.85.dist-info/WHEEL,sha256=P9jw-gEje8ByB7_hXoICnHtVCrEwMQh-630tKvQWehc,91
-PySDM-2.85.dist-info/top_level.txt,sha256=6NYaDAhUnaYMD7ebD_dQ7HlhiJS7NMuKEXb0ck7Wcsg,6
-PySDM-2.85.dist-info/RECORD,,
+PySDM-2.87.dist-info/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+PySDM-2.87.dist-info/METADATA,sha256=shahfELgf9gVfE3PnZ7P4iUSikIVwkR-ccN7yfNv1xY,17326
+PySDM-2.87.dist-info/WHEEL,sha256=P9jw-gEje8ByB7_hXoICnHtVCrEwMQh-630tKvQWehc,91
+PySDM-2.87.dist-info/top_level.txt,sha256=6NYaDAhUnaYMD7ebD_dQ7HlhiJS7NMuKEXb0ck7Wcsg,6
+PySDM-2.87.dist-info/RECORD,,