astro-metadata-translator 29.0.1__py3-none-any.whl → 29.2025.1700__py3-none-any.whl

astro_metadata_translator/observationInfo.py

@@ -115,6 +115,7 @@ class ObservationInfo:
         datetime_end: astropy.time.Time
         exposure_group: str
         exposure_time: astropy.units.Quantity
+        exposure_time_requested: astropy.units.Quantity
         dark_time: astropy.units.Quantity
         boresight_airmass: float
         boresight_rotation_angle: astropy.units.Quantity
@@ -131,6 +132,7 @@ class ObservationInfo:
         relative_humidity: float
         tracking_radec: astropy.coordinates.SkyCoord
         altaz_begin: astropy.coordinates.AltAz
+        altaz_end: astropy.coordinates.AltAz | None
         science_program: str
         observation_counter: int
         observation_reason: str

astro_metadata_translator/properties.py

@@ -460,7 +460,14 @@ may not be.""",
         simple_to_datetime,
     ),
     "exposure_time": PropertyDefinition(
-        "Duration of the exposure with shutter open (seconds).",
+        "Actual duration of the exposure (seconds).",
+        "astropy.units.Quantity",
+        astropy.units.Quantity,
+        exptime_to_simple,
+        simple_to_exptime,
+    ),
+    "exposure_time_requested": PropertyDefinition(
+        "Requested duration of the exposure (seconds).",
         "astropy.units.Quantity",
         astropy.units.Quantity,
         exptime_to_simple,
@@ -550,6 +557,13 @@ may not be.""",
         altaz_to_simple,
         simple_to_altaz,
     ),
