x2sys_binlist(1gmt) [debian man page]
X2SYS_BINLIST(1gmt) Generic Mapping Tools X2SYS_BINLIST(1gmt) NAME
x2sys_binlist - Create bin-index files from track data files SYNOPSIS
x2sys_binlist track(s) -TTAG [ -D ] [ -E ] [ -V ] DESCRIPTION
x2sys_binlist reads one or more track data files and produces a multi-segment ASCII track bin-index file (tbf) with the track name in the header and one data record per bin crossed; these records contain lon, lat, index, flags[, dist], where lon, lat are the coordinates of the center of the bin, the index is the 1-D number of the bin, and flags is a bitflag that describes which data fields were available in this bin. The optional dist requires -D. The input files can be of any format, which must be described and passed with the -T option. The bin-index listing is a crude representation of where the track goes and is used by the data archivist to build an x2sys track data base for miscellaneous track queries, such as when needing to determine which tracks should be compared in a crossover analysis. You must run x2ys_init to initialize the tag before you can run the indexing. tracks Can be one or more ASCII, native binary, or COARDS netCDF 1-D data files. To supply the data files via a text file with a list of tracks (one per record), specify the name of the track list after a leading equal-sign (e.g., =tracks.lis). If the names are miss- ing their file extension we will append the suffix specified for this TAG. Track files will be searched for first in the current directory and second in all directories listed in $X2SYS_HOME/TAG/TAG_paths.txt (if it exists). [If $X2SYS_HOME is not set it will default to $GMT_SHAREDIR/x2sys]. (Note: MGD77 files will also be looked for via MGD77_HOME/mgd77_paths.txt and *.gmt files will be searched for via $GMT_SHAREDIR/mgg/gmtfile_paths). -T Specify the x2sys TAG which tracks the attributes of this data type. OPTIONS
No space between the option flag and the associated arguments. -D Calculate the length of trackline segments per bin [Default skips this step]. The length fragments are given as the 5th output col- umn (after the flags). The length units are obtained via the TAB setting (see x2sys_init). -E Convert geographic data to a cylindrical equal-area projection prior to binning. Basically, we apply the projection -JYlon0/37:04:17.166076/360, where lon0 is the mid-longitude of the region. Requires -D, geographical data, and a global region (e.g., -Rg or -Rd). This option is useful for statistics related to trackline density but should not be used when preparing bin- index files for the x2sys track data bases. -V Selects verbose mode, which will send progress reports to stderr [Default runs "silently"]. EXAMPLES
To create a bin index file from the MGD77 file 01030061.mgd77 using the settings associated with the tag MGD77, do x2sys_binlist 01030061.mgd77 -TMGD77 > 01030061.tbf To create a track bin index file of all MGD77+ files residing in the current directory using the settings associated with the tag MGD77+ and calculate track distances, run x2sys_binlist *.nc -TMGD77+ -D > all.tbf SEE ALSO
x2sys_cross(1), x2sys_datalist(1), x2sys_get(1), x2sys_init(1), x2sys_put(1), x2sys_report(1), x2sys_solve(1) GMT 4.5.7 15 Jul 2011 X2SYS_BINLIST(1gmt)
Check Out this Related Man Page
X2SYS_GET(1gmt) Generic Mapping Tools X2SYS_GET(1gmt) NAME
x2sys_get - Get track listing from the x2sys track index databases SYNOPSIS
BD(x2sys_get) -TIT(TAG) [ -C ] [ -D ] [ -E ] [ -FIT(flags) ] [ -L[IT(list)] ] [ -NIT(flags) ] [ -Qe|BD(i) ] [ -Rwest/east/south/north[r] ] [ -V ] ] DESCRIPTION
BD(x2sys_get) will return the names of the track data files in the x2sys data base for this TAG that match the given requirements. You may choose a specific region and optionally ask only for tracks that meet certain data criteria. Finally, you may select an option to list all possible pairs that might generate crossovers. -T Specify the x2sys TAG which tracks the attributes of this data type. OPTIONS
No space between the option flag and the associated arguments. -C Instead of reporting the track names, just output the coordinates of the center of each bin that has at least one track with the specified data. -D Only report the track names [Default adds the availability of data for each field]. -E Append the file extension to all reported tracks [no extension]. -F Give a comma-separated list of column names (as described in the definition file) that should all be present within the selected region. [Default selects all data columns]. A track will be included in the returned list if at least one bin reports that the track has all of the listed columns. -L Crossover mode. Return a list of track pairs that should be checked for possible crossovers. The list is determined from the bin- index data base on the assumption that tracks occupying the same bin are very likely to intersect. By default we return all possi- ble pairs in the data base. Append the name of a file with a list of tracks if you want to limit the output to those pairs that involve at least one of the track names in your list. The output is suitable for the -K option in x2sys_cross. -N Give a comma-separated list of column names (as described in the definition file) that all must be absent. A track will be excluded from the returned list if at least one bin reports that the track some all of the listed columns. -Q Append e for external COEs only, and i for internal COEs only [Default is all COEs]. This applies to the crossover setup only and requires -L. -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. For Cartesian data just give xmin/xmax/ymin/ymax. This option limits the tracks to those that fall at least partly inside the spec- ified domain. -V Selects verbose mode, which will send progress reports to stderr [Default runs "silently"]. EXAMPLES
To find all the tracks associated with the tag MGD77, restricted to occupy a certain region in the south Pacific, and have at least free air anomalies and bathymetry, try BD(x2sys_get) -V -TMGD77 -R180/240/-60/-30 -Ffaa,depth To find all the tracks associated with the tag MGD77 that have depth but not twt, try BD(x2sys_get) -V -TMGD77 -Fdepth -Ntwt To find all the pairs associated with the tag MGD77 that might intersect each other, but only those pairs which involves tracks in your list new.lis, try BD(x2sys_get) -V -TMGD77 -Lnew.lis > xpairs.lis NOTE
The tracks that are returned all have the requested data (-F) within the specified region (-R). Furthermore, the columns of Y and N for other data types also reflect the content of the track portion within the selected region. SEE ALSO
x2sys_binlist(1), x2sys_cross(1), x2sys_datalist(1), x2sys_init(1), x2sys_list(1), x2sys_put(1), x2sys_report(1), x2sys_solve(1) GMT 4.5.7 15 Jul 2011 X2SYS_GET(1gmt)