discos

Interface to ESA’s DISCOS (Database and Information System Characterising Objects in Space).

This module provides access to the DISCOS database, which contains information about space objects including satellites, rocket bodies, and debris tracked by ESA.

Classes

DiscosQuery(token[, timeout, url])

A class to query the ESA DISCOS (Database and Information System Characterising Objects in Space) API.
class DiscosQuery(token: str, timeout: int | None = 10, url: str = 'https://discosweb.esoc.esa.int')[source]

Bases: object

A class to query the ESA DISCOS (Database and Information System Characterising Objects in Space) API.

__init__(token: str, timeout: int | None = 10, url: str = 'https://discosweb.esoc.esa.int')[source]

Initialize the DiscosQuery client.

Parameters:

  • token (str) – API authentication token from DISCOS.

  • timeout (int, optional) – Request timeout in seconds. Defaults to 10.

  • url (str, optional) – Base URL for the DISCOS API. Defaults to “https://discosweb.esoc.esa.int”.

query_object(sat_id: str | int, is_discos_id: bool = False, verbose: bool = True) → dict[str, any] | None[source]

Query object information from DISCOS using either a NORAD ID or a DISCOS ID.

Parameters:

  • sat_id (str | int) – The satellite identifier (NORAD ID or DISCOS ID).

  • is_discos_id (bool, optional) – If True, treats sat_id as a DISCOS internal ID. If False, treats it as a NORAD ID. Defaults to False.

  • verbose (bool, optional) – If True, prints status and error messages to the console. Defaults to True.

Returns:

A dictionary containing object attributes if successful, None otherwise.

Return type:

dict[str, Any] | None