Convert command line interface

The Convert Command Line Interface (CLI) supports the same conversions and filters as the Convert user interface.

The Convert CLI should be run from the location where NovAtel Application Suite is installed. For example, C:\Program Files\NovAtel Inc\NovAtel Application Suite>NovAtelApplicationSuite.exe --help.

CLI options

Option	Description
-h, --help	Outputs a help message for Convert CLI.
-f=, --format= [FORMAT]	Convert logs to FORMAT (ASCII\|BINARY\|ABBREV\|RINEX*\|KML). ASCII is the default conversion format.
--receiver-type= [TYPE]	Receiver type of the log files (OEM\|GIII). OEM is the default receiver type.
-a, --asc, --ascii	Shortcut for -f=ascii.
-b, --bin, --binary	Shortcut for -f=binary.
--abbrev	Shortcut for -f=abbrev
-k, --kml	Shortcut for -f=kml.
-r, --rin, --rinex, -r3.04, --rin3.04, --rinex3.04	Shortcut for -f=rinex3.04.
-r3.03, --rin3.03, --rinex3.03	Shortcut for -f=rinex3.03.
-r3.02, --rin3.02, --rinex3.02	Shortcut for -f=rinex3.02.
-r3.01, --rin3.01, --rinex3.01	Shortcut for -f=rinex3.01.
-r2.1, --rin2.1, --rinex2.1	Shortcut for -f=rinex2.1.
-c=, --convert=[comma-separated list of MESSAGE IDs or MESSAGE ID ranges]	Convert only the MESSAGE logs listed in this command. MESSAGE can be a log number or log name. By default, all logs are converted. E.g., -c=RANGE,BESTPOS,RTKPOS
-e=, --exclude=[comma-separated list of MESSAGE IDs or MESSAGE ID ranges]	Do not convert the MESSAGE logs listed in this command. All other logs will be converted. MESSAGE can be a log number or log name. E.g., -e=RAWSBASFRAME,RANGECMP,GPSEPHEM

Output path

Option	Description
-o, --output=[PATH]	Use PATH for output. PATH is the path to the directory used to store the output files. If not specified, the output files will be located in the same directory as the input files. The output files will have the following folder structure: Source/TimeStamp/Format/FileName where: `Source` = the name of source file being converted `TimeStamp` = the date and time when the file was converted `Format` = the data format the file was converted to (ASCII, BINARY, ABBREV, KML or RINEX) `FileName` = the file name of the converted data with the extension ascii, binary, abbrev or rinex depending on the format.
--dd	Automatically create a directory named after input file name and write the output files to it.
--md	Put the output files in <output file title>/convert
--dm	Put the output files in convert/<output file title>

Split

Option	Description
--split	Divide the output file into N files, one for each log type. The files extensions will be the file name _ log names.
-l=, --limit-output-size=[SIZE (MB)]	Limit the size of the output file to SIZE. If the size is exceeded, multiple output files will be produced.
--limit-output-duration=[time(Secs)]	Limit the size of the output file to time. From the start of the file, the logs till the time duration (for example, 3600 seconds (1 hour)) will be output to one output file and the next duration (3600 seconds (1 hour)) to the next output file and so on.
--daily-utc	Converts the log data on a 24 hours basis, which uses the UTC time zone.

Time windowing

Option	Description
--start-time=<WEEK>,<SECONDS>	Convert logs after the start time. If WEEK is 0 or not given, then the week of the first log will be used.
--finish-time=<WEEK>,<SECONDS>	Convert logs up to the finish time. If WEEK is 0 or not given, then the week of the first log will be used.
--limit-duration=[SECONDS]	Convert only SECONDS of data from start time, or from start of file if no start time is given.

Log conversion

Option	Description
--expand-cmp	Expand RANGECMP* logs to RANGE logs. The default is do not expand RANGECMP* logs to RANGE logs.
--unknown-bytes=[file\|interleave\|ignore]	Dump the unknown bytes to a separate file, interleave them in the output, or ignore them altogether.
--forcekinematicdataflag	Include the kinematic information for conversion.

Option

Description

--expand-cmp

Expand RANGECMP* logs to RANGE logs.

The default is do not expand RANGECMP* logs to RANGE logs.

--unknown-bytes=[file|interleave|ignore]

Dump the unknown bytes to a separate file, interleave them in the output, or ignore them altogether.

--forcekinematicdataflag

Include the kinematic information for conversion.

Sampling

Option	Description
--decimate=[INTERVAL (Secs)]	Decimate logs that occur at INTERVAL. INTERVAL must be an integer value that will align with the logging interval of the given MESSAGE or All logs. Example 1: NovAtelApplicationSuite --decimate=5 (output BESTPOS logs at 5 second intervals) Example 2: NovAtelApplicationSuite -c=42 --decimate=42,30 (filter output to only contain BESTPOS(42) logs at 30 second intervals)

Option

Description

--decimate=[INTERVAL (Secs)]

Decimate logs that occur at INTERVAL.

INTERVAL must be an integer value that will align with the logging interval of the given MESSAGE or All logs.

Example 1: NovAtelApplicationSuite --decimate=5 (output BESTPOS logs at 5 second intervals)

Example 2: NovAtelApplicationSuite -c=42 --decimate=42,30 (filter output to only contain BESTPOS(42) logs at 30 second intervals)