Back to home page

EIC code displayed by LXR

 
 

    


File indexing completed on 2025-01-18 09:57:17

0001 #ifndef __EECAMBRIDGEPLUGIN_HH__
0002 #define __EECAMBRIDGEPLUGIN_HH__
0003 
0004 //FJSTARTHEADER
0005 // $Id$
0006 //
0007 // Copyright (c) 2005-2021, Matteo Cacciari, Gavin P. Salam and Gregory Soyez
0008 //
0009 //----------------------------------------------------------------------
0010 // This file is part of FastJet.
0011 //
0012 //  FastJet is free software; you can redistribute it and/or modify
0013 //  it under the terms of the GNU General Public License as published by
0014 //  the Free Software Foundation; either version 2 of the License, or
0015 //  (at your option) any later version.
0016 //
0017 //  The algorithms that underlie FastJet have required considerable
0018 //  development. They are described in the original FastJet paper,
0019 //  hep-ph/0512210 and in the manual, arXiv:1111.6097. If you use
0020 //  FastJet as part of work towards a scientific publication, please
0021 //  quote the version you use and include a citation to the manual and
0022 //  optionally also to hep-ph/0512210.
0023 //
0024 //  FastJet is distributed in the hope that it will be useful,
0025 //  but WITHOUT ANY WARRANTY; without even the implied warranty of
0026 //  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
0027 //  GNU General Public License for more details.
0028 //
0029 //  You should have received a copy of the GNU General Public License
0030 //  along with FastJet. If not, see <http://www.gnu.org/licenses/>.
0031 //----------------------------------------------------------------------
0032 //FJENDHEADER
0033 
0034 
0035 #include "fastjet/JetDefinition.hh"
0036 
0037 FASTJET_BEGIN_NAMESPACE      // defined in fastjet/internal/base.hh
0038 
0039 // forward declaration to reduce includes
0040 class ClusterSequence;
0041 
0042 //----------------------------------------------------------------------
0043 //
0044 /// @ingroup plugins
0045 /// \class EECambridgePlugin
0046 /// Implementation of the e+e- Cambridge algorithm (plugin for fastjet v2.4 upwards)
0047 ///
0048 /// EECambridgePlugin is a plugin for fastjet (v2.4 upwards)
0049 /// It implements the Cambridge algorithm, as defined in 
0050 /// 
0051 /// Better jet clustering algorithms
0052 /// Yuri Dokshitzer, Garth Leder, Stefano Moretti,  Bryan Webber 
0053 /// JHEP 9708 (1997) 001
0054 /// http://www-spires.slac.stanford.edu/spires/find/hep/www?rawcmd=FIND+j+JHEPA%2C9708%2C001
0055 ///
0056 /// On construction one must supply a ycut value.
0057 ///
0058 /// To get the jets at the end call ClusterSequence::inclusive_jets();
0059 class EECambridgePlugin : public JetDefinition::Plugin {
0060 public:
0061   /// Main constructor for the EECambridge Plugin class.  
0062   /// It takes the dimensionless parameter ycut (the Q value for normalisation
0063   /// of the kt-distances is taken from the sum of all particle energies).
0064   EECambridgePlugin (double ycut_in) : _ycut(ycut_in) {}
0065 
0066   /// copy constructor
0067   EECambridgePlugin (const EECambridgePlugin & plugin) {
0068     *this = plugin;
0069   }
0070 
0071   // the things that are required by base class
0072   virtual std::string description () const;
0073   virtual void run_clustering(ClusterSequence &) const;
0074 
0075   double ycut() const {return _ycut;}
0076 
0077   /// the plugin mechanism's standard way of accessing the jet radius.
0078   /// This must be set to return something sensible, even if R
0079   /// does not make sense for this algorithm!
0080   virtual double R() const {return 1.0;}
0081 
0082   /// avoid the warning whenever the user requests "exclusive" jets
0083   /// from the cluster sequence
0084   virtual bool exclusive_sequence_meaningful() const {return true;}
0085 
0086   /// returns true because this plugin is intended for spherical
0087   /// geometries (i.e. it's an e+e- algorithm).
0088   virtual bool is_spherical() const {return true;}
0089 
0090 private:
0091   double _ycut;
0092 };
0093 
0094 FASTJET_END_NAMESPACE        // defined in fastjet/internal/base.hh
0095 
0096 #endif // __EECAMBRIDGEPLUGIN_HH__
0097