Project

General

Profile

Release Notes » History » Version 88

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