1MST_GROUPSORT(3)           Library Functions Manual           MST_GROUPSORT(3)
2
3
4

NAME

6       mst_groupsort - Manipulate MSTrace segments in a MSTraceGroup
7
8

SYNOPSIS

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

DESCRIPTION

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

RETURN VALUES

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

SEE ALSO

48       ms_intro(3) and mst_srcname(3).
49
50

AUTHOR

52       Chad Trabant
53       IRIS Data Management Center
54
55
56
57Libmseed API                      2007/04/12                  MST_GROUPSORT(3)