Back to home page

EIC code displayed by LXR

 
 

    


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

0001 #ifndef __D0RUNICONEPLUGIN_HH__
0002 #define __D0RUNICONEPLUGIN_HH__
0003 
0004 //FJSTARTHEADER
0005 // $Id: D0RunIConePlugin.hh 1778 2010-10-25 10:02:58Z soyez $
0006 //
0007 // Copyright (c) 2009-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 #include "fastjet/internal/base.hh"     // namespace macros (include explicitly to help Doxygen)
0035 #include "fastjet/D0RunIBaseConePlugin.hh"
0036 #include "fastjet/internal/thread_safety_helpers.hh"  // helpers to write transparent code w&wo C++11 features
0037 
0038 // questionable whether this should be in fastjet namespace or not...
0039 
0040 FASTJET_BEGIN_NAMESPACE      // defined in fastjet/internal/base.hh
0041 
0042 //----------------------------------------------------------------------
0043 //
0044 /// @ingroup plugins
0045 /// \class D0RunIConePlugin
0046 ///
0047 /// A plugin for FastJet (v3.0 or later) that provides an interface to
0048 /// the D0 version of Run-I cone algorithm
0049 ///
0050 /// The D0 code has been obtained from Lars Sonnenschein's web-space
0051 /// http://www-d0.fnal.gov/~sonne/D0RunIcone.tgz
0052 ///
0053 /// The version of the D0 Run I code distributed
0054 /// here has been modified by the FastJet authors, so as to provide
0055 /// access to the contents of the jets (as is necessary for the
0056 /// plugin). This does not modify the results of the clustering.
0057 ///
0058 /// The difference between this algorithm and the post-1996 version
0059 /// relates to the way the final jet momenta are calculated. Details
0060 /// are to be found in FERMILAB-PUB-97-242-E.
0061 //
0062 //----------------------------------------------------------------------
0063 class D0RunIConePlugin : public D0RunIBaseConePlugin {
0064 public:
0065   /// The D0RunIConePlugin constructor, which sets the "free" parameters of the
0066   /// algorithm:
0067   ///
0068   ///  \param CONErad is the cone radius
0069   ///
0070   ///  \param JETmne is a minimum ET requirement on every iteration
0071   ///    (jet dropped if Et < JETmne * Et_min_ratio ).
0072   ///    The value that has been used by D0 for JETmne: 8 GeV 
0073   ///    (and Et_min_ratio is 0.5)
0074   ///
0075   ///  \param SPlifr is the shared Et fraction splitting threshold, and
0076   ///    a value of 0.5 was usually used by D0
0077   ///
0078   /// The remaining parameters of the algorithm are not to be modified if the algorithm
0079   /// is to correspond to the one actually used by D0.
0080   ///
0081   D0RunIConePlugin (double CONErad_in, double JETmne_in , double SPLifr_in = _DEFAULT_SPLifr)
0082     : D0RunIBaseConePlugin(CONErad_in, JETmne_in , SPLifr_in){}
0083 
0084   // the things that are required by base class
0085   virtual std::string description () const;
0086 
0087   // the part that really does the clustering
0088   virtual void run_clustering(ClusterSequence &) const;
0089 
0090 private:
0091   static thread_safety_helpers::FirstTimeTrue _first_time;
0092 
0093   /// print a banner for reference to the 3rd-party code
0094   void _print_banner(std::ostream *ostr) const;
0095 };
0096 
0097 
0098 
0099 FASTJET_END_NAMESPACE      // defined in fastjet/internal/base.hh
0100 
0101 #endif // __D0RUNICONEPLUGIN_HH__