astrox-python 1.2.1__tar.gz → 1.2.2__tar.gz

{astrox_python-1.2.1 → astrox_python-1.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: astrox-python
-Version: 1.2.1
+Version: 1.2.2
 Summary: Python SDK for the ASTROX Web API.
 Project-URL: Homepage, https://github.com/Mtrya/astrox-python
 Project-URL: Repository, https://github.com/Mtrya/astrox-python.git

{astrox_python-1.2.1 → astrox_python-1.2.2}/docs/how_to/compute_lambert_transfer.md

@@ -62,6 +62,7 @@ python compute_lambert_transfer.py
 - `RV1`/`RV2`：出发/到达时的日心位置速度 `[x, y, z, vx, vy, vz]`（位置 m、速度 m/s）；ICRF 分支下转移速度与独立 Lambert 解一致，端点位置方向与 ICRF 轴方向一致。
 - `TimeOfFlightDays`：飞行时间（d），已验证为到达与出发时刻的精确天数差。
 - `ArrivalLightAngle`：到达时刻太阳光照角（deg），已验证为 `DeltaV2` 与 `RV2` 位置矢量的夹角。
+- `MinRangeAu`/`MaxRangeAu`：从出发到到达的转移弧上，距太阳的最小/最大距离（AU，包含端点）。
 
 ## 小行星与显式 MPC 根数
 

{astrox_python-1.2.1 → astrox_python-1.2.2}/docs/i18n/en/how_to/compute_lambert_transfer.md

@@ -63,6 +63,7 @@ Each result object contains:
 - `RV1`/`RV2`: heliocentric position and velocity at departure/arrival `[x, y, z, vx, vy, vz]` (positions m, velocities m/s); under the ICRF branch the transfer velocities agree with the independent Lambert solution, and the endpoint position directions match the ICRF axes.
 - `TimeOfFlightDays`: time of flight (d), verified to be the exact day difference between the arrival and departure times.
 - `ArrivalLightAngle`: Sun lighting angle at arrival (deg), verified to be the angle between `DeltaV2` and the `RV2` position vector.
+- `MinRangeAu`/`MaxRangeAu`: minimum/maximum distance from the Sun along the departure-to-arrival transfer arc (AU, including endpoints).
 
 ## Asteroids and explicit MPC elements
 

{astrox_python-1.2.1 → astrox_python-1.2.2}/docs/i18n/en/manual/celestial/README.md

@@ -280,6 +280,7 @@ The response contains `TransferResults` (an array of transfer results; each elem
 | `RV1` / `RV2` | number[6] | Position and velocity at departure/arrival (heliocentric) `[x, y, z, vx, vy, vz]`, positions m, velocities m/s |
 | `TimeOfFlightDays` | number | Time of flight, in d; verified to be the exact day difference between `ArrivalTime` and `DepartureTime` |
 | `ArrivalLightAngle` | number | Sun lighting angle at arrival, in deg; verified to be the angle between `DeltaV2` and the `RV2` position vector |
+| `MinRangeAu` / `MaxRangeAu` | number | Minimum/maximum distance from the Sun along the departure-to-arrival transfer arc, in AU; includes endpoints, rather than describing the full orbit's perihelion/aphelion distances |
 
 Verified (supported by independent cross-validation): omitting `sun_frame` produces exactly the same `TransferResults` as explicit `EclpJ2000ICRF`; `EclpJ2000ICRF` output is the `ICRF` output rotated by the fixed 23.43929111111111° J2000 mean obliquity; with `sun_frame="ICRF"`, the transfer velocities in `RV1`/`RV2` follow the zero-revolution prograde Lambert relationship, and the endpoint position directions use the ICRF axes; `max_departure_delta_v_m_s`/`max_arrival_delta_v_m_s`/`max_time_of_flight_days` filter the sampled grid by the `DV1_Mag`/`DV2_Mag`/time-of-flight upper bounds respectively. Note that since 2026-08-20 the server defaults (10000 m/s each for departure/arrival, 500 d) filter out cases beyond the defaults, so scans over large-ΔV windows need explicitly widened bounds. Unresolved: the exact coordinate relationship between explicit `MeanEclpJ2000` and ICRF, the physical meaning of `DeltaV` relative to the endpoint-body velocities, and independent Kepler propagation of explicit MPC elements (the `reference_frame` option does not change the arrival states of that route; the element convention is still unconfirmed). The numeric semantics of those branches remain unverified, so check them before use.
 

{astrox_python-1.2.1 → astrox_python-1.2.2}/docs/manual/celestial/README.md

@@ -280,6 +280,7 @@ print(
 | `RV1` / `RV2` | number[6] | 出发/到达时的位置速度（日心系）`[x, y, z, vx, vy, vz]`，位置 m、速度 m/s |
 | `TimeOfFlightDays` | number | 飞行时间，单位 d；已验证为 `ArrivalTime` 与 `DepartureTime` 的精确天数差 |
 | `ArrivalLightAngle` | number | 到达时刻太阳光照角，单位 deg；已验证为 `DeltaV2` 与 `RV2` 位置矢量的夹角 |
+| `MinRangeAu` / `MaxRangeAu` | number | 从出发到到达的转移弧上，距太阳的最小/最大距离，单位 AU；包含端点，不是整条轨道的近日点/远日点距离 |
 
 已验证（独立交叉验证支持）：省略 `sun_frame` 与显式传入 `EclpJ2000ICRF` 的 `TransferResults` 完全一致；`EclpJ2000ICRF` 输出是 `ICRF` 输出按 23.43929111111111° J2000 平黄赤交角进行的固定旋转；`sun_frame="ICRF"` 时，`RV1`/`RV2` 中的转移速度遵循零圈顺行 Lambert 关系，端点位置方向使用 ICRF 轴；`max_departure_delta_v_m_s`/`max_arrival_delta_v_m_s`/`max_time_of_flight_days` 分别按 `DV1_Mag`/`DV2_Mag`/飞行时间上限过滤采样网格。注意 2026-08-20 起服务端缺省值（出发/到达各 10000 m/s、500 d）会过滤掉超出缺省的算例，扫描大 ΔV 窗口时需显式放宽。未解决：显式 `MeanEclpJ2000` 与 ICRF 之间的精确坐标关系、`DeltaV` 相对端点天体速度的物理含义、显式 MPC 根数的独立开普勒递推（`reference_frame` 选项不改变该路由的到达状态，元素约定仍未确认）。这些分支的数值语义尚未验证，使用前请自行核对。
 

{astrox_python-1.2.1 → astrox_python-1.2.2}/docs/validation/celestial.md

@@ -43,9 +43,10 @@ Status of `celestial.mpc_ephemeris`: structure, `target_elements`, `reference_fr
 
 ## Lambert transfer windows
 
-Status of `celestial.lambert_transfer_window`: `partial` — the server-default frame, the `EclpJ2000ICRF`↔`ICRF` coordinate relation, the ICRF transfer-state relation for the maintained Earth→Mars grid, the ICRF axis identification of the `RV1`/`RV2` endpoint position directions, the `MinTofDays`/`MaxTofDays`/`MaxDepartureDV`/`MaxArrivalDV` filtering behavior, the DV-magnitude norm invariant, and the `TimeOfFlightDays`/`ArrivalLightAngle` field invariants are `verified`; the explicit `MeanEclpJ2000`↔`ICRF` coordinate relation, the physical endpoint-body-velocity interpretation of `DeltaV`, and the independent Kepler semantics of explicit MPC elements are `unresolved`.
+Status of `celestial.lambert_transfer_window`: `partial` — the server-default frame, the `EclpJ2000ICRF`↔`ICRF` coordinate relation, the ICRF transfer-state relation for the maintained Earth→Mars grid, the ICRF axis identification of the `RV1`/`RV2` endpoint position directions, the `MinTofDays`/`MaxTofDays`/`MaxDepartureDV`/`MaxArrivalDV` filtering behavior, the DV-magnitude norm invariant, the `MinRangeAu`/`MaxRangeAu` finite-arc extrema, and the `TimeOfFlightDays`/`ArrivalLightAngle` field invariants are `verified`; the explicit `MeanEclpJ2000`↔`ICRF` coordinate relation, the physical endpoint-body-velocity interpretation of `DeltaV`, and the independent Kepler semantics of explicit MPC elements are `unresolved`.
 
 - ICRF Earth→Mars zero-revolution prograde transfer states: `verified` through [`tests/validation/cross_validation/celestial/test_lambert_transfer_lamberthub.py`](../../tests/validation/cross_validation/celestial/test_lambert_transfer_lamberthub.py). The maintained case compares the complete six UTC departure/arrival timestamp pairs in a 2 departure days × 3 arrival days grid; the independent solver is `lamberthub.izzo2015` with the Sun gravitational parameter (`1.3271244004193938e20 m^3/s^2`), `M=0`, `prograde=True`, and `low_path=True` (a zero-revolution prograde Lambert solution), using the ASTROX `RV1`/`RV2` endpoint positions as its inputs. The ASTROX transfer velocities match the solver within `SOLVER_ABS_TOL_M_S = 1e-6` m/s. The endpoint positions themselves are the solver inputs; their full celestial-state meaning beyond the independently checked directions is not promoted here.
+- Transfer-arc `MinRangeAu`/`MaxRangeAu`: `verified` using independent `lamberthub.izzo2015` velocities and SciPy DOP853 two-body integration with radial-stationary events and both endpoints. The 22 maintained transfers cover Earth→Mars in ICRF and EclpJ2000ICRF, explicit-element asteroid transfers in ICRF, and 2/4/12/14-day ICRF transfers. They exercise 40 interior and 4 endpoint extrema, distinguishing finite-arc bounds from full-orbit apsides. Maximum observed residual is 1.46e-11 AU, below the pre-set 1e-9 AU bound (the 1e-6 m/s Lambert velocity precision budget accumulated over roughly 300 days is about 2e-10 AU; the remaining margin allows propagation amplification and integration error). Integration uses AU/day units, rtol=2e-12 and atol=2e-14, and independently checks arrival-position closure within 1e-9 AU. This comparison conditions on returned endpoint positions; it does not validate the endpoint ephemerides or resolve the explicit MPC-element convention. SciPy is an existing development dependency.
 - ICRF endpoint position-direction axis identification: `verified` through [`tests/validation/cross_validation/celestial/test_lambert_transfer_lamberthub.py`](../../tests/validation/cross_validation/celestial/test_lambert_transfer_lamberthub.py). For each of the six maintained Earth→Mars results, the `RV1`/`RV2` position directions at the returned UTC departure/arrival epochs are compared with independent Skyfield DE421 heliocentric Earth/Mars position directions (body-minus-Sun positions at the same epochs). The direct angular-separation maximum is approximately 8.54e-7 deg, within the pre-set `ICRF_AXIS_IDENTIFICATION_MAX_ANGLE_DEG = 0.01`; the best of the fixed ±23.43929111111111 deg obliquity rotations applied to the independent directions stays at approximately 22.35 deg maximum separation, above `WRONG_FRAME_MIN_SEPARATION_DEG = 1.0`. This verifies only the identification of the ICRF axes for the endpoint position directions — not full numerical-kernel precision, and not the celestial-state meaning of the endpoint positions beyond their direction. The explicit `MeanEclpJ2000`↔`ICRF` coordinate relation, the `DeltaV` physical interpretation, and the explicit MPC-element semantics remain separate `unresolved` items.
 - Server-default frame: `verified` on the maintained Earth→Mars grid by exact `TransferResults` equality between omitted `sun_frame` and explicit `sun_frame="EclpJ2000ICRF"`. The default result is distinguishable from explicit `MeanEclpJ2000`, with a current maximum state-vector separation of about 54 km.
 - `EclpJ2000ICRF`↔`ICRF` coordinate relation: `verified` on every `RV1`, `RV2`, `DeltaV1`, and `DeltaV2` vector in the maintained grid. A fixed 23.43929111111111° J2000 mean-obliquity rotation reproduces the ecliptic output from the independently anchored ICRF output within `ECLIPTIC_RELATION_POSITION_ABS_TOL_M = 1e-3 m` and `ECLIPTIC_RELATION_VELOCITY_ABS_TOL_M_S = 1e-9 m/s`; current maximum residuals are approximately 3.1e-5 m and 1.1e-11 m/s.
@@ -61,7 +62,7 @@ Status of `celestial.lambert_transfer_window`: `partial` — the server-default
 
 ## Live snapshot coverage
 
-The celestial functions are exercised in [`tests/validation/live_snapshot/celestial/test_celestial.py`](../../tests/validation/live_snapshot/celestial/test_celestial.py), with sidecar [`tests/validation/live_snapshot/celestial/celestial.snap.json`](../../tests/validation/live_snapshot/celestial/celestial.snap.json) covering `ephemeris` (Moon, explicit window), `cb_axes_rotation` (order 0 and 1), `mpc_ephemeris` (Apophis, server-owned default window), and `lambert_transfer_window` (Earth→Mars with the server-default `EclpJ2000ICRF` frame, and Earth→2015 XF261 with explicit MPC elements and `sun_frame="ICRF"`). The snapshots freeze recursive nested type/layout descriptors: per-field value kinds, the CZML `cartesianVelocity` 7-value grouping, the order-dependent `Rotation` lengths (4 for `order=0`, 7 for `order=1`), the MPC `OrbitElements` key set (including `ReferenceFrame` since 2026-08-20), and the transfer-result grid with its `DeltaV` 3-vector and `RV` 6-vector layouts plus the `TimeOfFlightDays`/`ArrivalLightAngle` numbers (since 2026-08-20); volatile numeric values are not frozen, and the MPC numeric values remain catalog-data-owned. Curated returns remove the transport status wrapper fields `IsSuccess`/`Message`, so the frozen shapes contain only server data fields. These live snapshots are drift detectors for the response shape of maintained public inputs.
+The celestial functions are exercised in [`tests/validation/live_snapshot/celestial/test_celestial.py`](../../tests/validation/live_snapshot/celestial/test_celestial.py), with sidecar [`tests/validation/live_snapshot/celestial/celestial.snap.json`](../../tests/validation/live_snapshot/celestial/celestial.snap.json) covering `ephemeris` (Moon, explicit window), `cb_axes_rotation` (order 0 and 1), `mpc_ephemeris` (Apophis, server-owned default window), and `lambert_transfer_window` (Earth→Mars with the server-default `EclpJ2000ICRF` frame, and Earth→2015 XF261 with explicit MPC elements and `sun_frame="ICRF"`). The snapshots freeze recursive nested type/layout descriptors: per-field value kinds, the CZML `cartesianVelocity` 7-value grouping, the order-dependent `Rotation` lengths (4 for `order=0`, 7 for `order=1`), the MPC `OrbitElements` key set (including `ReferenceFrame` since 2026-08-20), and the transfer-result grid with its `DeltaV` 3-vector and `RV` 6-vector layouts plus the `TimeOfFlightDays`/`ArrivalLightAngle` numbers (since 2026-08-20); the two range fields added in the 2026-09-19 upstream contract are also retained as numeric AU values with a 1e-9 AU absolute comparison tolerance; other volatile numeric values are not frozen, and the MPC numeric values remain catalog-data-owned. Curated returns remove the transport status wrapper fields `IsSuccess`/`Message`, so the frozen shapes contain only server data fields. These live snapshots detect drift in response shape and the retained range values for maintained public inputs.
 
 Cross-validation scripts:
 - [`tests/validation/cross_validation/celestial/test_ephemeris_skyfield.py`](../../tests/validation/cross_validation/celestial/test_ephemeris_skyfield.py)

{astrox_python-1.2.1 → astrox_python-1.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "astrox-python"
-version = "1.2.1"
+version = "1.2.2"
 description = "Python SDK for the ASTROX Web API."
 readme = "README.md"
 license = "MIT"
@@ -59,7 +59,7 @@ dev = [
     "astropy>=6.1.7",
     "spiceypy>=8.1.2",
     "scipy>=1.14",
-    "e2m2e==5.9.4",
+    "e2m2e==5.9.5",
 ]
 
 [tool.hatch.build.targets.wheel]

{astrox_python-1.2.1 → astrox_python-1.2.2}/tests/sdk/celestial/test_celestial.py

@@ -451,7 +451,13 @@ def test_lambert_transfer_window_lowers_complete_payload_and_strips_status(
     transfer_response = {
         "IsSuccess": True,
         "Message": "Success",
-        "TransferResults": [{"RV1": [1.0, 2.0, 3.0, 4.0, 5.0, 6.0]}],
+        "TransferResults": [
+            {
+                "RV1": [1.0, 2.0, 3.0, 4.0, 5.0, 6.0],
+                "MinRangeAu": 0.8,
+                "MaxRangeAu": 1.6,
+            }
+        ],
         "FutureField": {"preserve": True},
     }
     calls = record_raw_post(monkeypatch, transfer_response)
@@ -472,7 +478,13 @@ def test_lambert_transfer_window_lowers_complete_payload_and_strips_status(
     )
 
     assert response == {
-        "TransferResults": [{"RV1": [1.0, 2.0, 3.0, 4.0, 5.0, 6.0]}],
+        "TransferResults": [
+            {
+                "RV1": [1.0, 2.0, 3.0, 4.0, 5.0, 6.0],
+                "MinRangeAu": 0.8,
+                "MaxRangeAu": 1.6,
+            }
+        ],
         "FutureField": {"preserve": True},
     }
     assert response is not transfer_response

{astrox_python-1.2.1 → astrox_python-1.2.2}/tests/validation/cross_validation/celestial/test_lambert_transfer_lamberthub.py

@@ -29,6 +29,10 @@ server's element convention is identified.
 #       and DepartureTime
 #     - ArrivalLightAngle: verified as the angle in degrees between DeltaV2 and
 #       the RV2 position vector
+#     - MinRangeAu/MaxRangeAu: verified against independent Lambert velocities
+#       and DOP853 radial-stationary events plus endpoints for ICRF/EclpJ2000ICRF
+#       Earth -> Mars, explicit-element asteroid ICRF, and short ICRF transfers;
+#       conditional on returned endpoint positions, not their ephemeris model
 #     - DeltaV1/DeltaV2 physical body-velocity interpretation: unresolved
 #   Parameters:
 #     - departure and arrival sampling: verified for two departure dates and
@@ -71,6 +75,7 @@ import numpy as np
 import pytest
 from astropy.time import Time
 from lamberthub import izzo2015
+from scipy.integrate import solve_ivp
 
 REPO_ROOT = Path(__file__).resolve().parents[4]
 if str(REPO_ROOT) not in sys.path:
@@ -88,6 +93,7 @@ SUN_MU_M3_S2 = 1.3271244004193938e20
 AU_M = 149597870700.0
 MEAN_OBLIQUITY_DEG = 23.43929111111111
 SOLVER_ABS_TOL_M_S = 1.0e-6
+RANGE_ABS_TOL_AU = 1e-9
 NORM_REL_TOL = 1.0e-12
 NORM_ABS_TOL_M_S = 1.0e-9
 ECLIPTIC_RELATION_POSITION_ABS_TOL_M = 1.0e-3
@@ -306,6 +312,101 @@ def test_transfer_states_match_lamberthub_zero_revolution_prograde() -> None:
         )
 
 
+def test_transfer_ranges_match_independent_arc_extrema() -> None:
+    """Check finite transfer arcs, conditioning on the returned endpoint positions."""
+    configure_astrox_from_env()
+    # Independent Lambert velocities seed DOP853 two-body integration in AU/day.
+    # A 1e-6 m/s solver precision budget over ~300 days gives ~2e-10 AU;
+    # 1e-9 AU allows propagation amplification and integration error (rtol 2e-12).
+    # Endpoint ephemerides and explicit MPC element conventions are not tested here.
+    mu = SUN_MU_M3_S2 * 86400.0**2 / AU_M**3
+    max_residual = 0.0
+    interior_extrema = 0
+    endpoint_extrema = 0
+    grids = [
+        (
+            f"{frame}, explicit_elements={explicit_elements}",
+            _astrox_transfer_results(frame=frame, explicit_elements=explicit_elements),
+        )
+        for frame, explicit_elements in (
+            ("ICRF", False),
+            ("EclpJ2000ICRF", False),
+            ("ICRF", True),
+        )
+    ]
+    grids.append(
+        (
+            "ICRF short window",
+            _require_results(_short_window_results(min_tof_days=1), expected_count=4),
+        )
+    )
+    for label, results in grids:
+        for result in results:
+            r1, _ = _state(result, "RV1")
+            r2, _ = _state(result, "RV2")
+            tof_s = (
+                _time(result["ArrivalTime"]) - _time(result["DepartureTime"])
+            ).total_seconds()
+            v1, _ = izzo2015(
+                SUN_MU_M3_S2, r1, r2, tof_s, M=0, prograde=True, low_path=True
+            )
+            initial = np.concatenate((r1 / AU_M, v1 * 86400.0 / AU_M))
+            duration = tof_s / 86400.0
+
+            def derivative(t: float, state: np.ndarray) -> np.ndarray:
+                r = state[:3]
+                return np.concatenate((state[3:], -mu * r / np.linalg.norm(r) ** 3))
+
+            def radial_stationary(t: float, state: np.ndarray) -> float:
+                return float(np.dot(state[:3], state[3:]))
+
+            solution = solve_ivp(
+                derivative,
+                (0.0, duration),
+                initial,
+                method="DOP853",
+                rtol=2e-12,
+                atol=2e-14,
+                max_step=duration / 64,
+                events=radial_stationary,
+            )
+            if not solution.success:
+                raise CrossValidationError(solution.message)
+            endpoint_error = float(np.linalg.norm(solution.y[:3, -1] - r2 / AU_M))
+            if endpoint_error > RANGE_ABS_TOL_AU:
+                raise CrossValidationError(
+                    f"Independent transfer endpoint residual={endpoint_error} AU"
+                )
+            radii = [
+                float(np.linalg.norm(initial[:3])),
+                float(np.linalg.norm(solution.y[:3, -1])),
+            ]
+            radii.extend(
+                float(np.linalg.norm(state[:3])) for state in solution.y_events[0]
+            )
+            for key, index in (
+                ("MinRangeAu", int(np.argmin(radii))),
+                ("MaxRangeAu", int(np.argmax(radii))),
+            ):
+                actual = _require_number(result[key], field=key)
+                residual = abs(actual - radii[index])
+                max_residual = max(max_residual, residual)
+                if index < 2:
+                    endpoint_extrema += 1
+                else:
+                    interior_extrema += 1
+                if not math.isfinite(actual) or residual > RANGE_ABS_TOL_AU:
+                    raise CrossValidationError(
+                        f"{label}: {key}={actual}, independent={radii[index]}, residual={residual} AU"
+                    )
+    # These fixtures must distinguish finite-arc bounds from full-orbit apsides.
+    assert interior_extrema > 0
+    assert endpoint_extrema > 0
+    print(f"LAMBERT_RANGE_MAX_RESIDUAL_AU={max_residual:.12g}")
+    print(f"LAMBERT_RANGE_INTERIOR_EXTREMA={interior_extrema}")
+    print(f"LAMBERT_RANGE_ENDPOINT_EXTREMA={endpoint_extrema}")
+
+
 def test_transfer_delta_v_magnitudes_match_vector_norms() -> None:
     configure_astrox_from_env()
     results = _astrox_transfer_results(frame="ICRF", explicit_elements=False)
@@ -940,6 +1041,7 @@ def test_explicit_mpc_elements_match_independent_kepler_propagation() -> None:
 def main() -> int:
     try:
         test_transfer_states_match_lamberthub_zero_revolution_prograde()
+        test_transfer_ranges_match_independent_arc_extrema()
         test_transfer_delta_v_magnitudes_match_vector_norms()
         test_min_time_of_flight_filters_short_sampling_pairs()
         test_time_of_flight_days_matches_timestamp_delta()
@@ -951,7 +1053,7 @@ def main() -> int:
     except Exception as exc:
         print(f"CROSS_VALIDATION_FAILED={type(exc).__name__}: {exc}", file=sys.stderr)
         return 1
-    print("CROSS_VALIDATION_CHECKED=9")
+    print("CROSS_VALIDATION_CHECKED=10")
     print("CROSS_VALIDATION_FAILED=0")
     return 0
 

{astrox_python-1.2.1 → astrox_python-1.2.2}/tests/validation/live_snapshot/celestial/celestial.snap.json

@@ -195,6 +195,12 @@
                   "DepartureTime": {
                     "kind": "string"
                   },
+                  "MaxRangeAu": {
+                    "kind": "number"
+                  },
+                  "MinRangeAu": {
+                    "kind": "number"
+                  },
                   "RV1": {
                     "item": {
                       "kind": "number"
@@ -220,7 +226,33 @@
             }
           },
           "kind": "object"
-        }
+        },
+        "transfer_ranges_au": [
+          {
+            "MaxRangeAu": 1.6583036266502333,
+            "MinRangeAu": 0.5810318537519513
+          },
+          {
+            "MaxRangeAu": 1.6590932311459603,
+            "MinRangeAu": 0.5799496237129426
+          },
+          {
+            "MaxRangeAu": 1.6599357782012405,
+            "MinRangeAu": 0.5788355442344318
+          },
+          {
+            "MaxRangeAu": 1.654301440655211,
+            "MinRangeAu": 0.5908207427768893
+          },
+          {
+            "MaxRangeAu": 1.6549025168843594,
+            "MinRangeAu": 0.5898559754259631
+          },
+          {
+            "MaxRangeAu": 1.6555556342710411,
+            "MinRangeAu": 0.5888611049770791
+          }
+        ]
       }
     },
     {
@@ -261,6 +293,12 @@
                   "DepartureTime": {
                     "kind": "string"
                   },
+                  "MaxRangeAu": {
+                    "kind": "number"
+                  },
+                  "MinRangeAu": {
+                    "kind": "number"
+                  },
                   "RV1": {
                     "item": {
                       "kind": "number"
@@ -286,12 +324,38 @@
             }
           },
           "kind": "object"
-        }
+        },
+        "transfer_ranges_au": [
+          {
+            "MaxRangeAu": 1.1046815597850406,
+            "MinRangeAu": 0.9433212640311289
+          },
+          {
+            "MaxRangeAu": 1.1000967105904083,
+            "MinRangeAu": 0.9469611101758767
+          },
+          {
+            "MaxRangeAu": 1.0954139108010212,
+            "MinRangeAu": 0.950705771186044
+          },
+          {
+            "MaxRangeAu": 1.1033355644754934,
+            "MinRangeAu": 0.9453675951733505
+          },
+          {
+            "MaxRangeAu": 1.0987601689577309,
+            "MinRangeAu": 0.9489508608039481
+          },
+          {
+            "MaxRangeAu": 1.0940920723610155,
+            "MinRangeAu": 0.9526341172739136
+          }
+        ]
       }
     }
   ],
   "metadata": {
     "astrox_base_url": "http://astrox.cn:8765",
-    "refreshed_at": "2026-08-24T06:28:12Z"
+    "refreshed_at": "2026-09-21T05:23:56Z"
   }
 }

{astrox_python-1.2.1 → astrox_python-1.2.2}/tests/validation/live_snapshot/celestial/test_celestial.py

@@ -23,6 +23,8 @@ from tests.validation._support import (  # noqa: E402
 
 
 SNAPSHOT_PATH = Path(__file__).with_name("celestial.snap.json")
+# Range values use the independently validated transfer-arc precision bound.
+RANGE_ABS_TOL_AU = 1e-9
 START = "2026-01-01T00:00:00.000Z"
 STOP = "2026-01-02T00:00:00.000Z"
 
@@ -149,6 +151,8 @@ def _transfer_result_shape(value: Any, *, field: str) -> dict[str, Any]:
         "RV2",
         "TimeOfFlightDays",
         "ArrivalLightAngle",
+        "MinRangeAu",
+        "MaxRangeAu",
     )
     for key in required:
         if key not in value:
@@ -156,10 +160,22 @@ def _transfer_result_shape(value: Any, *, field: str) -> dict[str, Any]:
     for key in ("DepartureTime", "ArrivalTime"):
         if not isinstance(value[key], str):
             raise SnapshotError(f"{field}.{key} must be a string")
-    for key in ("DV1_Mag", "DV2_Mag", "TimeOfFlightDays", "ArrivalLightAngle"):
+    for key in (
+        "DV1_Mag",
+        "DV2_Mag",
+        "TimeOfFlightDays",
+        "ArrivalLightAngle",
+        "MinRangeAu",
+        "MaxRangeAu",
+    ):
         if not isinstance(value[key], int | float) or isinstance(value[key], bool):
             raise SnapshotError(f"{field}.{key} must be numeric")
-    for key, expected_length in (("DeltaV1", 3), ("DeltaV2", 3), ("RV1", 6), ("RV2", 6)):
+    for key, expected_length in (
+        ("DeltaV1", 3),
+        ("DeltaV2", 3),
+        ("RV1", 6),
+        ("RV2", 6),
+    ):
         series = value[key]
         if (
             not isinstance(series, list)
@@ -234,7 +250,12 @@ def transfer_shape(*, frame: str | None, explicit_elements: bool) -> dict[str, A
         item_fields[key]["length"] = expected_length
     for index, result in enumerate(results):
         _transfer_result_shape(result, field=f"TransferResults[{index}]")
-    return _response_snapshot(shape)
+    snapshot = _response_snapshot(shape)
+    snapshot["transfer_ranges_au"] = [
+        {key: result[key] for key in ("MinRangeAu", "MaxRangeAu")}
+        for result in results
+    ]
+    return snapshot
 
 
 CASES = [
@@ -273,12 +294,12 @@ CASES = [
 
 def test_celestial_live_snapshot() -> None:
     configure_astrox_from_env()
-    check_snapshot(cases=CASES, snapshot_path=SNAPSHOT_PATH)
+    check_snapshot(cases=CASES, snapshot_path=SNAPSHOT_PATH, abs_tol=RANGE_ABS_TOL_AU)
 
 
 def _main() -> int:
     try:
-        return snapshot_main(cases=CASES, snapshot_path=SNAPSHOT_PATH)
+        return snapshot_main(cases=CASES, snapshot_path=SNAPSHOT_PATH, abs_tol=RANGE_ABS_TOL_AU)
     except Exception as exc:
         print(f"LIVE_SNAPSHOT_FAILED={type(exc).__name__}: {exc}", file=sys.stderr)
         return 1

{astrox_python-1.2.1 → astrox_python-1.2.2}/uv.lock

@@ -109,7 +109,7 @@ wheels = [
 
 [[package]]
 name = "astrox-python"
-version = "1.2.1"
+version = "1.2.2"
 source = { editable = "." }
 dependencies = [
     { name = "requests" },
@@ -142,7 +142,7 @@ requires-dist = [{ name = "requests", specifier = ">=2.34.2" }]
 dev = [
     { name = "astropy", specifier = ">=6.1.7" },
     { name = "brahe", specifier = ">=1.6.0" },
-    { name = "e2m2e", specifier = "==5.9.4" },
+    { name = "e2m2e", specifier = "==5.9.5" },
     { name = "geographiclib", specifier = ">=2.1" },
     { name = "hatchling", specifier = ">=1.30.1" },
     { name = "lamberthub", specifier = ">=1.0.0" },
@@ -527,7 +527,7 @@ wheels = [
 
 [[package]]
 name = "e2m2e"
-version = "5.9.4"
+version = "5.9.5"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "calcephpy" },
@@ -540,11 +540,11 @@ dependencies = [
     { name = "spiceypy" },
     { name = "tqdm" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/86/84/72d8019c0d97c030a718ac4e535c4eaa936c29c50e7ce7680eb44c2cb4f5/e2m2e-5.9.4.tar.gz", hash = "sha256:56a29916e5677b9d8e8cd8501913a0794a03cd36080aaab2dee34b1a361131a1", size = 5887698, upload-time = "2026-09-04T09:58:55.746Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/85/12/470edadcaf7cfe7c5dab177b28205070089819b09414c53f823a98b56002/e2m2e-5.9.5.tar.gz", hash = "sha256:1d6ff9508d79aa9417e60dcd75086388a5788a367b8f89bfa193c0f972f385a9", size = 5888222, upload-time = "2026-09-07T06:12:55.248Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/ea/e9/01d094f1e8c4ce11f7d161055f44c205bca7ee39779f07ea35d1725a8515/e2m2e-5.9.4-cp310-abi3-manylinux_2_28_aarch64.whl", hash = "sha256:1dc6a9845219ed50d168c40596071ed984bbe5e457518ac4f62b9aff68aef9b4", size = 8047422, upload-time = "2026-09-04T09:58:49.133Z" },
-    { url = "https://files.pythonhosted.org/packages/83/7d/801c034c73f92599bbed9fb5fd6483badf24779876ca5c15491d1c2d1619/e2m2e-5.9.4-cp310-abi3-manylinux_2_28_x86_64.whl", hash = "sha256:7a4cd2d63039633fea2d0414f2efdbbcd056f29b577907790785ed63ec06007b", size = 8193466, upload-time = "2026-09-04T09:58:51.54Z" },
-    { url = "https://files.pythonhosted.org/packages/6f/e6/a0e9f7cae75bfe66552b36da869d83e4e0c307316a1177ca782d4c009dda/e2m2e-5.9.4-cp310-abi3-win_amd64.whl", hash = "sha256:7d23059dfb8004a4ee4df5a705bea222975a06bc0ce8ecd1d868825be12bf9bc", size = 7884876, upload-time = "2026-09-04T09:58:53.73Z" },
+    { url = "https://files.pythonhosted.org/packages/3c/fa/f006140a838ca92fca7c370e3f9e821e675eb637fbd358ea5842d44b77df/e2m2e-5.9.5-cp310-abi3-manylinux_2_28_aarch64.whl", hash = "sha256:e1254122d927eca64fa9e2323622009472c8f27dbbbfc2fbeda59ed0c458f560", size = 8047398, upload-time = "2026-09-07T06:12:47.606Z" },
+    { url = "https://files.pythonhosted.org/packages/85/4b/4fad55148ecefbb04f32dbb4b1666804ee4da4c12854e1540ccfa8d5c694/e2m2e-5.9.5-cp310-abi3-manylinux_2_28_x86_64.whl", hash = "sha256:52bfa9a8a90c03484170db8a22f2533abdc7e56fe7249a51d83d060720051964", size = 8189609, upload-time = "2026-09-07T06:12:50.82Z" },
+    { url = "https://files.pythonhosted.org/packages/df/f6/598c443d393b2b12ec34e0d592f9459fd2ea57f81fe6416dc93e3380131f/e2m2e-5.9.5-cp310-abi3-win_amd64.whl", hash = "sha256:68fd24c5142d816724fc3e99dd1bef4334dc7d038c1758fb0eef0dc78f327197", size = 7884931, upload-time = "2026-09-07T06:12:53.105Z" },
 ]
 
 [[package]]