SISCone  2.0.5
Public Member Functions | Static Public Member Functions | Public Attributes | Static Public Attributes
siscone::Csiscone Class Reference

final class: gather everything to compute the jet contents. More...

#include <siscone.h>

Inheritance diagram for siscone::Csiscone:
Inheritance graph
[legend]
Collaboration diagram for siscone::Csiscone:
Collaboration graph
[legend]

List of all members.

Public Member Functions

 Csiscone ()
 default ctor
 ~Csiscone ()
 default dtor
int compute_jets (std::vector< Cmomentum > &_particles, double _radius, double _f, int _n_pass_max=0, double _ptmin=0.0, Esplit_merge_scale _split_merge_scale=SM_pttilde)
 compute the jets from a given particle set.
int recompute_jets (double _f, double _ptmin=0.0, Esplit_merge_scale _split_merge_scale=SM_pttilde)
 recompute the jets with a different overlap parameter.

Static Public Member Functions

static void set_banner_stream (std::ostream *ostr)
 A call to this function modifies the stream used to print banners (by default cout).
static std::ostream * banner_stream ()
 returns a pointer to the stream to be used to print banners (cout by default)

Public Attributes

std::vector< std::vector
< Cmomentum > > 
protocones_list
 list of protocones found pass-by-pass

Static Public Attributes

static bool init_done = false
 check random generator initialisation

Detailed Description

final class: gather everything to compute the jet contents.

This is the class user should use. It computes the jet contents of a list of particles given a cone radius and a threshold for splitting/merging.

After the call to 'perform', the vector jets is filled with the jets found. the 'contents' field of each jets contains the indices of the particles included in that jet.

Definition at line 48 of file siscone.h.


Member Function Documentation

int siscone::Csiscone::compute_jets ( std::vector< Cmomentum > &  _particles,
double  _radius,
double  _f,
int  _n_pass_max = 0,
double  _ptmin = 0.0,
Esplit_merge_scale  _split_merge_scale = SM_pttilde 
)

compute the jets from a given particle set.

We are doing multiple passes such pass n_pass looks for jets among all particles not put into jets during previous passes. By default the number of passes is infinite (0).

Parameters:
_particleslist of particles
_radiuscone radius
_fshared energy threshold for splitting&merging
_n_pass_maxmaximum number of passes (0=full search)
_ptminminimum pT of the protojets
_split_merge_scalethe scale choice for the split-merge procedure NOTE: SM_pt leads to IR unsafety for some events with momentum conservation. SM_Et is IR safe but not boost invariant and not implemented(!) SM_mt is IR safe for hadronic events, but not for decays of two back-to-back particles of identical mass SM_pttilde is always IR safe, and also boost invariant (default)
Returns:
the number of jets found.

Definition at line 86 of file siscone.cpp.

References siscone::Cstable_cones::init().

int siscone::Csiscone::recompute_jets ( double  _f,
double  _ptmin = 0.0,
Esplit_merge_scale  _split_merge_scale = SM_pttilde 
)

recompute the jets with a different overlap parameter.

we use the same particles and R as in the preceeding call.

Parameters:
_fshared energy threshold for splitting&merging
_ptminminimum pT of the protojets
_split_merge_scalethe scale choice for the split-merge procedure split--merge variable NOTE: using pt leads to IR unsafety for some events with momentum conservation. So we strongly advise not to change the default value.
Returns:
the number of jets found, -1 if recomputation not allowed.

Definition at line 187 of file siscone.cpp.

static void siscone::Csiscone::set_banner_stream ( std::ostream *  ostr) [inline, static]

A call to this function modifies the stream used to print banners (by default cout).

Please note that if you distribute 3rd party code that links with SISCone, that 3rd party code must not use this call turn off the printing of thw banner by default. This requirement reflects the spirit of clause 2c of the GNU Public License (v2), under which SISCone is distributed.

Definition at line 116 of file siscone.h.


The documentation for this class was generated from the following files:
The SISCone project has been developed by Gavin Salam and Gregory Soyez
Documentation generated on Mon Jun 4 2012 18:23:38 for SISCone by  Doxygen 1.7.6.1