NAME

       x2sys_cross - Find and compute Cross-Over Errors


SYNOPSIS

       x2sys_cross  file(s)  OR  -Lflist [ -Agap ] [ -Cc|f|g ] [ -Ddeffile ] [
       -Fflags ] [ -Gd|g ] [ -Il|a|c ] [ -Jparams ] [-Kcombi.lis] [ -M[flag] [
       -Nwindow  ] [ -O ] [ -Qe|i ] [ -Sl|uspeed ] [ -TTAG ] [ -Wsize ] [ -V ]
       [ -2 ] [ -bo[s] ]


DESCRIPTION

       x2sys_cross is used to determine all intersections  between  or  within
       tracks,  and  report  the  time, position, discrepancies in all observ-
       ables, the mean values of the observables, heading along each trackseg-
       ment,  and  the distance along track at the cross-over point. The names
       of the files are passed on the command line, or as a list of files with
       the  -L option.  If they are identical or only one name is passed, then
       x2sys_cross will also  look  for  internal  cross-overs.  The  optional
       parameters are:

       -A     Ignore crossovers on segments of length > gap [no gap checking].

       -C     Select procedure for along-track distance calculation:
                      c Cartesian distances [Default].
                      f Flat earth distances.
                      g Great circle distances.

       -D     Give the definition file for this data format [x2sys].

       -F     Sets which columns to use. Give a comma-separated list of column
              names [Default is all columns].

       -G     Selects  geographical coordinates. Append d for discontinuity at
              the Dateline (makes longitude go from -180 to + 180)  or  g  for
              discontinuity  at  Greenwhich  (makes longitude go from 0 to 360
              [Default]).

       -I     Sets the interpolation mode. Choose among:
                      l Linear interpolation [Default].
                      a Akima spline interpolation.
                      c Cubic spline interpolation.

       -J     Selects the map projection. Scale is  UNIT/degree,  1:xxxxx,  or
              width  in  UNIT  (upper case modifier).  UNIT is cm, inch, or m,
              depending on the MEASURE_UNIT setting in .gmtdefaults4, but this
              can be overridden on the command line by appending c, i, or m to
              the scale/width value.  For map height, max  dimension,  or  min
              dimension, append h, +, or - to the width, respectively.

              CYLINDRICAL PROJECTIONS:

              -Jclon0/lat0/scale (Cassini)
              -Jjlon0/scale (Miller)
              -Jmscale (Mercator - Greenwich and Equator as origin)
              -Jmlon0/lat0/scale (Mercator - Give meridian and standard paral-
              lel)

              AZIMUTHAL PROJECTIONS:

              -Jalon0/lat0/scale (Lambert).
              -Jelon0/lat0/scale (Equidistant).
              -Jflon0/lat0/horizon/scale (Gnomonic).
              -Jglon0/lat0/scale (Orthographic).
              -Jslon0/lat0/[slat/]scale (General Stereographic)

              CONIC PROJECTIONS:

              -Jblon0/lat0/lat1/lat2/scale (Albers)
              -Jdlon0/lat0/lat1/lat2/scale (Equidistant)
              -Jllon0/lat0/lat1/lat2/scale (Lambert)

              MISCELLANEOUS PROJECTIONS:

              -Jhlon0/scale (Hammer)
              -Jilon0/scale (Sinusoidal)
              -Jk[f|s]lon0/scale (Eckert IV (f) and VI (s))
              -Jnlon0/scale (Robinson)
              -Jrlon0/scale (Winkel Tripel)
              -Jvlon0/scale (Van der Grinten)
              -Jwlon0/scale (Mollweide)

              NON-GEOGRAPHICAL PROJECTIONS:

              -Jp[a]scale[/origin]  (polar  (theta,r)  coordinates, optional a
              for azimuths and offset theta [0])
              -Jxx-scale[l|ppow][/y-scale[l|ppow]][d] (Linear, log, and  power
              scaling)
              More details can be found in the psbasemap man pages.

       -K     Only  process  the pair-combinations found in the file combi.lis
              [Default process all possible combinations among  the  specified
              files].  Suitable option for passing old x_setup output.

       -M     Multiple  segment  file(s).  Segments are separated by a special
              record.  For ASCII  files  the  first  character  must  be  flag
              [Default  is  ’>’].  For binary files all fields must be NaN and
              -bo[s]n must set the number of output columns explicitly.

       -N     Maximum number of points to use in the interpolation [6].

       -O     Output results using the old XOVER format [Default is X2SYS for-
              mat].   This  option  should  only  be used with *.gmt-formatted
              MGD77 files.

       -Q     Append e for  external  crossovers  only,  and  i  for  internal
              crossovers only [Default is all crossovers].

       -R     xmin,  xmax,  ymin, and ymax specify the Region of interest. For
              geographic regions,  these  limits  correspond  to  west,  east,
              south,  and north and you may specify them in decimal degrees or
              in [+-]dd:mm[:ss.xxx][W|E|S|N] format. Append r  if  lower  left
              type and positions must be as indicated  (however,  input/output
              and plotting formats are flexible).

       -S     Defines   window  of  track  speed  within  which  to  calculate
              crossovers.
                      -Sl sets lower speed [Default is 0].
                      -Su sets upper speed [Default is Infinity].

       -T     Sets the data set TAG which among other things sets the  defini-
              tion file.

       -V     Selects verbose mode, which will send progress reports to stderr
              [Default runs "silently"].

       -W     Sets maximum time gap (in user units) allowed between points  on
              either side of a crossover [Default is Infinity].

       -2     Report the values of each track at the crossover [Default is the
              crossover value and the mean value].

       -bo    Selects binary output. Append s for single precision [Default is
              double].


REMARKS

       The  COEs  found  are  printed  out  to standard output in ASCII format
       (unless -bo is set). When ASCII is chosen, the output format depends on
       whether  or  not old-style XOVER output (-O) has been selected.  If so,
       then the first record contains the file names  and  their  start  year,
       whereas  subsequent records have the data for each COE encountered. The
       fields written out are lat, lon, time along track #1, time along  track
       #2, x_gravity, x_magnetics, x_bathymetry, average gravity, average mag-
       netics, average bathymetry, heading along track #1, and  heading  along
       track #2. If the default format is chosen then the header record starts
       with "> ", and the output format for crossovers  are  first  8  columns
       that  contain  x, y, time along track #1, time along track #2, distance
       along track #1, distance along track #2, heading along  track  #1,  and
       heading along track #2, and then pairs of (COE, average value) for each
       data type. Sign convention: If lega and legb are passed on the  command
       line,  then  the COE value is Value (lega) - Value (legb). It is recom-
       mended that the Akima spline is  used  instead  of  the  natural  cubic
       spline,  since  it is less sensitive to outliers that tend to introduce
       wild oscillations in the interpolation.


EXAMPLES

       To compute all internal crossovers in the gmt-formatted file c2104.gmt,
       and output in the old XOVER format, use

       x2sys_cross c2104.gmt -O -Dgmt > c2104.d

       To  find  the crossover locations with bathymetry between the two MGD77
       files A13232.mgd77 and A99938.mgd77, try

       x2sys_cross  A13232.mgd77  A99938.mgd77  -Qe  -Dmgd77  -Flon,lat,top  >
       crossovers.d


Man(1) output converted with man2html