Supported platforms

			Linux Debian based OS 32 & 64 bit (Tested with: Ubuntu 22.04.3 LTS)
			Windows 10 32 & 64 bit

Linux (Debian based) Quick start

• Installation
• Use
• Killing the process

Installation (Linux)

1. Install 64 bit dependencies (64 bit system only) - Install additional dependency  "libc6-i386 lib32stdc++6" for 64 bit systems by running:

sudo apt update && sudo apt install libc6-i386 lib32stdc++6 -y

2. Install .NET Core dependency - Install .NET Core 6 found here.

3. Download NAVsolve CMD package - Download the NAVSolve CMD package by running:

sudo wget https://www.oxts.com/software/navsuite/navsolve-cmd/navsolve-cmd_1.3.1_linux.zip

4. Unpack .zip file - Unpack contents of .zip package with unzip command. Contents should include navsolve-cmd.deb for both system architectures:

unzip navsolve-cmd_1.3.1_linux.zip

5. Install packages with dpkg - Install navsolve-cmd.deb with "sudo dpkg -i <PACKAGE NAME>".

Linux 64 bit version 1.3.1 example:

Install navsolve-cmd.deb package by running:

sudo dpkg -i navsolve-cmd_1.3.1_amd64.deb

Linux 32 bit version 1.3.1 example:

sudo dpkg -i navsolve-cmd_1.3.1_i386.deb

6. Confirm installation - Confirm installation by calling the package executable.

navsolve-cmd

-If you are fully installed you should see the help page for the software application.

Issues - If you are having issues installing, enter the following in your terminal:

sudo apt -f install

Use (Linux)

Call the tool chain in your terminal by entering "navsolve-cmd" followed by any parameters you wish to use. Minimum parameter requirements are [--inputFolder] and [--batchsettings].

1. Configure your batch process settings - Navsolve-cmd requires a batch settings XML file that specifies the process settings. This needs to be configured before processing data. A template XML (batchsettings.xml) file is attached to this article and then modified to your process requirements using the XML Batch Settings section.
2. Open Terminal and Run Navsolve-cmd - See example below.

Linux terminal example:

navsolve-cmd -i=/path/folderOrList -b=/path/batchSettings.xml -o=/path/outputFolder

Killing the process (Linux)

Only the following methods work for killing the process and ensuring an orderly exit:

• CTRL+C at the console.
• kill [pid] command at the terminal.
• kill -15 [pid] command at the terminal.

Due to limitations in .NET Core, we are unable to capture any other kill signal - if these are used, then the application will end abruptly and the CSV Summary file will not have any lines written.

Windows quick start

• Installation
• Use
• Killing the process

Installation (Windows)

1. Install tool dependencies -  Install .NET 6 found here.
2. Create installation directory - Create an installation directory called "navsolve-cmd" in "c\Program Files".
3. Unpack zip files - The download package will be a zip file containing 2 inner zip files. Unpack the downloaded zip file then the contents of the 2 inner zip files to installation directory.

Tip: “blended.exe” should appear in the same directory as “navsolve-cmd.cmd”

Use (Windows)

To use the tool chain, run the command line from within the installation directory. Use the command ".\navsolve-cmd.cmd " to initialise NAVsolve-cmd followed by the processing parameters you wish to use. Minimum parameter requirements are [--inputFolder] and [--batchsettings], although calling the tool with none will cause an error resulting in displaying the help page.

1. Configure your batch process settings - NAVsolve-cmd requires a batch settings XML file that specifies the process settings. This needs to be configured before processing data. A template XML (batchsettings.xml) file is attached to this article and then modified to your process requirements using the XML Batch Settings section.
2. Open Windows command line - Windows PowerShell or Command Prompt work well.
3. Navigate to installation directory:

   cd "C:\Program Files\navsolve-cmd"

4. Run batch processing tool - See example below.

Windows minimum parameter example -  Running navsolve-cmd pointing to the input (-i) directory you want all RD files processed from and to your batch settings (-b) XML file.

.\navsolve-cmd.cmd -i="C:\path\to\input\directory" -b="C:\path\to\batch\settings\file\batchsettings.xml"

Example output -

Location:  "C:\Users\AppData\Local\Temp\NAVSolveWorkingFolder". Explanation: As no output directory specified working directory will be used. No working directory specified so defaults is "C:\Users\AppData\Local\Temp\NAVSolveWorkingFolder".

