1X2SYS_REPORT(1)              Generic Mapping Tools             X2SYS_REPORT(1)
2
3
4

NAME

6       x2sys_report - Report statistics from crossover data base
7

SYNOPSIS

9       x2sys_report  -Ccolumn  -TTAG  [  coedbase.txt  ] [ -A ] [ -I[list] ] [
10       -L[corrtable] ] [ -Nnx_min ] [ -Qe|i ] [ -Rwest/east/south/north[r] ] [
11       -Strack ] [ -V ]
12

DESCRIPTION

14       x2sys_report will read the input crossover ASCII data base coedbase.txt
15       (or stdin) and report on the statistics of crossovers (n, mean,  stdev,
16       rms,  weight) for each track.  Options are available to let you exclude
17       tracks and limit the output.
18
19       -C     Specify which data  column  you  want  to  process.   Crossovers
20              related  to  this  column  name must be present in the crossover
21              data base.
22
23       -T     Specify the x2sys TAG which tracks the attributes of  this  data
24              type.
25

OPTIONS

27       No space between the option flag and the associated arguments.
28
29       coedbase.txt
30              The  name  of  the input ASCII crossover error data base as pro‐
31              duced by x2sys_cross.  If  not  given  we  read  standard  input
32              instead.
33
34       -A     Eliminate COEs by distributing the COE between the two tracks in
35              proportion to track  weight  and  producing  (dist,  adjustment)
36              spline  knots  files  for  each track (for the selected column).
37              Such adjustments may be used by x2sys_datalist.  The  adjustment
38              files   are  called  track.column.adj  and  are  placed  in  the
39              $X2SYS_HOME/TAG directory. For  background  information  on  how
40              these adjustments are designed, see Mittal [1984].
41
42       -I     Name  of  ASCII file with a list of track names (one per record)
43              that should be excluded from consideration [Default includes all
44              tracks].
45
46       -L     Apply  optimal corrections to the chosen observable.  Append the
47              correction table to  use  [Default  uses  the  correction  table
48              TAG_corrections.txt   which   is   expected  to  reside  in  the
49              $X2SYS_HOME/TAG directory].  For the format of  this  file,  see
50              x2sys_solve.
51
52       -N     Only  report  data  from  tracks  involved  in  at  least nx_min
53              crossovers [all tracks].
54
55       -Q     Append e for external crossovers or i  for  internal  crossovers
56              only [Default is external].
57
58       -R     west, east, south, and north specify the Region of interest, and
59              you   may   specify   them   in   decimal    degrees    or    in
60              [+-]dd:mm[:ss.xxx][W|E|S|N]  format.  Append r if lower left and
61              upper right map coordinates are given instead of  w/e/s/n.   The
62              two  shorthands  -Rg  and -Rd stand for global domain (0/360 and
63              -180/+180 in longitude respectively, with -90/+90 in  latitude).
64              Alternatively, specify the name of an existing grid file and the
65              -R settings (and grid spacing, if applicable)  are  copied  from
66              the  grid.   For  Cartesian  data just give xmin/xmax/ymin/ymax.
67              This option bases the statistics on those COE that  fall  inside
68              the specified domain.
69
70       -S     Name  of  a  single track.  If given we restrict output to those
71              crossovers involving this track [Default  output  is  crossovers
72              involving any track pair].
73
74       -V     Selects verbose mode, which will send progress reports to stderr
75              [Default runs "silently"].
76

EXAMPLES

78       To report statistics of all the external magnetic crossovers associated
79       with  the  tag MGD77 from the file COE_data.txt, restricted to occupy a
80       certain region in the south Pacific, try
81
82       x2sys_report  COE_data.txt  -V  -TMGD77   -R180/240/-60/-30   -Cmag   >
83       mag_report.txt
84
85       To  report on the faa crossovers globally that involves track 12345678,
86       try
87
88       x2sys_report COE_data.txt -V -TMGD77 -Cfaa -S12345678  > faa_report.txt
89

REFERENCES

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

SEE ALSO

95       x2sys_binlist(1)    x2sys_cross(1)    x2sys_datalist(1)    x2sys_get(1)
96       x2sys_init(1) x2sys_list(1) x2sys_put(1) x2sys_solve(1)
97
98
99
100GMT 4.5.6                         10 Mar 2011                  X2SYS_REPORT(1)
Impressum