Main Page | Class Hierarchy | Class List | Directories | File List | Class Members | File Members | Related Pages

THiDetector Class Reference

#include <THiDetector.h>

Inheritance diagram for THiDetector:

[legend]
Collaboration diagram for THiDetector:
[legend]
List of all members.

Detailed Description

Heavy-ion detector base-class.

This class is the detector base-class. This contains most of the functionality that is used by the other heavy-ion detector classes.

Author:
JEP.
Version:
1.2.
Date:
April 2004.

Definition at line 19 of file THiDetector.h.

Public Member Functions

 THiDetector (const Char_t *="", UInt_t=1)
 THiDetector (const THiDetector &)
virtual ~THiDetector ()
THiDetector & operator= (const THiDetector &)
virtual void Clear (const Char_t *="")
virtual void Print (const Char_t *="") const
virtual void PrintData () const
virtual void SetSignals (const TSubEvent &)
virtual void Calibrate ()
virtual Bool_t PlotEnergies (TH2F *=0, const TCutG *=0, Bool_t=1) const
virtual Bool_t PlotTimes (TH2F *=0, const TCutG *=0, Bool_t=1) const
virtual Bool_t PlotEvT (TH2F *=0, Float_t=0, const TCutG *=0, Bool_t=1) const
void SetCalibration (const Char_t *=0)
void SetDatabase (const Char_t *)
virtual const Char_t * GetName () const
virtual void FindHits (vector< THit > *) const
Float_t GetMaxEnergy () const
void SetName (const Char_t *)
void SetChannels (UInt_t)
void SetCoordinates (Float_t, Float_t, Float_t)
UInt_t GetChannels () const
const TVector3 & GetCoordinates () const
const vector< const TDataItem<
Float_t > * > & 		GetEnergies () const
const vector< const TDataItem<
Float_t > * > & 		GetTimes () const
void Hit (Bool_t)
Bool_t IsHit () const
Bool_t IsName (const Char_t *) const

Protected Attributes

vector< const TDataItem< UShort_t > * > fAdcs
vector< const TDataItem< UShort_t > * > fTdcs
THiCalibration fCalib
vector< const TDataItem< Float_t > * > fEnergies
vector< const TDataItem< Float_t > * > fTimes
TVector3 fCoordinates
Bool_t fHit

Constructor & Destructor Documentation

THiDetector (  const Char_t *  name = "",
UInt_t  channels = 1
) 
 

Default constructor. Reserves space for channels worth of hits for the energy, time, ADC and TDC vectors. By default, THiDetector::SetCalibration() will use name to try and find a MySQL calibration table with a matching name.

Parameters:
[in] name The name of the detector e.g. DSSSD1.
[in] channels The number of channels the detector has e.g. 32.

Definition at line 23 of file THiDetector.cxx.

References fAdcs, and fTdcs.

THiDetector (  const THiDetector &  rhs  ) 
 

Copy constructor. Need this because we have pointers in the member list.

Parameters:
[in] rhs The object being copied.

Definition at line 38 of file THiDetector.cxx.

References fAdcs, fCalib, and fTdcs.

~THiDetector (   )  [virtual]
 

Default destructor.

Definition at line 49 of file THiDetector.cxx.

Member Function Documentation

THiDetector & operator= (  const THiDetector &  rhs  ) 
 

Assignment operator overload. This is needed as some of the DragonRoot classes deal with pointers.

Parameters:
[in] rhs The THiDetector to be copied.
Returns:
The this pointer.

Definition at line 55 of file THiDetector.cxx.

References fAdcs, fCalib, fTdcs, and TDetector::operator=().

Here is the call graph for this function:

void Clear (  const Char_t *  option = ""  )  [virtual]
 

Clear all the data held in this class.

Parameters:
[in] option The option is currently unimplemented.

Reimplemented from TDetector.

Definition at line 71 of file THiDetector.cxx.

References TDetector::Clear(), fAdcs, and fTdcs.

Here is the call graph for this function:

void Print (  const Char_t *  option = ""  )  const [virtual]
 

Print all the information held in this class. Use PrintData() if you want to print out the data held in this class.

Parameters:
[in] option If the option is 'a' then PrintData is called automatically and the ADC, TDC, energy and time data are also printed.

Reimplemented from TDetector.

Reimplemented in TDsssdDetector, TGeDetector, TIcDetector, TMcpDetector, TNaiDetector, and TSbDetector.

Definition at line 81 of file THiDetector.cxx.

References fCalib, THiCalibration::Print(), TDetector::Print(), and PrintData().

Here is the call graph for this function:

void PrintData (   )  const [virtual]
 

Print all the data held in this class.

Implements TDetector.

Definition at line 95 of file THiDetector.cxx.

References fAdcs, fTdcs, and THiCalibration::Print().

Here is the call graph for this function:

