PyMieSim 3.6.0__cp312-cp312-win_amd64.whl → 3.6.2__cp312-cp312-win_amd64.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,35 +1,35 @@
-lib/lib_ZBessel.a,sha256=lhYaerokx2kdkTutNNr__qIusysYCM-iIvzfzLAWRPs,10676
-lib/libcpp_base_scatterer.a,sha256=anFZqjy8kn8EdySIUyCGskmsTS3O5dmVrYwuGpmjRBY,303484
-lib/libcpp_coreshell.a,sha256=JTGOny2JKvlgMmmenEy2WZlJ5oENLEm1fMBe8oqKyzs,308164
-lib/libcpp_cylinder.a,sha256=CmPah5knxTguWioDabo0uedxkZ01Z8GnuBa_QX650k0,288398
-lib/libcpp_sphere.a,sha256=H6CfBPigGx1a84vglySe_8OjgPLd6hTaBDTd_w4nmNA,302250
-lib/libZBessel.a,sha256=7Q7WDXvRSIDGhVgYxEDQy6rvqy2n0alSp435fOTTh6U,133174
+lib/lib_ZBessel.a,sha256=kdvp2qpd9F1hOpucDF1KEVHa38MjdMKwC7qKoaaCXU8,10676
+lib/libcpp_base_scatterer.a,sha256=cKEYs8b41kjB8fhgpWTiMtLgTjvPfQfp9HWK0x4jV3U,303484
+lib/libcpp_coreshell.a,sha256=fAU45zG9MQ0g0HJuDWLjLErGzb7KKuQQVYpSXOSkYgM,309678
+lib/libcpp_cylinder.a,sha256=SosN7Z9vI26y6QGYinsZxLoV0IDgkD2jOCT7WPdEEOQ,289236
+lib/libcpp_sphere.a,sha256=khPsyEhL-YQmiqy8m9I5HkMHZijK2NicCcKvsQLLhqA,303586
+lib/libZBessel.a,sha256=ZMJJT0xvrRQ6EFqccvW_e7jXsLjuubEV7LHd5W96EoE,133174
 PyMieSim/__init__.py,sha256=3j_1gIfkkQdu6oflAVAot2mZPJO_yz5MVfhDNxjY6-s,469
 PyMieSim/__main__.py,sha256=oGbu6nM6nxHbA1DRvpiG6loI-mkVCuVCJJPnN5pAmgQ,246
-PyMieSim/_version.py,sha256=gjaLAkUsBET1sUPJb8F_jnhiFLEWqCIkrz1Y419AaLk,532
+PyMieSim/_version.py,sha256=Qz9CqjlG8W4W7QvXKDmXF77HDvedQAZC6IpghRWu7Io,532
 PyMieSim/binary/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-PyMieSim/binary/interface_detector.cp310-win_amd64.pyd,sha256=QkDGVeeDytSzLgFxJh42Ldoc88hTwm-vzN1QhK9MSPA,797184
