External GNSS converters

Setting up external utilities

Be sur to have set $AUTORINO_ENV environment variable to point to the configuration file containing the environment section, typically the main configuration file (autorino_main_cfg.yml).

Once each manufacturer’s converter is downloaded and installed (see below), you need to set the path to each you need to set the converter paths in the environment section of the main configuration file.

To configure the external utilities, you can:

set the full executable’s paths in the environment section.
set the paths in your $PATH environment variable, and then simply set the executable’s names in the env configuration file.

The authors recommend the second option, as it is more flexible and easier to maintain.

Download external GNSS converters

To properly use the autorino package, you need to install the official GNSS raw data converters from the different GNSS manufacturers websites. You can find the official converters here:

Leica

converter here: mdb2rinex
Go in: Products & Services > Downloads > GNSS Products > GRxx receiver > Tools > MDB to RINEX Converter for LINUX.
see IGSMAIL-8341 for more details.

Septentrio

converter here: sbf2rin

Topcon

converter here: tps2rin
autorino will emulate it with wine. Be sure to have wine installed on your computer. Detailled precedure will be added soon.

BINEX

converter here: convbin
convbin is part of the RTKLIB package. You can install it from the RTKLIB (explorer version) github repository.

detailed procedure

git clone https://github.com/rtklibexplorer/RTKLIB.git
cd RTKLIB/app/consapp/convbin/gcc
make

The compiled binary convbin will be in the RTKLIB/app/consapp/convbin/gcc folder.

Trimble (official Linux converter)

Ask Trimble support for the official Linux converter t0xConverter.

Trimble (unofficial dockerized converter)

converter here: trm2rinex-docker-ovs
This docker image is a wrapper around Trimble’s official converter trm2rinex which is not available for Linux.
It relies on Trimble’s official converter for Windows ConvertToRinex provided by Trimble.

The necessary software will be downloaded automatically when building the Docker image. But here are the links for information:

Main download page on Trimble support website
Trimble RINEX Converter
- Version 3.14 (the one used by the Docker)
Trimble Office Configuration Utility (companion software)
- Direct download link

Trimble’s runpkr00

for legacy RINEX2 conversion with teqc converter here: runpkr00

teqc

for legacy RINEX2 conversion with the well-known but discontinued UNAVCO’s teqc software converter here: teqc

RINEX handling software

You might also need RINEX handeling software:

teqc (for legacy RINEX2 only)
GFZRNX
IGN’s converto

Important

GFZRNX usage is not allowed in routine mode without a proper commercial license. Be sure to comply with it.

The authors of autorino are not responsible for any misuse of GFZRNX without license.

A recommended receipe for setting up the external utilities

Create a directory for the GNSS converters in your prefered location, e.g. your $HOME.

mkdir /your/favorite/location/converters_gnss
cd /your/favorite/location/converters_gnss

Create a subdirectory with a version name, typically the date of the download.

mkdir vYYYYMMDD

Copy the GNSS converters in the version directory. Do not forget to make each of them executable with chmod +x
Create a symbolic link called operational, pointing to the version directory.

ln -s vYYYYMMDD operational

Edit your .bashrc or .bash_profile file to add the operationnal virtual folder to your $PATH, and then make its content available in the whole environnement.

export PATH=$PATH:/your/favorite/location/converters_gnss/operational

If you want to update some conversion software, create a new version directory, set the new software inside, and update the operational symbolic link.