void SetSignals (  const TSubEvent &  subEvent  )  [virtual]
 

Sets the signals in the relevant vectors. This is implemented on a per detector basis.

Parameters:
[in] subEvent The subevent containing ADC and TDC data from the hardware.
Note:
The detector does not own the data set here, it must be deleted elsewhere.

Reimplemented in TDsssdDetector, TGeDetector, TIcDetector, TMcpDetector, TNaiDetector, and TSbDetector.

Definition at line 114 of file THiDetector.cxx.

void Calibrate (   )  [virtual]
 

Calibrate the energy and time signals.

Implements TDetector.

Definition at line 125 of file THiDetector.cxx.

References TCalibration::Calibrate(), fAdcs, fCalib, fTdcs, THiCalibration::GetAdc(), and THiCalibration::GetTdc().

Here is the call graph for this function:

Bool_t PlotEnergies (  TH2F *  hist = 0,
const TCutG *  cut = 0,
Bool_t  option = 1
)  const [virtual]
 

Plots the calibrated ADC data (energies) in a histogram. The channel plotted is the histogram-mapped channel so that more than one detector can be plotted on one histogram.

Parameters:
[in] hist The histogram to plot in.
[in] cut The cut to use.
[in] option Whether or not the hit should be plotted if outside the cut. Set true if the hit is not in the cut and you still want to plot it in the histogram hist. Default is true.
Returns:
True if any hits are in the cut, false otherwise.

Reimplemented from TDetector.

Definition at line 134 of file THiDetector.cxx.

References fCalib, THiCalibration::GetAdc(), and TCalibration::GetHistogramMap().

Here is the call graph for this function:

Bool_t PlotTimes (  TH2F *  hist = 0,
const TCutG *  cut = 0,
Bool_t  option = 1
)  const [virtual]
 

Plots the calibrated TDC signals (times) in a histogram. The channel plotted is the histogram-mapped channel so that more than one detector can be plotted on one histogram.

Parameters:
[in] hist The histogram to plot in.
[in] cut The cut to use.
[in] option Whether or not the hit should be plotted if outside the cut. Set true if the hit is not in the cut and you still want to plot it in the histogram hist. Default is true.
Returns:
True if any hits are in the cut, false otherwise.

Reimplemented from TDetector.

Definition at line 159 of file THiDetector.cxx.

References fCalib, TCalibration::GetHistogramMap(), and THiCalibration::GetTdc().

Here is the call graph for this function:

Bool_t PlotEvT (  TH2F *  hist = 0,
Float_t  time = 0,
const TCutG *  cut = 0,
Bool_t  option = 1
)  const [virtual]
 

Plot energy versus time for a heavy-ion detector. The given time value can be an RF or TAC time for example. If there is more than one energy signal present the time is plotted against each.

Parameters:
[in] hist The histogram to plot in.
[in] time The time to plot the energy against.
[in] cut The cut to use.
[in] option Whether or not the hit should be plotted if outside the cut. Set true if the hit is not in the cut and you still want to plot it in the histogram hist. Default is true.
Returns:
True if any hits are in the cut, false otherwise.

Reimplemented from TDetector.

Reimplemented in TIcDetector.

Definition at line 184 of file THiDetector.cxx.

void SetCalibration (  const Char_t *  detectorName = 0  )  [inline]
 

Instructs the THiCalibration to get its information from the database. If no name is given, simply the detector name is used. This method enables the calibration to be changed by just using a different table name. For example, for default: 

      TBgoDetector *bgo = new TBgoDetector("BGO12", 1);
      bgo->SetCalibration();
      bgo->Print();
Or, using the calibration table for a different BGO: 
      TBgoDetector *bgo = new TBgoDetector("BGO12", 1);
      bgo->SetCalibration("BGO13");
      bgo->Print();
Parameters:
[in] detectorName The name of the detector in the database.

Definition at line 53 of file THiDetector.h.

References fCalib, THiCalibration::FindCalibration(), and TDetector::GetName().

Here is the call graph for this function:

void SetDatabase (  const Char_t *  database  )  [inline]
 

Set the database from where the calibration data is accessed. Just a wrapper to the correct THiCalibration call.

Parameters:
[in] database The name of the database, for example "mysql://localhost:3306/dragon".

Definition at line 76 of file THiDetector.h.

References fCalib, and THiCalibration::SetDatabase().

Here is the call graph for this function:

const Char_t * GetName (   )  const [inline, virtual, inherited]
 

Get the detector name.

Returns:
The detector name as a character string.

Definition at line 113 of file TDetector.h.

References TDetector::fName.

void FindHits (  vector< THit > *  hits  )  const [virtual, inherited]
 

Virtual method to rebuild the particles that have hit the detector from the energy and time data. This is implemented per detector class because, for example, a BGO will have only 1 ADC channel per particle hit, whereas an MCP detector may have 4 ADC channels per particle hit.