-PyMieSim/binary/interface_detector.cp311-win_amd64.pyd,sha256=0IhoeFFjH1oFUzZiCnosIJP45lkWJ0uuw51FuOQsFY8,801792
-PyMieSim/binary/interface_detector.cp312-win_amd64.pyd,sha256=WhkFKidZOmAx6eo1ksVGsNwitAkQ99T2xvoOt2Lf0EA,806400
-PyMieSim/binary/interface_experiment.cp310-win_amd64.pyd,sha256=8wUhVq2kMpUh2zxqbN3pSKjr4q6Hg4q9J5cF0_ZbGOE,820736
-PyMieSim/binary/interface_experiment.cp311-win_amd64.pyd,sha256=XqlUixiWb1cLRU3GjTJF5B40ZN3-KW6BnmmvUN-SCbg,824320
-PyMieSim/binary/interface_experiment.cp312-win_amd64.pyd,sha256=EhHdYrNJOTssmrtmMOR0xXp3bHDyIEJkQk1DRWCG6JE,826368
-PyMieSim/binary/interface_scatterer.cp310-win_amd64.pyd,sha256=Grk5L_jwnWfbhU4dOxopDUxpXi01IpLqJgt4CrFkhuU,1203712
-PyMieSim/binary/interface_scatterer.cp311-win_amd64.pyd,sha256=7LPEfHpOQNQ939uaO19gGgDCbrhNsDxuE31c0qDl_LQ,1208320
-PyMieSim/binary/interface_scatterer.cp312-win_amd64.pyd,sha256=3VMMTLiTgOJCNFxWI9i5U2aQo4r2UiID3dcSZiEUzLw,1209856
-PyMieSim/binary/interface_sets.cp310-win_amd64.pyd,sha256=LSrsf6Jp4IYO0owKTqoo11xVdniLEE0qkJbEe-CUBHg,1216512
-PyMieSim/binary/interface_sets.cp311-win_amd64.pyd,sha256=7Sy_RPgFEf6lllEAAfIWxTUoBOn0v4CCG9QbXtoPucU,1220608
-PyMieSim/binary/interface_sets.cp312-win_amd64.pyd,sha256=LU2R3g3SA0Sis997dBpZh6D-4UBjFJ_vt8gZJXl0Us8,1221120
-PyMieSim/binary/interface_source.cp310-win_amd64.pyd,sha256=WZAYfn_QYXHwZlWkmvwCoU5nfuTcC8BWhMMfnxX69hw,552448
-PyMieSim/binary/interface_source.cp311-win_amd64.pyd,sha256=QAc8K_8doOEVypcDI1ToT6bB4KKqfsWAUynEhLuDyIA,556032
-PyMieSim/binary/interface_source.cp312-win_amd64.pyd,sha256=EF--Fkbn1yBS9pw35UNIvntCHnmlCyyITtiohKrMZPg,558080
-PyMieSim/binary/libcpp_coordinates.a,sha256=xGukc_Peov15ZoIyp6bXHjmMbRZ1a83eqlgNVW7c15U,23506
-PyMieSim/binary/libcpp_detector.a,sha256=uO_dRRjnvWOqHXRqldDmXNC-j429ErReeZkTlPgdbHU,310066
-PyMieSim/binary/libcpp_experiment.a,sha256=07DhSquV4fKmbGhPbV6rfdZvqtCq1PMy-iHFOA1kh9M,267740
-PyMieSim/binary/libcpp_fibonacci.a,sha256=wNBkUlPVfsO7kEHomRb5eaQBWF9D2hJsvyvHL9ttQnk,16808
-PyMieSim/binary/libcpp_mode_field.a,sha256=UgFwhxzLXdJVxjnJOd71BikaVugohet2qwdzykLJvk4,13388
-PyMieSim/binary/libcpp_sets.a,sha256=d0C6t3RlPA3ajfeZNoaDiz25TmWh_Xzkr4n4zgfi1y8,267654
-PyMieSim/binary/libcpp_source.a,sha256=do_gEVy5pt1R2AdRWq-MlkxannxlBVR7PR7VgWVC1h8,4070
+PyMieSim/binary/interface_detector.cp310-win_amd64.pyd,sha256=eRW0UB3LpzMNC2evq1Od8JujemDOFEt1CkluSiSEn8s,797184
+PyMieSim/binary/interface_detector.cp311-win_amd64.pyd,sha256=deDS3xT1x1fY5-BzYcBFo6ZBRr2aercmP5FHJMMeEvA,801792
+PyMieSim/binary/interface_detector.cp312-win_amd64.pyd,sha256=u6Ih48W_m0Yy-GvdiS5Foz0RkLb-uS2jVjfKhFbRWi8,806400
+PyMieSim/binary/interface_experiment.cp310-win_amd64.pyd,sha256=lPfiII7oFkfdv-7fs-_v2QhJy8IJxKO3mKBaMYWQtAA,820224
+PyMieSim/binary/interface_experiment.cp311-win_amd64.pyd,sha256=M2OkiL3n0TxVFNW-ZiYlmE2Bb-7277XvmDtFyaS9_-8,824832
+PyMieSim/binary/interface_experiment.cp312-win_amd64.pyd,sha256=GDhf-xSrAUomBIR-YYG9cIKpn081Kpbd5jNnGpQFvWg,825856
+PyMieSim/binary/interface_scatterer.cp310-win_amd64.pyd,sha256=c_JNztttOORzZ3or-WXmGMs9dcfHPso60DyD-Ox_epQ,1203712
+PyMieSim/binary/interface_scatterer.cp311-win_amd64.pyd,sha256=NXfrBtJXfW_NEAVF3pP9rnQjTUZhw1gwHC3gJM2WZ1o,1208320
+PyMieSim/binary/interface_scatterer.cp312-win_amd64.pyd,sha256=LBC1F8rGuhHgKCTRBps4LdH_sQWPFwWWs-7GlKaHbcM,1209856
+PyMieSim/binary/interface_sets.cp310-win_amd64.pyd,sha256=kzioC9R253Vr_vHs7IwvGu1rwpHzUJbB97Sy2FtWchk,1217024
+PyMieSim/binary/interface_sets.cp311-win_amd64.pyd,sha256=RnZmUuVtP835gUtzZqwjmmAoxNQ6vF7oKHN3-xUZ-xs,1221120
+PyMieSim/binary/interface_sets.cp312-win_amd64.pyd,sha256=4A_GocuJIyJwpCkWAU5HjLnXKAip0j06DlbguPXYl9w,1221632
+PyMieSim/binary/interface_source.cp310-win_amd64.pyd,sha256=mcXuJhDtVXpx2noaawZCGffbWcO4WopIWAMMEuwK2zE,552448
+PyMieSim/binary/interface_source.cp311-win_amd64.pyd,sha256=YpTbYyEU4DLRMiRIpRM9Ij0WRT6Jm6o0m7uSbdA1WhY,556032
+PyMieSim/binary/interface_source.cp312-win_amd64.pyd,sha256=xXNi_eqJ8uBlG5LCKbcdTV1VziyRv0dELf3YKbFudq0,558080
+PyMieSim/binary/libcpp_coordinates.a,sha256=da4kK74RmjaElT1CGf_mLlJFtHwk9kZ5bNLSTx0KmqA,23506
+PyMieSim/binary/libcpp_detector.a,sha256=i63SQOqTjwQCNlaB86OqpGk_PFchw6NbON5Q21rKDo4,310066
+PyMieSim/binary/libcpp_experiment.a,sha256=pl74iHnrtfoINxgxpD4F_dEooxR7QxSgBeXSDPge-K0,267740
+PyMieSim/binary/libcpp_fibonacci.a,sha256=BsjJsPgT8ixU3YU8hcADoSTbb73gkCsqEgpEQcO4dRo,16808
+PyMieSim/binary/libcpp_mode_field.a,sha256=yiZlXptOK3Z5wH3Jk9MlklUzz2VhUKvJMg_pfrZj1Sk,13388
+PyMieSim/binary/libcpp_sets.a,sha256=Gv6eNrbU64mladge1R-oAgLmSHeNEfgyQeg0c5ADIk4,267654
+PyMieSim/binary/libcpp_source.a,sha256=MsUButV7dvnL1spUzA3DvDQNBbyL4OCKhAKSOlJlHAk,4070
 PyMieSim/directories.py,sha256=x8nf0HACHDuny0YQ3sPnktY8aCKOA1RDvbDTSrerGN0,679
 PyMieSim/experiment/__init__.py,sha256=3W7RgRQ2wspQyhAsUUfd5oYx199lQbYv90Lf0A5Ypf4,46
 PyMieSim/experiment/dataframe_subclass.py,sha256=WVVbvLmdPaqgFU48f8Ua0-WOlNj-CDpK_tFNCDC5ixU,7394
