Name
gpcoord - version 0.0.0-snapshot-20131004Synopsis
gpcoord [OPTIONS] [FILES]Description
Operation on coordinates X Y[ Z [NAME]] given through FILES or stdin. If Z is omitted, Z=0.
gpcoord options:
- -distance
- Input must be X1 Y1 [Z1] X2 Y2 [Z2]. Output is in meters.
- -distance-lookup FILE
- Input must be NAME1 NAME2 [REF_DIST]. Output is in meters. If REF_DIST is provided the computed distance is compared to REF_DIST (output: name1 name2 calc ref diff_abs diff_rel(%)). See option '-lookup' for FILE format.
- -distance-geo
- Input must be LONG1 LAT1 [Z1] LONG2 LAT2 [Z2]. Output is in meters.
- -azimuth
- Input must be X1 Y1 [Z1] X2 Y2 [Z2]. Output is in degrees from north (Y axis).
- -azimuth-geo
- Input must be LONG1 LAT1 [Z1] LONG2 LAT2 [Z2]. Output is in degrees from north.
- -from-geo
- Input must be LONG LAT [Z [NAME]] in degrees (Z in meters). Output in rectangular coordinates X Y Z (m). Option -reference must be supplied.
- -to-geo
- Input must be X Y [Z [NAME]] in meters. Output geographical coordinates LONG LAT Z in degrees. Option -reference must be supplied.
- -to-utm [ZONE]
- Input must be LONG LAT [Z [NAME]] in degrees. If ZONE is omitted, the UTM is automatically computed. Output Universal Transverse Mercator coordinates UTM_ZONE UTM_LONG UTM_LAT Z in meters.
- -from-utm [ZONE]
- Input must be [UTM_ZONE] UTM_LONG UTM_LAT [Z [NAME]] in degrees. If UTM_ZONE is not available, it must be specified in the argument. Output geographical coordinates LONG LAT Z in degrees.
- -from-dms
- Input must be LONG LAT [Z [NAME]] in degrees, minutes, seconds (format: D.MMSSss..., Z in meters). Output is LONG LAT Z in degrees.
- -to-dms
- Input must be LONG LAT [Z [NAME]] in degrees. Output geographical coordinates LONG LAT Z in degrees, minutes, seconds (D.MMSSss..., Z in meters).
- -from-dm
- Input must be LONG LAT [Z [NAME]] in degrees, minutes (format: D.MMmm..., Z in meters). Output is LONG LAT Z in degrees.
- -to-dm
- Input must be LONG LAT [Z [NAME]] in degrees. Output geographical coordinates LONG LAT Z in degrees, minutes (D.MMmm..., Z in meters).
- -to-kml FILE
- Input must be LONG LAT [Z [NAME]] in degrees. Output to KML FILE.
- -from-kml FILE
- Output is LONG LAT Z NAME in degrees.
- -reference LONG LAT
- Set geographical coordinates at origin of rectangular coordinates (0,0).
- -translate TX TY
- Input must be X Y [Z [NAME]]. Translates by vection (TX,TY).
- -rotate ANGLE
- Input must be X Y [Z [NAME]]. Rotates around origin (0,0) with ANGLE in degrees counted clockwize.
- -average
- Input must be X Y [Z] from a fixed station. Output X Y [Z]. Coordinates can be lat/long or cartesian.
- -lookup FILE
- Return the coordinates of points referenced by their names. Input must be NAME. Output X Y [Z] NAME. FILE must contains points with format X Y Z NAME
- -localize X Y
- Input must be DISTANCE AZIMUTH from reference point X Y. Output are X Y of points shifted from reference point by DISTANCE and AZIMUTH. X Y are the rectangular coordinates of the reference point
- -trig-dist FILE
- Triangulate from known distances to at least two reference points. Input must be NAME DISTANCE. Output X Y DX DY. FILE must contains the reference points with format X Y [Z] NAME
- -trig-az FILE
- Triangulate from known azimuth to at least three reference points. Input must be NAME AZIMUTH. Output X Y DX DY. FILE must contains the reference points with format X Y [Z] NAME
- -from-distances
- Input must be NAME1 NAME2 DISTANCE. Output are X Y of named points (see -origin and -north).
- -circle RADIUS N [I0]
- Generate a set of N coordinates distributed on a circle of RADIUS, plus a center at 0 0. Coordinates are named starting at index I0 (0 by default).
fromdistance options:
- -stddev VALUE
- The estimated standard deviation of distance measurements (default=1cm).
- -origin NAME
- Sets point named NAME as the origin of the relative coordinates, solves translation ambiguity (see -from-distances).
- -north NAME
- Defines the north axis (or Y) as the segment from origin to point NAME, solves rotation ambiguity (see -from-distances).
- -eastward NAME
- Sets that point NAME is located eastward compared to origin, solves flip ambiguity (see -from-distances).
- -prior-positions FILE
- Sets prior coordinates of points. All solutions that fall outside the prior precision are discarded.
- -prior-precision VALUE
- Sets precision of prior localization (see -prior-positions, default=5m).
Generic options:
- -h, -help [<SECTION>]
- Shows help. SECTION may be empty or: all, html, latex, generic, debug, from distance, gpcoord
- -args
- Lists the argument history
- -version
- Shows version information
- -app-version
- Shows short version information
- -j, -jobs <N>
- Allows a maximum of N simulteneous jobs for parallel computations (default=2).
Debug options:
- -nobugreport
- Does not generate bug reports in case of error.
- -reportbug
- Starts bug report dialog, information about bug is passed through stdin. This option is used internally to report bugs if option -nobugreport is not specified.
- -reportint
- Starts bug report dialog, information about interruption is passed through stdin. This option is used internally to report interruptions if option -nobugreport is not specified.
Authors
Marc WatheletMarc Wathelet (LGIT, Grenoble, France)
