PyPartMC 2.0.0rc5__cp312-cp312-macosx_13_0_x86_64.whl → 2.0.0rc7__cp312-cp312-macosx_13_0_x86_64.whl

PyPartMC/__init__.py

@@ -4,6 +4,7 @@
 
 #  pylint: disable=invalid-name
 import importlib.metadata
+import inspect
 
 # pylint: disable=invalid-name,wrong-import-position
 import os
@@ -79,8 +80,29 @@ from ._PyPartMC import (  # pylint: disable=import-error
     __versions_of_build_time_dependencies__,
 )
 
+# Hacky workaround for missing docs in pdoc auto-generated documentation.
+# After the switch to nanobind, the docs became empty despite "__doc__" being
+# accessible in all of PyPartMC's objects. The code below manually populates
+# the "__all__" atrribute of the package. Additionally, functions in the generated
+# docs would be listed as nanobind objects with no additional documentation.
+# To solve that, dummy functions of the same name are created, and their "__doc__"
+# attribute is manually set to the "original" objects' "__doc__"
+if os.getenv("PDOC_GENERATE_PYPARTMC_DOCS") == "1":
+    all_items = []
+    for name, obj in inspect.getmembers(
+        _PyPartMC  # pylint: disable=undefined-variable
+    ):
+        if callable(obj):
+            if not inspect.isclass(obj):
+                exec(name + " = lambda : 0")  # pylint: disable=exec-used
+                temp = "_PyPartMC." + name + ".__doc__"
+                setattr(eval(name), "__doc__", eval(temp))  # pylint: disable=eval-used
+            all_items.append(name)
+
+    __all__ = tuple([*all_items, "si"])
+
 __version__ = importlib.metadata.version(__package__)
 
-# walkaround for MATLAB bindings
+# workaround for MATLAB bindings
 # pylint: disable=undefined-variable
 setattr(nanobind, "nb_type_0", type(_PyPartMC.AeroData))

