fact

Class DrsFileService

java.lang.Object

fact.DrsFileService

All Implemented Interfaces:

stream.service.Service

public class DrsFileService
extends Object
implements stream.service.Service

This is a service which, provided a data item from the telescopes data stream, this returns the proper drs calibration constants. By 'proper' I mean the drs constants which have been taken closest in time to the run the event was taken from. The url should point to the usual raw data folder containing the canonical file structure e.g. /fact/raw on the isdc. Created by mackaiver on 08/12/16.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	DrsFileService.CalibrationInfo A class to hold the calibrations constants needed to apply the infamous drs calibration to FACT raw data.

Field Summary

Fields

Modifier and Type	Field and Description
int	drsStep
stream.io.SourceURL	rawDataFolder

Constructor Summary

Constructors

Constructor and Description
DrsFileService()

Method Summary

Modifier and Type	Method and Description
DrsFileService.CalibrationInfo	getCalibrationConstantsForDataItem(stream.Data item) This method returns the calibration info for the given data item.
void	reset()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

rawDataFolder

@Parameter(required=true,
           description="The url pointing to the path containing the FACT raw data in FACTS canonical folder structure.")
public stream.io.SourceURL rawDataFolder

drsStep

@Parameter(required=false,
           description="The DrsStep to look for, should be 1 or 2.")
public int drsStep

Constructor Detail

DrsFileService

public DrsFileService()

Method Detail

getCalibrationConstantsForDataItem

public DrsFileService.CalibrationInfo getCalibrationConstantsForDataItem(stream.Data item)
                                                                  throws IOException

This method returns the calibration info for the given data item. This item should contain a key called DATE-OBS. Which is the beginning of the observation. If the drs calibration constants have not been loaded into the cache, all drs files in the folder of the current run are parsed for their date. The constants in the file closest to DATE-OBS are read and returned here.

Parameters:

item - a data item with FACT data

Returns:

a CalibrationInfo instance which holds the calibration constants

Throws:

IOException - if no file with drs constant can be found or an error occurs while reading it.

reset

public void reset()
           throws Exception

Specified by:

reset in interface stream.service.Service

Throws:

Exception