sbgsystems/qinertia-server repository overview

⁠Qinertia Server

Qinertia Server is a professional GNSS/INS post processing software dedicated for centralized server processing. This modern GNSS/INS Post Processing Software can be used with any RTK capable GNSS receivers to deliver centimeter-level Post Processed Kinematic solution (PPK). Qinertia also accepts Inertial Measurement Unit (IMU) data to provide a highly accurate and robust tightly coupled GNSS/INS solution.

Qinertia also exists as a standalone desktop application with an intuitive and powerful Graphical User Interface.

Please visit the official Qinertia web page to get more details: Qinertia⁠

Designed & Maintained by: SBG Systems⁠

⁠Documentation

The full Qinertia documentation can be found here: Qinertia Documentation⁠
Quick access to Qinertia Command Line Interface (CLI) reference manual: Qinertia CLI Documentation⁠

⁠Requirements

• The docker image use a linux environment. So a linux host or a mac host or windows with linux container is required. Windows host with windows container will not work.
• git to retrieve sample projects

⁠License

You need a valid commercial Qinertia Server license to use this docker image. Please contact us⁠ to get a license.

If you already have a valid Qinertia Server license, you need the license ID to use the docker image. You can get your license ID from https://license.sbg-systems.com⁠. The license ID is 10-digit such as 12345ABCDE.

View license information⁠ for the software contained in this image.

As with all Docker images, these likely also contain other software which may be under other licenses (such as Bash, etc from the base distribution, along with any direct or indirect dependencies of the primary software being contained).

As for any pre-built image usage, it is the image user's responsibility to ensure that any use of this image complies with any relevant licenses for all software contained within.

⁠How to use this image

⁠Supported tags

• 5.0⁠, 5.0.10956⁠, latest⁠
• 4.3⁠, 4.3.6492⁠
• 4.2⁠, 4.2.14583⁠
• 4.1⁠, 4.1.11686⁠
• 4.0⁠, 4.0.25049⁠
• 3.4⁠, 3.4.308⁠
• 3.3⁠, 3.3.4356⁠
• 3.2⁠, 3.2.1295⁠

⁠Getting Started

Run docker run --rm -it sbgsystems/qinertia-server --help to get image, create an ephemeral container and test if everything is ok.

The container is executive. This means that arguments given to the docker run command are directly pass to qinertia-cli executable.

⁠Authentication

As the ephemeral nature of docker run command, it is not possible to use qinertia-cli login command. Instead credentials have to be pass directement with the process command using either --user / --password options or QINERTIA_CLI_PROCESS_USER / QINERTIA_CLI_PROCESS_PASSWORD environment variables.

⁠Data

A docker volume must be bind to /qinertia mount point to allows the container to access project data and write reports and export.

⁠Example

Public data from this Github repo⁠ is used to illustrate. We consider a linux terminal (or WSL).

// Get sample data
$ git clone https://github.com/SBG-Systems/qinertiaExamples.git
$ cd qinertiaExamples/

// simpleCliDemo is used
$ ls simpleCliDemo/
base/  cliDemo.json  README.md  rover/

⁠Process using command line arguments

$ docker run --rm -it -v $PWD/simpleCliDemo:/qinertia sbgsystems/qinertia-server process --process-file /qinertia/cliDemo.json --user my_user --password my_password --license 12345ABCDE

⁠Process using environment variables

• Create a demo_env file containing :

QINERTIA_CLI_PROCESS_USER=my_user
QINERTIA_CLI_PROCESS_PASSWORD=my_password
QINERTIA_CLI_PROCESS_LICENSE=12345ABCDE

• Run the process

$ docker run --rm -it --env-file demo_env -v $PWD/simpleCliDemo:/qinertia sbgsystems/qinertia-server process --process-file /qinertia/cliDemo.json

⁠Reference

⁠Environment variables

• QINERTIA_CLI_PROCESS_USER (default =``)
• QINERTIA_CLI_PROCESS_PASSWORD (default =``)
• QINERTIA_CLI_PROCESS_LICENSE (default =``)
• QINERTIA_CLI_PROCESS_STATUS_OUTPUT (default =stdout)
• QINERTIA_CLI_PROCESS_PROCESS_FILE (default =/qinertia/process.json)
• QINERTIA_CLI_PROCESS_OUTPUT (default =/qinertia)
• QINERTIA_CLI_PROCESS_INPUT (default =/qinertia)
• QINERTIA_CLI_PROCESS_PROJECT (default =``)
• QINERTIA_CLI_PROCESS_LOGS (default =/qinertia/process.log)

⁠Image information

• User : qinertia (id=1000)
• Workdir : /home/qinertia