2020-02-27 17:42:43 +00:00
|
|
|
## Rinex2assist
|
2018-11-24 22:43:48 +00:00
|
|
|
|
2020-02-27 18:50:08 +00:00
|
|
|
<!-- prettier-ignore-start -->
|
2020-02-08 09:52:42 +00:00
|
|
|
[comment]: # (
|
|
|
|
SPDX-License-Identifier: GPL-3.0-or-later
|
|
|
|
)
|
|
|
|
|
|
|
|
[comment]: # (
|
2020-02-27 18:50:08 +00:00
|
|
|
SPDX-FileCopyrightText: 2019-2020 Carles Fernandez-Prades <carles.fernandez@cttc.es>
|
2020-02-08 09:52:42 +00:00
|
|
|
)
|
2020-02-27 18:50:08 +00:00
|
|
|
<!-- prettier-ignore-end -->
|
2020-02-08 09:52:42 +00:00
|
|
|
|
2020-02-27 17:42:43 +00:00
|
|
|
This program reads data from RINEX navigation files and generates XML files that
|
|
|
|
can be read by GNSS-SDR as Assisted GNSS data.
|
2018-11-26 19:01:25 +00:00
|
|
|
|
|
|
|
### Building
|
|
|
|
|
2020-02-27 17:42:43 +00:00
|
|
|
This program is built along with GNSS-SDR if the options
|
|
|
|
`ENABLE_UNIT_TESTING_EXTRA` or `ENABLE_SYSTEM_TESTING_EXTRA` are set to `ON`
|
|
|
|
when calling CMake:
|
2018-11-26 19:01:25 +00:00
|
|
|
|
|
|
|
```
|
|
|
|
$ cmake -DENABLE_SYSTEM_TESTING_EXTRA=ON ..
|
|
|
|
$ make
|
2019-07-20 10:55:46 +00:00
|
|
|
$ sudo make install
|
2018-11-26 19:01:25 +00:00
|
|
|
```
|
|
|
|
|
2020-02-27 17:42:43 +00:00
|
|
|
The last step is optional. Without it, you will get the executable at
|
|
|
|
`../install/rinex2assist`.
|
2018-11-26 19:01:25 +00:00
|
|
|
|
2020-02-27 17:42:43 +00:00
|
|
|
The building requires two extra dependencies: the Boost Iostreams library and
|
|
|
|
the program `uncompress`:
|
2018-11-26 19:01:25 +00:00
|
|
|
|
2020-02-27 17:42:43 +00:00
|
|
|
- The Boost Iostreams library can be installed through a package:
|
|
|
|
- In Debian / Ubuntu: `sudo apt-get install libboost-iostreams-dev`
|
|
|
|
- In Fedora / CentOS: `sudo yum install boost-iostreams`
|
|
|
|
- In OpenSUSE: `sudo zypper install libboost_iostreams-devel`
|
|
|
|
- In Arch Linux: included in `boost-libs` package.
|
|
|
|
- In macOS: included in Macports / Homebrew `boost` package.
|
|
|
|
- The program `uncompress` is available by default in most UNIX and GNU/Linux
|
|
|
|
systems.
|
|
|
|
- In Fedora / CentOS: `sudo yum install ncompress`
|
|
|
|
- In OpenSUSE: `sudo zypper install ncompress`
|
2018-11-26 19:01:25 +00:00
|
|
|
|
|
|
|
### Usage
|
|
|
|
|
|
|
|
The usage is as follows:
|
2018-11-24 22:43:48 +00:00
|
|
|
|
|
|
|
```
|
2018-11-26 22:08:05 +00:00
|
|
|
$ rinex2assist /path/to/RINEX_nav_file
|
2018-11-24 22:43:48 +00:00
|
|
|
```
|
|
|
|
|
2020-02-27 17:42:43 +00:00
|
|
|
The argument is mandatory (the name of the RINEX navigation file). The name
|
|
|
|
`gps_ephemeris.xml` is given to the output if GPS NAV data is fould. If the
|
|
|
|
RINEX file contains Galileo data, the corresponding `gal_ephemeris.xml` file
|
|
|
|
will be generated. The program is also able to extract parameters of the UTC and
|
|
|
|
the Ionospheric models from the RINEX header, if available. They will be called
|
|
|
|
`gps_utc_model.xml`, `gps_iono.xml`, `gal_utc_model.xml` and `gal_iono.xml`.
|
2018-11-24 22:43:48 +00:00
|
|
|
|
2020-02-27 17:42:43 +00:00
|
|
|
There are some servers available for downloading recent RINEX navigation files.
|
|
|
|
For instance:
|
2018-11-24 22:43:48 +00:00
|
|
|
|
2020-02-27 17:42:43 +00:00
|
|
|
- NASA:
|
|
|
|
[ftp://cddis.gsfc.nasa.gov/pub/gnss/data/hourly/](ftp://gssc.esa.int/gnss/data/hourly/)
|
|
|
|
- ESA:
|
|
|
|
[ftp://gssc.esa.int/gnss/data/hourly/](ftp://gssc.esa.int/gnss/data/hourly/)
|
|
|
|
- UNAVCO:
|
|
|
|
[ftp://data-out.unavco.org/pub/hourly/rinex/](ftp://data-out.unavco.org/pub/hourly/rinex/)
|
2018-11-24 22:43:48 +00:00
|
|
|
|
2020-02-27 17:42:43 +00:00
|
|
|
Just make sure to pick up a recent file from a
|
|
|
|
[station near you](http://www.igs.org/network).
|
|
|
|
|
|
|
|
The program accepts either versions 2.xx or 3.xx for the RINEX navigation data
|
|
|
|
file, as well as compressed files (ending in `.gz` or `.Z`).
|
2018-11-25 11:29:56 +00:00
|
|
|
|
|
|
|
Examples:
|
|
|
|
|
|
|
|
```
|
|
|
|
$ rinex2assist EBRE00ESP_R_20183290400_01H_GN.rnx.gz
|
|
|
|
Generated file: gps_ephemeris.xml
|
|
|
|
Generated file: gps_utc_model.xml
|
|
|
|
Generated file: gps_iono.xml
|
|
|
|
```
|
|
|
|
|
|
|
|
and
|
|
|
|
|
|
|
|
```
|
|
|
|
$ rinex2assist EBRE00ESP_R_20183290000_01H_EN.rnx.gz
|
|
|
|
Generated file: gal_ephemeris.xml
|
|
|
|
Generated file: gal_utc_model.xml
|
|
|
|
Generated file: gal_iono.xml
|
|
|
|
```
|
|
|
|
|
2020-02-27 17:42:43 +00:00
|
|
|
An example of GNSS-SDR configuration using ephemeris, UTC and ionospheric model
|
|
|
|
parameters for GPS L1 and Galileo signals is shown below:
|
2018-11-24 22:43:48 +00:00
|
|
|
|
|
|
|
```
|
|
|
|
GNSS-SDR.AGNSS_XML_enabled=true
|
|
|
|
GNSS-SDR.AGNSS_ref_location=41.39,2.31
|
|
|
|
GNSS-SDR.AGNSS_gps_ephemeris_xml=gps_ephemeris.xml
|
|
|
|
GNSS-SDR.AGNSS_gps_iono_xml=gps_iono.xml
|
|
|
|
GNSS-SDR.AGNSS_gps_utc_model_xml=gps_utc_model.xml
|
|
|
|
GNSS-SDR.AGNSS_gal_ephemeris_xml=gal_ephemeris.xml
|
2020-02-27 17:42:43 +00:00
|
|
|
GNSS-SDR.AGNSS_gal_iono_xml=gal_iono.xml
|
2018-11-24 22:43:48 +00:00
|
|
|
GNSS-SDR.AGNSS_gal_utc_model_xml=gal_utc_model.xml
|
|
|
|
```
|
|
|
|
|
2020-02-27 17:42:43 +00:00
|
|
|
More info about the usage of AGNSS data
|
|
|
|
[here](https://gnss-sdr.org/docs/sp-blocks/global-parameters/#assisted-gnss-with-xml-files).
|