#### DESCRIPTION #######################################################
########################################################################
##   Further preparation of seismic data for analysis of a specific   ##
##  seismic phase.  Essentially this is a wrapper script for more     ##
##  specific scripts to simplify the preprocessing stage.             ##
##                                                                    ##
##   Stages:                                                          ##
##    <> pull data from indicated directory that has correct value of ##
##       the indicated header field (ie verticals - cmpinc=0)         ##
##    <> write phase arrival times into header                        ##
##    <> remove files which do not include window near phase time     ##
##    <> lowpass filter data to prepare for interpolation             ##
##    <> interpolate data to a low common sample rate to avoid edge   ##
##       effects caused by resampling without initial conditions      ##
##                                                                    ##
##   LAST EDITED: June 15, 2008 at 16:45 GMT by Garrett Euler         ##
##   VERSION INFO:                                                    ##
##            1.2: removed filtering and resampling                   ##
##            1.1: rewrite for new setup                              ##
##            1.0: initial version                                    ##
########################################################################

#### USAGE #############################################################
########################################################################
##  Command line input:                                               ##
##     investigate_phase.pl in_dir date field value phase 1dmodel     ##
##                          window nproc                              ##
##                                                                    ##
##     where:                                                         ##
##        *in_dir - input data directory (without date)               ##
##        *date - event datetime string of data to work on            ##
##        *field - header field to use for selecting files            ##
##        *value - value of header field for selecting files          ##
##        *phase - seismic phase of interest - case sensitive         ##
##        *1dmodel - 1D model used to get phase arrival time          ##
##        *window - begin and end times of a file must be further     ##
##                  in seconds than this value from the arrival time  ##
##                  to be kept (ie 1/2 of minimum allowed window)     ##
##        *nproc - number of processes to use for tasks               ##
########################################################################

