satcatalogquery 0.2.1

A package to handle the space targets catalogue query

Welcome to the SATQUERY package

This package is an archive of scientific routines for data processing related to the space targets catalogue query. Currently, operations on targets catalogue query include:

1. targets catalogue query on shape info from DISCOS(Database and Information System Characterising Objects in Space) database;
2. targets catalogue query on orbit info from CelesTrak database;
3. targets catalogue query on both shape and orbit from a combined database;

How to Install

On Linux, macOS and Windows architectures, the binary wheels can be installed using pip by executing one of the following commands:

pip install satcatalogquery
pip install satcatalogquery --upgrade # to upgrade a pre-existing installation

How to use

Targets catalogue query from DISCOS

Query by NORAD_ID, where type of NORAD_ID can be int/str, list of int/str, or a text file named satno.txt in the following format:

# satno
52132
51454
37637
26758
44691

>>> from satcatalogquery import discos_query
>>> satcatlog = discos_query(NORAD_ID=[52132,51454,37637,26758,44691])
>>> # satcatog = discos_query(NORAD_ID='satno.txt')
>>> satcatlog.df # output pandas dataframe
>>> satcatlog.save() # save dataframe to .csv file

Query by mutiple options at the same time, such as COSPAR_ID, MASS, SHAPE, RCSAvg, etc.

>>> from satcatalogquery import discos_query
>>> satcatlog = discos_query(SHAPE=['Box','Pan'],RCSAvg=[0.5,100],DECAYED=False)

Targets catalogue query from CelesTrak

>>> from satcatalogquery import celestrak_query
>>> satcatlog = celestrak_query(MEAN_ALT=[300,2000],ECC=[0.01,0.1],PAYLOAD=False)

Targets catalogue query from combined database

>>> from satcatalogquery import targets_query
>>> satcatlog = targets_query(DECAYED=False,RCSAvg=[0.25,1e4],MEAN_ALT=[250,2000],TLE_STATUS=True,sort='RCSAvg')

Create object SatCatlog from a loacl .csv file

>>> from satcatalogquery import SatCatlog
>>> satcatlog = SatCatlog.from_csv('filename.csv')

Statistics

>>> satcatlog.hist1d('RCSAvg')
>>> satcatlog.hist1d(['StdMag','LAUNCH_DATE'])
>>> satcatlog.hist2d('MEAN_ALT','INCLINATION')
>>> satcatlog.pie('LAUNCH_SITE',cutoff=100)

Download TLE from results of targets catalogue query

>>> tle_path = satcatlog.get_tle()

Change log

• 0.2.1 — Jan 4, 2023

  • Add method from_csv and pie to class SatCatlog

  • Add statistics figures to README.md

• 0.1.1 — Jan 2, 2023

  • The satcatalogquery package was released.

Reference

• DISCOSweb
• CelesTrak and SATCAT Format Documentation
• Space-Track