Project

General

Profile

Release Notes » History » Version 91

Kyle Knoepfel, 09/09/2020 03:08 PM

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 91 Kyle Knoepfel
h2(#31001). canvas version:"3.10.01" (2020/07/24)
6 91 Kyle Knoepfel
7 91 Kyle Knoepfel
* _art_ suites: [[art:Release Notes 30602|3.06.02]]
8 91 Kyle Knoepfel
* _critic_ suites: [[critic:Release Notes|2.04.02]]
9 91 Kyle Knoepfel
* _gallery_ suites: [[gallery:Release Notes 11501|1.15.01]]
10 91 Kyle Knoepfel
11 88 Kyle Knoepfel
h2(#31000). canvas version:"3.10.00" (2020/07/07)
12 88 Kyle Knoepfel
13 90 Kyle Knoepfel
* _art_ suites: [[art:Release Notes 30600|3.06.00]], [[art:Release Notes 30601|3.06.01]]
14 90 Kyle Knoepfel
* _critic_ suites: [[critic:Release Notes|2.04.00]], [[critic:Release Notes|2.04.01]]
15 88 Kyle Knoepfel
* _gallery_ suites: [[gallery:Release Notes 11500|1.15.00]]
16 88 Kyle Knoepfel
17 89 Kyle Knoepfel
This version only supports Python 3 and SLF7.  The @e20@ qualifier (GCC 9.3 with C++17 enabled) has been added.
18 88 Kyle Knoepfel
19 86 Kyle Knoepfel
h2(#30901). canvas version:"3.09.01" (2020/03/02)
20 86 Kyle Knoepfel
21 87 Kyle Knoepfel
* _art_ suites: [[art:Release Notes 30500|3.05.00]], [[art:Release Notes 30501|3.05.01]]
22 87 Kyle Knoepfel
* _critic_ suites: [[critic:Release Notes|2.03.00]], [[critic:Release Notes|2.03.01]]
23 86 Kyle Knoepfel
* _gallery_ suites: [[gallery:Release Notes 11402|1.14.02]]
24 86 Kyle Knoepfel
25 82 Kyle Knoepfel
h2(#30900). canvas version:"3.09.00" (2019/11/12)
26 82 Kyle Knoepfel
27 82 Kyle Knoepfel
* _art_ suites: [[art:Release Notes 30400|3.04.00]]
28 85 Kyle Knoepfel
* _critic_ suites: [[critic:Release Notes|2.02.00]], [[critic:Release Notes|2.02.01]]
29 85 Kyle Knoepfel
* _gallery_ suites: [[gallery:Release Notes 11400|1.14.00]], [[gallery:Release Notes 11401|1.14.01]]
30 82 Kyle Knoepfel
31 83 Kyle Knoepfel
This version includes the following new features:
32 83 Kyle Knoepfel
33 83 Kyle Knoepfel
* The ability to create associative containers using the @art::InputTag@ key type (resolves issue #23320).
34 83 Kyle Knoepfel
* The @art::Assns::addMany@ overload set, which can be used for easily creating one-to-many associations.
35 82 Kyle Knoepfel
36 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.
37 84 Kyle Knoepfel
38 74 Kyle Knoepfel
h2(#30800). canvas version:"3.08.00" (2019/06/21)
39 74 Kyle Knoepfel
40 77 Kyle Knoepfel
* _art_ suites: [[art:Release Notes 30300|3.03.00]], [[art:Release Notes 30301|3.03.01]]
41 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]]
42 81 Kyle Knoepfel
* _gallery_ suites: [[gallery:Release Notes 11300|1.13.00]], [[gallery:Release Notes 11301|1.13.01]]
43 77 Kyle Knoepfel
44 74 Kyle Knoepfel
45 76 Kyle Knoepfel
Smart-query objects constructed with an @art::ProductToken@ now ensure C++ type consistency (resolves issue #20579).
46 76 Kyle Knoepfel
47 70 Kyle Knoepfel
h2(#30704). canvas version:"3.07.04" (2019/05/29)
48 70 Kyle Knoepfel
49 80 Kyle Knoepfel
*  _art_ suites: [[art:Release Notes 30206|3.02.06]]
50 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]]
51 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]]
52 70 Kyle Knoepfel
53 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).
54 72 Kyle Knoepfel
55 66 Kyle Knoepfel
h2(#30703). canvas version:"3.07.03" (2019/03/07)
56 69 Kyle Knoepfel
57 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]]
58 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]]
59 68 Kyle Knoepfel
* _gallery_ suites: [[gallery:Release Notes 11203|1.12.03]]
60 66 Kyle Knoepfel
61 65 Kyle Knoepfel
h2(#30702). canvas version:"3.07.02" (2019/03/05)
62 65 Kyle Knoepfel
63 65 Kyle Knoepfel
* _art_ suites: [[art:Release Notes 30202|3.02.02]]
64 67 Kyle Knoepfel
* _critic_ suites: [[critic:Release Notes#20002|2.00.02]]
65 65 Kyle Knoepfel
* _gallery_ suites: [[gallery:Release Notes 11202|1.12.02]]
66 65 Kyle Knoepfel
67 65 Kyle Knoepfel
68 64 Kyle Knoepfel
h2(#30701). canvas version:"3.07.01" (2019/02/07)
69 1 Lynn Garren
70 64 Kyle Knoepfel
* _art_ suites: [[art:Release Notes 30201|3.02.01]]
71 64 Kyle Knoepfel
* _critic_ suites: [[critic:Release Notes#20001|2.00.01]]
72 64 Kyle Knoepfel
* _gallery_ suites: [[gallery:Release Notes 11201|1.12.01]]
73 64 Kyle Knoepfel
74 64 Kyle Knoepfel
h2(#30700). canvas version:"3.07.00" (2019/01/30)
75 64 Kyle Knoepfel
76 64 Kyle Knoepfel
* _art_ suites: [[art:Release Notes 30200|3.02.00]]
77 64 Kyle Knoepfel
* _critic_ suites: [[critic:Release Notes#20000|2.00.00]]
78 64 Kyle Knoepfel
* _gallery_ suites: [[gallery:Release Notes 11200|1.12.00]]
79 64 Kyle Knoepfel
80 64 Kyle Knoepfel
81 64 Kyle Knoepfel
----
82 60 Kyle Knoepfel
83 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]])
84 60 Kyle Knoepfel
85 54 Kyle Knoepfel
h2. %(#30500)canvas% version:"3.05.00", 2018/09/25 ([[art:Release Notes 3.01.00|art suite 3.01.00]])
86 54 Kyle Knoepfel
87 55 Kyle Knoepfel
* C++17 only
88 55 Kyle Knoepfel
89 48 Kyle Knoepfel
h2. %(#30400)canvas% version:"3.04.00", 2018/06/05 ([[art:Release Notes 3.00.00|art suite 3.00.00]])
90 48 Kyle Knoepfel
91 52 Kyle Knoepfel
{{collapse(New features)
92 49 Kyle Knoepfel
* A helper facility for looping over each @art::BranchType@ value has been added:
93 49 Kyle Knoepfel
<pre><code class="cpp">
94 50 Kyle Knoepfel
art::for_each_branch_type([](art::BranchType const bt) { std::cout << bt << '\n'; });
95 1 Lynn Garren
</code></pre>
96 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.
97 1 Lynn Garren
98 52 Kyle Knoepfel
----
99 1 Lynn Garren
100 52 Kyle Knoepfel
}}
101 52 Kyle Knoepfel
102 52 Kyle Knoepfel
{{collapse(Breaking changes)
103 49 Kyle Knoepfel
{{include(30400 breaking changes)}}
104 52 Kyle Knoepfel
}}
105 49 Kyle Knoepfel
106 58 Kyle Knoepfel
----
107 58 Kyle Knoepfel
108 73 Kyle Knoepfel
h2. %(#30601)canvas% version:"3.06.01", 2019/06/07 ([[art:Release Notes 2.13.00|art suite 2.13.00]])
109 73 Kyle Knoepfel
110 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]])
111 59 Kyle Knoepfel
112 58 Kyle Knoepfel
h2. %(#30304)canvas% version:"3.03.04", 2018/11/19 ([[art:Release Notes 2.11.05|art suite 2.11.05]])
113 58 Kyle Knoepfel
114 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]])
115 53 Kyle Knoepfel
116 47 Kyle Knoepfel
h2. %(#30302)canvas% version:"3.03.02", 2018/05/04 ([[art:Release Notes 2.11.02|art suite 2.11.02]])
117 47 Kyle Knoepfel
118 42 Kyle Knoepfel
h2. %(#30301)canvas% version:"3.03.01", 2018/04/02 ([[art:Release Notes 2.11.01|art suite 2.11.01]])
119 42 Kyle Knoepfel
120 41 Kyle Knoepfel
h2. %(#30300)canvas% version:"3.03.00", 2018/03/30 ([[art:Release Notes 2.11.00|art suite 2.11.00]])
121 41 Kyle Knoepfel
122 44 Kyle Knoepfel
* This version supports GCC 7.3 with C++17 enabled.
123 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).
124 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.)
125 43 Kyle Knoepfel
126 43 Kyle Knoepfel
To support the above changes, two breaking changes were added:
127 43 Kyle Knoepfel
128 43 Kyle Knoepfel
{{include(30300 breaking changes)}}
129 43 Kyle Knoepfel
130 40 Kyle Knoepfel
h2. %(#30203)canvas% version:"3.02.03", 2018/03/16 ([[art:Release Notes 2.10.04|art suite 2.10.04]])
131 40 Kyle Knoepfel
132 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]])
133 38 Kyle Knoepfel
134 38 Kyle Knoepfel
* Change the fluffing of the @wrappedName_@ transient data member of @BranchDescription@ to the @BranchDescription@ constructor (resolves bug #18925).
135 38 Kyle Knoepfel
136 36 Kyle Knoepfel
h2. %(#30201)canvas% version:"3.02.01", 2018/01/23 ([[art:Release Notes 2.10.01|art suite 2.10.01]])
137 36 Kyle Knoepfel
138 36 Kyle Knoepfel
h2. %(#30200)canvas% version:"3.02.00", 2018/01/22 ([[art:Release Notes 2.10.00|art suite 2.10.00]])
139 36 Kyle Knoepfel
140 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.
141 37 Kyle Knoepfel
* Support Clang 5.0.1; involves introducing a dependency on ROOT for @c2@ builds.
142 37 Kyle Knoepfel
* Introduce dependency on the header-only @range@ library.
143 37 Kyle Knoepfel
* Provide specialization for @std::hash<art::Ptr<T>>@ (resolves issue #18655).
144 37 Kyle Knoepfel
145 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]])
146 33 Kyle Knoepfel
%(#10502)canvas% version:"1.05.02", 2017/12/04 ([[art:Release Notes 2.05.01|art suite 2.05.01]])
147 31 Kyle Knoepfel
148 31 Kyle Knoepfel
* Fix empty @RangeSet@ handling
149 31 Kyle Knoepfel
150 32 Kyle Knoepfel
h2. %(#30101)canvas% version:"3.01.01", 2017/11/07 ([[art:Release Notes 2.09.02|art suite 2.09.02]])
151 32 Kyle Knoepfel
152 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]]).
153 29 Kyle Knoepfel
154 30 Kyle Knoepfel
h2. %(#30003)canvas% version:"3.00.03", 2017/10/20 ([[art:Release Notes 2.08.04|art suite 2.08.04]]).
155 30 Kyle Knoepfel
156 30 Kyle Knoepfel
* Fix schema evolution rules implemented in @ProductIDStreamer@ (resolves bug #17898).
157 28 Kyle Knoepfel
158 27 Kyle Knoepfel
h2. %(#30002)canvas% version:"3.00.02", 2017/08/30 ([[art:Release Notes 2.08.03|art suite 2.08.03]]).
159 25 Kyle Knoepfel
160 26 Kyle Knoepfel
* Fix stale reference error in @IPRHelper@, introduced by using @art::detail::input_tag@ (resolves bug #17609).
161 26 Kyle Knoepfel
162 27 Kyle Knoepfel
h2. %(#30001)canvas% version:"3.00.01", 2017/08/04 ([[art:Release Notes 2.08.02|art suite 2.08.02]]).
163 25 Kyle Knoepfel
164 26 Kyle Knoepfel
* Upgrade to ROOT 6.10.04d.
165 26 Kyle Knoepfel
166 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]]).
167 21 Kyle Knoepfel
168 23 Kyle Knoepfel
{{include(30000 breaking changes)}}
169 21 Kyle Knoepfel
170 27 Kyle Knoepfel
h2. %(#20002)canvas% version:2.00.02, 2017/05/26 ([[art:Release Notes 2.07.03|art suite 2.07.03]]).
171 19 Kyle Knoepfel
172 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]]).
173 18 Kyle Knoepfel
174 20 Kyle Knoepfel
* Added the @art::EventIDMatcher@ class, which allows for selection of @EventID@<notextile></notextile>s based on a set of patterns.
175 20 Kyle Knoepfel
* Added a forward iterator to the @art::Assns<A,B,D>@ class template to allow iteration over the collection.
176 20 Kyle Knoepfel
* @art::thread_safe_registry_via_id@ container added to support concurrent insertion of elements.
177 20 Kyle Knoepfel
* Improved exception message in the case of a failure to merge @RangeSet@<notextile></notextile>.
178 20 Kyle Knoepfel
* Significant compile-time improvements to @art::Timestamp@.
179 20 Kyle Knoepfel
* C++ changes to accommodate compilation with Clang.
180 27 Kyle Knoepfel
* %{color:red}Breaking changes:%
181 20 Kyle Knoepfel
** Removed @art::BranchType@ from @art::TypeLabel@ class to avoid duplication downstream.
182 20 Kyle Knoepfel
** Removed @art::DoNotRecordParents@ base class.
183 20 Kyle Knoepfel
184 20 Kyle Knoepfel
185 27 Kyle Knoepfel
h2. %(#10604)canvas% version:1.06.04, 2017/03/22 ([[art:Release Notes 2.06.03|art suite 2.06.03]]).
186 17 Kyle Knoepfel
187 27 Kyle Knoepfel
h2. %(#10603)canvas% version:1.06.03, 2017/02/27 ([[art:Release Notes 2.06.02|art suite 2.06.02]]).
188 16 Kyle Knoepfel
189 16 Kyle Knoepfel
* Depends on patched version of ROOT that supports @gPad->WaitForPrimitive@ (resolves issue #15665).
190 16 Kyle Knoepfel
191 27 Kyle Knoepfel
h2. %(#10602)canvas% version:1.06.02, 2017/02/08 ([[art:Release Notes 2.06.01|art suite 2.06.01]]).
192 1 Lynn Garren
193 27 Kyle Knoepfel
h2. %(#10601)canvas% version:1.06.01, 2017/02/07 ([[art:Release Notes 2.06.00|art suite 2.06.00]]).
194 1 Lynn Garren
195 26 Kyle Knoepfel
* Merge libraries into one @canvas@ library (resolves issue #12995).
196 26 Kyle Knoepfel
* Replace ambiguous error code with two more descriptive codes (resolves issue #14664).
197 26 Kyle Knoepfel
* Further develop @art::Level@ enumeration infrastructure to support non-state-machine @art@ (related to issue #15398).
198 26 Kyle Knoepfel
* Enhance @art::Assns@ functionality (issues #10539).
199 26 Kyle Knoepfel
* Improve consistency of @art::Ptr@ handling (resolves issue #14763).
200 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).
201 15 Kyle Knoepfel
202 27 Kyle Knoepfel
h2. %(#10501)canvas% version:1.05.01, 2016/10/19 ([[art:Release Notes 2.05.00|art suite 2.05.00]]).
203 11 Kyle Knoepfel
204 12 Kyle Knoepfel
* Minor bug fixes.
205 12 Kyle Knoepfel
206 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]]).
207 9 Kyle Knoepfel
208 10 Kyle Knoepfel
* Substantially improve @RangeSet@ merging efficiency (resolves issue #13765).
209 10 Kyle Knoepfel
* Move @canvas/Utilities/detail/metaprogramming.h@ to @cetlib/detail/metaprogramming.h@.
210 10 Kyle Knoepfel
* Update to CLHEP 2.3.3.2 and ROOT 6.06.08.
211 10 Kyle Knoepfel
212 27 Kyle Knoepfel
h2. %(#10406)canvas% version:1.04.06, 2016/08/17 ([[art:Release Notes 2.03.00|art suite 2.03.00]]).
213 8 Kyle Knoepfel
214 8 Kyle Knoepfel
* Remove link-time dependency of @aggregate.h@ on @TH1@.
215 8 Kyle Knoepfel
216 27 Kyle Knoepfel
h2. %(#10405)canvas% version:1.04.05, 2016/08/08 ([[art:Release Notes 2.02.02|art suite 2.02.02]]).
217 7 Kyle Knoepfel
218 7 Kyle Knoepfel
* Remove dependency on @rapidjson@, which is not used in @canvas@ (resolves issue #12990).
219 7 Kyle Knoepfel
* Fix exception message whenever a dictionary is not found (resolves issue #13459).
220 7 Kyle Knoepfel
221 27 Kyle Knoepfel
h2. %(#10404)canvas% version:1.04.04, 2016/08/02 ([[art:Release Notes 2.02.01|art suite 2.02.01]]).
222 5 Kyle Knoepfel
223 6 Kyle Knoepfel
* Upgrade to ROOT 6.06.04b, which includes fixes to some memory leaks.
224 6 Kyle Knoepfel
225 27 Kyle Knoepfel
h2. %(#10403)canvas% version:1.04.03, 2016/08/02 ([[art:Release Notes 2.02.00|art suite 2.02.00]]).
226 6 Kyle Knoepfel
227 6 Kyle Knoepfel
* Remove explicit template instantiations in @classes.h@ files.
228 5 Kyle Knoepfel
229 27 Kyle Knoepfel
h2. %(#10402)canvas% version:1.04.02, 2016/06/08 ([[art:Release Notes 2.01.02|art suite 2.01.02]]).
230 4 Kyle Knoepfel
231 4 Kyle Knoepfel
* Fix comparison of unsigned and signed integers in aggregation test suite.
232 4 Kyle Knoepfel
233 27 Kyle Knoepfel
h2. %(#10401)canvas% version:1.04.01, 2016/06/07 ([[art:Release Notes 2.01.01|art suite 2.01.01]]).
234 2 Kyle Knoepfel
235 27 Kyle Knoepfel
h2. %(#10400)canvas% version:1.04.00, 2016/06/06 ([[art:Release Notes 2.01.00|art suite 2.01.00]]).
236 2 Kyle Knoepfel
237 3 Kyle Knoepfel
* @art::Wrapper<T>@ includes an additional datum called @rangeSetID@ that corresponds to the @rowid@ of the appropriate SQLite range-set table.
238 3 Kyle Knoepfel
* Product aggregation supported for @art::Wrapper<T>@.
239 3 Kyle Knoepfel
240 27 Kyle Knoepfel
h2. %(#10302)canvas% version:1.03.02, 2016/05/24 ([[art:Release Notes 2.00.02|art suite 2.00.02]]).
241 1 Lynn Garren
242 27 Kyle Knoepfel
h2. %(#10301)canvas% version:1.03.01, 2016/05/16 ([[art:Release Notes 2.00.01|art suite 2.00.01]]).