Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

x_over(1gmt) [debian man page]

X_OVER(1gmt)						       Generic Mapping Tools						      X_OVER(1gmt)

NAME
x_over - Find and compute Cross-Over Errors SYNOPSIS
x_over leg_1 [ leg_2 ] [ -A ] [ -C ] [ -L ] [ -V ] [ -Wtimegap ] [ -Gfact ] [ -Mfact ] [ -Tfact ] [ -Nnp_int ] DESCRIPTION
x_over is used to inspect two cruises to see if they intersect, and if so report the time, position, discrepancies in gravity/magnetics/ba- thymetry, heading for each track segment, and the average values of the geophysical observables at the cross-over point. The names of the legs are passed on the command line. If they are identical or only one name is passed, then x_over looks for internal cross-overs. The optional parameters are: -A Use an Akima spline to interpolate the geophysical field at the cross-over point. -C Use a Natural Cubic spline function instead. -L Use a linear interpolant [Default]. -W Do not compute cross-overs if the 2 nearest points are more than timegap minutes apart. -G Scale gravity by fact [Default is 0.1 since gmt-files store gravity in g.u.] -M Scale magnetic anomaly by fact [1.0]. -T Scale bathymetry by fact [1.0]. -N Specify how many points to use in the interpolation [Default is 6]. -V Selects verbose mode, which will send progress reports to stderr [Default runs "silently"]. Report the number of cross-overs for this pair of legs. BEWARE
The COEs found are printed out to standard output in ASCII format. The first record contains the leg 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 magnetics, average bathymetry, heading along track #1, and heading along track #2. Sign convention: If lega and legb are passed on the command line, then the COE value is Value (lega) - Value (legb). It is rec- ommended 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. SEE ALSO
GMT(1), x_system(1) REFERENCES
Wessel, P. XOVER: A Cross-over Error Detector for Track Data, Computers & Geosciences, 15, 333-346. GMT 4.5.7 15 Jul 2011 X_OVER(1gmt)

Check Out this Related Man Page

GMTLIST(1gmt)						       Generic Mapping Tools						     GMTLIST(1gmt)

NAME
gmtlist - A data-extractor for <legid>.gmt files SYNOPSIS
gmtlist leg-ids [ -Ccorrectionfile ] [ -Dastartdate ] [ -Dbstopdate ] [ -Fflags ] [ -G ] [ -H[i][nrec] ] [ -Rwest/east/south/north[r] ] [ -Sastartdist ] [ -Sbstopdist ] [ -V ] [ -Wweight ] [ -bo[s|S|d|D[ncol]|c[var1/...]] ] DESCRIPTION
gmtlist reads <legid>.gmt files and produces an ASCII [or binary] table. The <legid>.gmt files contain time(s), latitude(y), longitude(x), gravity(g/G), magnetics(m/M), and bathymetry(t/T), and the user may extract any combination of these 6 parameters + distance(d), heading (h), velocity (v), and weight (w, see -W). A sub-section can be specified by passing time- or distance-intervals along track or by select- ing a region. leg-ids Can be one or more cruisenames. To give a list of names, use `cat list_of_legs`. OPTIONS
No space between the option flag and the associated arguments -C Apply crossover Corrections to the data. If no correction file is given, gmtlist reads the default correction file. (See XSYSTEM for how to set up your own correction file). -Da Do not list data collected before startdate (mm/dd/yyyy/hh:mm) [Default is first day]. -Db Do not list data collected after stopdate (mm/dd/yyyy/hh:mm). [Default is last day]. -F Can be any combination of syxgmtdhv to indicate the desired output data. The data will appear in the order indicated by flags. If G, M, or T is substituted for g, m, t, only records that have that combination of data are written out. If s is followed by c (calen- dar), then yyyy/mm/dd/hh/mm/ss is written out, if s is followed by j (julian), then yyyy/jd/hh/mm/ss is written out. Default is seconds from start of year. -G Force Geographical longitudes (-180/+180) rather than geodetic (0-360) [Default]. -H Issue a header record with names for each data field. -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). Alterna- tively, specify the name of an existing grid file and the -R settings (and grid spacing, if applicable) are copied from the grid. -Sa Do not list data that are less than startdist km along track from port of departure. [Default is 0]. -Sb Do not list data that are more than stopdist km along track from port of departure. [Default is length of track]. -V Selects verbose mode, which will send progress reports to stderr [Default runs "silently"]. -W Set the weight for these data. Weight output option must be set in -F. This is useful if the data are to be processed with the weighted averaging techniques offered by blockmean, blockmedian, and blockmode. -b Selects binary output mode (in double precision) [Default is ASCII]. -H is ignored if -b is selected. Julian and calendar dates are not supported for binary time output (i.e., you get seconds from start of year). EXAMPLES
To get a (distance, heading, crossover-corrected gravity, bathymetry) listing from c2104.gmt, starting at June 3 1971 20:45 and ending at distance = 5000 km, use the following command: gmtlist c2104 -Da6/3/1971/20:45 -Sb5000 -Fdhgt -C > myfile To make input for blockmean and surface using all the cruises listed in the file gmt.list, but only the data that are inside the specified area, and make output binary: gmtlist `cat gmt.list` -Fxyg -R-40/-30/25/35 -b > allgrav.xyg SEE ALSO
GMT(1), x_system(1) REFERENCES
Wessel, P., and W. H. F. Smith, 2011, The Generic Mapping Tools (GMT) version 4.5.7 Technical Reference & Cookbook, SOEST/NOAA. Wessel, P., and W. H. F. Smith, 1998, New, Improved Version of Generic Mapping Tools Released, EOS Trans., AGU, 79(47), p. 579. Wessel, P., and W. H. F. Smith, 1995, New Version of the Generic Mapping Tools Released, EOS Trans., AGU, 76(33), p. 329. Wessel, P., and W. H. F. Smith, 1995, New Version of the Generic Mapping Tools Released, http://www.agu.org/eos_elec/95154e.html, Copyright 1995 by the American Geophysical Union. Wessel, P., and W. H. F. Smith, 1991, Free Software Helps Map and Display Data, EOS Trans., AGU, 72(41), p. 441. GMT 4.5.7 15 Jul 2011 GMTLIST(1gmt)
Man Page