NAME

       x2sys_report - Report statistics from crossover data base

SYNOPSIS

       x2sys_report  column TAG [ coedbase.txt ] [  ] [ [list] ] [ [corrtable] ] [ nx_min ] [ e|i
       ] [ [ region ] [ track ] [ [level] ]

       Note: No space is allowed between the option flag and the associated arguments.

DESCRIPTION

       x2sys_report will read the input crossover ASCII data base  coedbase.txt  (or  stdin)  and
       report  on  the  statistics  of  crossovers  (n, mean, stdev, rms, weight) for each track.
       Options are available to let you exclude tracks and limit the output.

REQUIRED ARGUMENTS

       coedbase.txt
              The name of the input ASCII crossover error data base as produced  by  x2sys_cross.
              If not given we read standard input instead.

       -Ccolumn
              Specify  which  data  column you want to process. Crossovers related to this column
              name must be present in the crossover data base.

       -TTAG  Specify the x2sys TAG which tracks the attributes of this data type.

OPTIONAL ARGUMENTS

       -A     Eliminate COEs by distributing the COE between the  two  tracks  in  proportion  to
              track  weight  and  producing  (dist, adjustment) spline knots files for each track
              (for the selected column). Such adjustments may  be  used  by  x2sys_datalist.  The
              adjustment  files are called track.column.adj and are placed in the $X2SYS_HOME/TAG
              directory. For background information on how these adjustments  are  designed,  see
              Mittal [1984].

       -I[list]
              Name  of  ASCII  file  with  a  list of track names (one per record) that should be
              excluded from consideration [Default includes all tracks].

       -L[corrtable]
              Apply optimal corrections to the chosen observable. Append the correction table  to
              use  [Default  uses  the  correction table TAG_corrections.txt which is expected to
              reside in the  $X2SYS_HOME/TAG  directory].  For  the  format  of  this  file,  see
              x2sys_solve.

       -Nnx_min
              Only report data from tracks involved in at least nx_min crossovers [all tracks].

       -Qe|i  Append  e  for  external  crossovers  or i for internal crossovers only [Default is
              external].

       -R[unit]west/east/south/north[/zmin/zmax][r]
              west, east, south, and north specify the region of interest, and  you  may  specify
              them in decimal degrees or in [+-]dd:mm[:ss.xxx][W|E|S|N] format. Append r if lower
              left and upper right  map  coordinates  are  given  instead  of  w/e/s/n.  The  two
              shorthands  -Rg  and  -Rd stand for global domain (0/360 and -180/+180 in longitude
              respectively, with -90/+90 in latitude).  Alternatively  for  grid  creation,  give
              Rcodelon/lat/nx/ny,  where  code is a 2-character combination of L, C, R (for left,
              center, or right) and T, M, B for top, middle, or bottom. e.g., BL for lower  left.
              This  indicates  which  point on a rectangular region the lon/lat coordinate refers
              to, and the grid dimensions nx and ny with grid spacings via -I is used  to  create
              the corresponding region.  Alternatively, specify the name of an existing grid file
              and the -R settings (and grid spacing, if applicable) are  copied  from  the  grid.
              Using  -Runit  expects  projected (Cartesian) coordinates compatible with chosen -J
              and we inversely project to determine actual rectangular  geographic  region.   For
              perspective  view  (-p), optionally append /zmin/zmax.  In case of perspective view
              (-p), a z-range (zmin, zmax) can be appended to indicate the third dimension.  This
              needs to be done only when using the -Jz option, not when using only the -p option.
              In the latter case a perspective view of  the  plane  is  plotted,  with  no  third
              dimension.  For Cartesian data just give xmin/xmax/ymin/ymax. This option bases the
              statistics on those COE that fall inside the specified domain.

       -Strack
              Name of a single track. If given we restrict output to those  crossovers  involving
              this track [Default output is crossovers involving any track pair].

       -V[level] (more ...)
              Select verbosity level [c].

       -^ or just -
              Print a short message about the syntax of the command, then exits (NOTE: on Windows
              use just -).

       -+ or just +
              Print  an  extensive  usage  (help)  message,  including  the  explanation  of  any
              module-specific option (but not the GMT common options), then exits.

       -? or no arguments
              Print  a  complete usage (help) message, including the explanation of options, then
              exits.

       --version
              Print GMT version and exit.

       --show-datadir
              Print full path to GMT share directory and exit.

EXAMPLES

       To report statistics of all the external magnetic crossovers associated with the tag MGD77
       from  the  file  COE_data.txt, restricted to occupy a certain region in the south Pacific,
       try

              gmt x2sys_report COE_data.txt -V -TMGD77 -R180/240/-60/-30 -Cmag >
                               mag_report.txt

       To report on the faa crossovers globally that involves track 12345678, try

              gmt x2sys_report COE_data.txt -V -TMGD77 -Cfaa -S2345678 > faa_report.txt

REFERENCES

       Mittal, P. K. (1984), Algorithm for error adjustment  of  potential  field  data  along  a
       survey network, Geophysics, 49(4), 467-469.

SEE ALSO

       x2sys_binlist   x2sys_cross   x2sys_datalist  x2sys_get  x2sys_init  x2sys_list  x2sys_put
       x2sys_solve

COPYRIGHT

       2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe