NAME
x2sys_init - Initialize data baes for track data files
SYNOPSIS
x2sys_init TAG [ -Ddeffile ] [ -F ] [ -Gd|g ] [ -Idx[dy] ] [
-Rwest/east/south/north ] [ -V ] [ -Wsize ]
DESCRIPTION
x2sys_init initializes a set of data bases that are particular to one
kind of track data. These data and their associated data bases are
given a short-hand notation called a system TAG. The TAG remembers set-
tings such as file format, whether the data are geographic or not, and
the binning resolution for track indexes. Running x2sys_init is a pre-
requisite to running x2sys_binlist which will create a crude represen-
tation of where data track go; this serves as input to the x2sys_put
too which updates the track data base. Then, x2sys_get can be used to
find which tracks and data are available inside a given region.
TAG The unique name of this data type system.
OPTIONS
No space between the option flag and the associated arguments
-D Definition file for this data set. [x2sys.def]
-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]).
-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
and upper right map coordinates are given instead of wesn. The
two shorthands -Rg -Rd stand for global domain (0/360 or
-180/+180 in longitude respectively, with -90/+90 in latitude).
For calendar time coordinates you may either give relative time
(relative to the selected TIME_EPOCH and in the selected
TIME_UNIT; append t to -JX|x), or absolute time of the form
[date]T[clock] (append T to -JX|x). At least one of date and
clock must be present; the T is always required. The date string
must be of the form [-]yyyy[-mm[-dd]] (Gregorian calendar) or
yyyy[-Www[-d]] (ISO week calendar), while the clock string must
be of the form hh:mm:ss[.xxx]. The use of delimiters and their
type and positions must be as indicated (however, input/output
and plotting formats are flexible).
-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].
EXAMPLES
lon a N 0 1 0 %10.5lf
lat a N 0 1 0 %9.5lf
time a N 0 1 0 %7.1lf
obs1 a N 0 1 0 %7.2lf
obs2 a N 0 1 0 %7.2lf
obs3 a N 0 1 0 %7.2lf
For ascii data the intype format is always a, Nan-proxy? should be Y if
there are certain values (e.g., -9999) that is used to represent miss-
ing data (NaNs). If so, the NaN-proxy values should be set accordingly
(otherwise it is ignored). The scale and offset is applied to the data
after it is read (first scaled, then offset), whereas the oformat is
used by some programs for formatted output.
Next we create the TAG and the databases for these line track files.
Assuming these are geographic and that we want to keep track of the
data distribution at a 1 x 1 degree resolution, we may run
x2sys_init LINE -V -G -Dline -R0/360/-90/90 -I1/1
where we have call the tag LINE. When x2sys tools will try to read your
line data files they will look in the file TAG_paths.txt for a list of
all the directories to examine. Therefore, create such a file (here
LINE_paths.txt) and stick the full paths to your data directories
there. All TAG-related files will be expected to be in the directory
pointed to by $X2SYS_HOME.
create tbf file(s)
Once the (empty) TAG database have been initialize we go through
a two- step process to populate them. First we run x2sys_binlist
on all our track files to create one (or more) multi-segment
track binindex files (tbf). These contain information on which
1x1 degree bins each track has visited and which observations
(in your case obs1, obs2, obs3) where actually observed (not all
tracks may have all the kinds of observations). Next, the track
binindex files are fed to x2sys_put which will insert the infor-
mation into the tag databases.
search Now you may use x2sys_get to find all the tracks within a cer-
tain sub-region, and optionally limit the search to those tracks
that have a particular combination of observables.
MGD77 or GMT
Definition files already exist for MGD77 files, the old *.gmt
files manipulated by the mgg supplements, and plain x,y,z
tracks. To initiate new track databases to be used with MGD77
data from NGDC, try
x2sys_init MGD77 -V -Dmgd77 -R0/360/-90/90 -I1/1
and the other steps are similar.
binary files
Let us pretend that your line files actually were binary files
with a 128-byte header structure (to be skipped) followed by the
data records and where lon, lat, time are double precision num-
time d N 0 1 0 %7.1lf
obs1 h Y 32000 0.1 0 %6.1lf
obs2 h Y 32000 0.1 0 %6.1lf
obs3 h N 0 0.1 0 %6.1lf
The rest of the steps are identical. The accepted intype flags
are c fir sugned 1-byte character (-127,+128), u for unsigned
byte (0-255), h for signed 2-byte integers (-32767,+32767), i
for signed 4-byte integers (-2,147,483,648,+2,147,483,648), f
for 4-byte floating points and d for 8-byte double precision
floating points.
SEE ALSO
x2sys_binlist(GMTMANSECTION) x2sys_get(GMTMANSECTION) x2sys_put(GMTMAN-
SECTION)
GMT4.0 1 Oct 2004 X2SYS_INIT(GMTMANSECTION)
Man(1) output converted with
man2html