Xpf2Gis
Purpose
This command line application converts the output *.xpf data file into a trajectory file readable with a GIS (geographical information system).
Usage
Xpf2Gis [/version] [/remote] [/autostart {on|off}] /c channel /f format [/l field] [/from time] [/to time] [/dec 100] [/toffset time] [/utcOrigin yyyy-mm-ddThh:mm:ss.sss] input output
Parameters
|
Argument |
Value |
Description |
|---|---|---|
|
/version |
Optional |
Displays version information about this application. |
|
/remote |
Optional |
Remote mode must be used when this application is embedded into an external application. Default is interactive mode. |
|
/autostart |
Optional |
If autostart is on (default) the process starts immediately, if off, user must type the start command to start the process. |
|
/c channel |
Mandatory |
Indicates channel to extract the data from. |
|
Format(1) |
Mandatory |
Format to use for the output file. It uses standard OGR format. See below. |
|
field |
Optional |
Indicates the name of the field containing the latitude. The longitude and altitude data are stored in the two next fields. |
|
/from time |
Optional |
Time of the first frame to be exported (seconds). |
|
/to time |
Optional |
Time of the last frame to be exported (seconds). |
|
/dec value |
Optional |
Decimates output points. |
|
/toffset |
Optional |
Offset to apply on the file time (seconds). |
|
/utcOrigin |
Optional |
UTC date/time corresponding to the origin of the file time. |
|
input |
Mandatory |
Input file name (XPF file). |
|
Output(2) |
Mandatory |
Output file name (geo-referenced file). |
(1) Choose the format of the output file. The table below lists the formats available for this application:
| Code | Description |
|---|---|
|
ESRI Shapefile |
ESRI Shapefile (.shp) |
|
DXF |
AutoCAD DXF (.dxf) |
|
GeoJSON |
GeoJSON (.geojson) |
|
Geoconcept |
GeoConcept text (.gxt) |
|
GML |
Geographic Markup Language (.gml) |
|
GMT |
Generic Mapping Tools (.gmt) |
|
KML |
Google Earth (.kml) |
|
MapInfo File |
MapInfo dataset (.tab) |
|
DGN |
Microstation DGN (.dgn) |
(2) The output file is made of point data. One point is defined by a latitude, a longitude, an altitude. If the latitude, longitude and altitude are followed by the four fields: StdDevX, StdDevY, StdDevZ and CovXY. They are read as standard deviation of the latitude, longitude and altitude and covariance of latitude/longitude position.
Notice that the latitude, longitude and altitude are defined in the same frame as the aiding GPS, which usually means WGS84. Nevertheless, if the GPS is used in RTK mode with correction defined in another frame, for instance RGF93, the latitude, longitude and altitude will be defined in the same frame.
The table below shows all the complementary attributes of the point:
|
Attribute |
Description |
Optional |
|
Id |
Single identifier |
|
|
DateTime |
Date and time |
|
|
StdDevX |
Standard deviation for longitude (m) |
ü |
|
StdDevY |
Standard deviation for latitude (m) |
ü |
|
StdDevZ |
Standard deviation for altitude (m) |
ü |
|
CovXY |
Covariance between latitude and longitude (m²) |
ü |
Example
In this example we will create a shape file for use in QGIS.
"C:\Program Files\Exail\Delph INS Subsea\Xpf2Gis.exe" /c primary-nav /f "ESRI Shapefile" ../postproins/out-ins-replay.xpf output.shp
In this example we export the position of the primary lever arm from our results file to an Esri Shapefile. It is important to enclose ESRI Shapefile in quotes in order for the export to work. With the exception of “Mapinfo File” all the other format specifiers can be used with or without quotation marks.
