Fork me on GitHub

source: git/external/fastjet/contribs/RecursiveTools/ChangeLog@ 54ec182

Last change on this file since 54ec182 was cb80e6f, checked in by Pavel Demin <pavel.demin@…>, 4 years ago

update FastJet library to 3.3.4 and FastJet Contrib library to 1.045
  • Property mode set to 100644
File size: 19.2 KB
Line 
12018-11-02 Jesse Thaler <jthaler@jthaler.net>
2
3 * AUTHORS: updated journal for RecursiveSoftDrop
4
52018-10-30 Gregory Soyez <soyez@fastjet.fr>
6
7 * RecursiveSoftDrop.cc:
8 fixed a few typos in comments
9
10 * RecursiveSoftDrop.hh:
11 used the native FJ Recluster tool when available (did create
12 conflicts in some cases)
13
142018-06-18 Jesse Thaler <jthaler@jthaler.net>
15
16 * README
17 Fixed incorrect order of zcut and beta in the README for SoftDrop example.
18
192018-05-29 Jesse Thaler <jthaler@jthaler.net>
20
21 * VERSION
22 * NEWS
23 Changed to 2.0.0-beta2, noted in news
24
252018-04-21 Jesse Thaler <jthaler@jthaler.net>
26
27 * AUTHORS: updated arxiv number for RecursiveSoftDrop
28
292018-04-21 Gavin Salam <gavin.salam@cern.ch>
30
31 * README: updated arxiv number for RecursiveSoftDrop & Bottom-up
32 Soft Drop.
33
342018-04-04 Gregory Soyez <soyez@fastjet.fr>
35
36 * RecursiveSoftDrop.cc (contrib):
37 fixed syntax of calls to structure_of<...>
38 (thanks to Attila Krasznahorkay)
39
402018-01-24 Gregory Soyez <soyez@fastjet.fr>
41
42 * RecursiveSoftDrop.cc:
43 for the (dafault) dynamical R0 implementation, the dynamical R0 is
44 evolved independently in each branch.
45
462017-10-10 Jesse Thaler <jthaler@jthaler.net>
47 * AUTHORS
48 Added mention of BUSD
49
50 * README
51 Some tweaks to the wording
52
532017-10-11 Gregory Soyez <soyez@fastjet.fr>
54
55 * IteratedSoftDrop.hh:
56 IteratedSoftDropInfo::size() and multiplicity() now return an
57 unsigned int instead of a double
58
592017-10-10 Jesse Thaler <jthaler@jthaler.net>
60 * AUTHORS
61 Updated journal reference for ISD
62
63 * example_isd.{cc,ref}:
64 Included soft drop multiplicity in example
65
66 * README
67 Added warning at top that documentation has not been updated
68
69 * VERSION
70 Changed to 2.0.0-beta1
71
722017-10-10 Gregory Soyez <soyez@fastjet.fr>
73
74 * example_isd.ref:
75 updated to reflect the bugfix below
76
77 * IteratedSoftDrop.cc:
78 fixed issue in description (was taking sqrt of -ve number when
79 there were no angular cut)
80
81 * NEWS:
82 drafted for RecursiveTools-2.0.0-beta1
83
84 * TODO:
85 updated list in view of a beta release
86
87 * example_isd.cc:
88 pointed to the right header for IteratedSoftDrop
89
90 * RecursiveSoftDrop.{hh,cc}:
91 * IteratedSoftDrop.{hh,cc}:
92 moved IteratedSoftDrop to its own file (replacing the old
93 implementation)
94
95 * example_advanced_usage.ref:
96 updated reference file following the fix below.
97
982017-09-28 Gregory Soyez <soyez@fastjet.fr>
99
100 * RecursiveSymmetryCutBase.cc:
101 when no substructure is found, keep the _symmetry, _delta_R and
102 _mu structure variables at -1. This for example allows one to
103 trigger on substructure by checking if delta_R>=0.
104
105 Note: we could set it to 0 (as it was before) and trigger using
106 _delta_R>0 but there might be some genuine substructure exactly
107 collinear.
108
1092017-09-19 Gregory Soyez <soyez@fastjet.fr>
110
111 * example_isd.ref:
112 updated to the latest version of the example
113
1142017-09-18 Gregory Soyez <soyez@fastjet.fr>
115
116 * Makefile:
117 updating make check to use all the examples (failing on ISD as
118 expected, see below)
119
120 * example_bottomup_softdrop.cc:
121 fixed typo
122
123 * example_bottomup_softdrop.ref:
124 * example_recursive_softdrop.ref:
125 added reference output for this example
126
127 * RecursiveSoftDrop.{hh,cc}:
128 * RecursiveSymmetryCutBase.{cc,hh}:
129 moved the "all_prongs" method from the base structure t oa
130 standalone function in RecursiveSoftDrop.hh
131
132 In practice, this is irrelevant for mMDT and SD (since pieces()
133 gets the job done, and the substructure class does not have (as
134 is) reliable info to get the full structure)
135
136 * RecursiveSymmetryCutBase.cc:
137 revamped a series of requests for substructure info to better
138 handle possible recursion into deeper jet substructure.
139
140 * RecursiveSoftDrop.{hh,cc}:
141 updated "description" to reuse the info from the base class
142
143 * example_isd.cc:
144 updated to use the newer implementation of ISD. Checked that it
145 gives the same results as the former implementation.
146
147 Note: make check still needs fixing because the example now
148 computes a different set of angularities
149
150 * RecursiveSoftDrop.hh:
151 added a few helpers to IteratedSoftDropInfo ([] operator and size,
152 meaning it can be used as a vector<pair<double,double> >)
153
154 * RecursiveSymmetryCutBase.cc:
155 . fixed bugs in the calculation of the geometric distances for ee
156 coordinates
157 . fixed bug in the computation of the (zg,thetag) pairs [it was
158 returning the groomed ones instead of the ones passing the
159 condition]
160
161 * example_recursive_softdrop.cc:
162 set the R0 parameter to the original jet radius
163
1642017-09-13 Gregory Soyez <soyez@fastjet.fr>
165
166 * example_recursive_softdrop.cc:
167 tied up a few comments and the code output
168
169 * RecursiveSymmetryCutBase.{hh,cc}:
170 removed the unneeded _is_composite
171
172 * RecursiveSoftDrop.cc:
173 fixed issue with "verbose" dropped info on branches with no
174 further substructure
175
1762017-09-11 Gregory Soyez <soyez@fastjet.fr>
177
178 * RecursiveSoftDrop.{hh,cc}:
179 have IteratedSoftDDrop returning by default an object of type
180 IteratedSoftDropInfo; added several helpers
181
1822017-09-08 Gregory Soyez <soyez@fastjet.fr>
183
184 * RecursiveSoftDrop.{hh,cc}:
185 updated IteratedSoftDrop to give it the flexibility of
186 RecursiveSoftDrop
187
188 * RecursiveSymmetryCutBase.hh:
189 fixed typo in comment
190
191 * example_mmdt_ee.cc: *** ADDED ***
192 added an example to illustrat usage in ee collisions
193
194 * example_isd.cc:
195 * BottomUpSoftDrop.cc:
196 * IteratedSoftDrop.cc:
197 * RecursiveSoftDrop.cc:
198 Fixed compilation issues with FJ 3.0 (mostly the usage of features
199 introduced only in FJ3.1)
200
201 * RecursiveSymmetryCutBase.{hh,cc}:
202 used the internal Recluster class for FJ<3.1.0 and the FJ antive
203 one for FJ>=3.1.0
204
205 * BottomUpSoftDrop.{hh,cc}:
206 moved the implementation of global_grooming to the source file and
207 fixed a few trivial compilation errors
208
2092017-09-08 Frédéric Dreyer <frederic.dreyer@gmail.com>
210
211 * BottomUpSoftDrop.hh:
212 added the global_grooming method to process full event
213
2142017-09-07 Gregory Soyez <soyez@fastjet.fr>
215
216 * RecursiveSoftDrop.cc:
217 cleaned (mostly by removing older commented-out code)
218
219 * RecursiveSoftDrop.{hh,cc}:
220 * RecursiveSymmetryCutBase.{hh,cc}:
221 * SoftDrop.cc:
222
223 added support for ee coordinates. For that, the symmetry measure
224 has to be set to either theta_E (which uses the 3-vector angle
225 theta) or to cos_theta_E which uses sqrt(2*[1-cos(theta)])
226
227 Accordingly, the recursion_choice can be set to larger_E to
228 recurse into the branch with the largest energy. The larger_m
229 mode, recorsing into the larger-mass branch is also possible but
230 not advised (for the same reason as the pp version).
231
232 * RecursiveSymmetryCutBase.{hh,cc}:
233 switched to the Recluster class provided with FastJet. ASlso
234 included the recluster description to RecursiveSymmetryCutBase
235 when it is user-defined.
236
2372017-09-06 Gregory Soyez <soyez@fastjet.fr>
238
239 * BottomUpSoftDrop.{hh,cc}:
240 . renamed SoftDropStructure -> BottomUpSoftDropStructure
241 SoftDropRecombiner -> BottomUpSoftDropRecombiner
242 SoftDropPlugin -> BottomUpSoftDropPlugin
243 . moved 'description' to source file (instead of header)
244 . kept the "area" information when available (jets will just
245 appear as having a 0 area)
246 . added most class description (main class still missing)
247
248 * RecursiveSoftDrop.cc:
249 . put internal classes to handle CS history in an internal namespace
250 . replaced the "switch" in the mail loop by a series of if (allows
251 us a few simplificatins/cleaning)
252 . more uniform treatment of issues in the presence of an angular cut
253 (as part of the above reorganisation)
254
255 * example_advanced_usage.ref:
256 updated reference output file following the bugfix (missing
257 "grooming mode" initialisation in one of the SoftDrop ctors) on
258 2017-08-01
259
260 * RecursiveSymmetryCutBase.cc:
261 removed redundent code
262
2632017-08-10 Gregory Soyez <soyez@fastjet.fr>
264
265 * RecursiveSoftDrop.cc:
266 fixed trivial typo in variable name
267
268>>>>>>> .r1071
2692017-08-04 Gregory Soyez <soyez@fastjet.fr>
270
271 * RecursiveSoftDrop.cc:
272 do not impose an angular cut in IterativeSD if it is -ve.
273
2742017-08-01 Gregory Soyez <soyez@fastjet.fr>
275
276 * example_recursive_softdrop.cc:
277 added a series of optional flags
278
279 * RecursiveSoftDrop.cc:
280 fixed a few issues with the fixed depth version
281
282 * RecursiveSymmetryCutBase.hh:
283 a jet is now considered as havig substructure if deltaR>0
284 (coherent with released version)
285
286 * SoftDrop.hh:
287 bugfix: set the "grooming mode" by default in all ctors
288 EDIT: caused issue with make check, fixed on 2017-09-069 (see
289 above)
290
291 * RecursiveSoftDrop.{hh,cc}:
292 added support for the "same depth" variant
293
294 * RecursiveSymmetryCutBase.cc:
295 also associate a RecursiveSymmetryCutBase::StructureType structure
296 to the result jet in case it is just a single particle (in
297 grooming mode)
298
2992017-07-31 Gregory Soyez <soyez@fastjet.fr>
300
301 * RecursiveSymmetryCutBase.{hh,cc}:
302 added the option to pass an extra parameter to the symmetry cut
303 function
304
305 * RecursiveSymmetryCutBase.{hh,cc}:
306 * ModifiedMassDropTagger.hh
307 * SoftDrop.hh:
308 minor adaptions due to the above change + added a few methods to
309 query the class information (symmetry cut, beta, ...)
310
311 * RecursiveSoftDrop.{hh,cc}:
312 Added support for
313 - a dynamical R0
314 - recursing only in the hardest branch
315 - imposing a min deltaR cut
316
317 Added a tentative IterativeSoftDrop class
318
3192017-07-28 Gregory Soyez <soyez@fastjet.fr>
320
321 * RecursiveSoftDrop.cc:
322 adapted to the latest changes in RecursiveSymmetryCutBase
323
324 * RecursiveSymmetryCutBase.{hh,cc}:
325 reorganised the output of the recursion step (recurse_one_step)
326 using an enum to make iot more readable (and to fix issues where
327 the dropped prong is actually 0, e.g. after subtraction)
328
3292017-07-26 Gregory Soyez <soyez@fastjet.fr>
330
331 * example_recursive_softdrop.cc: *** ADDED ***
332 added a draft example for the use of RecursiveSoftDrop
333
334 * RecursiveSoftDrop.{hh,cc}: *** ADDED ***
335 added a first pass at an implementation of RecursiveSoftDrop.
336
337 This is based on Frederic's initial version but keeps the
338 branching structure of the jet. Some of the features, like
339 dynamical R0, direct access to the substructure or the same depth
340 variant, are still unsupported.
341
342 * SoftDrop.hh:
343 declared _beta, _symmetry_cut and _R0sqr as protected (was
344 private) so they ca n be used by RecursiveSoftDrop
345
346 * RecursiveSymmetryCutBase.{hh,cc}:
347 extracted from result() the part that performs one step of the
348 resursion (implemented as recurse_one_step()). This is repeatedly
349 called by result(). It has specific conventions to indicate
350 whether or not some substructure has been found or if one ran into
351 some issue.
352
3532017-04-25 Kevin Zhou <knzhou@mit.edu>
354
355 * IteratedSoftDrop.hh
356 . Added Doxygen documentation
357
358 * RecursiveSymmetryCutBase.hh
359 . Added references to ISD
360
3612017-04-25 Jesse Thaler <jthaler@jthaler.net>
362 * AUTHORS, COPYING:
363 . Added ISD arXiv number
364
365 * example_isd.{cc,ref}
366 . Added ISD arXiv number
367 . Changing z_cut to be optimal value (with Lambda = 1 GeV)
368 . Tweaked formatting
369
370 * IteratedSoftDrop.{hh,cc}
371 . Added ISD arXiv number
372 . Assert added if recluster does not return one jet.
373
374 * README
375 . Added ISD arXiv number and tweaked wording
376
377
3782017-04-20 Kevin Zhou <knzhou@mit.edu>
379
380 * example_isd.{cc,ref} ** ADDED **
381 * IteratedSoftDrop.{cc,hh} ** ADDED **
382
383 * Makefile
384 . Added IteratedSoftDrop (ISD) as appropriate
385
386 * AUTHORS
387 . Added myself to author list
388 . Added placeholder for ISD paper
389
390 * COPYING
391 . Added placeholder for ISD paper
392
393 * README
394 . Added description of ISD
395
396 * TODO
397 . Added tasks to integrate ISD with other classes, e.g. SD,
398 Recluster, and the future RecursiveSoftDrop (RSD)
399
400 * NEWS
401 . Added dummy for release of 1.1.0
402
403 * VERSION:
404 . Switched version number to 1.1.0-dev
405
406 * example_advanced_usage.cc:
407 . Added $Id$ tag, didn't change anything else
408
4092014-07-30 Gregory Soyez <soyez@fastjet.fr>
410
411 * Recluster.hh: fixed the name of the #define for the header
412
4132014-07-09 Gregory Soyez <soyez@fastjet.fr> + Jesse
414
415 * NEWS:
416 release of RecursiveTools v1.0.0
417
418 * VERSION:
419 switched version number to 1.0.0
420
4212014-07-08 Gavin Salam <gavin.salam@cern.ch>
422
423 * README (RecursionChoice):
424 added ref to .hh for constness specs of virtual functions (to
425 reduce risk of failed overloading due to wrong constness).
426
4272014-07-08 Gregory Soyez <soyez@fastjet.fr> + Jesse
428
429 * README:
430 partially rewrote the description of set_subtractor
431
4322014-07-07 Gregory Soyez <soyez@fastjet.fr> + Jesse
433
434 * example_advanced_usage.cc:
435 * example_softdrop.cc:
436 a few small fixed in the header of the files
437
438 * VERSION:
439 switched over to 1.0.0-alpha2-devel
440
441 * README:
442 Reordered a few things and added a few details.
443
444 * Makefile (check):
445 Be quiter during "make check"
446
447 * Recluster.cc (contrib):
448 Documented the "single" ctor argument
449
450 * RecursiveSymmetryCutBase.cc (contrib):
451 If the user sets himself the reclustering, disable the "non-CA"
452 warning (we assume that he knows what he is doing). Mentioned in
453 the comments that non-CA reclustering has to be used at the user's
454 risk. Also throw when th input jet has no constituents or when
455 there is no cluster sequence after reclustering.
456
457 * Recluster.cc (contrib):
458 replaced a remaining mention to "filtering" by reclustering
459
4602014-07-04 Jesse Thaler <jthaler@jthaler.net>
461 * VERSION
462 . Ready for alpha release
463
4642014-06-17 Jesse Thaler <jthaler@jthaler.net>
465 * example_advanced_usage.{cc,ref} ** ADDED **
466 * Makefile
467 . New example file to test a bunch of soft drop options
468 . Put in makefile as well
469 . Fixed nasty memory bug with pointers to Recluster
470
471 * RecursiveSymmetryCutBase.cc
472 * example_softdrop.ref
473 . description() now says Groomer vs. Tagger
474
475 * RecursiveSymmetryCutBase.{cc,hh}
476 . Added optional verbose logging information about
477 kinematics of dropped branches
478
479 * example_softdrop.cc
480 * example_advanced_usage.cc
481 . Fixed
482
483
4842014-06-16 Gregory Soyez <soyez@fastjet.fr>
485
486 * Makefile:
487 also install the RecursiveSymmetryuCutBase.hh header
488
4892014-06-13 Jesse Thaler <jthaler@jthaler.net>
490 * AUTHORS
491 . Added myself to author list
492 . Put complete bibliographic details on papers
493
494 * COPYING
495 . Added boilerplate MC/GPLv2 statement
496
497 * example.cc: ** REMOVED ** renamed to...
498 * example_mmdt.cc ** ADDED **
499 * Makefile
500 . Made name change for consistency
501 . Made corresponding changes in Makefile
502
503 * example_mmdt_sub.cc:
504 * example_mmdt.cc:
505 * example_recluster.cc:
506 . light editing of comments
507
508 * example_softdrop.cc:
509 . light editing of comments
510 . added assert for sdjet != 0, since SoftDrop is a groomer
511
512 * ModifiedMassDropTagger.hh
513 * Recluster.{cc,hh}
514 * RecursiveSymmetryCutBase.{cc,hh}
515 * SoftDrop.hh
516 . Updated some comments
517
518 * README
519 . Updated to include basic usage description and some
520 technical details
521
522 * TODO:
523 . Added some discussion points.
524
5252014-06-13 Gregory Soyez <soyez@fastjet.fr>
526
527 * example_softdrop.{cc,ref}:
528 added an example for SoftDrop
529
530 * SoftDrop.{hh,cc}:
531 * ModifiedMassDropTagger.{hh,cc}:
532 * RecursiveSymmetryCutBase.{hh,cc}: *** ADDED ***
533 . added a base class for both the mMDT and SoftDrop
534 . made mMDT and SoftDrop inherit from RecursiveSymmetryCutBase
535 . moved the reclustering to the base class. By default, both
536 mMDT and SoftDrop now recluster the jet with C/A
537 . added set_grooming_mode and set_tagging_mode methods to the
538 base class
539
540 * Merging the development branch 1.0-beta1-softdrop-addition back
541 into the trunk (will correspond to revision 682)
542
543 * VERSION:
544 switched back to 1.0.0-devel
545
546 * SoftDrop.{hh,cc}:
547 added support for re-clustering through set_reclustering(bool,
548 Recluster*). By default, reclustering is done with
549 Cambridge/Aachen.
550
551 * example_recluster.{cc,ref}: *** ADDED ***
552 added an example of reclustering
553
554 * Recluster.{hh,cc}:
555 added a 'single' ctor argument [true by default]. When true, the
556 hardest jet after reclustering is returned, otherwise, the result
557 is a composite jet with all the subjets as its pieces.
558
5592014-05-15 Gregory Soyez <soyez@fastjet.fr>
560
561 * VERSION:
562 set version number to 1.0-alpha-PUWS14.1 in preparation for a
563 fastjet-contrib release for the pileup-workshop at CERN on May
564 2014.
565
5662014-04-25 Gregory Soyez <soyez@fastjet.fr>
567
568 * ModifiedMassDropTagger.hh:
569 * ModifiedMassDropTagger.cc:
570 Added comments at various places
571
572 * AUTHORS:
573 * README:
574 Updated info about what is now included in this contrib
575
576 * SoftDrop.hh: *** ADDED ***
577 * SoftDrop.cc: *** ADDED ***
578 * Recluster.hh: *** ADDED ***
579 * Recluster.cc; *** ADDED ***
580 Added tools for reclustering and softDrop
581
5822014-04-25 Gregory Soyez <soyez@fastjet.fr>
583
584 branch started at revision 611 to start including SoftDrop in the
585 Recursivetols contrib
586
5872014-04-24 Gregory Soyez <soyez@fastjet.fr>
588
589 * ModifiedMassDropTagger.hh:
590 added a mention of the fact that when result is called in the
591 presence of a subtractor, then the output is a subtracted
592 PseudoJet.
593
594 * ModifiedMassDropTagger.hh:
595 declared _symmetry_cut as protected (rather than provate) so it
596 can be accessed if symmetry_cut_description() is overloaded.
597
598 * example.cc:
599 trivial typo fixed in a comment
600
6012014-02-04 Gavin Salam <gavin.salam@cern.ch>
602
603 * VERSION:
604 upped it to 1.0-beta1
605
606 * example_mmdt_sub.cc (main):
607 added an #if to make sure FJ3.1 features are only used if FJ3.1
608 is available. (Currently FJ3.1 is only available to FJ developers).
609
6102014-01-26 Gavin Salam <gavin.salam@cern.ch>
611
612 * VERSION:
613 renamed to 1.0-beta0
614
615 * ModifiedMassDropTagger.hh:
616 * README:
617 added info on author names
618
619 * example_mmdt_sub.ref: *** ADDED ***
620 added reference output for the pileup test.
621
6222014-01-25 Gavin Salam <gavin.salam@cern.ch>
623
624 * example_mmdt_sub.cc:
625 * Makefile:
626 added an extra example illustrating functionality with pileup
627 subtraction.
628
6292014-01-24 Gavin Salam <gavin.salam@cern.ch>
630
631 * ModifiedMassDropTagger.cc:
632
633 Reorganised code so that (sub)jet.m2()>0 check is only used when
634 absolutely necessary: so if using a scalar_z symmetry measure,
635 whenever scalar_z < zcut, then there is no point checking the mu
636 condition. This means that there's no issue if the (sub)jet mass
637 is negative, and one simply recurses down into the jet. (Whereas
638 before it would bail out, reducing the tagging efficiency).
639
640 Also removed the verbose code.
641
6422014-01-23 Gavin Salam <gavin.salam@cern.ch>
643
644 * ModifiedMassDropTagger.cc|hh:
645 * example.cc
646 replaced "asymmetry" with "symmetry" in a number of places;
647 implemented the structural information and added it to the example;
648 added a new simplified constructor;
649 improved doxygen documentation;
650 started renaming -> RecursiveTools
651
652 * README
653 some tidying
654
655 * VERSION
656 1.0-b0
657
6582014-01-22 Gavin Salam <gavin.salam@cern.ch>
659
660 * ModifiedMassDropTagger.cc (contrib):
661 -ve mass now bails out also when using the "y" asymmetry measure.
662 Also, default my is now infinite.
663
6642014-01-20 Gavin Salam <gavin.salam@cern.ch> + Gregory
665
666
667 * ModifiedMassDropTagger.cc|hh:
668 introduced a virtual asymmetry_cut_fn (essentially a
669 dummy function returning a constant), to allow for derived classes
670 to do fancier things.
671
672 added warning about non-C/A clustering.
673 explicitly labelled some (inherited) virtual functions as
674 virtual.
675
6762014-01-20 Gavin Salam <gavin.salam@cern.ch>
677
678 * example.ref:
679 * example.cc (main):
680 got a first working example and make check setup.
681
682 * ModifiedMassDropTagger.cc|hh:
683 improved doxygen comments;
684 added option whereby input jet is assumed already subtracted
685
6862014-01-19 Gavin Salam <gavin.salam@cern.ch>
687
688 * ModifiedMassDropTagger.cc|hh:
689 * many other files
690
691 Initial creation, with basic code for MMDT
692
Note: See TracBrowser for help on using the repository browser.