/*
 *   THIS FILE IS UNDER RCS - DO NOT MODIFY UNLESS YOU HAVE
 *   CHECKED IT OUT USING THE COMMAND CHECKOUT.
 *
 *    $Id: sachead.h 349 2000-12-31 17:27:25Z lombard $
 *
 *    Revision history:
 *     $Log$
 *     Revision 1.2  2000/12/31 17:27:25  lombard
 *      More bug fixes and cleanup.
 *
 *     Revision 1.1  2000/12/19 18:31:25  lombard
 *     Initial revision
 *
 *
 *
 */

/* Earthwrm note:
 *  This file is sachead.h, part of the localmag program. It contains
 *  ONLY definitions related to SAC file headers. It does NOT contain
 *  any other definitions such as sacputaway function prototypes.
 *  Sorry for the confusion this may generate, but it's the only 
 *  way I could see to handle the problems in the earthworm file
 *  known as include/sachead.h  PNL 12/19/00
 */

/*              SAC Header Include File
 *
 *       This include file should be used when ever the SAC header
 *       is accessed.
 *       Values of `-12345' are used for any varriable which is UNKNOWN.
 *
 */


/************************************/
/** #define CONSTANTS              **/
/************************************/

#define SACHEADERSIZE   632     /* # of bytes in SAC header */

#define SACVERSION      6       /* version number of SAC */
#define SAC_I_D         2.0     /* SAC I.D. number */

#define SACWORD         float   /* SAC data is an array of floats */
#define SACUNDEF        -12345  /* undefined value */
#define SACSTRUNDEF     "-12345  "      /* undefined value for strings */

#define SACTEMP4        11

#define SACTEMP6        3
#define SACTEMP7        10

#define KEVNMLEN        16      /* length of event name */
#define K_LEN           8       /* length of all other string fields */

/* header value  constants */
#define SAC_ITIME      1L
#define SAC_IUNKN      5L
#define SAC_IBEGINTIME 9L
#define SAC_IO        11L

#define NUM_FLOAT       70      /* number of floats in header */
#define MAXINT          40      /* number of ints in header */
#define MAXSTRING       24      /* number of strings in header */

#define SAC_MAX_POLES_OR_ZEROES 100
#define     MAXTXT           150

/************************************/
/** TYPE DECLARATIONS              **/
/************************************/

/*      This is the actual data structure which is used to enter the header
        variables.
*/
struct SAChead {
        /* floating point fields */
        float delta;        /* nominal increment between evenly spaced data (sec) */
        float depmin;       /* min value of trace data (dep var) */
        float depmax;       /* max value of trace data (dep var) */
        float scale;        /* scale factor - NOT USED */
        float odelta;       /* Observed delta if different from delta */
        float b;            /* beginning value of time (indep var)  */
        float e;            /* ending value of time (indep var) */
        float o;            /* event origin time, relative to reference time */
        float a;            /* first arrival time, relative to reference time */
        float internal1;    
        float t0;           /* S-wave arrival time, relative to reference time */
        float t1;
        float t2;
        float t3;
        float t4;
        float t5;
        float t6;
        float t7;
        float t8;
        float t9;
        float f;            /* End of event time, relative to reference time */
        float resp0;
        float resp1;
        float resp2;
        float resp3;
        float resp4;
        float resp5;
        float resp6;
        float resp7;
        float resp8;
        float resp9;
        float stla;         /* station latitude (deg north) */
        float stlo;         /* station longitude (deg east) */
        float stel;         /* station elevation (meters) */
        float stdp;         
        float evla;         /* event location, latitude (deg north) */
        float evlo;         /* event location, longitude (deg east) */
        float evel;         
        float evdp;         /* event depth (km) */
        float blank1;
        float user0;        /* event magnitude */
        float user1;        /* event location rms (sec) */
        float user2;        /* event location gap (deg) */
        float user3;        /* event location standard error (km) */
        float user4;        
        float user5;        /* number of stations used in location */
        float user6;
        float user7;
        float user8;
        float user9;
        float dist;         /* event-station epicentral distance (km) */
        float az;           /* event to station azimuth (deg) */
        float baz;          /* event to station back-azimuth (deg) */
        float gcarc;        /* event to station arc distance (deg) */
        float internal2;
        float internal3;
        float depmen;
        float cmpaz;        /* component azimuth (deg) */
        float cmpinc;       /* component inclination (deg) */
float blank4[SACTEMP4];     
                            
