next up previous contents index
Next: Description Up: Header FrameCalibration.h Previous: Module FrameCalibration.c   Contents   Index

Prototypes



void
LALExtractFrameResponse(
    LALStatus               *status,
    COMPLEX8FrequencySeries *output,
    const CHAR              *catalog,
    const CHAR              *ifo
    )

The routine LALFrameExtractResponse() extracts the necessary calibration information from the frames. The frames used to construct the calibration are located using the specified catalog. The function constructs a response function (as a frequency series) from this information. If the fourth argument is non-NULL then this string specifies the detector (H1, H2, L1, etc.) for which the calibration is required. Certain fields of the output should be set before this routine is called. In particular:

  1. The epoch field of the frequency series should be set to the correct epoch so that the routine can generate a response function tailored to that time (accounting for calibration drifts).

  2. The units of the response function should be set to be either strain-per-count (for a response function) or count-per-strain (for a transfer function); the routine will then return either the response function or its inverse depending on the specified units. Furthermore, the power-of-ten field of the units is examined to scale the response function accordingly.

  3. The data vector should be allocated to the required length and the frequency step size should be set to the required value so that the routine can interpolate the response function to the required frequencies.
The format of the frame catalog must be as follows.
  1. It must contain an entry for one frame of type CAL_REF which contains the response and cavity gain frequency series that will be up dated to the specified point in time. For example it must contain an entry such as
       L CAL_REF 715388533 64 file://localhost/path/to/L-CAL_REF-715388533-64.gwf
    
    where the frame file contains the channels L1:CAL-RESPONSE and L1:CAL-CAV_GAIN.

  2. It must also contain entries for the frames needed to update the point calibration to the current time. These must contain the L1:CAL-OLOOP_FAC and L1:CAL-CAV_FAC channels. The update factor frames may either be SenseMon type frames, containing the factor channels as real_8 trend data or frames generated by the lalapps program lalapps_mkcalfac which creates channels of type complex_8. The entries in the cache file must be of the format
       L CAL_FAC 714240000 1369980 file://localhost/path/to/L-CAL_FAC-714240000-1369980.gwf
    
    for lalapps_mkcalfac type frames or
       L SenseMonitor_L1_M 729925200 3600 file://localhost/path/to/L-SenseMonitor_L1_M-729925200-3600.gwf
    
    for SenseMon type frames. If both types of frame are present in the cache, SenseMon frames are used in preference.



 * Author: Brown, D. A.
 * $Id: FrameCalibration.c,v 1.6 2003/08/08 23:08:53 duncan Exp $



void 
LALInitBarycenter(LALStatus *stat, EphemerisData *edat)
LALInitBarycenter()



Subsections
next up previous contents index
Next: Description Up: Header FrameCalibration.h Previous: Module FrameCalibration.c   Contents   Index
LAL test account 2003-10-23