PyMieSim 3.6.0__cp313-cp313-macosx_14_0_arm64.whl → 3.6.2__cp313-cp313-macosx_14_0_arm64.whl

PyMieSim/_version.py

@@ -17,5 +17,5 @@ __version__: str
 __version_tuple__: VERSION_TUPLE
 version_tuple: VERSION_TUPLE
 
-__version__ = version = '3.6.0'
-__version_tuple__ = version_tuple = (3, 6, 0)
+__version__ = version = '3.6.2'
+__version_tuple__ = version_tuple = (3, 6, 2)

PyMieSim/single/scatterer/base.py

@@ -126,6 +126,59 @@ class BaseScatterer(units.UnitsValidation):
         """
         return self._cpp_get_fields(phi=phi, theta=theta, r=r.to_base_units().magnitude)
 
+    def get_s1s2_array(self, phi: numpy.ndarray) -> Tuple[numpy.ndarray, numpy.ndarray]:
+        """Return the S1 and S2 scattering amplitudes for arbitrary ``phi`` angles.
+
+        Parameters
+        ----------
+        phi : numpy.ndarray
+            Array of azimuthal angles in **radians** for which the scattering
+            amplitudes are computed.
+
+        Returns
+        -------
+        Tuple[numpy.ndarray, numpy.ndarray]
+            Arrays of ``S1`` and ``S2`` values evaluated at the supplied angles.
+        """
+
+        phi = numpy.atleast_1d(phi)
+        return self._cpp_get_s1s2(phi=phi + numpy.pi / 2)
+
+    def get_stokes_array(
+        self,
+        phi: numpy.ndarray,
+        theta: numpy.ndarray,
+        r: units.Quantity = 1 * units.meter
+    ) -> Tuple[numpy.ndarray, numpy.ndarray, numpy.ndarray, numpy.ndarray]:
+        """Return the Stokes parameters for arbitrary ``phi`` and ``theta`` angles.
+
+        Parameters
+        ----------
+        phi : numpy.ndarray
+            Azimuthal angles in radians.
+        theta : numpy.ndarray
+            Polar angles in radians. Must be broadcastable with ``phi``.
+        r : units.Quantity, optional
+            Radial distance from the scatterer. Defaults to ``1 * meter``.
+
+        Returns
+        -------
+        Tuple[numpy.ndarray, numpy.ndarray, numpy.ndarray, numpy.ndarray]
+            The ``I``, ``Q``, ``U`` and ``V`` Stokes parameters.
+        """
+
+        phi, theta = numpy.broadcast_arrays(phi, theta)
+
+        E_phi, E_theta = self.get_farfields_array(phi=phi, theta=theta, r=r)
+
+        intensity = numpy.abs(E_phi) ** 2 + numpy.abs(E_theta) ** 2
+        I = intensity / numpy.max(intensity)
+        Q = (numpy.abs(E_phi) ** 2 - numpy.abs(E_theta) ** 2) / intensity
+        U = (+2 * numpy.real(E_phi * E_theta.conjugate())) / intensity
+        V = (-2 * numpy.imag(E_phi * E_theta.conjugate())) / intensity
+
+        return I, Q, U, V
+
     def get_s1s2(self, sampling: int = 200, distance: units.Quantity = 1 * units.meter) -> S1S2:
         r"""
         Compute the S1 and S2 scattering amplitude functions for a spherical scatterer.

PyMieSim/units.py

@@ -12,7 +12,7 @@ BASE_UNITS = [
 ]
 
 # Define prefixes for scaling units
-SCALES = ['nano', 'micro', 'milli', '', 'kilo', 'mega']
+SCALES = ['nano', 'micro', 'milli', '', 'kilo', 'mega', 'giga', 'tera']
 
 
 def initialize_registry(ureg: Optional[object] = None):