@@ -61,7 +61,7 @@ PyMieSim/single/detector/coherent.py,sha256=tvJJG41iSFHbFbWg1FB_Frxu1k5s6V8OMZBF
 PyMieSim/single/detector/uncoherent.py,sha256=CKR_Iqcx2UjD8ospj9H4rMFNbbM_jLXZgL_PLj2BGWw,4953
 PyMieSim/single/representations.py,sha256=vOznCZL-8KrErz-4m4-9w7g433rmUCfVmWFObLONd_Q,29883
 PyMieSim/single/scatterer/__init__.py,sha256=CN5D1UTvtIWMrlYvN4YqA3_DAp0jOPlPKl8ZCKUUU-4,128
-PyMieSim/single/scatterer/base.py,sha256=bRNhLsvu9t8SVROdpnXnpklR_9UNKhw69YmBo6PIjG8,20106
+PyMieSim/single/scatterer/base.py,sha256=CZb22chjhjYLvHLP_RI2l5NuttBC67giDZdcGz2OTms,22082
 PyMieSim/single/scatterer/core_shell.py,sha256=YL8GBDv2t_IlSFNWu1PPy52ZBbddt8NUPpbwRqJ0EEg,5199
 PyMieSim/single/scatterer/cylinder.py,sha256=i_pLQ6AIRqgssqRrYWNVsahV5J6aywQGsK6WmyauVsY,4174
 PyMieSim/single/scatterer/sphere.py,sha256=ypzmZ3QssQxlK15kacr7AqLqWP_-_bWcel3ynv1UNSI,3955
