pycrtools.lora

loraInfo(lora_second[, datadir, ...])	Reads in a file from LORA and returns a dictionary with important parameters, such as the core position (core), the energy (energy) and the direction (direction) of the shower.
loraTimestampToBlocknumber(lora_seconds, ...)	Calculates block number corresponding to LORA timestamp and the sample number within that block (i.e.
nsecFromSec(lora_second[, logfile])	Get nanosecond timing from LORA logfile.
plotReceived([logfile, days_to_average, ...])	Plot the triggers that were received from LORA at LOFAR.

LORA

pycrtools.lora.loraInfo(lora_second, datadir='/data/VHECR/LORAtriggered/LORA/', checkSurroundingSecond=True, silent=False)

Reads in a file from LORA and returns a dictionary with important parameters, such as the core position (core), the energy (energy) and the direction (direction) of the shower. For the direction the Az(imuth) is defined in degrees from North through East. El(evation) is in degrees from the horizon upwards.

Input parameters:

lora_second	UTC timestamp of LORA event or filename
datadir	Directory of LORA event files
checkSurroundingSecond	Checks if there is a dataset of neighbouring seconds if not of this second
silent	Print message of directory sought for

pycrtools.lora.loraTimestampToBlocknumber(lora_seconds, lora_nanoseconds, starttime, samplenumber, clockoffset=10000.0, blocksize=65536, samplingfrequency=200)

Calculates block number corresponding to LORA timestamp and the sample number within that block (i.e. returns a tuple (blocknumber,``samplenumber``)).

Input parameters:

lora_seconds	LORA timestamp in seconds (UTC timestamp, second after 1st January 1970).
lora_nanoseconds	LORA timestamp in nanoseconds.
starttime	LOFAR_TBB timestamp.
samplenumber	Sample number.
clockoffset	Clock offset between LORA and LOFAR.
blocksize	Blocksize of the LOFAR data.

pycrtools.lora.nsecFromSec(lora_second, logfile='/data/VHECR/LORAtriggered/LORA/LORAtime4')

Get nanosecond timing from LORA logfile.

Input parameters:

lora_second	Second from which to obtain the nanosecond time info.
logfile	LORA logfile from which to obtain the time info.

Output:

Tuple containing LORA second and nanosecond timing info.

pycrtools.lora.plotReceived(logfile='/data/VHECR/LORAtriggered/LORA/LORAreceived', days_to_average=1, cumulative=True, plotAllowed=True, plotNotAllowed=True, plotNoObservation=True, stacked=True)

Plot the triggers that were received from LORA at LOFAR. The trigger can be handled in three ways. Either there is no observation, so nothing is done. If there is an observation, it can do two things. Either triggering was allowed and TBB data should have been obtained, or triggering was not allowed and no TBB data was obtained.

Input parameters:

logfile	location of LORAreceived file
days_to_average	plot histogram averaged of these many days (<1 allowed)
cumulative	intgrate over time
plotAllowed	plot triggers that were allowed to obtain TBB data
plotNotAllowed	plot triggers that were not allowed to obtain TBB data
plotNoObservation	plot triggers during a time when no observation was running
stacked	stack the triggers together