tellurion 0.1.0__tar.gz

tellurion-0.1.0/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) [2026] [Liam M. Healy]
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

tellurion-0.1.0/MANIFEST.in

@@ -0,0 +1,2 @@
+include LICENSE.txt README.md
+recursive-include tellurion/ork/_orekit_data *

tellurion-0.1.0/PKG-INFO

@@ -0,0 +1,58 @@
+Metadata-Version: 2.4
+Name: tellurion
+Version: 0.1.0
+Summary: Astrodynamics and satellite navigation using Orekit and AstroPy
+Author: Liam Healy
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/liamh/tellurion
+Project-URL: Repository, https://github.com/liamh/tellurion
+Project-URL: Documentation, https://tellurion.readthedocs.io
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: Education
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+Requires-Dist: astropy>=8.0
+Requires-Dist: numpy>=1.20
+Requires-Dist: jdk4py
+Requires-Dist: orekit-jpype
+Requires-Dist: funcy
+Requires-Dist: pandas
+Requires-Dist: spacetrack
+Requires-Dist: geocoder
+Requires-Dist: munch
+Provides-Extra: hdf5
+Requires-Dist: astropy-hdf5io>=0.1.0; extra == "hdf5"
+Provides-Extra: docs
+Requires-Dist: sphinx>=7.0; extra == "docs"
+Requires-Dist: sphinx-rtd-theme; extra == "docs"
+Requires-Dist: sphinx-automodapi; extra == "docs"
+Requires-Dist: sphinx-astropy; extra == "docs"
+Requires-Dist: sphinx-changelog; extra == "docs"
+Requires-Dist: sphinx-design; extra == "docs"
+Requires-Dist: sphinxcontrib-globalsubs; extra == "docs"
+Requires-Dist: myst-nb; extra == "docs"
+Requires-Dist: jupytext; extra == "docs"
+Requires-Dist: matplotlib; extra == "docs"
+Requires-Dist: pydata-sphinx-theme; extra == "docs"
+Requires-Dist: numpydoc; extra == "docs"
+Requires-Dist: nbsphinx; extra == "docs"
+Requires-Dist: nbsphinx-link; extra == "docs"
+Requires-Dist: jupyter; extra == "docs"
+Requires-Dist: jupyterlab; extra == "docs"
+Requires-Dist: ipython; extra == "docs"
+Requires-Dist: ipykernel; extra == "docs"
+Provides-Extra: dev
+Requires-Dist: tellurion[hdf5]; extra == "dev"
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: black; extra == "dev"
+Requires-Dist: flake8; extra == "dev"
+Provides-Extra: all
+Requires-Dist: tellurion[dev,docs,hdf5]; extra == "all"
+Dynamic: license-file
+
+Tellurion is a package for astrodynamics and space navigation. Input and results use
+[AstroPy](https://www.astropy.org) objects, and orbit computations are performed by [Orekit](https://www.orekit.org/).

tellurion-0.1.0/README.md

@@ -0,0 +1,2 @@
+Tellurion is a package for astrodynamics and space navigation. Input and results use
+[AstroPy](https://www.astropy.org) objects, and orbit computations are performed by [Orekit](https://www.orekit.org/).

tellurion-0.1.0/pyproject.toml

@@ -0,0 +1,125 @@
+[build-system]
+requires = ["setuptools>=64", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "tellurion"
+version = "0.1.0"
+description = "Astrodynamics and satellite navigation using Orekit and AstroPy"
+authors = [{name = "Liam Healy"}]
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE.txt"]
+# Classifiers help PyPI index and search your license correctly
+classifiers = [
+    "Programming Language :: Python :: 3.10",
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Science/Research",
+    "Intended Audience :: Education"
+    ]
+
+# Core package dependencies
+dependencies = [
+    "astropy>=8.0",
+    "numpy>=1.20",
+    "jdk4py",
+    "orekit-jpype",
+    "funcy",
+    "pandas",
+    "spacetrack",
+    "geocoder",
+    "munch",  # for demos
+]
+
+
+[project.optional-dependencies]
+# HDF5 serialization support
+hdf5 = [
+    "astropy-hdf5io>=0.1.0",
+]
+
+# Documentation dependencies
+docs = [
+    "sphinx>=7.0",
+    "sphinx-rtd-theme",
+    "sphinx-automodapi",
+    "sphinx-astropy",
+    "sphinx-changelog",
+    "sphinx-design",
+    "sphinxcontrib-globalsubs",
+    "myst-nb",
+    "jupytext",
+    "matplotlib",
+    "pydata-sphinx-theme",
+    "numpydoc",
+    "nbsphinx",
+    "nbsphinx-link",
+    "jupyter",
+    "jupyterlab",
+    "ipython",
+    "ipykernel",
+]
+
+# Development dependencies (includes hdf5 so tests can cover it)
+dev = [
+    "tellurion[hdf5]",
+    "pytest>=7.0",
+    "pytest-cov",
+    "black",
+    "flake8",
+]
+
+# All optional dependencies combined
+all = [
+    "tellurion[hdf5,docs,dev]",
+]
+
+[project.urls]
+Homepage = "https://github.com/liamh/tellurion"
+Repository = "https://github.com/liamh/tellurion"
+Documentation = "https://tellurion.readthedocs.io"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["tellurion*"]
+
+[tool.setuptools.package-data]
+"tellurion.ork" = ["_orekit_data/**/*"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+addopts = "-p no:faulthandler -v --tb=short"
+markers = [
+    "hdf5: tests requiring astropy-hdf5io (deselect with '-m not hdf5')",
+]
+
+# Check/fix formatting and style for a single file
+#  ruff check --fix tellurion/ork/prop.py && ruff format tellurion/ork/prop.py
+# For all files
+#  ruff check --fix --unsafe-fixes . && ruff format .
+[tool.ruff]
+line-length = 88
+
+[tool.ruff.lint]
+select = [
+  "E",    # pycodestyle errors
+  "F",    # Pyflakes
+  "Q",    # Quote style
+  "W291", # Trailing whitespace
+  "W293", # Blank line whitespace
+  "D300", # Enforce PEP 257 triple-double quotes (""")
+  "I",    # isort (automatically formats import lines)
+]
+
+# Pass rule codes as an array (sequence) rather than a table/map
+extend-safe-fixes = ["W293", "W291"]
+
+[tool.ruff.lint.isort]
+combine-as-imports = true
+
+[tool.ruff.format]
+docstring-code-format = true

tellurion-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

tellurion-0.1.0/tellurion/__init__.py

@@ -0,0 +1,362 @@
+"""Top-level Tellurion public API."""
+
+from importlib import import_module as _import_module, util as _importlib_util
+from importlib.metadata import PackageNotFoundError, version as _version
+import inspect
+from functools import wraps
+
+import numpy as np
+from astropy.table import conf as table_conf
+
+# Configure printing
+table_conf.format_size_threshold = 3
+np.set_printoptions(suppress=True, precision=4, linewidth=np.inf)
+
+import tellurion.core as _core
+from tellurion.astro import (
+    abstime,
+    change_units,
+    from_array,
+    fromtime,
+    gravconstunits,
+    hcat,
+    hstack,
+    make_quantity,
+    normalizeangle,
+    orkunits,
+    prefunits,
+    prefnumabstime,
+    quantity_to_array,
+    quantity_to_dict,
+    rev,
+    revolution,
+    siunits,
+    sifloat,
+    striptime,
+    tc,
+    time_concat,
+    timesec,
+    to_array,
+    tq,
+    vstack,
+)
+from tellurion.core import (
+    PVT,
+    EarthObservationT,
+    ElementSetT,
+    MeanElementSetT,
+    PositionBase,
+    PositionT,
+    PositionVelocityT,
+    azelrange,
+    circular,
+    circeltma_names,
+    circeltta_names,
+    circtimeelements,
+    earthloc,
+    elev,
+    equeltma_names,
+    equeltta_names,
+    equinoctial,
+    equtimeelements,
+    gnuserid,
+    iscircels,
+    isequels,
+    iskepels,
+    kepeltma_names,
+    kepeltta_names,
+    kepler,
+    location,
+    magdiff,
+    nullisland,
+    obsdict1,
+    observer_location,
+    pvtcart,
+    satdata,
+    sfdict,
+    spacetrack_latest,
+    statefnval,
+    stscdata,
+    timeelements,
+    userid,
+)
+
+try:
+    __version__ = _version("tellurion")
+except PackageNotFoundError:
+    __version__ = "0+unknown"
+
+# Whether Orekit bridge module appears importable; does not initialize JVM.
+_ORK_AVAILABLE = _importlib_util.find_spec("orekit_jpype") is not None
+
+
+def _is_missing_orekit_bridge_error(exc):
+    current = exc
+    seen = set()
+    while current is not None and id(current) not in seen:
+        seen.add(id(current))
+        if isinstance(current, ModuleNotFoundError):
+            if (current.name or "").startswith("orekit_jpype"):
+                return True
+        elif isinstance(current, ImportError):
+            if (getattr(current, "name", "") or "").startswith("orekit_jpype"):
+                return True
+        current = current.__cause__ or current.__context__
+    return False
+
+
+def _is_orekit_init_error(exc):
+    text = str(exc)
+    return (
+        "Failed to initialize Orekit JVM/data." in text
+        or "Orekit initialization previously failed." in text
+    )
+
+
+def _raise_orekit_runtime_error(exc):
+    raise RuntimeError(
+        "Orekit support is not available or failed to initialize. "
+        "Install/configure Java + orekit-jpype, then retry."
+    ) from exc
+
+
+def _ork_attr(name):
+    """Fetch a lazy Orekit-backed symbol from tellurion.ork."""
+    if not _ORK_AVAILABLE:
+        _raise_orekit_runtime_error(RuntimeError("orekit_jpype not available"))
+    try:
+        value = getattr(_import_module("tellurion.ork"), name)
+    except RuntimeError as exc:
+        if _is_missing_orekit_bridge_error(exc) or _is_orekit_init_error(exc):
+            _raise_orekit_runtime_error(exc)
+        raise
+    except ModuleNotFoundError as exc:
+        if _is_missing_orekit_bridge_error(exc):
+            _raise_orekit_runtime_error(exc)
+        raise
+    if callable(value):
+        @wraps(value)
+        def _wrapped(*args, **kwargs):
+            try:
+                return value(*args, **kwargs)
+            except RuntimeError as exc:
+                if _is_missing_orekit_bridge_error(exc) or _is_orekit_init_error(exc):
+                    _raise_orekit_runtime_error(exc)
+                raise
+        return _wrapped
+    return value
+
+
+def init_orekit():
+    """Initialize JVM + Orekit data explicitly."""
+    return _ork_attr("init_orekit")()
+
+
+def orekit_available():
+    """Return True if orekit-jpype bridge module is importable."""
+    try:
+        ork = _import_module("tellurion.ork")
+        return bool(getattr(ork, "orekit_available")())
+    except Exception:
+        return bool(_importlib_util.find_spec("orekit_jpype") is not None)
+
+
+def prepare(*args, **kwargs):
+    """Prepare an Orekit-backed propagation."""
+    return _ork_attr("prepare")(*args, **kwargs)
+
+
+def propagate(*args, **kwargs):
+    """Execute a prepared Orekit-backed propagation."""
+    return _ork_attr("propagate")(*args, **kwargs)
+
+
+def setgravity(*args, **kwargs):
+    """Create an Orekit force environment."""
+    return _ork_attr("setgravity")(*args, **kwargs)
+
+
+def dragforce(*args, **kwargs):
+    """Add atmospheric drag to an Orekit force environment."""
+    return _ork_attr("dragforce")(*args, **kwargs)
+
+
+def siderealtime(*args, **kwargs):
+    """Compute sidereal time using Orekit reference frames."""
+    return _ork_attr("siderealtime")(*args, **kwargs)
+
+
+def elementval(*args, **kwargs):
+    """Compute orbital element values from a state representation."""
+    return _ork_attr("elementval")(*args, **kwargs)
+
+
+def pvt(*args, **kwargs):
+    """Convert an Orekit/object representation to PositionVelocityT."""
+    return _ork_attr("pvt")(*args, **kwargs)
+
+
+def allplane(*args, **kwargs):
+    return _ork_attr("allplane")(*args, **kwargs)
+
+
+def sma(*args, **kwargs):
+    """Compute semimajor axis from related orbit parameters."""
+    return _ork_attr("sma")(*args, **kwargs)
+
+
+def kepleranalytic(*args, **kwargs):
+    """Create a Kepler-only Orekit force environment."""
+    return _ork_attr("kepleranalytic")(*args, **kwargs)
+
+
+def tselements(*args, **kwargs):
+    """Build a TimeSeries of orbital elements from one or more states."""
+    return _ork_attr("tselements")(*args, **kwargs)
+
+
+def __getattr__(name):
+    """Fallback lazy Orekit symbol exposure for advanced/internal use."""
+    if name in ("element_hdf5", "posvel_hdf5", "spacetrack_hdf5"):
+        if hasattr(_core, name):
+            value = getattr(_core, name)
+            globals()[name] = value
+            return value
+        raise AttributeError(f"module 'tellurion' has no attribute '{name}'")
+
+    try:
+        value = _ork_attr(name)
+    except AttributeError as exc:
+        raise AttributeError(f"module 'tellurion' has no attribute '{name}'") from exc
+    globals()[name] = value
+    return value
+
+
+__all__ = [
+    "__version__",
+    "ElementSetT",
+    "EarthObservationT",
+    "MeanElementSetT",
+    "PVT",
+    "PositionBase",
+    "PositionT",
+    "PositionVelocityT",
+    "abstime",
+    "allplane",
+    "azelrange",
+    "change_units",
+    "circular",
+    "circeltma_names",
+    "circeltta_names",
+    "circtimeelements",
+    "dragforce",
+    "earthloc",
+    "elev",
+    "elementval",
+    "equeltma_names",
+    "equeltta_names",
+    "equinoctial",
+    "equtimeelements",
+    "from_array",
+    "fromtime",
+    "gnuserid",
+    "gravconstunits",
+    "hcat",
+    "hstack",
+    "init_orekit",
+    "iscircels",
+    "isequels",
+    "iskepels",
+    "kepeltma_names",
+    "kepeltta_names",
+    "kepler",
+    "kepleranalytic",
+    "location",
+    "magdiff",
+    "make_quantity",
+    "normalizeangle",
+    "orkunits",
+    "obsdict1",
+    "prefunits",
+    "nullisland",
+    "observer_location",
+    "orekit_available",
+    "prefnumabstime",
+    "prepare",
+    "propagate",
+    "pvt",
+    "pvtcart",
+    "quantity_to_array",
+    "quantity_to_dict",
+    "rev",
+    "revolution",
+    "setgravity",
+    "siderealtime",
+    "satdata",
+    "sfdict",
+    "siunits",
+    "sifloat",
+    "sma",
+    "spacetrack_latest",
+    "statefnval",
+    "stscdata",
+    "striptime",
+    "tc",
+    "timeelements",
+    "time_concat",
+    "timesec",
+    "to_array",
+    "tselements",
+    "tq",
+    "userid",
+    "vstack",
+]
+
+for _opt_name in ("element_hdf5", "posvel_hdf5", "spacetrack_hdf5"):
+    if hasattr(_core, _opt_name):
+        __all__.append(_opt_name)
+
+# Mapping of parameter names to their clean signature representations for Sphinx/help()
+_CLEAN_PARAM_REPRS = {
+    "forceenv": "force.deffe",
+    "unitlookup": "units.prefunits",
+}
+
+# Synchronize docstrings, signatures, and clean defaults from
+# tellurion.ork onto top-level wrappers
+try:
+    import tellurion.ork as _ork_module
+
+    for _name in __all__:
+        _wrapper = globals().get(_name)
+        if callable(_wrapper) and hasattr(_ork_module, _name):
+            _impl = getattr(_ork_module, _name)
+
+            # 1. Sync Docstrings
+            if hasattr(_impl, "__doc__") and _impl.__doc__:
+                _wrapper.__doc__ = _impl.__doc__
+
+            # 2. Sync Signatures & Format Defaults
+            try:
+                sig = inspect.signature(_impl)
+                new_params = []
+                for param_name, param in sig.parameters.items():
+                    if param_name in _CLEAN_PARAM_REPRS:
+                        display_str = _CLEAN_PARAM_REPRS[param_name]
+
+                        class _DefaultDisplay:
+                            def __init__(self, repr_str):
+                                self._repr_str = repr_str
+
+                            def __repr__(self):
+                                return self._repr_str
+
+                        param = param.replace(default=_DefaultDisplay(display_str))
+                    new_params.append(param)
+
+                _wrapper.__signature__ = sig.replace(parameters=new_params)
+            except (ValueError, TypeError):
+                pass
+except Exception:
+    # Gracefully handle missing Orekit/Java dependencies during bare import
+    pass

tellurion-0.1.0/tellurion/astro/__init__.py

@@ -0,0 +1,61 @@
+"""Public exports for tellurion.astro."""
+
+from tellurion.astro.quantity_utils import (
+    change_units,
+    hstack,
+    make_quantity,
+    quantity_to_array,
+    quantity_to_dict,
+    sifloat,
+    vstack,
+)
+from tellurion.astro.time import (
+    abstime,
+    from_array,
+    fromtime,
+    hcat,
+    prefnumabstime,
+    striptime,
+    tc,
+    time_concat,
+    timesec,
+    to_array,
+    tq,
+)
+from tellurion.astro.units import (
+    gravconstunits,
+    normalizeangle,
+    orkunits,
+    prefunits,
+    rev,
+    revolution,
+    siunits,
+)
+
+__all__ = [
+    "abstime",
+    "change_units",
+    "from_array",
+    "fromtime",
+    "gravconstunits",
+    "hcat",
+    "hstack",
+    "make_quantity",
+    "normalizeangle",
+    "orkunits",
+    "prefunits",
+    "prefnumabstime",
+    "quantity_to_array",
+    "quantity_to_dict",
+    "rev",
+    "revolution",
+    "siunits",
+    "sifloat",
+    "striptime",
+    "tc",
+    "time_concat",
+    "timesec",
+    "to_array",
+    "tq",
+    "vstack",
+]