detinfo Namespace Reference

General LArSoft Utilities. More...

Namespaces
	details
	timescales
	Namespace including different time scales as defined in LArSoft.

Classes
class	DetectorClocks
	Class used for the conversion of times between different formats and references. More...
class	DetectorClocksData
	Contains all timing reference information for the detector. More...
class	DetectorClocksException
class	DetectorClocksService
class	DetectorClocksServiceStandard
	art service managing detinfo::DetectorClocksStandard. More...
class	DetectorClocksStandard
	Implementation of detinfo::DetectorClocks interface with fixed settings from configuration. More...
class	DetectorClocksWithUnits
	A partial detinfo::DetectorClocksData supporting units. More...
class	DetectorProperties
class	DetectorPropertiesData
class	DetectorPropertiesService
class	DetectorPropertiesServiceStandard
class	DetectorPropertiesStandard
class	DetectorTimings
	A class exposing an upgraded interface of detinfo::DetectorClocksData. More...
class	ElecClock
	Class representing the time measured by an electronics clock. More...
class	LArProperties
class	LArPropertiesService
class	LArPropertiesServiceStandard
class	LArPropertiesStandard
	Properties related to liquid argon environment in the detector. More...
class	RunHistory
class	RunHistoryStandard
class	SubRun
class	SubRunStandard

Enumerations
enum	ConfigType_t {   kG4RefTime = 0, kTriggerOffsetTPC, kFramePeriod, kClockSpeedTPC,   kClockSpeedOptical, kClockSpeedTrigger, kClockSpeedExternal, kDefaultTrigTime,   kDefaultBeamTime, kConfigTypeMax }
enum	RunType_t {   kUnknownRunType =0, kProductionRun, kCommissioningRun, kTestRun,   kPedestalRun, kCalibrationRun, kNRunType }

Functions
int	trigger_offset (DetectorClocksData const &data)
double	sampling_rate (DetectorClocksData const &data)
	Returns the period of the TPC readout electronics clock. More...
template<typename Event >
detinfo::DetectorClocksData	detectorClocksStandardDataFor (detinfo::DetectorClocksStandard const &detClocks, Event const &event)
	Returns DetectorClocksData tuned on the specified event. More...
template<typename Event >
std::optional< std::pair< double, double > >	trigger_times_for_event (art::InputTag const &triggerTag, Event const &event)
	Loads DetectorClocksStandard trigger times. More...
template<typename Event >
std::optional< double >	g4ref_time_for_event (art::InputTag const &triggerTag, Event const &event)
	Loads DetectorClocksStandard G4Ref correction times. More...
detinfo::DetectorClocksWithUnits	makeDetectorClocksWithUnits (detinfo::DetectorClocksData const &clockData)
detinfo::DetectorTimings	makeDetectorTimings (detinfo::DetectorClocksData const &detClocks)
detinfo::DetectorTimings	makeDetectorTimings (detinfo::DetectorClocksData const *detClocks)
detinfo::DetectorTimings	makeDetectorTimings (detinfo::DetectorClocksWithUnits const &detClocksWU)

Variables
constexpr double	kTIME_MAX = std::numeric_limits<double>::max()
	Maximum time in microseconds. More...
constexpr double	kDEFAULT_FREQUENCY = 1.e-6
	Default Frequency in MHz. More...
constexpr double	kDEFAULT_FRAME_PERIOD = 1.6e3
	Default Frame period in micro-second. More...
constexpr double	kDEFAULT_FREQUENCY_OPTICAL = 64.
	Default Optical clock speed in MHz. More...
constexpr double	kDEFAULT_FREQUENCY_TPC = 2.
	Default TPC clock speed in MHz. More...
constexpr double	kDEFAULT_FREQUENCY_TRIGGER = 16.
	Default Trigger clock speed in MHz. More...
constexpr double	kDEFAULT_FREQUENCY_EXTERNAL = 31.25
	Default External clock speed in MHz. More...
constexpr double	kDEFAULT_MC_CLOCK_T0 = 0
	Default G4 reference time in micro-second. More...
constexpr double	kDEFAULT_TRIG_OFFSET_TPC = -1600.
	Default TPC readout start time offset from trigger in micro-second. More...
