fastjet::GhostedAreaSpec Class Reference

Class that defines the parameters that go into the measurement of active jet areas. More...

#include <GhostedAreaSpec.hh>

Collaboration diagram for fastjet::GhostedAreaSpec:

Collaboration graph
fastjet::BasicRandom\< double \>
[legend]
List of all members.

Public Member Functions

 GhostedAreaSpec ()
 default constructor
 GhostedAreaSpec (double ghost_maxrap, int repeat=gas::def_repeat, double ghost_area=gas::def_ghost_area, double grid_scatter=gas::def_grid_scatter, double kt_scatter=gas::def_kt_scatter, double mean_ghost_kt=gas::def_mean_ghost_kt)
 explicit constructor
void _initialize ()
 sets the detailed parameters for the ghosts (which may not be quite the same as those requested -- this is in order for things to fit in nicely into 2pi etc.
double ghost_etamax () const
double ghost_maxrap () const
double ghost_area () const
double grid_scatter () const
double kt_scatter () const
double mean_ghost_kt () const
int repeat () const
double actual_ghost_area () const
int n_ghosts () const
void set_ghost_area (double val)
void set_ghost_etamax (double val)
void set_ghost_maxrap (double val)
void set_grid_scatter (double val)
void set_kt_scatter (double val)
void set_mean_ghost_kt (double val)
void set_repeat (int val)
int nphi () const
 return nphi (ghosts layed out (-nrap, 0.
int nrap () const
void get_random_status (std::vector< int > &__iseed) const
 get all relevant information about the status of the random number generator, so that it can be reset subsequently with set_random_status.
void set_random_status (const std::vector< int > &__iseed)
 set the status of the random number generator, as obtained previously with get_random_status.
void checkpoint_random ()
void restore_checkpoint_random ()
std::string description () const
 for a summary
void add_ghosts (std::vector< PseudoJet > &) const
 push the ghost 4-momenta onto the back of the vector of PseudoJets
double random_at_own_risk () const
 very deprecated public access to a random number from the internal generator
BasicRandom< double > & generator_at_own_risk () const
 very deprecated public access to the generator itself

Private Member Functions

double _our_rand () const

Private Attributes

double _ghost_maxrap
int _repeat
double _ghost_area
double _grid_scatter
double _kt_scatter
double _mean_ghost_kt
double _actual_ghost_area
double _dphi
double _drap
int _n_ghosts
int _nphi
int _nrap
std::vector< int > _random_checkpoint

Static Private Attributes

static BasicRandom< double > _random_generator

Detailed Description

Class that defines the parameters that go into the measurement of active jet areas.

Definition at line 58 of file GhostedAreaSpec.hh.


Constructor & Destructor Documentation

fastjet::GhostedAreaSpec::GhostedAreaSpec (  )  [inline]

default constructor

Definition at line 61 of file GhostedAreaSpec.hh.

fastjet::GhostedAreaSpec::GhostedAreaSpec ( double  ghost_maxrap,
int  repeat = gas::def_repeat,
double  ghost_area = gas::def_ghost_area,
double  grid_scatter = gas::def_grid_scatter,
double  kt_scatter = gas::def_kt_scatter,
double  mean_ghost_kt = gas::def_mean_ghost_kt 
) [inline, explicit]

explicit constructor

Definition at line 70 of file GhostedAreaSpec.hh.


Member Function Documentation

void fastjet::GhostedAreaSpec::_initialize (  ) 

sets the detailed parameters for the ghosts (which may not be quite the same as those requested -- this is in order for things to fit in nicely into 2pi etc.

..

Definition at line 45 of file GhostedAreaSpec.cc.

References _actual_ghost_area, _dphi, _drap, _ghost_area, _ghost_maxrap, _n_ghosts, _nphi, _nrap, checkpoint_random(), and fastjet::twopi.

00045                                   {
00046   // add on area-measuring dummy particles
00047   _drap = sqrt(_ghost_area);
00048   _dphi = _drap;
00049   _nphi = int(ceil(twopi/_dphi)); _dphi = twopi/_nphi;
00050   _nrap = int(ceil(_ghost_maxrap/_drap)); _drap = _ghost_maxrap / _nrap;
00051   _actual_ghost_area = _dphi * _drap;
00052   _n_ghosts   = (2*_nrap+1)*_nphi;
00053 
00054   // checkpoint the status of the random number generator.
00055   checkpoint_random();
00056   //_random_generator.info(cerr);
00057 }

double fastjet::GhostedAreaSpec::ghost_etamax (  )  const [inline]

Definition at line 90 of file GhostedAreaSpec.hh.

00090 {return _ghost_maxrap;};

double fastjet::GhostedAreaSpec::ghost_maxrap (  )  const [inline]

Definition at line 91 of file GhostedAreaSpec.hh.

Referenced by fastjet::ClusterSequenceActiveArea::_initialise_AA(), fastjet::ClusterSequenceArea::_warn_if_range_unsuitable(), and description().

00091 {return _ghost_maxrap;};

double fastjet::GhostedAreaSpec::ghost_area (  )  const [inline]

Definition at line 92 of file GhostedAreaSpec.hh.

Referenced by description().

00092 {return _ghost_area   ;};

double fastjet::GhostedAreaSpec::grid_scatter (  )  const [inline]

Definition at line 93 of file GhostedAreaSpec.hh.

Referenced by description().

00093 {return _grid_scatter;};

double fastjet::GhostedAreaSpec::kt_scatter (  )  const [inline]

Definition at line 94 of file GhostedAreaSpec.hh.

Referenced by description().

00094 {return _kt_scatter  ;};

double fastjet::GhostedAreaSpec::mean_ghost_kt (  )  const [inline]

Definition at line 95 of file GhostedAreaSpec.hh.

Referenced by fastjet::ClusterSequencePassiveArea::_initialise_and_run_PA(), and description().

00095 {return _mean_ghost_kt  ;};

int fastjet::GhostedAreaSpec::repeat (  )  const [inline]

Definition at line 96 of file GhostedAreaSpec.hh.

Referenced by fastjet::ClusterSequenceActiveArea::_initialise_AA(), fastjet::ClusterSequenceActiveArea::_postprocess_AA(), fastjet::ClusterSequence1GhostPassiveArea::_run_1GPA(), fastjet::ClusterSequenceActiveArea::_run_AA(), and description().

00096 {return _repeat      ;};

double fastjet::GhostedAreaSpec::actual_ghost_area (  )  const [inline]

Definition at line 99 of file GhostedAreaSpec.hh.

Referenced by fastjet::ClusterSequenceActiveAreaExplicitGhosts::_add_ghosts(), fastjet::ClusterSequence1GhostPassiveArea::_run_1GPA(), and description().

00099 {return _actual_ghost_area;};

int fastjet::GhostedAreaSpec::n_ghosts (  )  const [inline]

Definition at line 100 of file GhostedAreaSpec.hh.

Referenced by fastjet::ClusterSequenceActiveAreaExplicitGhosts::_add_ghosts().

00100 {return _n_ghosts;};

void fastjet::GhostedAreaSpec::set_ghost_area ( double  val  )  [inline]

Definition at line 103 of file GhostedAreaSpec.hh.

00103 {_ghost_area    = val; _initialize();};

void fastjet::GhostedAreaSpec::set_ghost_etamax ( double  val  )  [inline]

Definition at line 104 of file GhostedAreaSpec.hh.

00104 {_ghost_maxrap = val; _initialize();};

void fastjet::GhostedAreaSpec::set_ghost_maxrap ( double  val  )  [inline]

Definition at line 105 of file GhostedAreaSpec.hh.

00105 {_ghost_maxrap = val; _initialize();};

void fastjet::GhostedAreaSpec::set_grid_scatter ( double  val  )  [inline]

Definition at line 106 of file GhostedAreaSpec.hh.

00106 {_grid_scatter   = val; };

void fastjet::GhostedAreaSpec::set_kt_scatter ( double  val  )  [inline]

Definition at line 107 of file GhostedAreaSpec.hh.

00107 {_kt_scatter     = val; };

void fastjet::GhostedAreaSpec::set_mean_ghost_kt ( double  val  )  [inline]

Definition at line 108 of file GhostedAreaSpec.hh.

00108 {_mean_ghost_kt  = val; };

void fastjet::GhostedAreaSpec::set_repeat ( int  val  )  [inline]

Definition at line 109 of file GhostedAreaSpec.hh.

00109 {_repeat         = val; };

int fastjet::GhostedAreaSpec::nphi (  )  const [inline]

return nphi (ghosts layed out (-nrap, 0.

.nphi-1), (-nrap+1,0..nphi-1), ... (nrap,0..nphi-1)

Definition at line 113 of file GhostedAreaSpec.hh.

00113 {return _nphi;}

int fastjet::GhostedAreaSpec::nrap (  )  const [inline]

Definition at line 114 of file GhostedAreaSpec.hh.

00114 {return _nrap;}

void fastjet::GhostedAreaSpec::get_random_status ( std::vector< int > &  __iseed  )  const [inline]

get all relevant information about the status of the random number generator, so that it can be reset subsequently with set_random_status.

Definition at line 119 of file GhostedAreaSpec.hh.

00119                                                                 {
00120     _random_generator.get_status(__iseed);}

void fastjet::GhostedAreaSpec::set_random_status ( const std::vector< int > &  __iseed  )  [inline]

set the status of the random number generator, as obtained previously with get_random_status.

Note that the random generator is a static member of the class, i.e. common to all instances of the class --- so if you modify the random for this instance, you modify it for all instances.

Definition at line 127 of file GhostedAreaSpec.hh.

00127                                                                 {
00128     _random_generator.set_status(__iseed);}

void fastjet::GhostedAreaSpec::checkpoint_random (  )  [inline]

Definition at line 130 of file GhostedAreaSpec.hh.

Referenced by _initialize().

void fastjet::GhostedAreaSpec::restore_checkpoint_random (  )  [inline]

Definition at line 131 of file GhostedAreaSpec.hh.

string fastjet::GhostedAreaSpec::description (  )  const

for a summary

Definition at line 83 of file GhostedAreaSpec.cc.

References actual_ghost_area(), ghost_area(), ghost_maxrap(), grid_scatter(), kt_scatter(), mean_ghost_kt(), and repeat().

Referenced by fastjet::AreaDefinition::description().

00083                                           {
00084 
00085   ostringstream ostr;
00086   ostr << "ghosts of area " << actual_ghost_area() 
00087        << " (had requested " << ghost_area() << ")"
00088        << ", placed up to y = " << ghost_maxrap() 
00089        << ", scattered wrt to perfect grid by (rel) " << grid_scatter() 
00090        << ", mean_ghost_kt = " << mean_ghost_kt()
00091        << ", rel kt_scatter =  " << kt_scatter()
00092        << ", n repetitions of ghost distributions =  " << repeat();
00093   return ostr.str();
00094 }

void fastjet::GhostedAreaSpec::add_ghosts ( std::vector< PseudoJet > &   )  const

push the ghost 4-momenta onto the back of the vector of PseudoJets

Referenced by fastjet::ClusterSequenceActiveAreaExplicitGhosts::_add_ghosts(), and fastjet::ClusterSequence1GhostPassiveArea::_run_1GPA().

double fastjet::GhostedAreaSpec::random_at_own_risk (  )  const [inline]

very deprecated public access to a random number from the internal generator

Definition at line 141 of file GhostedAreaSpec.hh.

00141 {return _our_rand();};

BasicRandom<double>& fastjet::GhostedAreaSpec::generator_at_own_risk (  )  const [inline]

very deprecated public access to the generator itself

Definition at line 143 of file GhostedAreaSpec.hh.

00143                                                              {
00144     return _random_generator;}

double fastjet::GhostedAreaSpec::_our_rand (  )  const [inline, private]

Definition at line 165 of file GhostedAreaSpec.hh.

00165 {return _random_generator();};


Member Data Documentation

double fastjet::GhostedAreaSpec::_ghost_maxrap [private]

Definition at line 149 of file GhostedAreaSpec.hh.

Referenced by _initialize().

int fastjet::GhostedAreaSpec::_repeat [private]

Definition at line 150 of file GhostedAreaSpec.hh.

double fastjet::GhostedAreaSpec::_ghost_area [private]

Definition at line 151 of file GhostedAreaSpec.hh.

Referenced by _initialize().

double fastjet::GhostedAreaSpec::_grid_scatter [private]

Definition at line 152 of file GhostedAreaSpec.hh.

double fastjet::GhostedAreaSpec::_kt_scatter [private]

Definition at line 153 of file GhostedAreaSpec.hh.

double fastjet::GhostedAreaSpec::_mean_ghost_kt [private]

Definition at line 154 of file GhostedAreaSpec.hh.

double fastjet::GhostedAreaSpec::_actual_ghost_area [private]

Definition at line 157 of file GhostedAreaSpec.hh.

Referenced by _initialize().

double fastjet::GhostedAreaSpec::_dphi [private]

Definition at line 157 of file GhostedAreaSpec.hh.

Referenced by _initialize().

double fastjet::GhostedAreaSpec::_drap [private]

Definition at line 157 of file GhostedAreaSpec.hh.

Referenced by _initialize().

int fastjet::GhostedAreaSpec::_n_ghosts [private]

Definition at line 158 of file GhostedAreaSpec.hh.

Referenced by _initialize().

int fastjet::GhostedAreaSpec::_nphi [private]

Definition at line 158 of file GhostedAreaSpec.hh.

Referenced by _initialize().

int fastjet::GhostedAreaSpec::_nrap [private]

Definition at line 158 of file GhostedAreaSpec.hh.

Referenced by _initialize().

std::vector<int> fastjet::GhostedAreaSpec::_random_checkpoint [private]

Definition at line 161 of file GhostedAreaSpec.hh.

BasicRandom< double > fastjet::GhostedAreaSpec::_random_generator [static, private]

Definition at line 162 of file GhostedAreaSpec.hh.


The documentation for this class was generated from the following files:
Generated on Tue Dec 18 17:05:52 2007 for fastjet by  doxygen 1.5.2