NAME

       ms_srcname - Determine source names using the SEED naming nomenclature.

SYNOPSIS

       #include <libmseed.h>

       char  *ms_recsrcname ( char *record, char *srcname, flag quality );

       char  *msr_srcname ( MSRecord *msr, char *srcname, flag quality );

       char  *mst_srcname ( MSTrace *mst, char *srcname, flag quality );

DESCRIPTION

       These   routines   generate   a   source   name  using  the  SEED  naming  nomenclature  in  the  format:
       'NET_STA_LOC_CHAN' and stores it in the buffer provided at srcname.  If the quality flag is true the data
       quality character will be appended to the source name resulting in a format of: 'NET_STA_LOC_CHAN_QUAL'.

       The memory pointed to by srcname must have enough room for the resulting string.  As of SEED 2.4 this  is
       a  maximum of 18 characters including the terminating NULL.  The MSRecord and MSTrace structs are capable
       of producing a source name of 42 characters  (including  the  terminating  NULL)  and  libmseed  commonly
       allocates 50 characters for the srcname buffer.

       ms_recsrcname  generates a source name string for the SEED data record at record.  If the quality flag is
       true the quality character will be appended.

       msr_srcname generates a source name string for the specified MSRecord struct.  If  the  quality  flag  is
       true the quality character will be appended.

       mst_srcname  generates  a source name string in for the specified MSTrace struct.  If the quality flag is
       true *and* mst->dataquality is not zero the quality character will be appended.

LOCATION IDS AND SPACES

       The source name produced by these routines never include spaces.  The fixed format nature  of  SEED  data
       records  leads  to  blank  or unused location IDs represented by spaces.  Such blank location IDs will be
       collapsed to nothing in the resulting sources names.

RETURN VALUES

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

AUTHOR

       Chad Trabant
       IRIS Data Management Center

Libmseed API                                       2006/11/27                                      MS_SRCNAME(3)