km3pipe.hardware

Classes representing KM3NeT hardware.

Module Contents

Classes

Detector

A KM3NeT detector.

UTMInfo

The UTM information

PMT

Represents a photomultiplier.

Attributes

log

ORDERED_PMT_IDS

km3pipe.hardware.log[source]
class km3pipe.hardware.Detector(filename=None, det_id=None, t0set=0, string=None)[source]

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).

property comments[source]
property dom_ids[source]
property dom_positions[source]

The positions of the DOMs, calculated from PMT directions.

property dom_table[source]

A Table containing DOM attributes

property com[source]

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

property xy_positions[source]

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

property pmt_angles[source]

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

property ascii[source]

The ascii representation of the detector

property n_dus[source]
max_supported_version = 5[source]
reset_caches()[source]
add_comment(comment)[source]

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

translate_detector(vector)[source]

Translate the detector by a given vector

rotate_dom_by_yaw(dom_id, heading, centre_point=None)[source]

Rotate a DOM by a given (yaw) heading.

rotate_du_by_yaw(du, heading)[source]

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

rescale(factor, origin=(0, 0, 0))[source]

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

write(filename)[source]

Save detx file.

pmt_with_id(pmt_id)[source]

Get PMT with global pmt_id

get_pmt(dom_id, channel_id)[source]

Return PMT with DOM ID and DAQ channel ID

pmtid2omkey(pmt_id)[source]
domid2floor(dom_id)[source]
class km3pipe.hardware.UTMInfo(ellipsoid, grid, easting, northing, z)[source]

The UTM information

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

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,...[source]