Fork me on GitHub

source: git/external/fastjet/contribs/RecursiveTools/ChangeLog@ 942a705

Last change on this file since 942a705 was b7b836a, checked in by Pavel Demin <pavel-demin@…>, 6 years ago

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