• MPCQ

Python client library for querying MPC data through BigQuery.

Python Client for MPC BigQuery Database

mpcq is a Python client library for querying Minor Planet Center (MPC) data through Google BigQuery. The library provides access to a BigQuery replica of the Small Bodies Node (SBN) database for efficient querying of asteroid observation data.

Key features:

  • BigQuery integration: Access to a complete replica of the MPC database
  • Query patterns: Pre-built patterns for common asteroid data operations
  • Data access: Query observations, orbits, identifications, and submission history
  • Cross-matching: Match observations and find duplicates across datasets
  • Format support: Utilities for ADES, CSV, and Parquet formats

Examples

from mpcq.client import BigQueryMPCClient

# Initialize with your BigQuery dataset
client = BigQueryMPCClient(
    dataset_id="your_main_dataset_id",
    views_dataset_id="your_views_dataset_id"
)

# Query observations for any asteroid
observations = client.query_observations(["2013 RR165"])

# Cross-match your data with MPC
matched = client.cross_match_observations(
    your_observations,
    obstime_tolerance_seconds=30,
    arcseconds_tolerance=2.0
)

Provides access to over 479 million asteroid observations through Google BigQuery. Documentation available at mpcq.readthedocs.io.