km3pipe.hardware

Classes representing KM3NeT hardware.

Module Contents

Classes

Detector(filename=None, det_id=None, t0set=None, calibration=None)	A KM3NeT detector.
UTMInfo(ellipsoid, grid, easting, northing, z)	The UTM information
PMT(id, pos, dir, t0, channel_id, omkey)	Represents a photomultiplier.

km3pipe.hardware.log

class km3pipe.hardware.Detector(filename=None, det_id=None, t0set=None, calibration=None)

Bases:object

A KM3NeT detector.

Parameters:

filename: str, optional

Name of .detx file with detector definition.

det_id: int, optional

.detx ID of detector (when retrieving from database).

t0set: optional

t0set (when retrieving from database).

calibration: optional

calibration (when retrieving from database).

comments

dom_ids

dom_positions

The positions of the DOMs, calculated from PMT directions.

dom_table

A Table containing DOM attributes

com

Center of mass, calculated from the mean of the PMT positions

xy_positions

XY positions of the DUs, given by the DOMs on floor 1.

pmt_angles

A list of PMT directions sorted by PMT channel, on DU-1, floor-1

ascii

The ascii representation of the detector

n_dus

reset_caches(self)

add_comment(self, comment)

Add a comment which will be prefixed with a ‘#’

translate_detector(self, vector)

Translate the detector by a given vector

rotate_dom_by_yaw(self, dom_id, heading, centre_point=None)

Rotate a DOM by a given (yaw) heading.

rotate_du_by_yaw(self, du, heading)

Rotate all DOMs on DU by a given (yaw) heading.

rescale(self, factor, origin=(0, 0, 0))

Stretch or shrink detector (DOM positions) by a given factor.

write(self, filename)

Save detx file.

pmt_with_id(self, pmt_id)

Get PMT with global pmt_id

get_pmt(self, dom_id, channel_id)

Return PMT with DOM ID and DAQ channel ID

pmtid2omkey(self, pmt_id)

domid2floor(self, dom_id)

class km3pipe.hardware.UTMInfo(ellipsoid, grid, easting, northing, z)

Bases:object

The UTM information

class km3pipe.hardware.PMT(id, pos, dir, t0, channel_id, omkey)

Bases:object

Represents a photomultiplier.

Parameters:

id: int

pos: 3-float-tuple (x, y, z)

dir: 3-float-tuple (x, y, z)

t0: int

channel_id: int

omkey: int

km3pipe.hardware.ORDERED_PMT_IDS = [28, 23, 22, 21, 27, 29, 20, 30, 26, 25, 19, 24, 13, 7, 1, 14, 18, 12, 6, 2, 11, 8, 0, 15, 4, 3, 5, 17, 10, 9, 16]