constexpr double	kDEFAULT_TRIG_TIME = 0.0
	Default TriggerTime in micro-second. More...
constexpr double	kDEFAULT_BEAM_TIME = 0.0
	Default BeamGateTime in micro-second. More...

Detailed Description

General LArSoft Utilities.

Title: OpFlash Algorithims Author: Ben Jones, MIT (Edited by wketc.nosp@m.hum@.nosp@m.lanl..nosp@m.gov and gleb..nosp@m.sine.nosp@m.v@duk.nosp@m.e.ed.nosp@m.u)

Description: These are the algorithms used by OpFlashFinder to produce flashes.

ClusterMatchTQ class

tjyan.nosp@m.g@fn.nosp@m.al.go.nosp@m.v

Algorithm for matching clusters between different views based on time and charge information

Input: a list of clusters and all hits associated with clusters Output: a vector of index vectors. Each group of indices represent a particle candidate

Title: SpacePointAlg_TimeSort class Author: wketc.nosp@m.hum@.nosp@m.lanl..nosp@m.gov Inputs: std::vector<recob::Hit> (one for each plane) Outputs: std::vector<recob::SpacePoint>

Description: This space point algorithm tries to improve speed by (1) keeping hit collections distinct among planes; (2) sorting hit collections by time; and, (3) having a lookup table for (y,z) coordinate positions. The original use case for this code was with the TTHitFinder, which produces an incredibly large number of hits per plane, making some sorted space point alg more attractive.

This code is totally microboone specific, btw.

Enumeration Type Documentation

enum detinfo::ConfigType_t

Enumerator
kG4RefTime
kTriggerOffsetTPC
kFramePeriod
kClockSpeedTPC
kClockSpeedOptical
kClockSpeedTrigger
kClockSpeedExternal
kDefaultTrigTime
kDefaultBeamTime
kConfigTypeMax

Definition at line 21 of file DetectorClocks.h.

                    {
    kG4RefTime = 0,
    kTriggerOffsetTPC,
    kFramePeriod,
    kClockSpeedTPC,
    kClockSpeedOptical,
    kClockSpeedTrigger,
    kClockSpeedExternal,
    kDefaultTrigTime,
    kDefaultBeamTime,
    kConfigTypeMax
  };

enum detinfo::RunType_t

Enumerator
kUnknownRunType
kProductionRun
kCommissioningRun
kTestRun
kPedestalRun
kCalibrationRun
kNRunType

Definition at line 15 of file RunHistory.h.

                 {
    kUnknownRunType=0,
    kProductionRun,
    kCommissioningRun,
    kTestRun,
    kPedestalRun,
    kCalibrationRun,
    kNRunType
  };

Function Documentation

template<typename Event >

detinfo::DetectorClocksData detinfo::detectorClocksStandardDataFor	(	detinfo::DetectorClocksStandard const &	detClocks,
		Event const &	event
	)

Returns DetectorClocksData tuned on the specified event.

Template Parameters

Event

type of framework event

Parameters

detClocks	service provider generating the data
event	event to read information from

Returns

DetectorClocksData tuned on the specified event

This function takes care to extract all what is needed by DetectorClocksStandard service provider in order to provide data for the event.

Example:

detinfo::DetectorClocksStandard const detClocks
  { config.get<fhicl::ParameterSet>("services.DetectorClocksService") };

for (gallery::Event event(inputFiles); !event.atEnd(); event.next()) {

  detinfo::DetectorClocksData const clockData
    = detinfo::detectorClocksStandardDataFor(detClocks, event);

  auto const triggerTime = clockData.TriggerTime();

  // etc...

} // for

Requirements

The implementation is effectively dependent on the framework managing the event, but it is not formally dependent on any implementation. Assumptions include everything that is required by other helper functions like detinfo::trigger_times_for_event() and detinfo::g4ref_time_for_event() (mostly, support for a call like Event::getByLabel(art::InputTag, Event::HandleT<T>)).