{pypartmc-2.0.0rc5.dist-info → pypartmc-2.0.0rc7.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyPartMC
-Version: 2.0.0rc5
+Version: 2.0.0rc7
 Summary: Python interface to PartMC
 Author-Email: "https://github.com/open-atmos/PyPartMC/graphs/contributors" <nriemer@illinois.edu>
 License-Expression: GPL-3.0
@@ -117,6 +117,11 @@ pip install PyPartMC[examples]
 [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/open-atmos/PyPartMC/blob/main/examples/cloud_parcel.ipynb)
 [![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/open-atmos/PyPartMC.git/main?urlpath=lab/tree/examples/cloud_parcel.ipynb)
 [![ARM JupyterHub](https://img.shields.io/static/v1?label=launch%20in&logo=jupyter&color=lightblue&message=ARM+JupyterHub)](https://jupyterhub.arm.gov/hub/user-redirect/git-pull?repo=https%3A//github.com/open-atmos/PyPartMC&branch=main&urlPath=)
+- Immersion freezing example:   
+[![View notebook](https://img.shields.io/static/v1?label=render%20on&logo=github&color=87ce3e&message=GitHub)](https://github.com/open-atmos/PyPartMC/blob/main/examples/immersion_freezing.ipynb)
+[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/open-atmos/PyPartMC/blob/main/examples/immersion_freezing.ipynb)
+[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/open-atmos/PyPartMC.git/main?urlpath=lab/tree/examples/immersion_freezing.ipynb)
+[![ARM JupyterHub](https://img.shields.io/static/v1?label=launch%20in&logo=jupyter&color=lightblue&message=ARM+JupyterHub)](https://jupyterhub.arm.gov/hub/user-redirect/git-pull?repo=https%3A//github.com/open-atmos/PyPartMC&branch=main&urlPath=)
 - Coagulation model intercomparison for additive (Golovin) kernel with: PyPartMC, [PySDM](https://open-atmos.github.io/PySDM), [Droplets.jl](https://github.com/emmacware/droplets.jl) and [dustpy](https://stammler.github.io/dustpy/):    
 [![View notebook](https://img.shields.io/static/v1?label=render%20on&logo=github&color=87ce3e&message=GitHub)](https://github.com/open-atmos/PyPartMC/blob/main/examples/additive_coag_comparison.ipynb) 
 [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/open-atmos/PyPartMC/blob/main/examples/additive_coag_comparison.ipynb) 
@@ -159,9 +164,9 @@ import PyPartMC as ppmc
 from PyPartMC import si
 
 aero_data = ppmc.AeroData((
-    #      [density, ions in solution, molecular weight, kappa]
-    {"OC": [1000 *si.kg/si.m**3, 0, 1e-3 *si.kg/si.mol, 0.001]},
-    {"BC": [1800 *si.kg/si.m**3, 0, 1e-3 *si.kg/si.mol, 0]},
+    #      [density, ions in solution, molecular weight, kappa, abifm_m, abifm_c]
+    {"OC": [1000 *si.kg/si.m**3, 0, 1e-3 *si.kg/si.mol, 0.001, 0, 0]},
+    {"BC": [1800 *si.kg/si.m**3, 0, 1e-3 *si.kg/si.mol, 0, 0 , 0]},
 ))
 
 aero_dist = ppmc.AeroDist(
@@ -202,9 +207,9 @@ ppmc = pyimport("PyPartMC")
 si = ppmc["si"]
 
 aero_data = ppmc.AeroData((
-  #       (density, ions in solution, molecular weight, kappa)
-  Dict("OC"=>(1000 * si.kg/si.m^3, 0, 1e-3 * si.kg/si.mol, 0.001)),
-  Dict("BC"=>(1800 * si.kg/si.m^3, 0, 1e-3 * si.kg/si.mol, 0))
+  #       (density, ions in solution, molecular weight, kappa, abifm_m, abifm_c)
+  Dict("OC"=>(1000 * si.kg/si.m^3, 0, 1e-3 * si.kg/si.mol, 0.001, 0, 0)),
+  Dict("BC"=>(1800 * si.kg/si.m^3, 0, 1e-3 * si.kg/si.mol, 0, 0, 0))
 ))
 
 aero_dist = ppmc.AeroDist(aero_data, (
@@ -245,8 +250,8 @@ ppmc = py.importlib.import_module('PyPartMC');
 si = py.importlib.import_module('PyPartMC').si;
 
 aero_data = ppmc.AeroData(py.tuple({ ...
-  py.dict(pyargs("OC", py.tuple({1000 * si.kg/si.m^3, 0, 1e-3 * si.kg/si.mol, 0.001}))), ...
-  py.dict(pyargs("BC", py.tuple({1800 * si.kg/si.m^3, 0, 1e-3 * si.kg/si.mol, 0}))) ...
+  py.dict(pyargs("OC", py.tuple({1000 * si.kg/si.m^3, 0, 1e-3 * si.kg/si.mol, 0.001, 0, 0}))), ...
+  py.dict(pyargs("BC", py.tuple({1800 * si.kg/si.m^3, 0, 1e-3 * si.kg/si.mol, 0, 0, 0}))) ...
 }));
 
 aero_dist = ppmc.AeroDist(aero_data, py.tuple({ ...
@@ -288,7 +293,7 @@ PyPartMC is used within the [test workflow of the PySDM project](https://github.
 ## Other packages with relevant feature scope
 
 - [aerosolGDEFoam](https://openaerosol.sourceforge.io/): OpenFOAM CFD-coupled aerosol dynamics including nucleation, coagulation, and surface growth 
-- [AIOMFAC and AIOMFAC-web](http://www.aiomfac.caltech.edu/): Fortran-implemented aerosol thermodynamic model for calculation of activity coefficients in organic-inorganic mixtures – from simple binary solutions to complex multicomponent systems
+- [AIOMFAC and AIOMFAC-web](http://web.archive.org/web/20250730204937/https://www.aiomfac.caltech.edu/): Fortran-implemented aerosol thermodynamic model for calculation of activity coefficients in organic-inorganic mixtures – from simple binary solutions to complex multicomponent systems
 - [DustPy](https://stammler.github.io/dustpy/): Python package for modelling dust evolution in protoplanetary disks (differences: focus on astrophysical applications vs. atmospheric aerosol)
 - [multilayerpy](https://github.com/tintin554/multilayerpy): kinetic multi-layer model for aerosol particles and films 
 - [PyBox](https://pybox.readthedocs.io): aerosol simulation model featuring gas and particle chamistry (differences: PyBox focuses on chemical mechanisms; PyPartMC is an interface to PartMC which focuses on physics - e.g., collisions of aerosol particles - while chemical processes are handled with external software, e.g., CAMP or MOSAIC)

pypartmc-2.0.0rc7.dist-info/RECORD

@@ -0,0 +1,9 @@
+PyPartMC/__init__.py,sha256=iVz2ccwCEvjPu70_Uv0IKVC_fqYO248vWLunJ75ovok,3438
+PyPartMC/_PyPartMC.abi3.so,sha256=PsBwYsKi3C5698XZPkGsVT-k4ylsmJEFdRkS18ssD8w,8520752
+PyPartMC/.dylibs/libgfortran.5.dylib,sha256=EQdwib-rcZOmroTT5xKULVdXgX_ox4ctFfc3ncRyVOQ,3988672
+PyPartMC/.dylibs/libquadmath.0.dylib,sha256=Ljr4W0s6meK2zWD_sBfgU8kBF2YSgGkZraoYwQ4QH1k,379200
+PyPartMC/.dylibs/libgcc_s.1.1.dylib,sha256=0FfRvoVbRmONLhY4IEsrMK9Mcargq5EQycdrN0f_hEc,266112
+pypartmc-2.0.0rc7.dist-info/RECORD,,
+pypartmc-2.0.0rc7.dist-info/WHEEL,sha256=tD0eQtOb7VxpRfRxijLoH4fSOOJJQtqT7I2fSx0WLOs,142
+pypartmc-2.0.0rc7.dist-info/METADATA,sha256=ErzEX0DE_uDb_XCEtzweGtRu6MqUHQYcXhzKKJRYIo0,28527
+pypartmc-2.0.0rc7.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149

pypartmc-2.0.0rc5.dist-info/RECORD

@@ -1,9 +0,0 @@
-pypartmc-2.0.0rc5.dist-info/RECORD,,
-pypartmc-2.0.0rc5.dist-info/WHEEL,sha256=tD0eQtOb7VxpRfRxijLoH4fSOOJJQtqT7I2fSx0WLOs,142
-pypartmc-2.0.0rc5.dist-info/METADATA,sha256=WqRG5fZFB_rJnWZIb9B8VDPFRCICI85dCIHTb3-g7Ac,27597
-pypartmc-2.0.0rc5.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-PyPartMC/__init__.py,sha256=e1ngb8Sodfqneb__Vmf_K5eIOoOY11gvrSHmlIZbruM,2349
-PyPartMC/_PyPartMC.abi3.so,sha256=zy--z2Dmir7sbUV1Sxg0eOFk5EJ7Xy9pRWf8Libsr9U,8485888
-PyPartMC/.dylibs/libgfortran.5.dylib,sha256=uZj18mk7PGjzH0FQclHZLMRAcsG4TETIRZt_8CGlEpg,3988672
-PyPartMC/.dylibs/libquadmath.0.dylib,sha256=19PcPx5n69p9h9xP2dOhLmhRI2hzljSQcJBXLyFC2go,379200
-PyPartMC/.dylibs/libgcc_s.1.1.dylib,sha256=mW61tfzTB6d8xKZxf5SR2V03z7kbDW950dagh_mLK_U,266112