3.2. czelta.event_reader

class czelta.event_reader

Object containing events loaded from file. Have defined len method returning number of events in event_reader.

It is iterable:

number_of_events = len(some_event_reader)

for event in some_event_reader:
    # do something with event
    # for example print event in format same as is in txt.
    print(str(event))

Getting invidual events:

some_event = some_event_reader[7]

Getting slice of events:

#standart index
some_events = some_event_reader[7:12]

#getting slice by datetime object
#datetime are always handled as UTC
from datetime import datetime
some_events = some_event_reader[datetime(2013,9,1), datetime(2013,9,30)]

load(path_to_file)

Load events from file. This delete all current events and tries to load events from file. Also tries to guess station by file name (finding station name in filename).

save(path_to_file)

Save events to file. Can save txt or dat(binary files same as from website).

runs()

Return iterable object containing all runs.

run(run_index)

Return iterable object containing all events in run

set_station(station)

Set station for event_reader. Station is also set for all current events.

station can be string ('pardubice_gd') or int (station id) or station object itself.

filter(filter_func)

Custom-filter function. As parameter give a function, which is ready to be called with parameter event object, which return True if you want remove event and False if you want let event in event_reader. Implementation is quite raw, so exceptions inside function are not handled properly!

filtering all calibrations:

def filter_func(e):
    return e.calibration
some_event_reader.filter(filter_func)

filtering all except calibrations:

def filter_func(e):
    return not e.calibration
some_event_reader.filter(filter_func)

filtering all events with horizont below 40 degres:

def filter_func(e):
    if e.HA_direction[0]<40:
        return True
# must have loaded config_data.JSON: czelta.station.load()
# and set station with: some_event_reader.set_station("some_station")
some_event_reader.filter(filter_func)

filter_calibrations()

Predefined fast filter. Filter all events marked as calibration.

filter_maximum_TDC()

Predefined fast filter. Filter all events which have at least one TDC chanel equal maximum value (4095). Events with maximum value have bad measured TDC and sky direction can’t be determined right.

filter_maximum_ADC()

Predefined fast filter. Filter all events which have at least one ADC(energy) channel equal maximum value(2047).

filter_minimum_ADC()

Predefined fast filter. Filter all events which have at least one ADC(energy) channel equal zero (Not measured).

flux(_from, to)

Returns number of events between first and second timestamp or datetime

number_of_events(run)

Return number of events in event_reader. Same result have len(event_reader).

number_of_runs()

Return number of runs. Same result have len(event_reader.runs()).

item(i)

indexes events

measure_time()

Return sum of times in invidual runs, so this is effective measure time.

class czelta.event_reader_runs

Iteratable class for runs of czelta.event_reader.