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

NAME

6       msr_normalize_header - Normalize or synchronize the header fields of an
7       MSRecord structure.
8
9

SYNOPSIS

11       #include <libmseed.h>
12
13       int  msr_normalize_header ( MSRecord *msr, flag verbose);
14
15

DESCRIPTION

17       msr_normalize_header updates the SEED  structures  associated  with  an
18       MSRecord   structure   (MSRecord.fsdh   and   the  blockette  chain  at
19       MSRecord.blkts) with primary values stored at the MSRecord level  (e.g.
20       MSRecord.starttime, MSRecord.samprate, etc.).
21
22       The  long  explanation  is  that certain key values (start time, sample
23       rate, etc.) are duplicated in a given MSRecord structure.  For  example
24       the  start  time  is stored at both MSRecord.starttime and in the BTIME
25       structure in the  FSDH  at  MSRecord.fsdh.   The  base  values  at  the
26       MSRecord level (e.g. MSRecord.starttime) are always the primary values.
27       But before the data record can be packed these values  must  be  trans‐
28       lated  back  into the SEED structures.  For these duplicated values the
29       msr_normalize_header routine peforms this translation.   Normally  this
30       routine  will be called via internal functions when msr_pack is called,
31       it could also be used to synchronize the header values  when  they  are
32       directly modified.
33
34

RETURN VALUE

36       msr_normalize_header  returns the header length in bytes on success and
37       -1 on error.
38
39

SEE ALSO

41       ms_intro(3), msr_pack(3) and msr_pack_header(3).
42
43

AUTHOR

45       Chad Trabant
46       IRIS Data Management Center
47
48
49
50Libmseed API                      2007/04/28           MSR_NORMALIZE_HEADER(3)