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

NAME

6       mstl_init - Adding MSRecord data coverage to and MSTraceList structure
7
8

SYNOPSIS

10       #include <libmseed.h>
11
12       MSTraceSeg *mstl_addmsr ( MSTraceList *mstl, MSRecord *msr,
13                                 flag dataquality, flag autoheal,
14                                 double timetol, double sampratetol );
15
16
17

DESCRIPTION

19       mstl_addmsr adds the data coverage in a MSRecord structure to the spec‐
20       ified MSTraceList structure.  If data samples are associated  with  the
21       MSRecord they will also be added to the MSTraceList.  New MSTraceID and
22       MSTraceSeg sub-structures will be created and added to the  MSTraceList
23       as needed.
24
25       Each  MSTraceList  contains a list of trace IDs as MSTraceID structures
26       each of which contain a list of time segments as MSTraceSeg structures.
27       This  routine  will maintain the list of trace IDs in alphanumeric sort
28       order and the subsequent time segments in time order.
29
30       If the dataquality flag is true traces will be grouped  by  quality  in
31       addition  to  the source name identifiers, in short differentiate using
32       quality or not.
33
34       If the autoheal flag is true any two trace  segments  which  would  fit
35       together  due  to  the  addition  of  the new MSRecord coverage will be
36       merged.  The only reason to set this option to  false  (0)  is  if  the
37       prvtptr pointer member of the MSTraceSeg structures is being used since
38       libmseed has no knowledge how such data should be merged.
39
40

RETURN VALUES

42       mstl_addmsr returns NULL on error  and  a  pointer  to  the  MSTraceSeg
43       structure to which the data coverage was added on success.
44
45

SEE ALSO

47       mstl_init(3) and mstl_free(3).
48
49

AUTHOR

51       Chad Trabant
52       IRIS Data Management Center
53
54
55
56Libmseed API                      2008/11/21                      MSTL_INIT(3)