Project

General

Profile

Release Notes » History » Version 84

Kyle Knoepfel, 11/15/2019 09:01 AM

1 1 Lynn Garren
h1. Release Notes
2 1 Lynn Garren
3 46 Kyle Knoepfel
These notes are intended to serve as a guide to the user-visible features in a particular _art_ suite release. As such, only versions included in _art_ suite releases, or those with substantive changes, are included.
4 46 Kyle Knoepfel
5 82 Kyle Knoepfel
h2(#30900). canvas version:"3.09.00" (2019/11/12)
6 82 Kyle Knoepfel
7 82 Kyle Knoepfel
* _art_ suites: [[art:Release Notes 30400|3.04.00]]
8 82 Kyle Knoepfel
* _critic_ suites: [[critic:Release Notes#20200|2.02.00]]
9 82 Kyle Knoepfel
* _gallery_ suites: [[gallery:Release Notes 11400|1.14.00]]
10 82 Kyle Knoepfel
11 83 Kyle Knoepfel
This version includes the following new features:
12 83 Kyle Knoepfel
13 83 Kyle Knoepfel
* The ability to create associative containers using the @art::InputTag@ key type (resolves issue #23320).
14 83 Kyle Knoepfel
* The @art::Assns::addMany@ overload set, which can be used for easily creating one-to-many associations.
15 82 Kyle Knoepfel
16 84 Kyle Knoepfel
This version only supports qualifiers @e19@ and @c7@.  In addition, Python 3 is enabled by default.  To use Python 2, the @'py2'@ qualifier must be specified when setting up the @canvas@ UPS product.
17 84 Kyle Knoepfel
18 74 Kyle Knoepfel
h2(#30800). canvas version:"3.08.00" (2019/06/21)
19 74 Kyle Knoepfel
20 77 Kyle Knoepfel
* _art_ suites: [[art:Release Notes 30300|3.03.00]], [[art:Release Notes 30301|3.03.01]]
21 81 Kyle Knoepfel
* _critic_ suites: [[critic:Release Notes#20100|2.01.00]], [[critic:Release Notes#20102|2.01.02]], [[critic:Release Notes#20103|2.01.03]], [[critic:Release Notes#20104|2.01.04]]
22 81 Kyle Knoepfel
* _gallery_ suites: [[gallery:Release Notes 11300|1.13.00]], [[gallery:Release Notes 11301|1.13.01]]
23 77 Kyle Knoepfel
24 74 Kyle Knoepfel
25 76 Kyle Knoepfel
Smart-query objects constructed with an @art::ProductToken@ now ensure C++ type consistency (resolves issue #20579).
26 76 Kyle Knoepfel
27 70 Kyle Knoepfel
h2(#30704). canvas version:"3.07.04" (2019/05/29)
28 70 Kyle Knoepfel
29 80 Kyle Knoepfel
*  _art_ suites: [[art:Release Notes 30206|3.02.06]]
30 80 Kyle Knoepfel
* _critic_ suites: [[critic:Release Notes#20006|2.00.06]], [[critic:Release Notes#20007|2.00.07]], [[critic:Release Notes#20009|2.00.09]], [[critic:Release Notes#20010|2.00.10]]
31 80 Kyle Knoepfel
* _gallery_ suites: [[gallery:Release Notes 11204|1.12.04]], [[gallery:Release Notes 11206|1.12.06]], [[gallery:Release Notes 11207|1.12.07]]
32 70 Kyle Knoepfel
33 72 Kyle Knoepfel
The @setPtr@ and @getElementAddresses@ customization points for @art::Ptr@ were unintentionally disabled for _art_ 3.  These have been restored with this version of @canvas@ (resolves issue #22643).
34 72 Kyle Knoepfel
35 66 Kyle Knoepfel
h2(#30703). canvas version:"3.07.03" (2019/03/07)
36 69 Kyle Knoepfel
37 69 Kyle Knoepfel
* _art_ suites: [[art:Release Notes 30203|3.02.03]], [[art:Release Notes 30204|3.02.04]], [[art:Release Notes 30205|3.02.05]]
38 67 Kyle Knoepfel
* _critic_ suites: [[critic:Release Notes#20003|2.00.03]], [[critic:Release Notes#20004|2.00.04]], [[critic:Release Notes#20005|2.00.05]]
39 68 Kyle Knoepfel
* _gallery_ suites: [[gallery:Release Notes 11203|1.12.03]]
40 66 Kyle Knoepfel
41 65 Kyle Knoepfel
h2(#30702). canvas version:"3.07.02" (2019/03/05)
42 65 Kyle Knoepfel
43 65 Kyle Knoepfel
* _art_ suites: [[art:Release Notes 30202|3.02.02]]
44 67 Kyle Knoepfel
* _critic_ suites: [[critic:Release Notes#20002|2.00.02]]
45 65 Kyle Knoepfel
* _gallery_ suites: [[gallery:Release Notes 11202|1.12.02]]
46 65 Kyle Knoepfel
47 65 Kyle Knoepfel
48 64 Kyle Knoepfel
h2(#30701). canvas version:"3.07.01" (2019/02/07)
49 1 Lynn Garren
50 64 Kyle Knoepfel
* _art_ suites: [[art:Release Notes 30201|3.02.01]]
51 64 Kyle Knoepfel
* _critic_ suites: [[critic:Release Notes#20001|2.00.01]]
52 64 Kyle Knoepfel
* _gallery_ suites: [[gallery:Release Notes 11201|1.12.01]]
53 64 Kyle Knoepfel
54 64 Kyle Knoepfel
h2(#30700). canvas version:"3.07.00" (2019/01/30)
55 64 Kyle Knoepfel
56 64 Kyle Knoepfel
* _art_ suites: [[art:Release Notes 30200|3.02.00]]
57 64 Kyle Knoepfel
* _critic_ suites: [[critic:Release Notes#20000|2.00.00]]
58 64 Kyle Knoepfel
* _gallery_ suites: [[gallery:Release Notes 11200|1.12.00]]
59 64 Kyle Knoepfel
60 64 Kyle Knoepfel
61 64 Kyle Knoepfel
----
62 60 Kyle Knoepfel
63 63 Kyle Knoepfel
h2. %(#30501)canvas% version:"3.05.01", 2019/01/29 ([[art:Release Notes 3.01.01|art suite 3.01.01]], [[art:Release Notes 3.01.02|art suite 3.01.02]])
64 60 Kyle Knoepfel
65 54 Kyle Knoepfel
h2. %(#30500)canvas% version:"3.05.00", 2018/09/25 ([[art:Release Notes 3.01.00|art suite 3.01.00]])
66 54 Kyle Knoepfel
67 55 Kyle Knoepfel
* C++17 only
68 55 Kyle Knoepfel
69 48 Kyle Knoepfel
h2. %(#30400)canvas% version:"3.04.00", 2018/06/05 ([[art:Release Notes 3.00.00|art suite 3.00.00]])
70 48 Kyle Knoepfel
71 52 Kyle Knoepfel
{{collapse(New features)
72 49 Kyle Knoepfel
* A helper facility for looping over each @art::BranchType@ value has been added:
73 49 Kyle Knoepfel
<pre><code class="cpp">
74 50 Kyle Knoepfel
art::for_each_branch_type([](art::BranchType const bt) { std::cout << bt << '\n'; });
75 1 Lynn Garren
</code></pre>
76 1 Lynn Garren
* The ability to debug TBB task execution within _art_ can be enabled by the user specifying the environment variable @ART_DEBUG_TASKS=<NUM>@, where the value of @<NUM>@ is an integer threshold.
77 1 Lynn Garren
78 52 Kyle Knoepfel
----
79 1 Lynn Garren
80 52 Kyle Knoepfel
}}
81 52 Kyle Knoepfel
82 52 Kyle Knoepfel
{{collapse(Breaking changes)
83 49 Kyle Knoepfel
{{include(30400 breaking changes)}}
84 52 Kyle Knoepfel
}}
85 49 Kyle Knoepfel
86 58 Kyle Knoepfel
----
87 58 Kyle Knoepfel
88 73 Kyle Knoepfel
h2. %(#30601)canvas% version:"3.06.01", 2019/06/07 ([[art:Release Notes 2.13.00|art suite 2.13.00]])
89 73 Kyle Knoepfel
90 73 Kyle Knoepfel
h2. %(#30600)canvas% version:"3.06.00", 2019/01/22 ([[art:Release Notes 2.12.00|art suite 2.12.00]], [[art:Release Notes 2.12.01|art suite 2.12.01]])
91 59 Kyle Knoepfel
92 58 Kyle Knoepfel
h2. %(#30304)canvas% version:"3.03.04", 2018/11/19 ([[art:Release Notes 2.11.05|art suite 2.11.05]])
93 58 Kyle Knoepfel
94 57 Kyle Knoepfel
h2. %(#30303)canvas% version:"3.03.03", 2018/07/16 ([[art:Release Notes 2.11.03|art suite 2.11.03]], [[art:Release Notes 2.11.04|art suite 2.11.04]])
95 53 Kyle Knoepfel
96 47 Kyle Knoepfel
h2. %(#30302)canvas% version:"3.03.02", 2018/05/04 ([[art:Release Notes 2.11.02|art suite 2.11.02]])
97 47 Kyle Knoepfel
98 42 Kyle Knoepfel
h2. %(#30301)canvas% version:"3.03.01", 2018/04/02 ([[art:Release Notes 2.11.01|art suite 2.11.01]])
99 42 Kyle Knoepfel
100 41 Kyle Knoepfel
h2. %(#30300)canvas% version:"3.03.00", 2018/03/30 ([[art:Release Notes 2.11.00|art suite 2.11.00]])
101 41 Kyle Knoepfel
102 44 Kyle Knoepfel
* This version supports GCC 7.3 with C++17 enabled.
103 43 Kyle Knoepfel
* In past versions of project:canvas, @RangeSet@ representations for a full run, and for a completely empty run have been the same under the assumption that it is not possible to create a completely empty run.  Although this assumption is correct for all newly created products/runs in versions of _art_ that support the concept of a @RangeSet@, it is incorrect when reading files that do not have @RangeSet@ information.  To be able to disambiguate between empty range sets and full-run range sets, we have changed the representation of the full-run @RangeSet@ (resolves bug #18996).
104 45 Kyle Knoepfel
* During the dereferencing of an @art::Ptr<T>@, a check is made that the @art::Ptr@ index is valid.  This happens during the first dereference of the product for a given event (or subrun/run).  Subsequent dereferences incur no additional run-time overhead. (Resolves issue #18849.)
105 43 Kyle Knoepfel
106 43 Kyle Knoepfel
To support the above changes, two breaking changes were added:
107 43 Kyle Knoepfel
108 43 Kyle Knoepfel
{{include(30300 breaking changes)}}
109 43 Kyle Knoepfel
110 40 Kyle Knoepfel
h2. %(#30203)canvas% version:"3.02.03", 2018/03/16 ([[art:Release Notes 2.10.04|art suite 2.10.04]])
111 40 Kyle Knoepfel
112 39 Kyle Knoepfel
h2. %(#30202)canvas% version:"3.02.02", 2018/02/15 ([[art:Release Notes 2.10.02|art suite 2.10.02]], [[art:Release Notes 2.10.03|art suite 2.10.03]])
113 38 Kyle Knoepfel
114 38 Kyle Knoepfel
* Change the fluffing of the @wrappedName_@ transient data member of @BranchDescription@ to the @BranchDescription@ constructor (resolves bug #18925).
115 38 Kyle Knoepfel
116 36 Kyle Knoepfel
h2. %(#30201)canvas% version:"3.02.01", 2018/01/23 ([[art:Release Notes 2.10.01|art suite 2.10.01]])
117 36 Kyle Knoepfel
118 36 Kyle Knoepfel
h2. %(#30200)canvas% version:"3.02.00", 2018/01/22 ([[art:Release Notes 2.10.00|art suite 2.10.00]])
119 36 Kyle Knoepfel
120 37 Kyle Knoepfel
* Add @AssnsAlgorithms.h@, which provides means of grouping @Assns@ elements based on the "left" element values of an @Assns<L,R(,D)>@ object.
121 37 Kyle Knoepfel
* Support Clang 5.0.1; involves introducing a dependency on ROOT for @c2@ builds.
122 37 Kyle Knoepfel
* Introduce dependency on the header-only @range@ library.
123 37 Kyle Knoepfel
* Provide specialization for @std::hash<art::Ptr<T>>@ (resolves issue #18655).
124 37 Kyle Knoepfel
125 35 Kyle Knoepfel
h2. %(#30103)canvas% version:"3.01.03", 2017/12/06 ([[art:Release Notes 2.09.03|art suite 2.09.03]], [[art:Release Notes 2.09.04|art suite 2.09.04]], [[art:Release Notes 2.09.05|art suite 2.09.05]], [[art:Release Notes 2.09.06|art suite 2.09.06]])
126 33 Kyle Knoepfel
%(#10502)canvas% version:"1.05.02", 2017/12/04 ([[art:Release Notes 2.05.01|art suite 2.05.01]])
127 31 Kyle Knoepfel
128 31 Kyle Knoepfel
* Fix empty @RangeSet@ handling
129 31 Kyle Knoepfel
130 32 Kyle Knoepfel
h2. %(#30101)canvas% version:"3.01.01", 2017/11/07 ([[art:Release Notes 2.09.02|art suite 2.09.02]])
131 32 Kyle Knoepfel
132 29 Kyle Knoepfel
h2. %(#30100)canvas% version:"3.01.00", 2017/10/17 ([[art:Release Notes 2.09.00|art suite 2.09.00]], [[art:Release Notes 2.09.01|art suite 2.09.01]]).
133 29 Kyle Knoepfel
134 30 Kyle Knoepfel
h2. %(#30003)canvas% version:"3.00.03", 2017/10/20 ([[art:Release Notes 2.08.04|art suite 2.08.04]]).
135 30 Kyle Knoepfel
136 30 Kyle Knoepfel
* Fix schema evolution rules implemented in @ProductIDStreamer@ (resolves bug #17898).
137 28 Kyle Knoepfel
138 27 Kyle Knoepfel
h2. %(#30002)canvas% version:"3.00.02", 2017/08/30 ([[art:Release Notes 2.08.03|art suite 2.08.03]]).
139 25 Kyle Knoepfel
140 26 Kyle Knoepfel
* Fix stale reference error in @IPRHelper@, introduced by using @art::detail::input_tag@ (resolves bug #17609).
141 26 Kyle Knoepfel
142 27 Kyle Knoepfel
h2. %(#30001)canvas% version:"3.00.01", 2017/08/04 ([[art:Release Notes 2.08.02|art suite 2.08.02]]).
143 25 Kyle Knoepfel
144 26 Kyle Knoepfel
* Upgrade to ROOT 6.10.04d.
145 26 Kyle Knoepfel
146 27 Kyle Knoepfel
h2. %(#30000)canvas% version:"3.00.00", 2017/08/01 ([[art:Release Notes 2.08.00|art suite 2.08.00]], [[art:Release Notes 2.08.01|art suite 2.08.01]]).
147 21 Kyle Knoepfel
148 23 Kyle Knoepfel
{{include(30000 breaking changes)}}
149 21 Kyle Knoepfel
150 27 Kyle Knoepfel
h2. %(#20002)canvas% version:2.00.02, 2017/05/26 ([[art:Release Notes 2.07.03|art suite 2.07.03]]).
151 19 Kyle Knoepfel
152 27 Kyle Knoepfel
h2. %(#20001)canvas% version:2.00.01, 2017/05/25 ([[art:Release Notes 2.07.01|art suite 2.07.01]], [[art:Release Notes 2.07.02|art suite 2.07.02]]).
153 18 Kyle Knoepfel
154 20 Kyle Knoepfel
* Added the @art::EventIDMatcher@ class, which allows for selection of @EventID@<notextile></notextile>s based on a set of patterns.
155 20 Kyle Knoepfel
* Added a forward iterator to the @art::Assns<A,B,D>@ class template to allow iteration over the collection.
156 20 Kyle Knoepfel
* @art::thread_safe_registry_via_id@ container added to support concurrent insertion of elements.
157 20 Kyle Knoepfel
* Improved exception message in the case of a failure to merge @RangeSet@<notextile></notextile>.
158 20 Kyle Knoepfel
* Significant compile-time improvements to @art::Timestamp@.
159 20 Kyle Knoepfel
* C++ changes to accommodate compilation with Clang.
160 27 Kyle Knoepfel
* %{color:red}Breaking changes:%
161 20 Kyle Knoepfel
** Removed @art::BranchType@ from @art::TypeLabel@ class to avoid duplication downstream.
162 20 Kyle Knoepfel
** Removed @art::DoNotRecordParents@ base class.
163 20 Kyle Knoepfel
164 20 Kyle Knoepfel
165 27 Kyle Knoepfel
h2. %(#10604)canvas% version:1.06.04, 2017/03/22 ([[art:Release Notes 2.06.03|art suite 2.06.03]]).
166 17 Kyle Knoepfel
167 27 Kyle Knoepfel
h2. %(#10603)canvas% version:1.06.03, 2017/02/27 ([[art:Release Notes 2.06.02|art suite 2.06.02]]).
168 16 Kyle Knoepfel
169 16 Kyle Knoepfel
* Depends on patched version of ROOT that supports @gPad->WaitForPrimitive@ (resolves issue #15665).
170 16 Kyle Knoepfel
171 27 Kyle Knoepfel
h2. %(#10602)canvas% version:1.06.02, 2017/02/08 ([[art:Release Notes 2.06.01|art suite 2.06.01]]).
172 1 Lynn Garren
173 27 Kyle Knoepfel
h2. %(#10601)canvas% version:1.06.01, 2017/02/07 ([[art:Release Notes 2.06.00|art suite 2.06.00]]).
174 1 Lynn Garren
175 26 Kyle Knoepfel
* Merge libraries into one @canvas@ library (resolves issue #12995).
176 26 Kyle Knoepfel
* Replace ambiguous error code with two more descriptive codes (resolves issue #14664).
177 26 Kyle Knoepfel
* Further develop @art::Level@ enumeration infrastructure to support non-state-machine @art@ (related to issue #15398).
178 26 Kyle Knoepfel
* Enhance @art::Assns@ functionality (issues #10539).
179 26 Kyle Knoepfel
* Improve consistency of @art::Ptr@ handling (resolves issue #14763).
180 26 Kyle Knoepfel
* Allow for @const@ qualification of the `size()` member function during type introspection, which @art::Wrapper@ relies on for @Assns@ products (resolves issue #14378).
181 15 Kyle Knoepfel
182 27 Kyle Knoepfel
h2. %(#10501)canvas% version:1.05.01, 2016/10/19 ([[art:Release Notes 2.05.00|art suite 2.05.00]]).
183 11 Kyle Knoepfel
184 12 Kyle Knoepfel
* Minor bug fixes.
185 12 Kyle Knoepfel
186 27 Kyle Knoepfel
h2. %(#10500)canvas% version:1.05.00, 2016/09/14 ([[art:Release Notes 2.04.00|art suite 2.04.00]], [[art:Release Notes 2.04.01|art suite 2.04.01]]).
187 9 Kyle Knoepfel
188 10 Kyle Knoepfel
* Substantially improve @RangeSet@ merging efficiency (resolves issue #13765).
189 10 Kyle Knoepfel
* Move @canvas/Utilities/detail/metaprogramming.h@ to @cetlib/detail/metaprogramming.h@.
190 10 Kyle Knoepfel
* Update to CLHEP 2.3.3.2 and ROOT 6.06.08.
191 10 Kyle Knoepfel
192 27 Kyle Knoepfel
h2. %(#10406)canvas% version:1.04.06, 2016/08/17 ([[art:Release Notes 2.03.00|art suite 2.03.00]]).
193 8 Kyle Knoepfel
194 8 Kyle Knoepfel
* Remove link-time dependency of @aggregate.h@ on @TH1@.
195 8 Kyle Knoepfel
196 27 Kyle Knoepfel
h2. %(#10405)canvas% version:1.04.05, 2016/08/08 ([[art:Release Notes 2.02.02|art suite 2.02.02]]).
197 7 Kyle Knoepfel
198 7 Kyle Knoepfel
* Remove dependency on @rapidjson@, which is not used in @canvas@ (resolves issue #12990).
199 7 Kyle Knoepfel
* Fix exception message whenever a dictionary is not found (resolves issue #13459).
200 7 Kyle Knoepfel
201 27 Kyle Knoepfel
h2. %(#10404)canvas% version:1.04.04, 2016/08/02 ([[art:Release Notes 2.02.01|art suite 2.02.01]]).
202 5 Kyle Knoepfel
203 6 Kyle Knoepfel
* Upgrade to ROOT 6.06.04b, which includes fixes to some memory leaks.
204 6 Kyle Knoepfel
205 27 Kyle Knoepfel
h2. %(#10403)canvas% version:1.04.03, 2016/08/02 ([[art:Release Notes 2.02.00|art suite 2.02.00]]).
206 6 Kyle Knoepfel
207 6 Kyle Knoepfel
* Remove explicit template instantiations in @classes.h@ files.
208 5 Kyle Knoepfel
209 27 Kyle Knoepfel
h2. %(#10402)canvas% version:1.04.02, 2016/06/08 ([[art:Release Notes 2.01.02|art suite 2.01.02]]).
210 4 Kyle Knoepfel
211 4 Kyle Knoepfel
* Fix comparison of unsigned and signed integers in aggregation test suite.
212 4 Kyle Knoepfel
213 27 Kyle Knoepfel
h2. %(#10401)canvas% version:1.04.01, 2016/06/07 ([[art:Release Notes 2.01.01|art suite 2.01.01]]).
214 2 Kyle Knoepfel
215 27 Kyle Knoepfel
h2. %(#10400)canvas% version:1.04.00, 2016/06/06 ([[art:Release Notes 2.01.00|art suite 2.01.00]]).
216 2 Kyle Knoepfel
217 3 Kyle Knoepfel
* @art::Wrapper<T>@ includes an additional datum called @rangeSetID@ that corresponds to the @rowid@ of the appropriate SQLite range-set table.
218 3 Kyle Knoepfel
* Product aggregation supported for @art::Wrapper<T>@.
219 3 Kyle Knoepfel
220 27 Kyle Knoepfel
h2. %(#10302)canvas% version:1.03.02, 2016/05/24 ([[art:Release Notes 2.00.02|art suite 2.00.02]]).
221 1 Lynn Garren
222 27 Kyle Knoepfel
h2. %(#10301)canvas% version:1.03.01, 2016/05/16 ([[art:Release Notes 2.00.01|art suite 2.00.01]]).