The TRT_ConditionsServices package

Author

Denve.nosp@m.r.Wh.nosp@m.ittin.nosp@m.gton.nosp@m.@cern.nosp@m..ch

Introduction

TRT_ConditionsServices contains tools for accessing and managing TRT conditions data

Class Overview

• TRT_ConditionsSummarySvc : provides summary of status from all tools
• TRT_ConditionsTestSvc : returns InDet::TRT_COND_GOOD for testing
• TRT_DCS_ConditionsSvc : interface to DCS data in COOL
• TRT_DAQ_ConditionsSvc : interface to DAQ configuration data
• TRT_ByteStream_ConditionsSvc : interface to ByteStream errors
• TRT_CalDbSvc : manages calibration and alignment constants.
• TRT_AlignDbSvc : manages module alignment constants.
• TRT_StrawAlignDbSvc : manages straw alignment constants.
• TRTStrawStatusSummarySvc : manages dead/noisy straw lists
• TRTStrawNeighbourSvc : mapping of straws to electronic pads
• TRT_HWMappingSvc: mapping of straws to COOL DCS HV channel names/numbers

TRT_ConditionsSummarySvc

This Service provides an overall assessment of an identifier, determined by considering the TRT Conditions status flags returned by a list of services of type ITRT_ConditionsSvc.

TRT_ConditionsTestSvc

This Service provides a simple example of a service which inherets from ITRT_ConditionsSvc. It returns a TRT Conditions status flag (GOOD) for an identifier.

TRT_DCS_ConditionsSvc

This Service provides access to DCS conditions information read from the COOL offline database. It inherets from ITRT_ConditionsSvc and returns a TRT Conditions status flag for an identifier indicating whether its straw voltage was within tolerance range.

TRT_DAQ_ConditionsSvc

This Service provides access to DAQ conditions information from the DAQ configuration database. It inherits from ITRT_ConditionsSvc and returns a TRT Conditions status flag for an identifier indicating whether the ROD it is read out from participated in the run.

TRT_ByteStream_ConditionsSvc

This Service provides access and management of TRT ByteStream errors, stored in StoreGate containers.

TRT_CalDbSvc

This Service manages TRT calibration data stored in TRTCond::NestedContainer classes. The following methods are provided:
Always called:

• initialize (register callbacks and cache pointers if requested, read constants from text file if requested)

TDS Accessors:

• getT0 (for a given identifier and level - default STRAW)
• getRtRelation (for a given identifier and level)
• driftRadius (for a given drifttime and id. Returns also t0)
• trtcondid (get TRTCond::ExpandedIdentifier from Identifier)
• getRtContainer (used in calibration)
• getT0Container (used in calibration)

TDS Modifiers:

• setT0 (for a given TRTCond::ExpandedIdentifier)
• setRtRelation (for a given TRTCond::ExpandedIdentifier)

Persistifiers:

• writeTextFile (export TDS contents to a text file)
• readTextFile (fill TDS contents to a text file)
• streamOutCalibObjects (stream objects to POOL output)
• registerCalibObjects (register objects in IOVDb)
• printCondObjects (printout details of the data in the TDS)

IOVDbSvc.Folders+=["/TRT/Calib <tag>sometag</tag>"]

• IOVDbSvc.Folders+=["/TRT/Align <tag>sometag</tag>"]

  For reading in constants from text file (see code and share/CalibrationConstants for format) supply file name and set readFromTextFile. Also comment out the Folders+=.

  This will work in normal reconstruction. If the purpose is to write the constants to database, call the tool from the TRT_AlignAlgs package.

TRT_AlignDbSvc

This Service manages TRT alignment data stored in AlignableTransform classes. The following methods are provided:
Always called:

• initialize (register callbacks and cache pointers if requested, read constants from text file if requested)

TDS Accessors:

• getTrans (get level 1 transform for a given identifier)
• getGlobalTrans (get level 2 transform for a given identifier)
• getLvl1Align (get level 1 AlignableTransform for a given identifier)
• getLvl2Align (get level 2 AlignableTransform for a given identifier)
• getTransPtr (get pointer to AlignableTransform for given key)
• cgetTransPtr (get const pointer to AlignableTransform for given key)

TDS Modifiers:

• createAlignObjects (create empty set of folders according to GeoModel version)
• setLvl1Align (set level 1 AlignableTransform for a given identifier)
• setLvl2Align (set level 2 AlignableTransform for a given identifier)
• tweakTrans (tweak level 1 transform for a given identifier)
• tweakTrans2 (tweak level 2 transform for a given identifier)

Persistifiers:

• writeAlignTextFile (write TDS contents to a text file)
• readAlignTextFile (fill TDS from a text file)
• streamOutAlignObjects (stream objects to POOL output)
• registerAlignObjects (register objects in IOVDb)
• printCondObjects (printout details of the alignment data in the TDS)

IOVDbSvc.Folders+=["/TRT/Calib <tag>sometag</tag>"]

• IOVDbSvc.Folders+=["/TRT/Align <tag>sometag</tag>"]

  For reading in constants from text file (see code and share/CalibrationConstants for format) supply file name and set readFromTextFile. Also comment out the Folders+=.

  This will work in normal reconstruction. If the purpose is to write the constants to database call the tool from the TRT_CalibAlgs package.

TRT_StrawAlignDbSvc

Like TRT_CalDbSvc, but the stored data are here two independent Rphi rotations of each end of a straw.

TRTStrawStatusSummarySvc

This Service provides access to the dead/noisy straw lists.

TRT_HWMappingSvc

This Service provides a mapping of straws to COOL DCS HV channel names/numbers. The barrel HV-line map can be created by accessing the HW Mapping Database by Serguei Oleshko, or by a hard-coded mapping scheme defined in the tool's source code. The endcap map is currently only available through the hard-coded mapping scheme.

jobOptions