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

NAME

6       ms_srcname - Determine source names using the SEED naming nomenclature.
7
8

SYNOPSIS

10       #include <libmseed.h>
11
12       char  *ms_recsrcname ( char *record, char *srcname, flag quality );
13
14       char  *msr_srcname ( MSRecord *msr, char *srcname, flag quality );
15
16       char  *mst_srcname ( MSTrace *mst, char *srcname, flag quality );
17
18

DESCRIPTION

20       These  routines  generate a source name using the SEED naming nomencla‐
21       ture in the format: 'NET_STA_LOC_CHAN' and stores it in the buffer pro‐
22       vided at srcname.  If the quality flag is true the data quality charac‐
23       ter will be appended to the source  name  resulting  in  a  format  of:
24       'NET_STA_LOC_CHAN_QUAL'.
25
26       The  memory pointed to by srcname must have enough room for the result‐
27       ing string.  As of SEED 2.4 this is a maximum of 18 characters  includ‐
28       ing the terminating NULL.  The MSRecord and MSTrace structs are capable
29       of producing a source name of 42 characters (including the  terminating
30       NULL)  and  libmseed  commonly  allocates 50 characters for the srcname
31       buffer.
32
33       ms_recsrcname generates a source name string for the SEED  data  record
34       at  record.   If the quality flag is true the quality character will be
35       appended.
36
37       msr_srcname generates a source name string for the  specified  MSRecord
38       struct.   If  the  quality  flag  is true the quality character will be
39       appended.
40
41       mst_srcname generates a source name string in for the specified MSTrace
42       struct.  If the quality flag is true *and* mst->dataquality is not zero
43       the quality character will be appended.
44
45

LOCATION IDS AND SPACES

47       The source name produced by these routines never include  spaces.   The
48       fixed format nature of SEED data records leads to blank or unused loca‐
49       tion IDs represented by spaces.  Such blank location IDs will  be  col‐
50       lapsed to nothing in the resulting sources names.
51
52

RETURN VALUES

54       The routines return a pointer to the resulting string or NULL on error.
55
56

AUTHOR

58       Chad Trabant
59       IRIS Data Management Center
60
61
62
63Libmseed API                      2006/11/27                     MS_SRCNAME(3)
Impressum