fact.auxservice

Interface AuxiliaryService

All Superinterfaces:

stream.service.Service

All Known Implementing Classes:

AuxFileService

public interface AuxiliaryService
extends stream.service.Service

The service should provide the ability to get the aux data from some data source. Since sensor data can be written at different time intervals and frequencies we need to specify some strategy for fetching the data. E.g. get the nearest point written before the given timestamp.

Created by kai on 31.03.15.

Method Summary

Modifier and Type	Method and Description
AuxPoint	getAuxiliaryData(AuxiliaryServiceName serviceName, ZonedDateTime eventTimeStamp, AuxPointStrategy strategy) An AuxiliaryService needs to implement just one method.
static Optional<ZonedDateTime>	unixTimeUTCToDateTime(stream.Data item) Takes the int[2] array found in the FITs files under the name UnixTimeUTC from the Data Item and converts it to a DateTime instance with time zone UTC.
static Optional<ZonedDateTime>	unixTimeUTCToDateTime(int[] eventTime) Takes the int[2] array found in the FITs files under the name UnixTimeUTC and converts it to a DateTime instance with time zone UTC.

Methods inherited from interface stream.service.Service

reset

Method Detail

getAuxiliaryData

AuxPoint getAuxiliaryData(AuxiliaryServiceName serviceName,
                          ZonedDateTime eventTimeStamp,
                          AuxPointStrategy strategy)
                   throws IOException

An AuxiliaryService needs to implement just one method. Providing the timestamp of the event, the name of the service and some strategy, this method should return an AuxPoint.

Parameters:

serviceName - the name of the aux data to access. This is written in the filename 20130112..fits

eventTimeStamp - the DateTime of the event you need the aux data for.

strategy - one of the strategies implemented for fetcvhing aux points

Returns:

the auxpoint according to the strategy

Throws:

IOException - in case something goes wrong while trying to access the aux data. Be it a file or a database.

unixTimeUTCToDateTime

static Optional<ZonedDateTime> unixTimeUTCToDateTime(int[] eventTime)

Takes the int[2] array found in the FITs files under the name UnixTimeUTC and converts it to a DateTime instance with time zone UTC. If the passed array cannot be converted the optional will be empty.

Parameters:

eventTime - the UnixTimeUTC array as found in the FITS file.

Returns:

an Optional containing the Datetime instance

unixTimeUTCToDateTime

static Optional<ZonedDateTime> unixTimeUTCToDateTime(stream.Data item)

Takes the int[2] array found in the FITs files under the name UnixTimeUTC from the Data Item and converts it to a DateTime instance with time zone UTC. If the passed array cannot be converted the optional will be empty.

Parameters:

item - A data item from the stream of raw FACT data

Returns:

an Optional containing the Datetime instance