NAME

       mst_groupsort - Manipulate MSTrace segments in a MSTraceGroup

SYNOPSIS

       #include <libmseed.h>

       MSTrace  *mst_groupsort ( MSTraceGroup *mstg, flag quality );

       MSTrace  *mst_groupheal ( MSTraceGroup *mstg, double timetol,
                                 double sampratetol );

DESCRIPTION

       mst_groupsort  will  sort the MSTrace segments in a MSTraceGroup first on the source name (as returned by
       mst_srcname), then on start time, then on descending end time, and finally on sample rate.   The  quality
       flag,  passed  directly to mst_srcname, controls the addition of the quality indicator to the source name
       and thus the addition of sorting on the quality indicator (but only if  the  MSTrace  has  an  associated
       quality, see mst_srcname(3) for more details).

       mst_groupheal  will  attempt  to heal MSTrace segments in a MSTraceGroup if they fit within the specified
       time and sample rate tolerance (timetol and sampratetol respectively).  This is useful when, for whatever
       reason,  the MSTraceGroup has separate MSTrace segments which belong together.  This usually only happens
       when data is added to a MSTraceGroup in random data time order.  Before attempting to heal  the  MSTraces
       the MSTraceGroup will be sorted using mst_groupsort.

       If  sampratetol  is -1.0 the default tolerance of abs(1-sr1/sr2) is used.  If timetol is -1.0 the default
       time tolerance of 1/2 the sample period will be used.

RETURN VALUES

       mst_groupsort returns 0 on success and -1 on error.

       mst_groupheal returns the number of MSTrace segments merged on success and -1 on error.

SEE ALSO

       ms_intro(3) and mst_srcname(3).

AUTHOR

       Chad Trabant
       IRIS Data Management Center