        /* integer fields */
        long nzyear;        /* Reference time = Trace beginning time (year) */
        long nzjday;        /*  (julian day) */
        long nzhour;        /*  (hour) */
        long nzmin;                 /*  (minute) */
        long nzsec;                 /*  (second) */
        long nzmsec;        /*  (millisecond) */
        long internal4;
        long internal5;
        long internal6;
        long npts;          /* number of points in trace */
        long internal7;
        long internal8;
long blank6[SACTEMP6];
        long iftype;        /* Type of data:  1 for time series */
        long idep;          /* Type of dependent data =UNKNOWN */
        long iztype;        /* zero time equivalence  =1 for beginning */
        long iblank6a;
        long iinst;
        long istreg;
        long ievreg;
        long ievtyp;        /* event type; IUNKN */
        long iqual;
        long isynth;
long blank7[SACTEMP7];
        unsigned long leven;    /* =1 for evenly spaced data */
        unsigned long lpspol;   /* =1 for correct polarity, 0 for reversed */
        unsigned long lovrok;
        unsigned long lcalda;
        unsigned long lblank1;

        /* character string fields */
        char kstnm[K_LEN];      /* station name (blank padded) */
        char kevnm[KEVNMLEN];   /* event name */
        char khole[K_LEN];
        char ko[K_LEN];         /* Origin time label */
        char ka[K_LEN];         /* First arrival time label */
        char kt0[K_LEN];        /* S-wave time label */
        char kt1[K_LEN];
        char kt2[K_LEN];
        char kt3[K_LEN];
        char kt4[K_LEN];
        char kt5[K_LEN];
        char kt6[K_LEN];
        char kt7[K_LEN];
        char kt8[K_LEN];
        char kt9[K_LEN];
        char kf[K_LEN];
        char kuser0[K_LEN];
        char kuser1[K_LEN];
        char kuser2[K_LEN];
        char kcmpnm[K_LEN];
        char knetwk[K_LEN];
        char kdatrd[K_LEN];
        char kinst[K_LEN];
};

/*      This is a structure of the same size as 'SAChead', but in a form
        that is easier to initialize
*/

#define NUM_FLOAT       70      /* number of floats in header */
#define MAXINT          40      /* number of ints in header */
#define MAXSTRING       24      /* number of strings in header */

struct SAChead2 {
        float SACfloat[NUM_FLOAT];
        long SACint[MAXINT];
        char SACstring[MAXSTRING][K_LEN];
};


typedef struct _SAC_PZNum
{
  double      dReal;
  double      dImag;
} SAC_PZNum;

typedef struct _SAC_ResponseStruct
{
  double    dGain;
  int         iNumPoles;
  int         iNumZeroes;
  SAC_PZNum  Poles[SAC_MAX_POLES_OR_ZEROES];
  SAC_PZNum  Zeroes[SAC_MAX_POLES_OR_ZEROES];
} SAC_ResponseStruct;

/** SACFilelist is used to create an ordered list of files.
    The filelist is used by several SAC macros **/
typedef struct _SACFileList
{
    char    filename[MAXTXT];   /* Sac file name */
    double  sort_param;         /* sort parameter - starttime */
} SACFileListStruct;

typedef struct _SAC_OriginStruct
{
  double dLat;       /* ->evla */
  double dLon;       /* ->evlo */
  double dElev;      /* ->evel */
  double tOrigin;    /* ->o */
} SAC_OriginStruct;

typedef struct _SAC_ArrivalStruct
{
  double tPhase;     /* ->a */
  char   cPhase;     /* ->ka[0] */  /* only P and S are supported by SAC */
  double dCodaLen;   /* ->f */
  float  dDist;      /* ->dist */
  float  dAzm;       /* ->az */
  int    iPhaseWt;   /* ->ka[2] */
  char   cFMotion;   /* ->ka[1] */
} SAC_ArrivalStruct;

typedef struct _SAC_StationStruct
{
  float dLat; /* ->stla */
  float dLon; /* ->stlo */
  float dElev; /* ->stel */
  int   bResponseIsValid;
  SAC_ResponseStruct * pResponse;
} SAC_StationStruct;


/* eof sachead.h */
