/*! * \file gps_cnav_ephemeris.h * \brief Interface of a GPS CNAV EPHEMERIS storage * \author Javier Arribas, 2015. jarribas(at)cttc.es * * ------------------------------------------------------------------------- * * Copyright (C) 2010-2019 (see AUTHORS file for a list of contributors) * * GNSS-SDR is a software defined Global Navigation * Satellite Systems receiver * * This file is part of GNSS-SDR. * * SPDX-License-Identifier: GPL-3.0-or-later * * ------------------------------------------------------------------------- */ #ifndef GNSS_SDR_GPS_CNAV_EPHEMERIS_H #define GNSS_SDR_GPS_CNAV_EPHEMERIS_H #include #include /*! * \brief This class is a storage and orbital model functions for the GPS SV ephemeris data as described in IS-GPS-200K * * See https://www.gps.gov/technical/icwg/IS-GPS-200K.pdf Appendix III */ class Gps_CNAV_Ephemeris { public: /*! * Default constructor */ Gps_CNAV_Ephemeris() = default; /*! * \brief Compute the ECEF SV coordinates and ECEF velocity * Implementation of Table 20-IV (IS-GPS-200K) */ double satellitePosition(double transmitTime); /*! * \brief Sets (\a d_satClkDrift)and returns the clock drift in seconds according to the User Algorithm for SV Clock Correction * (IS-GPS-200K, 20.3.3.3.3.1) */ double sv_clock_drift(double transmitTime); /*! * \brief Sets (\a d_dtr) and returns the clock relativistic correction term in seconds according to the User Algorithm for SV Clock Correction * (IS-GPS-200K, 20.3.3.3.3.1) */ double sv_clock_relativistic_term(double transmitTime); uint32_t i_satellite_PRN{}; // SV PRN NUMBER // Message Types 10 and 11 Parameters (1 of 2) int32_t i_GPS_week{}; //!< GPS week number, aka WN [week] int32_t i_URA{}; //!< ED Accuracy Index int32_t i_signal_health{}; //!< Signal health (L1/L2/L5) int32_t d_Top{}; //!< Data predict time of week double d_DELTA_A{}; //!< Semi-major axis difference at reference time double d_A_DOT{}; //!< Change rate in semi-major axis double d_Delta_n{}; //!< Mean Motion Difference From Computed Value [semi-circles/s] double d_DELTA_DOT_N{}; //!< Rate of mean motion difference from computed value double d_M_0{}; //!< Mean Anomaly at Reference Time [semi-circles] double d_e_eccentricity{}; //!< Eccentricity double d_OMEGA{}; //!< Argument of Perigee [semi-cicles] double d_OMEGA0{}; //!< Longitude of Ascending Node of Orbit Plane at Weekly Epoch [semi-cicles] int32_t d_Toe1{}; //!< Ephemeris data reference time of week (Ref. 20.3.3.4.3 IS-GPS-200K) [s] int32_t d_Toe2{}; //!< Ephemeris data reference time of week (Ref. 20.3.3.4.3 IS-GPS-200K) [s] double d_DELTA_OMEGA_DOT{}; //!< Rate of Right Ascension difference [semi-circles/s] double d_i_0{}; //!< Inclination Angle at Reference Time [semi-circles] double d_IDOT{}; //!< Rate of Inclination Angle [semi-circles/s] double d_Cis{}; //!< Amplitude of the Sine Harmonic Correction Term to the Angle of Inclination [rad] double d_Cic{}; //!< Amplitude of the Cosine Harmonic Correction Term to the Angle of Inclination [rad] double d_Crs{}; //!< Amplitude of the Sine Harmonic Correction Term to the Orbit Radius [m] double d_Crc{}; //!< Amplitude of the Cosine Harmonic Correction Term to the Orbit Radius [m] double d_Cus{}; //!< Amplitude of the Sine Harmonic Correction Term to the Argument of Latitude [rad] double d_Cuc{}; //!< Amplitude of the Cosine Harmonic Correction Term to the Argument of Latitude [rad] // Clock Correction and Accuracy Parameters int32_t d_Toc{}; //!< clock data reference time (Ref. 20.3.3.3.3.1 IS-GPS-200K) [s] double d_A_f0{}; //!< Coefficient 0 of code phase offset model [s] double d_A_f1{}; //!< Coefficient 1 of code phase offset model [s/s] double d_A_f2{}; //!< Coefficient 2 of code phase offset model [s/s^2] double d_URA0{}; //!< NED Accuracy Index double d_URA1{}; //!< NED Accuracy Change Index double d_URA2{}; //!< NED Accuracy Change Rate Index // Group Delay Differential Parameters double d_TGD{}; //!< Estimated Group Delay Differential: L1-L2 correction term only for the benefit of "L1 P(Y)" or "L2 P(Y)" s users [s] double d_ISCL1{}; double d_ISCL2{}; double d_ISCL5I{}; double d_ISCL5Q{}; int32_t d_TOW{}; //!< Time of GPS Week of the ephemeris set (taken from subframes TOW) [s] // clock terms derived from ephemeris data double d_satClkDrift{}; //!< GPS clock error double d_dtr{}; //!< relativistic clock correction term // satellite positions double d_satpos_X{}; //!< Earth-fixed coordinate x of the satellite [m]. Intersection of the IERS Reference Meridian (IRM) and the plane passing through the origin and normal to the Z-axis. double d_satpos_Y{}; //!< Earth-fixed coordinate y of the satellite [m]. Completes a right-handed, Earth-Centered, Earth-Fixed orthogonal coordinate system. double d_satpos_Z{}; //!< Earth-fixed coordinate z of the satellite [m]. The direction of the IERS (International Earth Rotation and Reference Systems Service) Reference Pole (IRP). // Satellite velocity double d_satvel_X{}; //!< Earth-fixed velocity coordinate x of the satellite [m] double d_satvel_Y{}; //!< Earth-fixed velocity coordinate y of the satellite [m] double d_satvel_Z{}; //!< Earth-fixed velocity coordinate z of the satellite [m] /*! \brief If true, enhanced level of integrity assurance. * * If false, indicates that the conveying signal is provided with the legacy level of integrity assurance. * That is, the probability that the instantaneous URE of the conveying signal exceeds 4.42 times the upper bound * value of the current broadcast URA index, for more than 5.2 seconds, without an accompanying alert, is less * than 1E-5 per hour. If true, indicates that the conveying signal is provided with an enhanced level of * integrity assurance. That is, the probability that the instantaneous URE of the conveying signal exceeds 5.73 * times the upper bound value of the current broadcast URA index, for more than 5.2 seconds, without an * accompanying alert, is less than 1E-8 per hour. */ bool b_integrity_status_flag{}; bool b_l2c_phasing_flag{}; bool b_alert_flag{}; //!< If true, indicates that the SV URA may be worse than indicated in d_SV_accuracy, use that SV at our own risk. bool b_antispoofing_flag{}; //!< If true, the AntiSpoofing mode is ON in that SV template /*! * \brief Serialize is a boost standard method to be called by the boost XML serialization. Here is used to save the ephemeris data on disk file. */ inline void serialize(Archive& archive, const uint32_t version) { using boost::serialization::make_nvp; if (version) { }; archive& make_nvp("i_satellite_PRN", i_satellite_PRN); // SV PRN NUMBER archive& make_nvp("d_TOW", d_TOW); //!< Time of GPS Week of the ephemeris set (taken from subframes TOW) [s] archive& make_nvp("d_Crs", d_Crs); //!< Amplitude of the Sine Harmonic Correction Term to the Orbit Radius [m] archive& make_nvp("d_M_0", d_M_0); //!< Mean Anomaly at Reference Time [semi-circles] archive& make_nvp("d_Cuc", d_Cuc); //!< Amplitude of the Cosine Harmonic Correction Term to the Argument of Latitude [rad] archive& make_nvp("d_e_eccentricity", d_e_eccentricity); //!< Eccentricity [dimensionless] archive& make_nvp("d_Cus", d_Cus); //!< Amplitude of the Sine Harmonic Correction Term to the Argument of Latitude [rad] archive& make_nvp("d_Toe1", d_Toe1); //!< Ephemeris data reference time of week (Ref. 20.3.3.4.3 IS-GPS-200K) [s] archive& make_nvp("d_Toe2", d_Toe2); //!< Ephemeris data reference time of week (Ref. 20.3.3.4.3 IS-GPS-200K) [s] archive& make_nvp("d_Toc", d_Toc); //!< clock data reference time (Ref. 20.3.3.3.3.1 IS-GPS-200K) [s] archive& make_nvp("d_Cic", d_Cic); //!< Amplitude of the Cosine Harmonic Correction Term to the Angle of Inclination [rad] archive& make_nvp("d_OMEGA0", d_OMEGA0); //!< Longitude of Ascending Node of Orbit Plane at Weekly Epoch [semi-circles] archive& make_nvp("d_Cis", d_Cis); //!< Amplitude of the Sine Harmonic Correction Term to the Angle of Inclination [rad] archive& make_nvp("d_i_0", d_i_0); //!< Inclination Angle at Reference Time [semi-circles] archive& make_nvp("d_Crc", d_Crc); //!< Amplitude of the Cosine Harmonic Correction Term to the Orbit Radius [m] archive& make_nvp("d_OMEGA", d_OMEGA); //!< Argument of Perigee [semi-cicles] archive& make_nvp("d_IDOT", d_IDOT); //!< Rate of Inclination Angle [semi-circles/s] archive& make_nvp("i_GPS_week", i_GPS_week); //!< GPS week number, aka WN [week] archive& make_nvp("d_TGD", d_TGD); //!< Estimated Group Delay Differential: L1-L2 correction term only for the benefit of "L1 P(Y)" or "L2 P(Y)" s users [s] archive& make_nvp("d_ISCL1", d_ISCL1); //!< Estimated Group Delay Differential: L1P(Y)-L1C/A correction term only for the benefit of "L1 P(Y)" or "L2 P(Y)" s users [s] archive& make_nvp("d_ISCL2", d_ISCL2); //!< Estimated Group Delay Differential: L1P(Y)-L2C correction term only for the benefit of "L1 P(Y)" or "L2 P(Y)" s users [s] archive& make_nvp("d_ISCL5I", d_ISCL5I); //!< Estimated Group Delay Differential: L1P(Y)-L5i correction term only for the benefit of "L1 P(Y)" or "L2 P(Y)" s users [s] archive& make_nvp("d_ISCL5Q", d_ISCL5Q); //!< Estimated Group Delay Differential: L1P(Y)-L5q correction term only for the benefit of "L1 P(Y)" or "L2 P(Y)" s users [s] archive& make_nvp("d_DELTA_A", d_DELTA_A); //!< Semi-major axis difference at reference time [m] archive& make_nvp("d_A_DOT", d_A_DOT); //!< Change rate in semi-major axis [m/s] archive& make_nvp("d_DELTA_OMEGA_DOT", d_DELTA_OMEGA_DOT); //!< Rate of Right Ascension difference [semi-circles/s] archive& make_nvp("d_A_f0", d_A_f0); //!< Coefficient 0 of code phase offset model [s] archive& make_nvp("d_A_f1", d_A_f1); //!< Coefficient 1 of code phase offset model [s/s] archive& make_nvp("d_A_f2", d_A_f2); //!< Coefficient 2 of code phase offset model [s/s^2] archive& make_nvp("b_integrity_status_flag", b_integrity_status_flag); archive& make_nvp("b_alert_flag", b_alert_flag); //!< If true, indicates that the SV URA may be worse than indicated in d_SV_accuracy, use that SV at our own risk. archive& make_nvp("b_antispoofing_flag", b_antispoofing_flag); //!< If true, the AntiSpoofing mode is ON in that SV } private: double check_t(double time); }; #endif