Remove build and data folders, move tests and utils to the base of the source tree

2025-10-22 11:07:41 +00:00 · 2024-10-04 11:55:09 +02:00
parent 5be2971c9b
commit 825037592a
251 changed files with 154 additions and 179 deletions
--- a/utils/front-end-cal/front_end_cal.h
+++ b/utils/front-end-cal/front_end_cal.h
@@ -0,0 +1,129 @@
+/*!
+ * \file front_end_cal.h
+ * \brief Interface of the Front-end calibration program.
+ * \author Javier Arribas, 2013. jarribas(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_FRONT_END_CAL_H
+#define GNSS_SDR_FRONT_END_CAL_H
+
+#include <armadillo>
+#include <memory>
+#include <string>
+
+class ConfigurationInterface;
+
+class FrontEndCal
+{
+public:
+    FrontEndCal() = default;
+    ~FrontEndCal() = default;
+
+    /*!
+     * \brief Sets the configuration data required by get_ephemeris function
+     *
+     */
+    void set_configuration(std::shared_ptr<ConfigurationInterface> configuration);
+
+    /*!
+     * \brief This function connects to a Secure User Location Protocol (SUPL) server to obtain
+     * the current GPS ephemeris and GPS assistance data. It requires the configuration parameters set by
+     * set_configuration function.
+     *
+     */
+    bool get_ephemeris();
+
+    /*!
+     * \brief This function estimates the GPS L1 satellite Doppler frequency [Hz] using the following data:
+     * 1- Orbital model from the ephemeris
+     * 2- Approximate GPS Time of Week (TOW)
+     * 3- Approximate receiver Latitude and Longitude (WGS-84)
+     *
+     */
+    double estimate_doppler_from_eph(unsigned int PRN, double tow, double lat, double lon, double height) noexcept(false);
+
+    /*!
+     * \brief This function models the Elonics E4000 + RTL2832 front-end
+     * Inputs:
+     *  f_bb_true_Hz    - Ideal output frequency in baseband [Hz]
+     *  f_in_bb_meas_Hz - measured output frequency in baseband [Hz]
+     * Outputs:
+     *  estimated_fs_Hz  - Sampling frequency estimation based on the
+     *  measurements and the front-end model
+     *  estimated_f_if_bb_Hz - Equivalent bb if frequency estimation based on the
+     *  measurements and the front-end model
+     *  Front-end TUNER Elonics E4000 + RTL2832 sampler For GPS L1 1575.42 MHz
+     *
+     */
+    void GPS_L1_front_end_model_E4000(double f_bb_true_Hz, double f_bb_meas_Hz, double fs_nominal_hz, double *estimated_fs_Hz, double *estimated_f_if_Hz, double *f_osc_err_ppm);
+
+private:
+    std::shared_ptr<ConfigurationInterface> configuration_;
+
+    /*
+     * LLA2ECEF Convert geodetic coordinates to Earth-centered Earth-fixed
+     * (ECEF)  coordinates. P = LLA2ECEF( LLA ) converts an M-by-3 array of geodetic coordinates
+     * (latitude, longitude and altitude), LLA, to an M-by-3 array of ECEF
+     * coordinates, P.  LLA is in [degrees degrees meters].  P is in meters.
+     * The default ellipsoid planet is WGS84. Original copyright (c) by Kai Borre.
+     */
+    arma::vec lla2ecef(const arma::vec &lla);
+
+    /*
+     * GEODETIC2ECEF Convert geodetic to geocentric (ECEF) coordinates
+     * [X, Y, Z] = GEODETIC2ECEF(PHI, LAMBDA, H, ELLIPSOID) converts geodetic
+     * point locations specified by the coordinate arrays PHI (geodetic
+     * latitude in radians), LAMBDA (longitude in radians), and H (ellipsoidal
+     * height) to geocentric Cartesian coordinates X, Y, and Z.  The geodetic
+     * coordinates refer to the reference ellipsoid specified by ELLIPSOID (a
+     * row vector with the form [semimajor axis, eccentricity]).  H must use
+     * the same units as the semimajor axis;  X, Y, and Z will be expressed in
+     * these units also.
+     *
+     * The geocentric Cartesian coordinate system is fixed with respect to the
+     * Earth, with its origin at the center of the ellipsoid and its X-, Y-,
+     * and Z-axes intersecting the surface at the following points:
+     * PHI  LAMBDA
+     * X-axis:    0     0      (Equator at the Prime Meridian)
+     * Y-axis:    0   pi/2     (Equator at 90-degrees East
+     * Z-axis:  pi/2    0      (North Pole)
+     *
+     * A common synonym is Earth-Centered, Earth-Fixed coordinates, or ECEF.
+     *
+     * See also ECEF2GEODETIC, ECEF2LV, GEODETIC2GEOCENTRICLAT, LV2ECEF.
+     *
+     * Copyright 2004-2009 The MathWorks, Inc.
+     * $Revision: 1.1.6.4 $  $Date: 2009/04/15 23:34:46 $
+     * Reference
+     * ---------
+     * Paul R. Wolf and Bon A. Dewitt, "Elements of Photogrammetry with
+     * Applications in GIS," 3rd Ed., McGraw-Hill, 2000 (Appendix F-3).
+     */
+    arma::vec geodetic2ecef(double phi, double lambda, double h, const arma::vec &ellipsoid);
+
+    /*
+     * Reads the ephemeris data from an external XML file
+     */
+    bool read_assistance_from_XML();
+
+    /*
+     * Connects to Secure User Location Protocol (SUPL) server to obtain
+     * the current GPS ephemeris and GPS assistance data.
+     */
+    int Get_SUPL_Assist();
+
+    const std::string eph_default_xml_filename = "./gps_ephemeris.xml";
+};
+
+#endif