1MST_GROUPSORT(3) Library Functions Manual MST_GROUPSORT(3)
2
3
4
6 mst_groupsort - Manipulate MSTrace segments in a MSTraceGroup
7
8
10 #include <libmseed.h>
11
12 MSTrace *mst_groupsort ( MSTraceGroup *mstg, flag quality );
13
14 MSTrace *mst_groupheal ( MSTraceGroup *mstg, double timetol,
15 double sampratetol );
16
17
19 mst_groupsort will sort the MSTrace segments in a MSTraceGroup first on
20 the source name (as returned by mst_srcname), then on start time, then
21 on descending end time, and finally on sample rate. The quality flag,
22 passed directly to mst_srcname, controls the addition of the quality
23 indicator to the source name and thus the addition of sorting on the
24 quality indicator (but only if the MSTrace has an associated quality,
25 see mst_srcname(3) for more details).
26
27 mst_groupheal will attempt to heal MSTrace segments in a MSTraceGroup
28 if they fit within the specified time and sample rate tolerance (time‐
29 tol and sampratetol respectively). This is useful when, for whatever
30 reason, the MSTraceGroup has separate MSTrace segments which belong
31 together. This usually only happens when data is added to a MSTrace‐
32 Group in random data time order. Before attempting to heal the
33 MSTraces the MSTraceGroup will be sorted using mst_groupsort.
34
35 If sampratetol is -1.0 the default tolerance of abs(1-sr1/sr2) is used.
36 If timetol is -1.0 the default time tolerance of 1/2 the sample period
37 will be used.
38
39
41 mst_groupsort returns 0 on success and -1 on error.
42
43 mst_groupheal returns the number of MSTrace segments merged on success
44 and -1 on error.
45
46
48 ms_intro(3) and mst_srcname(3).
49
50
52 Chad Trabant
53 IRIS Data Management Center
54
55
56
57Libmseed API 2007/04/12 MST_GROUPSORT(3)