| 1 | -------------------------
|
|---|
| 2 | Version 2
|
|---|
| 3 | -------------------------
|
|---|
| 4 |
|
|---|
| 5 | This is a streamlining of the N-subjettiness code, developed mainly by TJ
|
|---|
| 6 | Wilkason. The core functionality is unchanged, but classes have been
|
|---|
| 7 | dramatically reorganized to allow for later expansion. Because the API for
|
|---|
| 8 | Njettiness has changed, we have called this v2 (http://semver.org).
|
|---|
| 9 |
|
|---|
| 10 | Note that we have maintain backwards compatibility for the typical ways that
|
|---|
| 11 | Nsubjettiness was used. In particular, all of the Nsubjettiness class code in
|
|---|
| 12 | the example file from v1.0.3 still compiles, as does the NjettinessPlugin class
|
|---|
| 13 | code that uses the default measure.
|
|---|
| 14 |
|
|---|
| 15 | The key new features are:
|
|---|
| 16 |
|
|---|
| 17 | * NsubjettinessRatio: Direct access to tau_N / tau_M (the most requested
|
|---|
| 18 | feature)
|
|---|
| 19 | * MeasureDefinition to allow access to normalized and unnormalized measures
|
|---|
| 20 | * AxesDefinition to allow for access to more general axes modes
|
|---|
| 21 | * Winner-Take-All recombination axes: a faster way to find axes than beta=1
|
|---|
| 22 | minimization, but with comparable performance.
|
|---|
| 23 | * TauComponents to get access to the pieces of the N-(sub)jettiness
|
|---|
| 24 | calculation.
|
|---|
| 25 | * TauExtras to get complete access to get partitioning and axes information.
|
|---|
| 26 | * For clarity, split the example file into an example_basic_usage and
|
|---|
| 27 | example_advanced_usage (and example_advanced_usage_ee for e+e- collisions).
|
|---|
| 28 | * In Nsubjettiness, access to seedAxes() and currentAxes() to figure out the
|
|---|
| 29 | axes used before and after minimization.
|
|---|
| 30 | * In Nsubjettiness, access to currentSubjets() to get the subjet fourvectors.
|
|---|
| 31 | * (v2.2) XConePlugin, which improves on the previous NjettinessPlugin to use
|
|---|
| 32 | N-jettiness as a jet finder using the new ConicalGeometric measure.
|
|---|
| 33 |
|
|---|
| 34 | -- 2.2.4: (Jun 14, 2016) Fixed bug where multi-pass minimization could yield
|
|---|
| 35 | pathological axes (thanks Gregory Soyez)
|
|---|
| 36 | -- 2.2.3: (Apr 4, 2016) Fixed bug where a jet with fewer than N constituents
|
|---|
| 37 | could give random value for tau_N (thanks Nathan Hartland)
|
|---|
| 38 | -- 2.2.2: (Mar 29, 2016) Updating SharedPtr interface for FJ 3.2
|
|---|
| 39 | -- 2.2.1: (Sept 28, 2015) Fix of small Makefile bug
|
|---|
| 40 | -- 2.2.0: (Sept 7, 2015) Inclusion of the XCone jet algorithm, as well as a
|
|---|
| 41 | few new measures, including the "conical geometric" measure and
|
|---|
| 42 | options for e+e- colliders. Improvement of the
|
|---|
| 43 | Measure/AxesDefinition interface to allow for direct
|
|---|
| 44 | use in calculations.
|
|---|
| 45 | * Fixed bug where MultiPass_Axes did not actually minimize
|
|---|
| 46 | * Fixed floating point error with infinity^2 in various measures
|
|---|
| 47 |
|
|---|
| 48 | -- 2.1.0: (July 9, 2014) Inclusion of Measure/AxesDefinition interface.
|
|---|
| 49 | This was the first publicly available version of Nsubjettiness v2.
|
|---|
| 50 | -- 2.0.0: Initial release of v2.0. This was never officially made public.
|
|---|
| 51 |
|
|---|
| 52 | -------------------------
|
|---|
| 53 | Version 1
|
|---|
| 54 | -------------------------
|
|---|
| 55 |
|
|---|
| 56 | This was a new release using FastJet contrib framework, primary developed by
|
|---|
| 57 | Jesse Thaler.
|
|---|
| 58 |
|
|---|
| 59 | -- 1.0.3: Added inlines to fix compile issue (thanks Matthew Low)
|
|---|
| 60 | -- 1.0.2: Fixed potential dependency issue (thanks FJ authors)
|
|---|
| 61 | -- 1.0.1: Fixed memory leak in Njettiness.hh (thanks FJ authors)
|
|---|
| 62 | -- 1.0.0: New release using FastJet contrib framework. This includes a new
|
|---|
| 63 | makefile and a simplified example program.
|
|---|
| 64 |
|
|---|
| 65 | -------------------------
|
|---|
| 66 | Previous Versions
|
|---|
| 67 | -------------------------
|
|---|
| 68 |
|
|---|
| 69 | The previous versions of this code were developed initially by Ken Van Tilburg,
|
|---|
| 70 | tweaked by Jesse Thaler, and made into a robust FastJet add on by Chris
|
|---|
| 71 | Vermilion.
|
|---|
| 72 |
|
|---|
| 73 | Previous versions available from:
|
|---|
| 74 | http://jthaler.net/jets/Njettiness-0.5.1.tar.gz (Experimental Version)
|
|---|
| 75 | http://jthaler.net/jets/Njettiness-0.4.1.tar.gz (Stable Version)
|
|---|
| 76 |
|
|---|
| 77 | Previous version history:
|
|---|
| 78 | -- 0.5.1: For Njettiness Plugin, added access to currentTau values and axes via
|
|---|
| 79 | ClusterSequence::Extras class. (thanks to Dinko Ferencek and John
|
|---|
| 80 | Paul Chou)
|
|---|
| 81 | -- 0.5.0: Corrected fatal error in ConstituentTauValue (TauValue unaffected).
|
|---|
| 82 | Started process of allowing for more general measures and alternative
|
|---|
| 83 | minimization schemes. Extremely preliminary inclusion of alternative
|
|---|
| 84 | "geometric" measure.
|
|---|
| 85 | -- 0.4.1: Corrected bug where a too-small value of Rcut would cause the
|
|---|
| 86 | minimization procedure to fail (thanks Marat Freytsis, Brian Shuve)
|
|---|
| 87 | -- 0.4.0: Adding Nsubjettiness FunctionOfPseudoJet<float>. Re-organizing file
|
|---|
| 88 | structure and doing some re-naming to clarify Njettiness vs.
|
|---|
| 89 | Nsubjettiness. Some speedup in UpdateAxes code. (CKV)
|
|---|
| 90 | -- 0.3.2: Returns zero instead of a segmentation fault when the number of
|
|---|
| 91 | particles in a jet is smaller than the N value in tau_N (thanks
|
|---|
| 92 | Grigory Ovanesyan)
|
|---|
| 93 | -- 0.3.2: Fixed -Wshadow errors (thanks Grigory Ovanesyan)
|
|---|
| 94 | -- 0.3.1: Fixed stray comma/semicolon compiler error (thanks Grigory Ovanesyan)
|
|---|
| 95 | -- 0.3.1: Corrected tarbomb issue (thanks Jonathan Walsh)
|
|---|
| 96 | -- 0.3.1: Added anti-kT seeds as option
|
|---|
| 97 | -- 0.3.1: Fixed bug in minimization code with R_cutoff (thanks Chris Vermilion)
|
|---|
| 98 | -- 0.3.1: Added getPartition() and getJets() functions as helper functions for
|
|---|
| 99 | Chris Vermilion. (JT)
|
|---|