Definition at line 67 of file DetectorClocksStandardDataFor.h.

    {

    auto const& config_values = detClocks.ConfigValues();
    // Trigger times
    double trig_time{config_values[kDefaultTrigTime]};
    double beam_time{config_values[kDefaultBeamTime]};
    if (auto times = trigger_times_for_event(detClocks.TrigModuleName(), event)) {
      std::tie(trig_time, beam_time) = *times;
    }

    double g4_ref_time{config_values[kG4RefTime]};
    if (auto sim_trig_time = g4ref_time_for_event(detClocks.G4RefCorrTrigModuleName(), event)) {
      g4_ref_time -= trig_time;
      g4_ref_time += *sim_trig_time;
    }
    return detClocks.DataFor(g4_ref_time, trig_time, beam_time);
  } // detinfo::detectorClocksStandardDataFor()

template<typename Event >

std::optional<double> detinfo::g4ref_time_for_event	(	art::InputTag const &	triggerTag,
		Event const &	event
	)

Loads DetectorClocksStandard G4Ref correction times.

Template Parameters

Event

type of event where trigger data might be stored

Parameters

detClocks	the instance of detinfo::DetectorClocksStandard to set
event	the event the trigger objects are stored into

Returns

whether the g4 ref correction was set from a trigger object

Exceptions

cet::exception

if trigger data product has more than one trigger

This function sets the trigger and beam gate times of detClocks. First, it attempts to read the settings from the event (see setDetectorClocksStandardG4RefTimeCorrectionFromEvent()). If that fails "nicely", then sets them with the default values from the configuration.

A "nice" failure is where there is no trigger object in the event. Other types of failure include when there are more than one trigger objects in the event, in which case no choice is made, and an exception is thrown.

Definition at line 103 of file DetectorClocksStandardTriggerLoader.h.

  {
    // fetch the trigger data product
    using TriggerHandle_t = typename Event::template HandleT<std::vector<raw::Trigger>>;

    TriggerHandle_t triggerHandle;
    if (!event.template getByLabel(triggerTag, triggerHandle)) return std::nullopt;

    // check that we do have a trigger
    // (we have already checked whether the handle is valid above)
    auto const& triggers = *triggerHandle;
    if (triggers.empty()) return std::nullopt;

    // select which trigger to set (i.e., the only one!)
    if (triggers.size() != 1) {
      throw cet::exception("setDetectorClocksStandardTrigger")
        << "Found " << triggers.size() << " trigger objects in '" << triggerTag.encode()
        << "' (only one trigger per event is supported)\n";
    }

    return std::make_optional(triggers.front().TriggerTime());
  }

detinfo::DetectorClocksWithUnits detinfo::makeDetectorClocksWithUnits ( detinfo::DetectorClocksData const &  clockData )

inline

Transforms a detinfo::DetectorClocksData into a detinfo::DetectorClocksWithUnits.

Definition at line 144 of file DetectorTimings.h.

  {
    return detinfo::DetectorClocksWithUnits{clockData};
  }

detinfo::DetectorTimings detinfo::makeDetectorTimings ( detinfo::DetectorClocksData const &  detClocks )

inline

Returns DetectorTimings object from specified detinfo::DetectorClocksData.

Definition at line 698 of file DetectorTimings.h.

  {
    return detinfo::DetectorTimings{detClocks};
  }

detinfo::DetectorTimings detinfo::makeDetectorTimings ( detinfo::DetectorClocksData const *  detClocks )

inline

Returns DetectorTimings object from specified detinfo::DetectorClocksData.

Definition at line 706 of file DetectorTimings.h.

  {
    return makeDetectorTimings(*detClocks);
  }

detinfo::DetectorTimings detinfo::makeDetectorTimings ( detinfo::DetectorClocksWithUnits const &  detClocksWU )

inline

Returns DetectorTimings object from specified detinfo::DetectorClocksWithUnits.

Definition at line 714 of file DetectorTimings.h.

  {
    return static_cast<detinfo::DetectorTimings const&>(detClocksWU);
  }

double detinfo::sampling_rate ( DetectorClocksData const &  data )

inline

Returns the period of the TPC readout electronics clock.

Returns

the period of the TPC readout electronics clock [µs]

See also

detinfo::DetectorClocks::TPCClock()

