Project block

Description

This block defines administrative project information that is required to create a new project. It is also used to import a project acquisition to Qinertia such as data logged by an APOGEE or NAVSIGHT unit.

Importing data

Qinertia can import several types of data such as IMU, PVT, RAW GNSS, events, odometer and even the INS configuration. Qinertia offers two ways, that can be combined, to import data:

Import all data from a project. The project package contains all measurements as well as the INS configuration
Create an empty project and then import manually each measurement one by one with the Sources block

Please read the page Project Creation for more information.

Import Project Package

This is the easiest way to import and process acquisitions from SBG Systems INS, Novatel SPAN products or Septentrio INS.

For example, SBG Systems INS stores in a single file all the measurements (IMU, PVT, GNSS RAW, odometer, ...), using the sbgECom binary protocol, as well as a JSON file with the INS configuration.

Qinertia can parse these files to automatically to extract each set of data as well as the configuration. You just have to set, in the project block, the type parameter to sbgECom and where Qinertia should find the files using either path or files parameters.

Override data source

You can import data from a project file and then use the Sources block to manually override a specific input. It could be interesting, for example, if you would like to import an acquisition but you would like to replace the RAW GNSS data with RAW data from an other GNSS receiver.

Create an Empty Project

If you would like to import manually each data set from a specific file, you should just create an empty project by omitting the type, path and files parameters. In this case, you will have to specify, for each data type (IMU, PVT, RAW GNSS, etc), which file to load in the next Sources block.

For example, you should use this mode if you would like to import generic third party IMU data to Qinertia as each data will be stored in a dedicated file.

JSON Block Sample

The project block can be used in several ways and you can find below examples for each use case.

Import Project from directory

In this example, you ask Qinertia to automatically import all sbgECom files located in the MyAcquisition directory.

"project":{
  "name":"ApogeeProject",
  "author": "Jean Dupont",
  "organization": "SBG Systems",
  "description": "This project demonstrates how to import SBG Systems INS data.\nAs you can see, the description fields supports multi-line with the two '\n' chars.",
  "type":"sbgECom",
  "path":"./MyAcquisition/"
}

JS

Import Project from files

The following project block loads a specific list of Novatel SPAN files to create an INS project ready for tight coupling.

"project":{
  "name":"ThirdPartyProject",
  "author": "Jean Dupont",
  "organization": "SBG Systems",
  "description": "This project demonstrates how to manually specify which files have to be imported.",
  "type": "novatel",
  "files": ["myData/spanCpt7Data_01.bin", "myData/spanCpt7Data_02.bin"]
}

JS

Create an empty Project

You can use the following syntax to create an empty project. No data is imported in this step so you will have to manually specify all data to import in the next Sources block.

"project":{
  "name":"ThirdPartyProject",
  "author": "Jean Dupont",
  "organization": "SBG Systems"
}

JS

Block Specification

Parameter	Type	Description
`name`	string	Project name.
`author`	string	Project author.
`organization`	string	Project organization/company name.
`description`	string	Optional project description that can includes multi-line content using `\n`
`type`	string	Select the project package to import: `sbgECom`: Load SBG Sytems INS measurements and configuration files to create an INS project. `septentrio`: Load Septentrio sbf files and either create a GNSS only or INS project. `novatel`: Load Novatel/SPAN files and either create a GNSS only or INS project. `ublox`: Load u-blox binary ubx file and create a GNSS only project. `trimble`: Load Trimble RT27 RAW GNSS observables to create a GNSS only project. `dji`: Load from a DJI Photogrammetry acquisition RTCM GNSS data and MRK match files. `pos`: Create INS project from POS INS real time solution, IMU data, RAW GNSS measurements and configuration. This parameter is required if you would like to import data from a project.
`path`	string	Path to the project to import where Qinertia will try to load all files that comply with the `type` parameter. This parameter is required if the `type` parameter is provided and exclusive with the `files` parameter.
`files`	array	List all project files specifically to load as specified by the `type` parameter and in the correct order. This parameter is required if the `type` parameter is provided and exclusive with the `path` parameter.

Contiguous files

If you provide a list of files using the files parameter, you have to make sure the files are contiguous with no gaps.

Relative Paths

Relative paths are referenced to the JSON process file unless you have specified a base path with the --input option while invoking Qinertia command line.

Download PDF