@@ -70,7 +70,7 @@ PyMieSim/single/source/base.py,sha256=T7Wx-4JYsG7-OOuZAga7XrzQiYo1jzB2AHLWTxr71U
 PyMieSim/single/source/gaussian.py,sha256=LY7ShqlnpefXdHaEz5oQZBVhjxBQWcLhNjgGVzfOSxc,4986
 PyMieSim/single/source/planewave.py,sha256=Wr5vnege_0yyogG4oVDnJgGOnTfBcI0Delw61M_iTn8,3683
 PyMieSim/special_functions.py,sha256=klYnLr-fpKt8VlqWngWJMeexLxbP-3hezBXQF5gSGGI,2174
-PyMieSim/units.py,sha256=b6TscVsAkKOiJfqs28gRLI4z_0g1tMS9lzelO623OjQ,4353
+PyMieSim/units.py,sha256=Vuu13jNf-jlVoGsWgjN4sSIjx_ovgKrpEKVr1UEjyQU,4369
 PyMieSim/validation_data/bohren_huffman/figure_810.csv,sha256=a16WSB7y7_TuGcboXUINj7y-mX0mkG_Vo0CFtE-pfF8,10073
 PyMieSim/validation_data/bohren_huffman/figure_87.csv,sha256=6vf5uPxzYP7N1rD8GgQJxi4-Yme8Q3ycPpsavXlQQZY,40002
 PyMieSim/validation_data/bohren_huffman/figure_88.csv,sha256=c30NQRjxlPz6plBcuG3kMVdTYQ0sHmRXRnzS67gyFnQ,40002
@@ -90,7 +90,7 @@ PyMieSim/validation_data/pymiescatt/validation_Qsca_coreshell_1.csv,sha256=fW1pa
 PyMieSim/validation_data/pymiescatt/validation_Qsca_coreshell_2.csv,sha256=khOJo3N54CqvrG9sxpuvvv5mZlcF3awOk738WHLougI,10400
 PyMieSim/validation_data/pymiescatt/validation_Qsca_medium.csv,sha256=7PE_F3sLIKmKPhcoMUxeByZHw3lzDfc3TH9g9bh3Noo,20800
 PyMieSim/validation_data/pymiescatt/validation_sphere.csv,sha256=0VCbInLU-PcTMa8IOsGL9vBWYJ9tQ6FpMv3ApV8fQVY,143548
-pymiesim-3.6.0.dist-info/METADATA,sha256=NLH1cmL-XPL5EVHrCZuT_ZTIbYMT-jqEMJlNV92L1PQ,9530
-pymiesim-3.6.0.dist-info/WHEEL,sha256=TcMXEVBP2SQds4YZwJ6flDTTNRzCE5owNAganfIqM0g,106
-pymiesim-3.6.0.dist-info/licenses/LICENSE,sha256=Iiz1zBIAocPfqqVpPTakp8OKXY9K5j4bIRbgaXy2iAE,1109
-pymiesim-3.6.0.dist-info/RECORD,,
+pymiesim-3.6.2.dist-info/METADATA,sha256=yoziIyxY_OA6060JK0Mg1wOMjUdiAZ3dL6VRI73wYLk,9532
+pymiesim-3.6.2.dist-info/WHEEL,sha256=TcMXEVBP2SQds4YZwJ6flDTTNRzCE5owNAganfIqM0g,106
+pymiesim-3.6.2.dist-info/licenses/LICENSE,sha256=Iiz1zBIAocPfqqVpPTakp8OKXY9K5j4bIRbgaXy2iAE,1109
+pymiesim-3.6.2.dist-info/RECORD,,