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