Generalize SSB<->LISA coordinate transforms to arbitrary constellations (Taiji/TianQin), add numeric/real orbit support

.github/workflows/basic-tests.yml

@@ -62,6 +62,25 @@ jobs:
           examples/inference/relmarg/*.gwf
           examples/inference/single/*.gwf
 
+    - name: Install lisaorbits (optional ESA lisa-orbit-files cross-check)
+      # lisaorbits requires Python >= 3.12 (see its pyproject.toml), so this
+      # is skipped on the 3.11 leg; the tests it enables
+      # (test_coordinates_space_orbit.py's TestOptionalLisaorbitsDuckTyping,
+      # TestOptionalESAOemOrbitFiles) already skip gracefully if it's absent,
+      # so this step is purely additive coverage, not a hard requirement.
+      if: matrix.test-type == 'unittest' && matrix.python-version != '3.11'
+      run: |
+        pixi run -e unittest pip install lisaorbits
+
+    - name: Install lunarsky (optional lunar-site position tests)
+      # lunarsky has no Python version restriction (unlike lisaorbits), so
+      # this runs on all three legs; test_coordinates_moon.py's
+      # TestOptionalLunarskySite skips gracefully if it's absent, so this
+      # step is purely additive coverage, not a hard requirement.
+      if: matrix.test-type == 'unittest'
+      run: |
+        pixi run -e unittest pip install lunarsky
+
     - name: run pycbc test suite
       run: |
         export LAL_DATA_PATH=$HOME/lal_aux_data

pycbc/coordinates/__init__.py

@@ -17,10 +17,17 @@
 more advanced transformations between ground-based detectors and space-borne
 detectors.
 """
+# ruff: noqa: F403, F405 -- this module deliberately re-exports every name
+# from its submodules via `import *`, with the combined public API listed
+# explicitly in `__all__` below; ruff cannot resolve star-imported names
+# statically, so F403 ("unable to detect undefined names") and F405 ("may
+# be undefined, or defined from star imports") are expected here, not a
+# sign of a real undefined-name bug.
 
 from pycbc.coordinates.base import *
+from pycbc.coordinates.moon import *
 from pycbc.coordinates.space import *
-
+from pycbc.coordinates.space_orbit import *
 
 __all__ = ['cartesian_to_spherical_rho', 'cartesian_to_spherical_azimuthal',
            'cartesian_to_spherical_polar', 'cartesian_to_spherical',
@@ -34,4 +41,13 @@
            'lisa_position_ssb', 'earth_position_ssb',
            't_geo_from_ssb', 't_ssb_from_t_geo', 'ssb_to_geo', 'geo_to_ssb',
            'lisa_to_geo', 'geo_to_lisa',
+           'NumericOrbits', 'LisaAnalyticOrbit', 'LisaKeplerianOrbit',
+           'TaijiAnalyticOrbit', 'TaijiKeplerianOrbit',
+           'TianQinAnalyticOrbit', 'ICRSOrbitAdapter',
+           'constellation_frame', 'link_vector',
+           't_detector_from_ssb', 't_ssb_from_t_detector',
+           'rotation_matrix_ssb_to_moon', 'moon_site_position_ssb',
+           't_moon_from_ssb', 't_ssb_from_t_moon',
+           'ssb_to_moon', 'moon_to_ssb',
+           'moon_to_geo', 'geo_to_moon', 'moon_to_lisa', 'lisa_to_moon',
            ]