Package: satcatalogquery
Welcome to the SATQUERY packageThis package is an archive of scientific routines for querying orbital and geometric information of space objects.
Currently, operations on objects catalogue query include:Query of spatial objects on geometric information from DISCOS(Database and Information System Characterising Objects in Space) database;Query of spatial objects on orbital information from CelesTrak database;Query of spatial objects on both geometric and orbital information from a combined database;How to InstallOn 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 installationHow to useObjects catalogue query from DISCOSQuery 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>>>fromsatcatalogqueryimportSatCatalog>>>satcatlog=SatCatalog.discos_query(NORAD_ID=[52132,51454,37637,26758,44691])>>># satcatog = SatCatalog.discos_query(NORAD_ID='satno.txt')>>>satcatlog.df# output pandas dataframe>>>satcatlog.to_csv()# save dataframe to .csv fileQuery by mutiple options at the same time, such as COSPAR_ID, MASS, SHAPE, RCSAvg, etc.>>>satcatlog=SatCatalog.discos_query(SHAPE=['Box','Pan'],RCSAvg=[0.5,10],DECAYED=False)Objects catalogue query from CelesTrak>>>satcatlog=SatCatalog.celestrak_query(MEAN_ALT=[300,2000],ECC=[0.01,0.1],PAYLOAD=False)Objects catalogue query from combined database>>>satcatlog=SatCatalog.objects_query(DECAYED=False,RCSAvg=[0.25,10],MEAN_ALT=[250,2000],TLE_STATUS=True,sort='RCSAvg')Create objectSatCatlogfrom a loacl .csv file>>>fromsatcatalogqueryimportSatCatalog>>>satcatlog=SatCatalog.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 Space-Track according to the results of objects catalogue query>>>tle_path=satcatlog.get_tle()Download TLE from Space-Track by Norad IDs>>>fromsatcatalogqueryimportdownload_tle>>>tle_file=download_tle([52132,51454,37637,26758,44691])>>>print(tle_file)Next, you may be interested inData processing related to TLE files.Change log0.2.4 — Dec 08, 2023Fixed a bug where a newline character was appended to the end of the string when reading tokens from a file.The download URL of qsmag.zip has been modified to solve the bug that caused the file download failure due to the original URL being invalid.0.2.3 — Sep 23, 2023Fixed the bug that when downloading TLE data from SpaceTrack, the automatically generated wrong authentication file due to incorrect user name or password input could no longer be updated.0.2.2 — Apr 24, 2023Change the method.save()to.to_csv()Add methods.discos_query(),.celestrak_query(),.objects_query()to class SatCatalogChange classSatCatlogtoSatCatalog0.2.1 — Jan 4, 2023Add methodfrom_csvandpieto class SatCatlogAdd statistics figures to README.md0.1.1 — Jan 2,  2023Thesatcatalogquerypackage was released.Next ReleaseAdded DISCOSweb API support for version2.0.0.Improve code structure and enrich technical documentation.ReferenceDISCOSwebCelesTrakandSATCAT Format DocumentationSpace-Track