mirror of
https://github.com/gnss-sdr/gnss-sdr
synced 2026-07-20 01:48:52 +00:00
112 lines
4.7 KiB
C++
112 lines
4.7 KiB
C++
/*!
|
|
* \file pvt_solution.h
|
|
* \brief Interface of a base class for a PVT solution
|
|
* \author Carles Fernandez-Prades, 2015. cfernandez(at)cttc.es
|
|
*
|
|
*
|
|
* -----------------------------------------------------------------------------
|
|
*
|
|
* GNSS-SDR is a Global Navigation Satellite System software-defined receiver.
|
|
* This file is part of GNSS-SDR.
|
|
*
|
|
* Copyright (C) 2010-2020 (see AUTHORS file for a list of contributors)
|
|
* SPDX-License-Identifier: GPL-3.0-or-later
|
|
*
|
|
* -----------------------------------------------------------------------------
|
|
*/
|
|
|
|
#ifndef GNSS_SDR_PVT_SOLUTION_H
|
|
#define GNSS_SDR_PVT_SOLUTION_H
|
|
|
|
#include <boost/date_time/posix_time/posix_time.hpp>
|
|
#include <array>
|
|
#include <cstdint>
|
|
|
|
/** \addtogroup PVT
|
|
* \{ */
|
|
/** \addtogroup PVT_libs
|
|
* \{ */
|
|
|
|
|
|
/*!
|
|
* \brief Base class for a PVT solution
|
|
*
|
|
*/
|
|
class Pvt_Solution
|
|
{
|
|
public:
|
|
Pvt_Solution() = default;
|
|
virtual ~Pvt_Solution() = default;
|
|
|
|
virtual double get_hdop() const = 0;
|
|
virtual double get_vdop() const = 0;
|
|
virtual double get_pdop() const = 0;
|
|
virtual double get_gdop() const = 0;
|
|
|
|
std::array<double, 3> get_rx_pos() const;
|
|
std::array<double, 3> get_rx_vel() const;
|
|
boost::posix_time::ptime get_position_UTC_time() const;
|
|
double get_latitude() const; //!< Get RX position Latitude WGS84 [deg]
|
|
double get_longitude() const; //!< Get RX position Longitude WGS84 [deg]
|
|
double get_height() const; //!< Get RX position height WGS84 [m]
|
|
double get_time_offset_s() const; //!< Get RX time offset [s]
|
|
double get_clock_drift_ppm() const; //!< Get the Rx clock drift [ppm]
|
|
double get_speed_over_ground() const; //!< Get RX speed over ground [m/s]
|
|
double get_course_over_ground() const; //!< Get RX course over ground [deg]
|
|
int get_num_valid_observations() const; //!< Get the number of valid pseudorange observations (valid satellites)
|
|
int32_t get_ref_gps_week() const; //!< Get the reference GPS week used to resolve the mod-1024 week rollover (0 if unset)
|
|
bool is_valid_position() const;
|
|
|
|
void set_rx_pos(const std::array<double, 3> &pos); //!< Set position: X, Y, Z in Cartesian ECEF coordinates [m]
|
|
void set_rx_vel(const std::array<double, 3> &vel); //!< Set velocity: East [m/s], North [m/s], Up [m/s]
|
|
void set_position_UTC_time(const boost::posix_time::ptime &pt);
|
|
void set_time_offset_s(double offset); //!< Set RX time offset [s]
|
|
void set_clock_drift_ppm(double clock_drift_ppm); //!< Set the Rx clock drift [ppm]
|
|
void set_speed_over_ground(double speed_m_s); //!< Set RX speed over ground [m/s]
|
|
void set_course_over_ground(double cog_deg); //!< Set RX course over ground [deg]
|
|
void set_valid_position(bool is_valid);
|
|
void set_num_valid_observations(int num); //!< Set the number of valid pseudorange observations (valid satellites)
|
|
void set_ref_gps_week(int32_t ref_week); //!< Set the reference GPS week (e.g., derived from the date of signal capture) used to resolve the mod-1024 week rollover in post-processing mode
|
|
|
|
private:
|
|
/*
|
|
* Conversion of Cartesian coordinates (X,Y,Z) to geographical
|
|
* coordinates (d_latitude_d, d_longitude_d, d_height_m) on a selected reference ellipsoid.
|
|
*
|
|
* \param[in] X [m] Cartesian coordinate
|
|
* \param[in] Y [m] Cartesian coordinate
|
|
* \param[in] Z [m] Cartesian coordinate
|
|
* \param[in] elipsoid_selection. Choices of Reference Ellipsoid for Geographical Coordinates:
|
|
* 0 - International Ellipsoid 1924.
|
|
* 1 - International Ellipsoid 1967.
|
|
* 2 - World Geodetic System 1972.
|
|
* 3 - Geodetic Reference System 1980.
|
|
* 4 - World Geodetic System 1984.
|
|
*
|
|
*/
|
|
int cart2geo(double X, double Y, double Z, int elipsoid_selection);
|
|
|
|
std::array<double, 3> d_rx_pos{};
|
|
std::array<double, 3> d_rx_vel{};
|
|
boost::posix_time::ptime d_position_UTC_time;
|
|
|
|
double d_latitude_d{0.0}; // RX position Latitude WGS84 [deg]
|
|
double d_longitude_d{0.0}; // RX position Longitude WGS84 [deg]
|
|
double d_height_m{0.0}; // RX position height WGS84 [m]
|
|
double d_rx_dt_s{0.0}; // RX time offset [s]
|
|
double d_rx_clock_drift_ppm{0.0}; // RX clock drift [ppm]
|
|
double d_speed_over_ground_m_s{0.0}; // RX speed over ground [m/s]
|
|
double d_course_over_ground_d{0.0}; // RX course over ground [deg]
|
|
|
|
int d_valid_observations{0}; // Number of valid observations in this epoch
|
|
|
|
int32_t d_ref_gps_week{0}; // Reference GPS week to correct the mod-1024 week rollover in post-processing mode (0: use system clock)
|
|
|
|
bool d_valid_position{false};
|
|
};
|
|
|
|
|
|
/** \} */
|
|
/** \} */
|
|
#endif // GNSS_SDR_PVT_SOLUTION_H
|