exosim 2.2.3__tar.gz → 2.2.4__tar.gz

{exosim-2.2.3 → exosim-2.2.4}/CHANGELOG.rst

@@ -12,6 +12,20 @@ Unreleased changes live as fragments in ``changelog.d/`` and are merged here by
 
 .. scriv-insert-here
 
+.. _changelog-2.2.4:
+
+[2.2.4_] - Rescale sources API
+==============================
+
+Added
+-----
+
+- ``Channel.rescale_sources()`` and ``Channel.rescale_radiances()``: the two
+  halves of ``Channel.rescale_contributions()``, which now calls both and
+  behaves as before. A pipeline that propagates the sources a second time
+  (for example after ``define_sources``) can rescale only the sources, without
+  multiplying the path radiances by the wavelength step again.
+
 .. _changelog-2.2.3:
 
 [2.2.3_] - Elliptical aperture area
@@ -304,5 +318,7 @@ Cleaned repository
 
 .. _2.2.3: https://github.com/arielmission-space/ExoSim2.0/releases/tag/v2.2.3
 
+.. _2.2.4: https://github.com/arielmission-space/ExoSim2.0/releases/tag/v2.2.4
+
 .. _keepachangelog: https://keepachangelog.com/en/1.0.0/
 .. _semver: https://semver.org/spec/v2.0.0.html

{exosim-2.2.3 → exosim-2.2.4}/CITATION.cff

@@ -18,5 +18,5 @@ authors:
 
 title: "ExoSim 2: the new exoplanet observation simulator applied to the Ariel space mission"
 doi: 10.1007/s10686-024-09976-2
-version: 2.2.3
+version: 2.2.4
 date-released: 2026-11-13

{exosim-2.2.3 → exosim-2.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: exosim
-Version: 2.2.3
+Version: 2.2.4
 Summary: ExoSim 2 is the next generation of the Exoplanet Observation Simulator (ExoSim) tailored for spectro-photometric observations of transiting exoplanets from space, ground, and sub-orbital platforms. This software is a complete rewrite implemented in Python 3, embracing object-oriented design principles.
 Author: E. Pascale, A. Bocchieri, A. Lorenzani, A. Papageorgiou
 Author-email: "L. V. Mugnai" <mugnail@cardiff.ac.uk>

{exosim-2.2.3 → exosim-2.2.4}/codemeta.json

@@ -40,7 +40,7 @@
     "license": "https://spdx.org/licenses/BSD-3-Clause",
     "name": "ExoSim2",
     "programmingLanguage": "Python 3",
-    "version": "2.2.3",
+    "version": "2.2.4",
     "codemeta:contIntegration": {
         "id": "https://app.codecov.io/gh/arielmission-space/ExoSim2-public"
     },

{exosim-2.2.3 → exosim-2.2.4}/src/exosim/models/channel.py

@@ -252,38 +252,52 @@ class Channel(log.Logger):
             self.bkg_focal_plane = focal_plane.copy(dataset_name="bkg_focal_plane")
         return focal_plane
 
-    # todo change into a more clearer name
-    def rescale_contributions(self) -> None:
+    def _focal_plane_wavelength_step(self) -> u.Quantity:
+        """Wavelength width of each focal-plane spectral column."""
+        x_wav_osr = self.focal_plane.spectral
+        d_x_wav_osr = np.zeros_like(x_wav_osr)
+        idx = np.where(x_wav_osr > 0.0)
+        d_x_wav_osr[idx] = np.gradient(x_wav_osr[idx])
+        if np.any(d_x_wav_osr < 0):
+            d_x_wav_osr *= -1.0
+        return d_x_wav_osr * self.focal_plane.spectral_units
+
+    def rescale_sources(self) -> None:
         """
-        It updated the contributions (sources and path)
-        by rebinning them to the wavelength solution grid
-        and multiplying them by the wl solution gradient
+        It rebins the sources onto the focal-plane wavelength grid and
+        multiplies them by the wavelength width of each column, turning
+        spectral densities into signals per column. Each source must be
+        rescaled once, after it has been propagated.
         """
-
-        def wl_gradient(x_wav_osr):
-            d_x_wav_osr = np.zeros_like(x_wav_osr)
-            idx = np.where(x_wav_osr > 0.0)
-            d_x_wav_osr[idx] = np.gradient(x_wav_osr[idx])
-            if np.any(d_x_wav_osr < 0):
-                d_x_wav_osr *= -1.0
-            return d_x_wav_osr
-
-        d_spectral_wl = (
-            wl_gradient(self.focal_plane.spectral) * self.focal_plane.spectral_units
-        )
-
-        # multiply sources by gradient
         if self.sources:
+            d_spectral_wl = self._focal_plane_wavelength_step()
             for source in self.sources:
                 self.sources[source].spectral_rebin(self.focal_plane.spectral)
                 self.sources[source] *= d_spectral_wl
 
-        # multiply radiances by gradient
+    def rescale_radiances(self) -> None:
+        """
+        It rebins the path radiances (foregrounds and optical-element
+        emission) onto the focal-plane wavelength grid and multiplies them
+        by the wavelength width of each column. The radiances must be
+        rescaled once: when the sources are propagated again (for example
+        after :meth:`define_sources`), use :meth:`rescale_sources` only.
+        """
         if self.path:
+            d_spectral_wl = self._focal_plane_wavelength_step()
             for rad in [k for k in self.path if "radiance" in k]:
                 self.path[rad].spectral_rebin(self.focal_plane.spectral)
                 self.path[rad] *= d_spectral_wl
 
+    def rescale_contributions(self) -> None:
+        """
+        It rescales the sources and the path radiances onto the focal-plane
+        wavelength grid: :meth:`rescale_sources` followed by
+        :meth:`rescale_radiances`.
+        """
+        self.rescale_sources()
+        self.rescale_radiances()
+
     @property
     def target_source(self):
         # TODO test this

{exosim-2.2.3 → exosim-2.2.4}/src/exosim.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: exosim
-Version: 2.2.3
+Version: 2.2.4
 Summary: ExoSim 2 is the next generation of the Exoplanet Observation Simulator (ExoSim) tailored for spectro-photometric observations of transiting exoplanets from space, ground, and sub-orbital platforms. This software is a complete rewrite implemented in Python 3, embracing object-oriented design principles.
 Author: E. Pascale, A. Bocchieri, A. Lorenzani, A. Papageorgiou
 Author-email: "L. V. Mugnai" <mugnail@cardiff.ac.uk>

{exosim-2.2.3 → exosim-2.2.4}/src/exosim.egg-info/scm_version.json

@@ -1,7 +1,7 @@
 {
-  "tag": "2.2.3",
+  "tag": "2.2.4",
   "distance": 0,
-  "node": "g2c8bbdef",
+  "node": "g4b1c5c05",
   "dirty": false,
   "branch": "HEAD",
   "node_date": "2026-11-13"