Definition at line 643 of file DetectorClocksData.h.

  {
    return data.TPCClock().TickPeriod() * 1.e3;
  }

int detinfo::trigger_offset ( DetectorClocksData const &  data )

inline

Definition at line 632 of file DetectorClocksData.h.

  {
    return data.TPCClock().Ticks(data.TriggerOffsetTPC() * -1.);
  }

template<typename Event >

std::optional<std::pair<double, double> > detinfo::trigger_times_for_event	(	art::InputTag const &	triggerTag,
		Event const &	event
	)

Loads DetectorClocksStandard trigger times.

Template Parameters

Event

type of event where trigger data might be stored

Parameters

detClocks	the instance of detinfo::DetectorClocksStandard to set
event	the event the trigger objects are stored into

Returns

whether the times were set from a trigger object

Exceptions

cet::exception

if trigger data product has more than one trigger

This function sets the trigger and beam gate times of detClocks. First, it attempts to read the settings from the event (see setDetectorClocksStandardTriggersFromEvent()). If that fails "nicely", then sets them with the default values from the configuration.

A "nice" failure is where there is no trigger object in the event. Other types of failure include when there are more than one trigger objects in the event, in which case no choice is made, and an exception is thrown.

Definition at line 58 of file DetectorClocksStandardTriggerLoader.h.

  {
    // try to read the trigger from the event
    // fetch the trigger data product
    using TriggerHandle_t = typename Event::template HandleT<std::vector<raw::Trigger>>;

    TriggerHandle_t triggerHandle;
    if (!event.template getByLabel(triggerTag, triggerHandle)) { return std::nullopt; }

    // check that we do have a trigger
    // (we have already checked whether the handle is valid above)
    auto const& triggers = *triggerHandle;
    if (triggers.empty()) { return std::nullopt; }

    // select which trigger to set (i.e., the only one!)
    if (triggers.size() != 1) {
      throw cet::exception("setDetectorClocksStandardTrigger")
        << "Found " << triggers.size() << " trigger objects in '" << triggerTag.encode()
        << "' (only one trigger per event is supported)\n";
    }

    auto const& trigger = triggers.front();
    return std::make_optional(std::make_pair(trigger.TriggerTime(), trigger.BeamGateTime()));
  }

Variable Documentation

constexpr double detinfo::kDEFAULT_BEAM_TIME = 0.0

Default BeamGateTime in micro-second.

Definition at line 39 of file ClockConstants.h.

constexpr double detinfo::kDEFAULT_FRAME_PERIOD = 1.6e3

Default Frame period in micro-second.

Definition at line 15 of file ClockConstants.h.

constexpr double detinfo::kDEFAULT_FREQUENCY = 1.e-6

Default Frequency in MHz.

Definition at line 12 of file ClockConstants.h.

constexpr double detinfo::kDEFAULT_FREQUENCY_EXTERNAL = 31.25

Default External clock speed in MHz.

Definition at line 27 of file ClockConstants.h.

constexpr double detinfo::kDEFAULT_FREQUENCY_OPTICAL = 64.

Default Optical clock speed in MHz.

Definition at line 18 of file ClockConstants.h.

constexpr double detinfo::kDEFAULT_FREQUENCY_TPC = 2.

Default TPC clock speed in MHz.

Definition at line 21 of file ClockConstants.h.

constexpr double detinfo::kDEFAULT_FREQUENCY_TRIGGER = 16.

Default Trigger clock speed in MHz.

Definition at line 24 of file ClockConstants.h.

constexpr double detinfo::kDEFAULT_MC_CLOCK_T0 = 0

Default G4 reference time in micro-second.

Definition at line 30 of file ClockConstants.h.

constexpr double detinfo::kDEFAULT_TRIG_OFFSET_TPC = -1600.

Default TPC readout start time offset from trigger in micro-second.

Definition at line 33 of file ClockConstants.h.

constexpr double detinfo::kDEFAULT_TRIG_TIME = 0.0

Default TriggerTime in micro-second.

Definition at line 36 of file ClockConstants.h.

constexpr double detinfo::kTIME_MAX = std::numeric_limits<double>::max()

Maximum time in microseconds.

Definition at line 9 of file ClockConstants.h.