{pymiesim-3.6.0.dist-info → pymiesim-3.6.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: PyMieSim
-Version: 3.6.0
+Version: 3.6.2
 Summary: A package for light scattering computation.
 Keywords: mie,scattering,backscatter,sphere,cylinder,nanoparticle,phase function,efficiency,rayleigh,backscattering
 Author-Email: Martin Poinsinet de Sivry-Houle <martin.poinsinet.de.sivry@gmail.com>
@@ -193,7 +193,7 @@ If you use PyMieSim in academic work, please cite:
 
 Contact
 -------
-For questions or contributions, contact `martin.poinsinet.de.sivry@gmail.ca <mailto:martin.poinsinet.de.sivry@gmail.ca>`_.
+For questions or contributions, contact `martin.poinsinet.de.sivry@gmail.com <mailto:martin.poinsinet.de.sivry@gmail.com>`_.
 
 .. |logo| image:: https://github.com/MartinPdeS/PyMieSim/raw/master/docs/images/logo.png
     :alt: PyOptik logo

{pymiesim-3.6.0.dist-info → pymiesim-3.6.2.dist-info}/RECORD

@@ -1,5 +1,9 @@
-PyMieSim/units.py,sha256=L7Trn8rW5d5AQK1_8I-XwaHGswXklupXs5wHgWQtJNQ,4224
-PyMieSim/_version.py,sha256=eic-6Xs9-9wocSdGZ3Qt8lkpGHJbspTaUymbZDQfBkA,511
+pymiesim-3.6.2.dist-info/RECORD,,
+pymiesim-3.6.2.dist-info/WHEEL,sha256=_wdnp6N2S4se9FSmG8Grxw-01KRCMKjjAi2kFwM0M4I,114
+pymiesim-3.6.2.dist-info/METADATA,sha256=yoziIyxY_OA6060JK0Mg1wOMjUdiAZ3dL6VRI73wYLk,9532
+pymiesim-3.6.2.dist-info/licenses/LICENSE,sha256=-QSWDJghhVqbAzChmEK86liqPX_eeQFgdwlrKTLLcIA,1088
+PyMieSim/units.py,sha256=v8fSnzYU6B7qEqkhFj5P2QofFV-qHJ3I1bTixgnG1fM,4240
+PyMieSim/_version.py,sha256=NBUzwa2zr8t3-TKaVeP0ZYSkB9sd6Z52RcDA5GmYxv8,511
 PyMieSim/directories.py,sha256=ohe9qvjwN0IJ7OpZHsD7LxKYGMLr4CC7xYUGgWgw-Rg,648
 PyMieSim/__init__.py,sha256=ZRdkOFRqjkVCq0qQs4DHIFnAgkdtBr19gZaq1k6bzxw,453
 PyMieSim/mesh.py,sha256=WcX_rXpWxH7WDniIqaG4rPC-pfDm4AG9ZAX-zI8GbhU,14566
@@ -14,7 +18,7 @@ PyMieSim/single/source/base.py,sha256=HKqsEVw7caNV7ev8OVNPi3zMHc4cgGuhH9s2XcgvgB
 PyMieSim/single/source/gaussian.py,sha256=vVZ7UVkhlm2KvsTOf2uVcm9rjgXISSs7sv798m9otp4,4849
 PyMieSim/single/scatterer/__init__.py,sha256=2a9o-VHfqGloCEEbfIGSjLIIzWssRCt9W72AYvU2nSg,124
 PyMieSim/single/scatterer/core_shell.py,sha256=fqhu2PooEUDo7Vnotio7_iz2stozC5i5XczP8vdOKMs,5074
-PyMieSim/single/scatterer/base.py,sha256=CVVI8_nSgoF_BkEN0Fb_A61YHgMnKfOiKaKbe60NsD8,19701
+PyMieSim/single/scatterer/base.py,sha256=0VKnDBvStQAXO4s4A1N2IJ76wTwSV23Fjd8PQ3Di9Fo,21624
 PyMieSim/single/scatterer/sphere.py,sha256=NVBP9iUX0pAPWdi13xbMzgLfllDPCgvF5BuJuWfUUec,3847
 PyMieSim/single/scatterer/cylinder.py,sha256=GNABjAb2csnWxANlIdJW7PhuuewJHMVAlzNmlfnz7eU,4062
 PyMieSim/single/detector/uncoherent.py,sha256=DOqf5hU5ghEhj8IooC5uJX6pjMwNBveIr-FzcWkgTLk,4848
@@ -68,39 +72,35 @@ PyMieSim/experiment/detector/__init__.py,sha256=pvtXHKR2pM7JOeTTcouKipeQwi0e8dZi
 PyMieSim/experiment/detector/base.py,sha256=j2yY_InLQDAPgDkM19ILlIEF-2koGMKRe9Hc-nFpyGc,7340
 PyMieSim/binary/interface_source.cpython-312-darwin.so,sha256=CQ8wPJrzmwAW9nnbhMUQD4KIpSSCuWP7kXfHDAoqBqY,240624
 PyMieSim/binary/interface_detector.cpython-313-darwin.so,sha256=_J_R1Z8lu8dfS0zLtzU7m1dOKISoApLKjPo5GoFwXlA,492592
-PyMieSim/binary/interface_experiment.cpython-311-darwin.so,sha256=j-bh2Ec8tOKyVRCQwgYr5L5Xi4LWUJUFamhlT7N5vf4,491584
-PyMieSim/binary/interface_sets.cpython-312-darwin.so,sha256=OvqbheIrBafqIkepmA92exYqyQh_LvYngm7InIJ3M5s,595968
-PyMieSim/binary/interface_scatterer.cpython-312-darwin.so,sha256=YskPBQa5MBPGHkxIRZ5pQ_m3_5YMQKixbn97JIxMePA,576512
-PyMieSim/binary/libcpp_coordinates.a,sha256=JF0rPWiu7e4IvItQgWMAZ1s-8uYHsJI2vTc76yHcdxo,22432
+PyMieSim/binary/interface_experiment.cpython-311-darwin.so,sha256=GFJkP7rOWysGz9Z5FG97aHw3lJXp4BDka-MPCHh0Pes,491584
+PyMieSim/binary/interface_sets.cpython-312-darwin.so,sha256=MVTlQVa14WgkaL1xp_oeyXDv4tXNH6jn-oaTomKCwnM,596304
+PyMieSim/binary/interface_scatterer.cpython-312-darwin.so,sha256=04kfUnjl47JaG_Al9gEoEpv4H7DPGREwv0-IG_w-uvY,576800
+PyMieSim/binary/libcpp_coordinates.a,sha256=gm4ED1_wv54-75kAILdMIddCOmer9hBR-8nF-uA3I3c,22432
 PyMieSim/binary/interface_source.cpython-313-darwin.so,sha256=fIG-_MNdIlDlA01hhBWpUNxCKOTTK66yhHiIiU2IQ1U,240864
 PyMieSim/binary/interface_detector.cpython-312-darwin.so,sha256=zb-Fd5xUJ8boMJ-hrYYj-HmwaURdymcSfs00GBtTSlY,492336
-PyMieSim/binary/libcpp_source.a,sha256=eCtn6C7ikdkcVKHYMjA5fbjZvErko1JiyUGjRv6PU4U,6720
-PyMieSim/binary/interface_experiment.cpython-310-darwin.so,sha256=4fBEUHQlYLuesrGM45q23MiGDHJ2SC6D6OyuFhS1kT8,474976
-PyMieSim/binary/interface_sets.cpython-313-darwin.so,sha256=khK4bZiYVH795MWaDKlHSLgNHqegeOC_w6O9f-NLB2E,596256
-PyMieSim/binary/interface_scatterer.cpython-313-darwin.so,sha256=xgx7mGN20uy_u4WGOHyXZRLnrQORe17o0k3vdlHwn9c,576752
+PyMieSim/binary/libcpp_source.a,sha256=K58kzkefPfqKvesoUupATJul4cskxrHwK6C-YS3j8Vg,6720
+PyMieSim/binary/interface_experiment.cpython-310-darwin.so,sha256=YvN2RCpQBfmSl6Z4CbvbW3JaFCme0mXgy_A6Jr5z-eY,474976
+PyMieSim/binary/interface_sets.cpython-313-darwin.so,sha256=_kO_8U3GZBvVBIVvsBpKrwzwEnRgtIqRSdKR4EsTDSU,596544
+PyMieSim/binary/interface_scatterer.cpython-313-darwin.so,sha256=_jLjC5qd6Jp6cTTeHwVJJxDpBxUtMEm6IBphB4uV_kg,577040
 PyMieSim/binary/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 PyMieSim/binary/interface_detector.cpython-311-darwin.so,sha256=lh_RCWgRN4R1wKI3q-tWLtC_8666eV09V3H0qafR0q8,492336
 PyMieSim/binary/interface_source.cpython-310-darwin.so,sha256=WKhrAqfJWndYN1ACTmjnD7W4qHu0OPZiE4kK7Zu-de0,240624
-PyMieSim/binary/libcpp_fibonacci.a,sha256=JV1VxGz_S_jn4S-ov6oDJ3eaw7AXVISG1HxSaXhr2p8,14160
-PyMieSim/binary/interface_sets.cpython-310-darwin.so,sha256=67faOdm74RVKsEq-bRptcZTtagRfYbSdRkAW9njxtJ0,579360
-PyMieSim/binary/libcpp_experiment.a,sha256=A8LnPFH62-Xy48vb-WWDaT7FgfGqhRV1gJcCeWtGYoY,172960
-PyMieSim/binary/interface_experiment.cpython-313-darwin.so,sha256=p_N_r_jKmN1_wKuumGD25cIFXQh6rXZZGQ15aHjB_cg,491824
-PyMieSim/binary/libcpp_mode_field.a,sha256=1JYKKeZ6sCW-07MdudTk3hldvvGPT3Nzwx2Y8Xna6SM,10960
-PyMieSim/binary/interface_scatterer.cpython-310-darwin.so,sha256=UdqKQyH0KUkGlW1PIz891BnfDiUQ08QqHRDcDQda4MI,559936
+PyMieSim/binary/libcpp_fibonacci.a,sha256=yuhaAzJZph4jKSndN46r3IwP4X0Qe8o0ycrjXnPHWbE,14160
+PyMieSim/binary/interface_sets.cpython-310-darwin.so,sha256=Visa5KodgbNq4SpOAZ5JD5eRz7Q1FZgXqNGyG1pEwSQ,579632
+PyMieSim/binary/libcpp_experiment.a,sha256=mYuFXPM5Y43eNmcCH1B-fXtunQdxx36a5fLfj8c1FaQ,172960
+PyMieSim/binary/interface_experiment.cpython-313-darwin.so,sha256=OTbaf5_Dr-5Z-8aY4UcXNm9q-D6S0ekI05fhIa_wt-E,491824
+PyMieSim/binary/libcpp_mode_field.a,sha256=M62RDFL14y7t0pTjqzvbb5I3n16t3lxA881jDEA_YsE,10960
+PyMieSim/binary/interface_scatterer.cpython-310-darwin.so,sha256=9jv04bzud0oVFQ0NsGN15s9kMrrzWAjTpI9blkNunJ8,560224
 PyMieSim/binary/interface_detector.cpython-310-darwin.so,sha256=Cm8QqjfgCodblQQfRTFgh9kTxYMmS-D55E_w7ND4N9o,475776
 PyMieSim/binary/interface_source.cpython-311-darwin.so,sha256=8ZwlKEMALhwE8u7vvSH_LlEpimsPcQtB8BnubLyKW0M,240624
-PyMieSim/binary/interface_sets.cpython-311-darwin.so,sha256=4rRbWfSR1jQ1cF328qHIfYZN1em6sJMr3pbGw9wHALo,579440
-PyMieSim/binary/interface_experiment.cpython-312-darwin.so,sha256=suJQTGXWhS5aJb9xYpQQi23CY3vrVqmiLUTbp0867kE,491584
-PyMieSim/binary/libcpp_sets.a,sha256=2rL9-8odQvPPPVgGUHqd_GNWoMug8RNfoaJQnQ6Ut9o,172952
-PyMieSim/binary/interface_scatterer.cpython-311-darwin.so,sha256=W9qVZz9zvi4cRU_GgqMMQnxsx6KhKQ5cx3IaUxynYI8,576512
-PyMieSim/binary/libcpp_detector.a,sha256=w7m6xRYURit3o8XwvlkHzC6SapbE2ABewVFBWlosLwI,200264
-pymiesim-3.6.0.dist-info/RECORD,,
-pymiesim-3.6.0.dist-info/WHEEL,sha256=_wdnp6N2S4se9FSmG8Grxw-01KRCMKjjAi2kFwM0M4I,114
-pymiesim-3.6.0.dist-info/METADATA,sha256=NLH1cmL-XPL5EVHrCZuT_ZTIbYMT-jqEMJlNV92L1PQ,9530
-pymiesim-3.6.0.dist-info/licenses/LICENSE,sha256=-QSWDJghhVqbAzChmEK86liqPX_eeQFgdwlrKTLLcIA,1088
-lib/libcpp_cylinder.a,sha256=D1mbpyUi7ZBzDRkTYhFgNUxGWGRxiCnU9pFW3lC0aj8,187992
-lib/libcpp_sphere.a,sha256=8-x7Wcupbo6FYIKKCW_MnUXjBcefKJj2LtpkXD-s6vM,196984
-lib/libZBessel.a,sha256=rmEdAOjcB6LZ_55VI2OYc65c77Qq_1ACbI0Ff-Pfjlw,106200
-lib/lib_ZBessel.a,sha256=Mz8WmHrnFGKmImtue_1xjpbzJhgM7PSxlt26r6PQYU8,9840
-lib/libcpp_coreshell.a,sha256=uy4HmHTRWHnR4h0a9Vbb1tORgqOYUSNCPHXvS1_r68U,196296
-lib/libcpp_base_scatterer.a,sha256=9hVprMKB3BKaEJOAcbUfKw1vdgOaB6EQ-aCu2Qa7lMM,197136
+PyMieSim/binary/interface_sets.cpython-311-darwin.so,sha256=LkDJ3m4atitgTZFnorzql4C0sISSSZ8FVyEMJIDAfw0,579776
+PyMieSim/binary/interface_experiment.cpython-312-darwin.so,sha256=rliIkpNrvIRf2ZwyDITw4XLYBzRZ8Spa_h5JEdgyy-Q,491584
+PyMieSim/binary/libcpp_sets.a,sha256=Ny3ew74gPQ52SdvWkb1IqlFs1gRm5SvDbd7W14GYLU4,172952
+PyMieSim/binary/interface_scatterer.cpython-311-darwin.so,sha256=L74jfmT-dNnZzxdoTxvdLlxALfKS5e_4A0NCYeyv7Es,576800
+PyMieSim/binary/libcpp_detector.a,sha256=a79qarKO9CYDoefAU8K70ypq-j1sXWricwUQN6r1D5k,200264
+lib/libcpp_cylinder.a,sha256=S7JAm5HxbJTrVXcrbpI-YXJsUl8bDjm4Q92pUpUnySU,188440
+lib/libcpp_sphere.a,sha256=b06MsiTFyPbAS48hM85mvU7iLN7k07d56BPBuvJz5nw,197848
+lib/libZBessel.a,sha256=ncJ_uqMWTWbft8oHBfes0KHx8RIjmqLo41Pm_NA68SI,106200
+lib/lib_ZBessel.a,sha256=nTDc2NCv0c_vJqwHHxhH7iFeGH1wOmL4X0899Nj8vLg,9840
+lib/libcpp_coreshell.a,sha256=BzV_fYSPyV4xwTa5NPvZFZsMo7_ikB3qM_L6f0nXlyg,197208
+lib/libcpp_base_scatterer.a,sha256=s8N3EhedGT96TSmxVzU86Qr1mb5Ia0ZnL-33WRxpE04,197136