Export Commands
The following commands relate to the export of the final solution and are applicable to all projects.
Command |
-expprofile# [input] |
Example |
-expprofile1 Geographic |
Description |
Specifies the profile to be used when writing the formatted solution to disk. |
Input |
Name of the Export Wizard profile to be used. |
Notes |
You can use one of the software's built-in profiles or customize one through the interface. The # designator must be 1...8 to uniquely identify the export. |
Required? |
No. But if the -expprofile# is used, then this command is required. |
Command |
-expfile# [input] |
Example |
-expfile1 "C:\My Data\final_solution.txt" |
Description |
Specifies the name given to the output file. |
Input |
Full file path and name of the output file to be created during the export process. |
Notes |
Only applicable if the -expprofile command is used. If the file already exists, it will be over-written. The # designator must be 1...8 to uniquely identify the export. |
Required? |
No. But if the -expprofile# is used, then this command is required. |
Command |
-expsrc# [input] |
Example |
-expsrc1 epochs |
Description |
Specifies the source to be used when generating the output file. |
Input |
epochs to output the trajectory at a fixed time interval. features to output data only for the loaded camera events/features. static to output data only for the static sessions. |
Notes |
Only applicable if the -expprofile command is used. In order to use the features option, there must be valid features/events loaded. The static option will not output solutions for any kinematic epochs. The # designator must be 1...8 to uniquely identify the export. |
Required? |
No. If the -expprofile command is used but the output source is not specified, the utility will output in epochs mode. |
Command |
-expla# [X] [Y] [Z] |
Example |
-expla1 -0.145 0.986 0.883 |
Description |
Specifies the lever arm to be applied during export. |
Input |
The X/Y/Z spatial offsets, in meters, from the IMU to the point of interest. |
Notes |
Only applicable if the -expprofile command is used. Only applicable for inertial processing. The offsets must be referenced in the X-right, Y-forward, Z-up frame. The IMU’s center of navigation is the origin of the frame. The # designator must be 1...8 to uniquely identify the export. |
Required? |
No. If not specified, the output file will be generated with respect to the IMU. |
Command |
-exputmzone# [input] |
Example |
-exputmzone1 11 |
Description |
Specifies the UTM zone number to be applied during export. |
Input |
0 to have the software automatically determine the zone number. 1…60 to force the UTM zone number to a specific value. |
Notes |
Only applicable if the -expprofile command is used. Only applicable if the export profile contains UTM grid output variables. The # designator must be 1...8 to uniquely identify the export. |
Required? |
No. If not specified, the software will use whichever UTM zone number was most recently used with the export profile. |
Command |
-expkml [on/off] |
Example |
-expkml on |
Description |
Enables the export of the KML file after processing |
Input |
on to enable off to disable (off is the default) |
Notes |
Available in all processing modes |
Required? |
No |
Command |
-exprot# [Rx] [Ry] [Rz] |
Example |
-exprot1 90 0 180 |
Description |
Specifies a body-to-user frame rotation to be applied during export. |
Input |
The rotations, in degrees, to rotate from the body frame to the user-defined frame. |
Notes |
Only applicable if the -expprofile command is used. Only applicable for inertial processing. Rotation order is about Z, then about X, then about Y. The # designator must be 1...8 to uniquely identify the export. |
Required? |
No. If not specified, no rotations will be applied. |
Command |
-expsbet [on/off] |
Example |
-expsbet on |
Description |
Enables the export of the SBET file after processing |
Input |
on to enable off to disable (off is the default) |
Notes |
Only applicable for inertial processing |
Required? |
Required to enable all other export “-expsbet…” commands |
Command |
-expsbetkernel [input] |
Example |
-expsbetkernel text_to_append |
Description |
Appends text to the SBET output file name |
Input |
Desired text to append |
Notes |
Only applicable if the -expsbet command is used Results in the exported file: SBET_<kernel_text>.OUT |
Required? |
No |
Command |
-expsbetsmrmsg [on/off] |
Example |
-expsbetsmrmsg on |
Description |
Enables the export of the SMRMSG in addition to the SBET |
Input |
on to enable off to disable (off is the default) |
Notes |
Only applicable if the -expsbet command is used |
Required? |
No |
Command |
-expsbetsmrmsgposscale [input] |
Example |
-expsbetsmrmsgposscale 2.0 |
Description |
Scale the position standard deviations in the SMRMSG file |
Input |
Must be a positive floating-point number (1.0 is the default) |
Notes |
Only applicable if the -expsbet command is used |
Required? |
No |
Command |
-expsbetsmrmsgattscale [input] |
Example |
-expsbetsmrmsgattscale 2.0 |
Description |
Scale the attitude standard deviations in the SMRMSG file |
Input |
Must be a positive floating-point number (1.0 is the default) |
Notes |
Only applicable if the -expsbet command is used |
Required? |
No |
Command |
-expsbetimuframe [on/off] |
Example |
-expsbetimuframe on |
Description |
Output the SBET attitude with respect to the IMU frame rather than the default X-forward, Y-right, Z-down frame |
Input |
on to enable off to disable (off is the default) |
Notes |
Only applicable if the -expsbet command is used Cannot be used in conjunction with the -expsbetcustomframe command or else processing will halt |
Required? |
No |
Command |
-expsbetcustomframe [X] [Y] [Z] |
Example |
-expsbetcustomframe 0 0 180 |
Description |
Define the desired output frame of the SBET attitude |
Input |
The rotations about the XYZ axis to apply to get to the desired custom output frame |
Notes |
Only applicable if the -expsbet command is used Rotation order is first about Z, then about X, then about Y. The starting frame is the Inertial Explorer body frame of X-right, Y-forward, Z-up Cannot be used in conjunction with the -expsbetimuframe command or else processing will halt |
Required? |
No |
Command |
-expsbetutctime [on/off] |
Example |
-expsbetutctime on |
Description |
Output UTC time in the SBET file rather than GPS time |
Input |
on to enable off to disable (off is the default) |
Notes |
Only applicable if the -expsbet command is used |
Required? |
No |
Command |
-expriegl [on/off] |
Example |
-expriegl on |
Description |
Enables the export of the RIEGL file after processing |
Input |
on to enable off to disable (off is the default) |
Notes |
Only applicable for inertial processing |
Required? |
Required to enable all other export “-expriegl…” commands |
Command |
-exprieglgeodeticsystem [input] |
Example |
-exprieglgeodeticsystem WGS84 |
Description |
Sets the geodetic system string in the RIEGL header. The string will be truncated at 32 characters. |
Input |
The desired geodetic system string (empty by default) |
Notes |
Only applicable if the -expriegl command is used |
Required? |
No |
Command |
-exprieglprojectname [input] |
Example |
-exprieglprojectname “My project name” |
Description |
Sets the project name string in the RIEGL header. The string will be truncated at 32 characters. |
Input |
The desired project name string (empty by default) |
Notes |
Only applicable if the -expriegl command is used |
Required? |
No |
Command |
-exprieglcompanyname [input] |
Example |
-exprieglcompanyname “My company name” |
Description |
Sets the company name string in the RIEGL header. The string will be truncated at 32 characters. |
Input |
The desired company name string (empty by default) |
Notes |
Only applicable if the -expriegl command is used |
Required? |
No |
Command |
-expriegltimezone [input] |
Example |
-expriegltimezone “GMT-6” |
Description |
Sets the time zone string in the RIEGL header. The string will be truncated at 16 characters. |
Input |
The desired time zone string (empty by default) |
Notes |
Only applicable if the -expriegl command is used |
Required? |
No |
Command |
-expriegllocation [input] |
Example |
-expriegllocation “Canada” |
Description |
Sets the location string in the RIEGL header. The string will be truncated at 32 characters. |
Input |
The desired location string (empty by default) |
Notes |
Only applicable if the -expriegl command is used |
Required? |
No |
Command |
-exprieglnavigationdevice [input] |
Example |
-exprieglnavigationdevice “IMU” |
Description |
Sets the navigation device string in the RIEGL header. The string will be truncated at 32 characters. |
Input |
The desired navigation device string (empty by default) |
Notes |
Only applicable if the -expriegl command is used |
Required? |
No |
Command |
-exprieglposscale [input] |
Example |
-exprieglposscale 2.0 |
Description |
Scale the position standard deviations in the RIEGL file |
Input |
Must be a positive floating-point number (1.0 is the default) |
Notes |
Only applicable if the -expriegl command is used |
Required? |
No |
Command |
-exprieglattscale [input] |
Example |
-exprieglattscale 2.0 |
Description |
Scale the attitude standard deviations in the RIEGL file |
Input |
Must be a positive floating-point number (1.0 is the default) |
Notes |
Only applicable if the -expriegl command is used |
Required? |
No |
Command |
-expintervaltime# [input] |
Example |
-expintervaltime1 0.5 |
Description |
Specifies the time interval to use for export. |
Input |
Time interval, in seconds |
Notes |
Only applicable if the -expprofile command is used. Only applicable if -expintervaltype has been used to set the interval type to "time". Only applicable for inertial processing. The # designator must be 1...8 to uniquely identify the export. |
Required? |
No. If -expintervaltype has been used to set the interval type to "time", then the export will be generated with 1 second spacing. Otherwise, the settings within the export profile (*.PRF) will be used instead. |
Command |
-expintervaldist# [input] |
Example |
-expintervaldist1 25.0 |
Description |
Specifies the distance interval to use for export. |
Input |
Distance interval, in meters |
Notes |
Only applicable if the -expprofile command is used. Only applicable if -expintervaltype has been used to set the interval type to "distance". Only applicable for inertial processing. The # designator must be 1...8 to uniquely identify the export. |
Required? |
No. If -expintervaltype has been used to set the interval type to "distance", then the export will be generated with 1 meter spacing. Otherwise, the settings within the export profile (*.PRF) will be used instead. |
Command |
-expintervaltype# [input] |
Example |
-expintervaltype1 time |
Description |
Specifies the interval type to use for export. |
Input |
time to use time-based export distance to use distance-based export |
Notes |
Only applicable if the -expprofile command is used. Only applicable for inertial processing. The # designator must be 1...8 to uniquely identify the export. |
Required? |
No. If not used, then the settings within the export profile (*.PRF) will be used instead. |