empyrean.query_sbdb

query_sbdb(names, cache_dir=None)[source]

Query JPL SBDB for orbital elements with covariance.

Parameters:

  • names (list[str]) – Object names or designations (e.g. ["Apophis", "67P"]).

  • cache_dir (str | Path | bool | None) –

    • None (default): cache JSON responses under $EMPYREAN_CACHE_DIR/sbdb (or ~/.empyrean/cache/sbdb if unset).

    • False: disable caching for this call.

    • explicit path: use this directory.

Return type:

CartesianOrbits | KeplerianOrbits | CometaryOrbits | SphericalOrbits

Returns:

quivr Orbits table – Cartesian / Keplerian / Cometary / Spherical orbits depending on what SBDB returned (cometary by convention for asteroid / comet records). Includes covariance and non-gravitational parameters when SBDB exposes them.