Output files:

• NCOM file/s (One for each RD in input directory named as such)
• Summary.csv (Contains process details for each file)

Killing the process (Windows)

• CTRL+C at the console.
• Message appears asking "Terminate batch job?"
• Type  y then press ENTER.

Command parameter reference

The following is a list of all command parameters accepted for NAVsolve-cmd along with a description of how to use them.

--inputFolder

-i

--batchSettings

-b

--outputFolder

-o

--workingFolder

-w

--outputType

-t

--logFile

-l

--logLevel

--summaryFile

-s

--skipExisting

--version

-v

--help

-h

Notes:

• A process summary file is written at {workingfolder}/summary.csv. The summary CSV file is over written on each run.
• All parameter flags are non-case sensitive, but parameter values are case sensitive e.g. inputfolder, INPUTFOLDER, and InputFolder will all be accepted.
• Windows file paths use "\" instead of "/" for Linux terminal.

XML batch settings file

NAVsolve-cmd requires a XML settings file, which gives the process detailed instructions on how to process the RD files. Using the XML file you can modify the process to include RINEX files and/or use a configuration other than the one contained within your RD file.

Fig. 2 - RD-CSV Process with user specified configuration & RINEX files:

The following settings can be specified in the XML file:

• Blended process - method blended uses to process RD to NCOM.
• Advanced smoothing - When enabled, the process smooths the combined average of processed navigation data.
• Specify configuration file - Lets the process know you want to use a different configuration file to the one contained within the RD file. By default RawData file configuration is used.
• Location of configuration file - Once you have opted to use a configuration from File, this setting tag points to the folder containing your desired configuration.
• Clean up - When enabled, once the process has completed all interstitial files will be removed from the working directory.
• Multiple RINEX - Points to folder containing RINEX files for retrieval and use in processing with differential corrections.
• Specify RINEX - Allows location and name of individual RINEX files to be specified for use in processing with differential corrections.
• RINEX file type filter - You can use this setting to filter in or out RINEX type "G" or "N" files from the processing.
• Specify CSV output data rate - You have the option to select at what rate data is output to CSV.
• Specify CSV output measurements - You can specify exactly which measurements are output to CSV.

XML file settings reference

The following is a list of process settings available for configuration via batch settings XML file. Defined is what the setting controls, the XML Tag to use in the file and the options available to input into the XML tag. 

<BlendedProcessType>Option</BlendedProcessType>

<EnableSmoothing>Option</EnableSmoothing>

<CfgFileOption>Option</CfgFileOption>

<CfgFileOption>File</CfgFileOption> **Required**
<ConfigFilePath>/path/config</ConfigFilePath>

<CleanFolders>Option</CleanFolders>

<SelectedBaseStationOption>Option</SelectedBaseStationOption>

<BaseStationFolder>/path/RINEX</BaseStationFolder>

<BaseStationFileList>
    <string>path/to/base/station/file/example.19o</string>
    <string>path/to/base/station/file/example.19o</string>
</BaseStationFileList>

<IncludeRinexFiles>
    <IncludeRinexFile Include="Option" Type="O"/>
    <IncludeRinexFile Include="Option" Type="G"/>
    <IncludeRinexFile Include="Option" Type="N"/>
</IncludeRinexFiles>

<MaximumDistance>Option</MaximumDistance>

 <ExportDataRate>Option</ExportDataRate>

<ExportTimeFormat>Option</ExportTimeFormat>

<ExportStatus>Option</ExportStatus>

<ExportInvalid>Option</ExportInvalid>

<Headings>Option</Headings>

<ExportMeasurements>
    <BPMeasurementItem>
        <DisplayName>Option</DisplayName>
        <Name>Option</Name>
        <Unit>Option</Unit>
        <OxTSName>Option</OxTSName>
        <ShortName>Option</ShortName>
        <LegacyName>Option</LegacyName>
    </BPMeasurementItem>
</ExportMeasurements>

Notes: 

• Using a Combined process for a large RD file (typically >1.5GB) can cause blended.exe to fail for that process. If this happens, use Simulated mode to process this RD file.
• 256 is the maximum RINEX files the process can handle without failing.
• RINEX file type "O" cannot be filtered out of processing.