Parameters:
[in] hits The vector to which the hits should be added.

Reimplemented in TBgoDetector, TDsssdDetector, TGeDetector, TIcDetector, TMcpDetector, TNaiDetector, and TSbDetector.

Definition at line 177 of file TDetector.cxx.

Float_t GetMaxEnergy (   )  const [inherited]
 

Gets the maximum energy that was in the detector.

Returns:
The maximum value in fEnergies.

Definition at line 188 of file TDetector.cxx.

References TDetector::fEnergies.

void SetName (  const Char_t *  name  )  [inline, inherited]
 

Set the detector name. This should match the name of the calibration table in the SQL database, otherwise the calibration will not be found.

Parameters:
[in] name The name of the detector e.g. "DSSSD0".

Definition at line 84 of file TDetector.h.

References TDetector::fName.

void SetChannels (  UInt_t  channels  )  [inline, inherited]
 

Set the number of channels of the detector.

Parameters:
[in] channels The number of detector channels e.g. this would be 32 for a DSSSD or 1 for a BGO.

Definition at line 94 of file TDetector.h.

References TDetector::fChannels.

void SetCoordinates (  Float_t  x,
Float_t  y,
Float_t  z
)  [inline, inherited]
 

Set the x,y,z position of the particle.

Parameters:
[in] x The x-position.
[in] y The y-position.
[in] z The z-position.

Definition at line 103 of file TDetector.h.

References TDetector::fCoordinates.

UInt_t GetChannels (   )  const [inline, inherited]
 

Get the number of detector channels.

Returns:
The detector channels as an unsigned integer (doesn't make any sense to have negative channels!).

Definition at line 121 of file TDetector.h.

const TVector3 & GetCoordinates (   )  const [inline, inherited]
 

Get the coordinates of the detector.

Returns:
The coordinates in as a vector.

Definition at line 130 of file TDetector.h.

const vector< const TDataItem< Float_t > * > & GetEnergies (   )  const [inline, inherited]
 

Get the energy signals belonging to this detector.

Returns:
The detector energy signals.

Definition at line 138 of file TDetector.h.

const vector< const TDataItem< Float_t > * > & GetTimes (   )  const [inline, inherited]
 

Get the time signals belonging to this detector.

Returns:
The detector time signals.

Definition at line 146 of file TDetector.h.

void Hit (  Bool_t  status  )  [inline, inherited]
 

Set the status of the fHit parameter.

Parameters:
[in] status This should be set to 1 only if a hit has occured in the particular detector, 0 otherwise.

Definition at line 154 of file TDetector.h.

References TDetector::fHit.

Bool_t IsHit (   )  const [inline, inherited]
 

Get the hit status of the detector.

Returns:
True (1) if the detector is hit; false (0) otherwise.

Definition at line 163 of file TDetector.h.

Bool_t IsName (  const Char_t *  name  )  const [inline, inherited]
 

Check to see if the name of the detector matches name.

Returns:
True (1) if the name is the same; false (0) otherwise.

Definition at line 171 of file TDetector.h.

Member Data Documentation

vector<const TDataItem<UShort_t> *> fAdcs [protected]
 

Data from the heavy-ion ADCs is stored in here. This is contained in a vector due to considerations of speed and ability to manipulate the data within the raw data array.

Definition at line 42 of file THiDetector.h.

vector<const TDataItem<UShort_t> *> fTdcs [protected]
 

Data from the heavy-ion TDCs is stored in here. This is contained in a vector due to considerations of speed and ability to manipulate the data within the raw data array.

Definition at line 47 of file THiDetector.h.

THiCalibration fCalib [protected]
 

The heavy-ion electronics calibration.

Definition at line 50 of file THiDetector.h.

vector<const TDataItem<Float_t> *> fEnergies [protected, inherited]
 

Calibrated data from the heavy-ion ADCs is stored in here i.e. this vector would be filled after a call to TDetector::Calibrate(). This data is then manipulated to build the correct energies for each particle that could have hit the detector.

Definition at line 60 of file TDetector.h.

vector<const TDataItem<Float_t> *> fTimes [protected, inherited]
 

Calibrated data from the heavy-ion TDCs is stored in here i.e. this vector would be filled after a call to TDetector::Calibrate(). This data is then manipulated to build the correct energies for each particle that could have hit the detector.

Definition at line 67 of file TDetector.h.

TVector3 fCoordinates [protected, inherited]
 

The detector coordinates.

Definition at line 70 of file TDetector.h.

Bool_t fHit [protected, inherited]
 

Boolean to keep track of whether the detector has been hit.

Definition at line 73 of file TDetector.h.

The documentation for this class was generated from the following files:
Generated on Mon Jan 8 11:54:35 2007 for DragonRoot by  doxygen 1.3.9.1