+    "altaz_end": PropertyDefinition(
+        "Telescope boresight azimuth and elevation at end of observation.",
+        "astropy.coordinates.AltAz",
+        astropy.coordinates.AltAz,
+        altaz_to_simple,
+        simple_to_altaz,
+    ),
     "science_program": PropertyDefinition("Observing program (survey or proposal) identifier.", "str", str),
     "observation_type": PropertyDefinition(
         "Type of observation (currently: science, dark, flat, bias, focus).",

astro_metadata_translator/translator.py

@@ -1042,6 +1042,34 @@ class MetadataTranslator:
             return "science"
         return "unknown"
 
+    @cache_translation
+    def to_exposure_time_requested(self) -> astropy.units.Quantity:
+        """Return the requested exposure time in seconds.
+
+        Base class implementations returns the same value as ``exposure_time``.
+        This information may not be available for all instruments.
+
+        Returns
+        -------
+        exptime : `astropy.units.Quantity`
+            The recorded exposure time in seconds.
+        """
+        return self.to_exposure_time()
+
+    @cache_translation
+    def to_altaz_end(self) -> astropy.coordinates.AltAz | None:
+        """Return the AltAz for the end of the observation.
+
+        Base class implementation returns `None`. Subclasses should override
+        if the value is known.
+
+        Returns
+        -------
+        altaz : `astropy.coordinates.AltAz` or `None`
+            The AltAz for the end of the observation.
+        """
+        return None
+
     @classmethod
     def observing_date_to_offset(cls, observing_date: astropy.time.Time) -> astropy.time.TimeDelta | None:
         """Calculate the observing day offset to apply for a given observation.

astro_metadata_translator/translators/decam.py

@@ -61,6 +61,7 @@ class DecamTranslator(FitsTranslator):
 
     _trivial_map: dict[str, str | list[str] | tuple[Any, ...]] = {
         "exposure_time": ("EXPTIME", {"unit": u.s}),
+        "exposure_time_requested": ("EXPREQ", {"unit": u.s}),
         "dark_time": ("DARKTIME", {"unit": u.s}),
         "boresight_airmass": ("AIRMASS", {"checker": is_non_science}),
         "observation_id": "OBSID",

astro_metadata_translator/translators/helpers.py

@@ -149,12 +149,16 @@ def altaz_from_degree_headers(
     altazpairs: tuple[tuple[str, str], ...],
     obstime: astropy.time.Time,
     is_zd: set[str] | None = None,
+    max_alt: float = 90.0,
+    min_alt: float = 0.0,
 ) -> AltAz:
     """Calculate the altitude/azimuth coordinates from lists of headers.
 
-    If the altitude is found but is greater than 90 deg, it will be returned
-    fixed at 90 deg.
-    If the altitude or azimuth are negative and this is a calibration
+    If the altitude is found but is greater than the maximum allowed value,
+    it will be returned fixed at that maximum value.
+    If the altitude is found but is less than the minimum allowed value, it
+    will be returned clipped to that minimum value.
+    If the azimuth is less than -360.0 and this is not a science
     observation, `None` will be returned.
 
     Parameters
@@ -167,6 +171,15 @@ def altaz_from_degree_headers(
     is_zd : `set`, optional
         Contains keywords that correspond to zenith distances rather than
         altitude.
+    max_alt : `float`, optional
+        Maximum allowed altitude in degrees. Will be clamped to this value if
+        out of range. This value will be forced to +90 if it exceeds +90
+        since `astropy.coordinates.AltAz` does not allow a value larger than
+        this even if that is caused by a telescope that can lean back at
+        Zenith.
+    min_alt : `float`, optional
+        Minimum allowed altitude in degrees. Will be clamped to this value if
+        out of range.
 
     Returns
     -------
@@ -181,6 +194,8 @@ def altaz_from_degree_headers(
         No AltAz keywords were found and this observation is a science
         observation.
     """
+    if max_alt > 90.0:
+        max_alt = 90.0
     for alt_key, az_key in altazpairs:
         if self.are_keys_ok([az_key, alt_key]):
             az = self._header[az_key]
@@ -190,13 +205,16 @@ def altaz_from_degree_headers(
             if is_zd and alt_key in is_zd:
                 alt = altitude_from_zenith_distance(alt * u.deg).value
 
-            if az < -360.0 or alt < 0.0:
+            if az < -360.0 or alt < -90.0:
                 # Break out of loop since we have found values but
-                # they are bad.
+                # they are not believable
                 break
-            if alt > 90.0:
-                log.warning("%s: Clipping altitude (%f) at 90 degrees", self._log_prefix, alt)
-                alt = 90.0
+            if alt > max_alt:
+                log.info("%s: Clipping altitude (%f) at %f degrees", self._log_prefix, alt, max_alt)
+                alt = max_alt
+            elif alt < min_alt:
+                log.info("%s: Clipping altitude (%f) at %f degrees", self._log_prefix, alt, min_alt)
+                alt = min_alt
 
             altaz = AltAz(az * u.deg, alt * u.deg, obstime=obstime, location=self.to_location())
             self._used_these_cards(az_key, alt_key)

astro_metadata_translator/translators/megaprime.py

@@ -64,6 +64,7 @@ class MegaPrimeTranslator(FitsTranslator):
         "physical_filter": "FILTER",
         "dark_time": ("DARKTIME", {"unit": u.s}),
         "exposure_time": ("EXPTIME", {"unit": u.s}),
+        "exposure_time_requested": ("EXPREQ", {"unit": u.s}),
         "observation_id": "OBSID",
         "object": "OBJECT",
         "science_program": "RUNID",

astro_metadata_translator/version.py

@@ -1,2 +1,2 @@
 __all__ = ["__version__"]
-__version__ = "29.0.1"
+__version__ = "29.2025.1700"

{astro_metadata_translator-29.0.1.dist-info → astro_metadata_translator-29.2025.1700.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: astro-metadata-translator
-Version: 29.0.1
+Version: 29.2025.1700
 Summary: A translator for astronomical metadata.
 Author-email: Rubin Observatory Data Management <dm-admin@lists.lsst.org>
 License: BSD 3-Clause License

{astro_metadata_translator-29.0.1.dist-info → astro_metadata_translator-29.2025.1700.dist-info}/RECORD

@@ -3,12 +3,12 @@ astro_metadata_translator/file_helpers.py,sha256=Y8jovSkAjjHIUMbY4gtiEdEZZ8KzHFC
 astro_metadata_translator/headers.py,sha256=21KWaPnBPDkonh5coZ0NolMdtM6KVozqi1Fd2d1z80M,18944
 astro_metadata_translator/indexing.py,sha256=GxQNDJ_-YVqNBAbaUFku6MrzgKrcS7yTLUO498b3rCM,14530
 astro_metadata_translator/observationGroup.py,sha256=XRP8xpHQXx4hSl_SrBBan_q1gmxpu2VuepjLZEWthsQ,8689
-astro_metadata_translator/observationInfo.py,sha256=J7-yoC5s5gV3lFdFmos9HaQ9YjyRIpZ-ivs7RjnKUSA,27435
-astro_metadata_translator/properties.py,sha256=MrZjOPXJdJQ6_D9jxopEP3HIil0Lc9Qus5IxruXHXZQ,18321
+astro_metadata_translator/observationInfo.py,sha256=mlxtrOlJB7qjMZzxVo2-8CjC-KFCexZsBkI_9VtXakI,27543
+astro_metadata_translator/properties.py,sha256=oiatCGP6g7O0sm5dku50dUyMJtu8IORFLXRu4Sx1hCo,18787
 astro_metadata_translator/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 astro_metadata_translator/tests.py,sha256=S73nreZm3pCfRlU8sKHbXfEoEkZ2zSY5pbHs9hDYBAM,13251
-astro_metadata_translator/translator.py,sha256=0F8QXUnUuiDnqTkv24C2QtsI68srZtTI4nczE-V7Y9M,55696
-astro_metadata_translator/version.py,sha256=Oycc9MfI16leETuVPQiwtLHLWpMrSvgO5aQ1pJrqY48,49
+astro_metadata_translator/translator.py,sha256=5dA5Dsj57PxTMtdE-t1jixWHLPkW1BNsdUJhiYfsbNc,56602
+astro_metadata_translator/version.py,sha256=k6PcnewHb2vETZCsCS6q8mJ_uyMg-otfwuQ8B0oDDwQ,55
 astro_metadata_translator/bin/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 astro_metadata_translator/bin/translate.py,sha256=uf69YI58nxVI4i-p5nPxPsQWdHlk-QY_WmMBkeeKQB0,11018
 astro_metadata_translator/bin/writeindex.py,sha256=pGdN0Z8WNQKGIFCJz_YHd384nAxVsBKK6JQ1lWQbTN8,4220
@@ -50,18 +50,18 @@ astro_metadata_translator/corrections/SuprimeCam/README.md,sha256=UaaDRv8T5ik-iY
 astro_metadata_translator/serialize/__init__.py,sha256=pthEgasrT3Qw4e7nZk_X1rPBjDju5AsdHDnxqoOoAsU,427
 astro_metadata_translator/serialize/fits.py,sha256=mjBYhL_wy_-aGgmswxMn1bIgq0U764uv02ge_1_5iRg,3811
 astro_metadata_translator/translators/__init__.py,sha256=RHzTw7pnp5o5wyZPWg__udthT6qFQMZAJBsicxkRVZY,560
-astro_metadata_translator/translators/decam.py,sha256=1YLeCpsHFlLZgswycxaz0RzC4lXoMxM1SnCDfaQaZGg,18224
+astro_metadata_translator/translators/decam.py,sha256=R0M_p5EpPVvpeEQk0nSJdd34UJiIUvqBrlbsC_NQbOc,18286
 astro_metadata_translator/translators/fits.py,sha256=h4tIB2XIg_oV-m5kVe6ny1gJIKMcDsEBO-SvC_NWinM,7030
-astro_metadata_translator/translators/helpers.py,sha256=HjhV5_ttyW3V2ZLZ2lyoQTRvmo7P3dLxnWmDQCfXR34,6557
+astro_metadata_translator/translators/helpers.py,sha256=SrfI1qo-jLZfsCO60AU9Mft8ecPx8VAq35ap7gv2we0,7478
 astro_metadata_translator/translators/hsc.py,sha256=Ca7zKICl04HrKQG51_bWyxAio7Oiibuuw39fcvtG6wI,8529
-astro_metadata_translator/translators/megaprime.py,sha256=X9qbcJxZNryOmfe0rekUSAPQnXbockjgKXMTOPf5ftM,10820
+astro_metadata_translator/translators/megaprime.py,sha256=n46ZkE95XuybU5JOKhBTE1VIiS-aNwxjuaJxjrz_BH0,10882
 astro_metadata_translator/translators/sdss.py,sha256=prUTawPqAXzJ5i2p2yXH3ekLuj3rWGy-YjJMquJPMq0,9445
 astro_metadata_translator/translators/subaru.py,sha256=-CTzxc2MpgEEpma-toD6B8RcvV-t5MNZq_fb4UGbHQU,2143
 astro_metadata_translator/translators/suprimecam.py,sha256=b3S54aHvZ2SprvXRdOLCIJToj6KAiqjK-JB5My8xLWM,8409
-astro_metadata_translator-29.0.1.dist-info/licenses/LICENSE,sha256=6DRIob1hPfPI0HmYxqGJXcJr7Vc81mXQJHtjH29gygw,1518
-astro_metadata_translator-29.0.1.dist-info/METADATA,sha256=SPdUsGRdqIq-79BVJcwxAoGkNS9KXFcBdXLdlTvgBh4,1895
-astro_metadata_translator-29.0.1.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
-astro_metadata_translator-29.0.1.dist-info/entry_points.txt,sha256=9dwf9VZWuNtomGwNBEc0S9HJ740wnPSVEO8yNEPto6Y,83
-astro_metadata_translator-29.0.1.dist-info/top_level.txt,sha256=ll138q-If3_TxKr2nTm5F3MEhWqvHbF3ptEDOhvgfRU,26
-astro_metadata_translator-29.0.1.dist-info/zip-safe,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
-astro_metadata_translator-29.0.1.dist-info/RECORD,,
+astro_metadata_translator-29.2025.1700.dist-info/licenses/LICENSE,sha256=6DRIob1hPfPI0HmYxqGJXcJr7Vc81mXQJHtjH29gygw,1518
+astro_metadata_translator-29.2025.1700.dist-info/METADATA,sha256=Kwd_bX9v9nKkYCBHrwqMbdif1oRUMA-Lh9qylSTgJFE,1901
+astro_metadata_translator-29.2025.1700.dist-info/WHEEL,sha256=SmOxYU7pzNKBqASvQJ7DjX3XGUF92lrGhMb3R6_iiqI,91
+astro_metadata_translator-29.2025.1700.dist-info/entry_points.txt,sha256=9dwf9VZWuNtomGwNBEc0S9HJ740wnPSVEO8yNEPto6Y,83
+astro_metadata_translator-29.2025.1700.dist-info/top_level.txt,sha256=ll138q-If3_TxKr2nTm5F3MEhWqvHbF3ptEDOhvgfRU,26
+astro_metadata_translator-29.2025.1700.dist-info/zip-safe,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+astro_metadata_translator-29.2025.1700.dist-info/RECORD,,

{astro_metadata_translator-29.0.1.dist-info → astro_metadata_translator-29.2025.1700.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (78.1.0)
+Generator: setuptools (79.0.1)
 Root-Is-Purelib: true
 Tag: py3-none-any