SatelliteDatabase.hpp

浏览该文件的文档.

 
 
 
#pragma once
 
#include "Database.hpp"
#include "AstUtil/StringView.hpp"
#include <string>
#include <vector>
 
AST_NAMESPACE_BEGIN
 
class SatelliteDatabaseEntry;
class SatelliteDatabaseQuery;
class TimePoint;
 
class AST_CORE_API SatelliteDatabase : public Database
{
public:
    using Entry = SatelliteDatabaseEntry;
    using EntryList = std::vector<SatelliteDatabaseEntry>;
 
    SatelliteDatabase();
    explicit SatelliteDatabase(StringView filePath);
    ~SatelliteDatabase() override;
 
    // -- 加载 --
    errc_t load(StringView filePath);
    errc_t reload();
    bool isLoaded() const { return loaded_; }
 
    const TimePoint& lastUpdateTime() const { return lastUpdateTime_; }
 
    // -- 底层查询 --
    const std::vector<std::string>&     getMissions() const;
    EntryList                           getEntries(const SatelliteDatabaseQuery& query) const;
    const EntryList&                    getEntries() const;
    size_t                              size() const { return entries_.size(); }
 
    const std::string& filePath() const { return filePath_; }
 
private:
    void refreshMissions();
 
    errc_t loadSatcatFile(StringView filePath);
 
private:
    std::string filePath_{};                          
    TimePoint lastUpdateTime_{};                      
    std::vector<SatelliteDatabaseEntry> entries_{};   
    std::vector<std::string> missions_{};             
    bool loaded_{false};                              
};
 
/*
celestrak SATCAT Legacy Text Data Format
参考：https://celestrak.org/satcat/satcat-format.php
 
Legacy Text Data Format:
 
------------------------------------------------------------------------------------------------------------------------------------
Column
000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000111111111111111111111111111111111
000000000111111111122222222223333333333444444444455555555556666666666777777777788888888889999999999000000000011111111112222222222333
123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012
------------------------------------------------------------------------------------------------------------------------------------
yyyy-nnnaaa  nnnnn M*O aaaaaaaaaaaaaaaaaaaaaaaa  aaaaa  yyyy-mm-dd  aaaaa  yyyy-mm-dd  nnnnn.n  nnn.n  nnnnnn  nnnnnn  nnn.nnnn  aaa
------------------------------------------------------------------------------------------------------------------------------------
Columns Description
001-011 International Designator
        - Launch Year (001-004)
        - Launch of the Year (006-008)
        - Piece of the Launch (009-011)
014-018 NORAD Catalog Number
020-020 Multiple Name Flag ("M" if multiple names exist; alternate names found in satcat-annex.csv)
021-021 Payload Flag ("*" if payload; blank otherwise)
022-022 Operational Status Code
024-047 Satellite Name(s)
        - R/B(1) = Rocket body, first stage
        - R/B(2) = Rocket body, second stage
        - DEB = Debris
        - PLAT = Platform
        - Items in parentheses are alternate names
        - Items in brackets indicate type of object
          (e.g., BREEZE-M DEB [TANK] = tank)
        - An ampersand (&) indicates two or more objects are attached
050-054 Source or Ownership
057-066 Launch Date [year-month-day]
069-073 Launch Site
076-085 Decay Date, if applicable [year-month-day]
088-094 Orbital period [minutes]; truncated at 99999.9
097-101 Inclination [degrees]
104-109 Apogee Altitude [kilometers]; truncated at 999999
112-117 Perigee Altitude [kilometers]; truncated at 999999
120-127 Radar Cross Section [meters2]; N/A if no data available
130-132 Orbital Status Code
        - NCE = No Current Elements
        - NIE = No Initial Elements
        - NEA = No Elements Available
        - DOC = Permanently Docked
        - ISS = Docked to International Space Station
        - XXN = Central Body (XX) and Orbit Type (N)
            - AS = Asteroid
            - EA = Earth (default if blank)
            - EL = Earth Lagrange
            - EM = Earth-Moon Barycenter
            - JU = Jupiter
            - MA = Mars
            - ME = Mercury
            - MO = Moon (Earth)
            - NE = Neptune
            - PL = Pluto
            - SA = Saturn
            - SS = Solar System Escape
            - SU = Sun
            - UR = Uranus
            - VE = Venus
            - 0 = Orbit
            - 1 = Landing
            - 2 = Impact
            - 3 = Roundtrip
        (e.g., SU0 = Heliocentric Orbit, MO2 = Lunar Impact)
 
*/
 
AST_NAMESPACE_END