NAME

       msr_normalize_header  -  Normalize  or  synchronize  the  header  fields  of  an  MSRecord
       structure.

SYNOPSIS

       #include <libmseed.h>

       int  msr_normalize_header ( MSRecord *msr, flag verbose);

DESCRIPTION

       msr_normalize_header updates the SEED structures associated  with  an  MSRecord  structure
       (MSRecord.fsdh  and  the  blockette chain at MSRecord.blkts) with primary values stored at
       the MSRecord level (e.g. MSRecord.starttime, MSRecord.samprate, etc.).

       The long explanation is that certain key  values  (start  time,  sample  rate,  etc.)  are
       duplicated  in  a  given MSRecord structure.  For example the start time is stored at both
       MSRecord.starttime and in the BTIME structure in the  FSDH  at  MSRecord.fsdh.   The  base
       values at the MSRecord level (e.g. MSRecord.starttime) are always the primary values.  But
       before the data record can be packed these values must be translated back  into  the  SEED
       structures.   For  these  duplicated  values the msr_normalize_header routine peforms this
       translation.  Normally this routine will be called via internal functions when msr_pack is
       called,  it  could  also  be  used to synchronize the header values when they are directly
       modified.

RETURN VALUE

       msr_normalize_header returns the header length in bytes on success and -1 on error.

SEE ALSO

       ms_intro(3), msr_pack(3) and msr_pack_header(3).

AUTHOR

       Chad Trabant
       IRIS Data Management Center