cet-is » canvas

h1. Release Notes

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.

h2(#31000). canvas version:"3.10.00" (2020/07/07)

* _art_ suites: [[art:Release Notes 30600|3.06.00]]

* _critic_ suites: [[critic:Release Notes|2.04.00]]

* _gallery_ suites: [[gallery:Release Notes 11500|1.15.00]]

This version only supports Python 3 and SLF7.  The @e20@ qualifier (GCC 9.3 with C++17 enabled) has been added.

h2(#30901). canvas version:"3.09.01" (2020/03/02)

* _art_ suites: [[art:Release Notes 30500|3.05.00]], [[art:Release Notes 30501|3.05.01]]

* _critic_ suites: [[critic:Release Notes|2.03.00]], [[critic:Release Notes|2.03.01]]

* _gallery_ suites: [[gallery:Release Notes 11402|1.14.02]]

h2(#30900). canvas version:"3.09.00" (2019/11/12)

* _art_ suites: [[art:Release Notes 30400|3.04.00]]

* _critic_ suites: [[critic:Release Notes|2.02.00]], [[critic:Release Notes|2.02.01]]

* _gallery_ suites: [[gallery:Release Notes 11400|1.14.00]], [[gallery:Release Notes 11401|1.14.01]]

This version includes the following new features:

* The ability to create associative containers using the @art::InputTag@ key type (resolves issue #23320).

* The @art::Assns::addMany@ overload set, which can be used for easily creating one-to-many associations.

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.

h2(#30800). canvas version:"3.08.00" (2019/06/21)

* _art_ suites: [[art:Release Notes 30300|3.03.00]], [[art:Release Notes 30301|3.03.01]]

* _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]]

* _gallery_ suites: [[gallery:Release Notes 11300|1.13.00]], [[gallery:Release Notes 11301|1.13.01]]

Smart-query objects constructed with an @art::ProductToken@ now ensure C++ type consistency (resolves issue #20579).

h2(#30704). canvas version:"3.07.04" (2019/05/29)

*  _art_ suites: [[art:Release Notes 30206|3.02.06]]

* _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]]

* _gallery_ suites: [[gallery:Release Notes 11204|1.12.04]], [[gallery:Release Notes 11206|1.12.06]], [[gallery:Release Notes 11207|1.12.07]]

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).

h2(#30703). canvas version:"3.07.03" (2019/03/07)

* _art_ suites: [[art:Release Notes 30203|3.02.03]], [[art:Release Notes 30204|3.02.04]], [[art:Release Notes 30205|3.02.05]]

* _critic_ suites: [[critic:Release Notes#20003|2.00.03]], [[critic:Release Notes#20004|2.00.04]], [[critic:Release Notes#20005|2.00.05]]

* _gallery_ suites: [[gallery:Release Notes 11203|1.12.03]]

h2(#30702). canvas version:"3.07.02" (2019/03/05)

* _art_ suites: [[art:Release Notes 30202|3.02.02]]

* _critic_ suites: [[critic:Release Notes#20002|2.00.02]]

* _gallery_ suites: [[gallery:Release Notes 11202|1.12.02]]

h2(#30701). canvas version:"3.07.01" (2019/02/07)

* _art_ suites: [[art:Release Notes 30201|3.02.01]]

* _critic_ suites: [[critic:Release Notes#20001|2.00.01]]

* _gallery_ suites: [[gallery:Release Notes 11201|1.12.01]]

h2(#30700). canvas version:"3.07.00" (2019/01/30)

* _art_ suites: [[art:Release Notes 30200|3.02.00]]

* _critic_ suites: [[critic:Release Notes#20000|2.00.00]]

* _gallery_ suites: [[gallery:Release Notes 11200|1.12.00]]

----

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]])

h2. %(#30500)canvas% version:"3.05.00", 2018/09/25 ([[art:Release Notes 3.01.00|art suite 3.01.00]])

* C++17 only

h2. %(#30400)canvas% version:"3.04.00", 2018/06/05 ([[art:Release Notes 3.00.00|art suite 3.00.00]])

{{collapse(New features)

* A helper facility for looping over each @art::BranchType@ value has been added:

<pre><code class="cpp">

art::for_each_branch_type([](art::BranchType const bt) { std::cout << bt << '\n'; });

</code></pre>

* 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.

----

}}

{{collapse(Breaking changes)

{{include(30400 breaking changes)}}

}}

----

h2. %(#30601)canvas% version:"3.06.01", 2019/06/07 ([[art:Release Notes 2.13.00|art suite 2.13.00]])

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]])

h2. %(#30304)canvas% version:"3.03.04", 2018/11/19 ([[art:Release Notes 2.11.05|art suite 2.11.05]])

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]])

h2. %(#30302)canvas% version:"3.03.02", 2018/05/04 ([[art:Release Notes 2.11.02|art suite 2.11.02]])

h2. %(#30301)canvas% version:"3.03.01", 2018/04/02 ([[art:Release Notes 2.11.01|art suite 2.11.01]])

h2. %(#30300)canvas% version:"3.03.00", 2018/03/30 ([[art:Release Notes 2.11.00|art suite 2.11.00]])

* This version supports GCC 7.3 with C++17 enabled.

* 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).

* 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.)

To support the above changes, two breaking changes were added:

{{include(30300 breaking changes)}}

h2. %(#30203)canvas% version:"3.02.03", 2018/03/16 ([[art:Release Notes 2.10.04|art suite 2.10.04]])

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]])

* Change the fluffing of the @wrappedName_@ transient data member of @BranchDescription@ to the @BranchDescription@ constructor (resolves bug #18925).

h2. %(#30201)canvas% version:"3.02.01", 2018/01/23 ([[art:Release Notes 2.10.01|art suite 2.10.01]])

h2. %(#30200)canvas% version:"3.02.00", 2018/01/22 ([[art:Release Notes 2.10.00|art suite 2.10.00]])

* Add @AssnsAlgorithms.h@, which provides means of grouping @Assns@ elements based on the "left" element values of an @Assns<L,R(,D)>@ object.

* Support Clang 5.0.1; involves introducing a dependency on ROOT for @c2@ builds.

* Introduce dependency on the header-only @range@ library.

* Provide specialization for @std::hash<art::Ptr<T>>@ (resolves issue #18655).

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]])

%(#10502)canvas% version:"1.05.02", 2017/12/04 ([[art:Release Notes 2.05.01|art suite 2.05.01]])

* Fix empty @RangeSet@ handling

h2. %(#30101)canvas% version:"3.01.01", 2017/11/07 ([[art:Release Notes 2.09.02|art suite 2.09.02]])

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]]).

h2. %(#30003)canvas% version:"3.00.03", 2017/10/20 ([[art:Release Notes 2.08.04|art suite 2.08.04]]).

* Fix schema evolution rules implemented in @ProductIDStreamer@ (resolves bug #17898).

h2. %(#30002)canvas% version:"3.00.02", 2017/08/30 ([[art:Release Notes 2.08.03|art suite 2.08.03]]).

* Fix stale reference error in @IPRHelper@, introduced by using @art::detail::input_tag@ (resolves bug #17609).

h2. %(#30001)canvas% version:"3.00.01", 2017/08/04 ([[art:Release Notes 2.08.02|art suite 2.08.02]]).

* Upgrade to ROOT 6.10.04d.

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]]).

{{include(30000 breaking changes)}}

h2. %(#20002)canvas% version:2.00.02, 2017/05/26 ([[art:Release Notes 2.07.03|art suite 2.07.03]]).

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]]).

* Added the @art::EventIDMatcher@ class, which allows for selection of @EventID@<notextile></notextile>s based on a set of patterns.

* Added a forward iterator to the @art::Assns<A,B,D>@ class template to allow iteration over the collection.

* @art::thread_safe_registry_via_id@ container added to support concurrent insertion of elements.

* Improved exception message in the case of a failure to merge @RangeSet@<notextile></notextile>.

* Significant compile-time improvements to @art::Timestamp@.

* C++ changes to accommodate compilation with Clang.

* %{color:red}Breaking changes:%

** Removed @art::BranchType@ from @art::TypeLabel@ class to avoid duplication downstream.

** Removed @art::DoNotRecordParents@ base class.

h2. %(#10604)canvas% version:1.06.04, 2017/03/22 ([[art:Release Notes 2.06.03|art suite 2.06.03]]).

h2. %(#10603)canvas% version:1.06.03, 2017/02/27 ([[art:Release Notes 2.06.02|art suite 2.06.02]]).

* Depends on patched version of ROOT that supports @gPad->WaitForPrimitive@ (resolves issue #15665).

h2. %(#10602)canvas% version:1.06.02, 2017/02/08 ([[art:Release Notes 2.06.01|art suite 2.06.01]]).

h2. %(#10601)canvas% version:1.06.01, 2017/02/07 ([[art:Release Notes 2.06.00|art suite 2.06.00]]).

* Merge libraries into one @canvas@ library (resolves issue #12995).

* Replace ambiguous error code with two more descriptive codes (resolves issue #14664).

* Further develop @art::Level@ enumeration infrastructure to support non-state-machine @art@ (related to issue #15398).

* Enhance @art::Assns@ functionality (issues #10539).

* Improve consistency of @art::Ptr@ handling (resolves issue #14763).

* Allow for @const@ qualification of the `size()` member function during type introspection, which @art::Wrapper@ relies on for @Assns@ products (resolves issue #14378).

h2. %(#10501)canvas% version:1.05.01, 2016/10/19 ([[art:Release Notes 2.05.00|art suite 2.05.00]]).

* Minor bug fixes.

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]]).

* Substantially improve @RangeSet@ merging efficiency (resolves issue #13765).

* Move @canvas/Utilities/detail/metaprogramming.h@ to @cetlib/detail/metaprogramming.h@.

* Update to CLHEP 2.3.3.2 and ROOT 6.06.08.

h2. %(#10406)canvas% version:1.04.06, 2016/08/17 ([[art:Release Notes 2.03.00|art suite 2.03.00]]).

* Remove link-time dependency of @aggregate.h@ on @TH1@.

h2. %(#10405)canvas% version:1.04.05, 2016/08/08 ([[art:Release Notes 2.02.02|art suite 2.02.02]]).

* Remove dependency on @rapidjson@, which is not used in @canvas@ (resolves issue #12990).

* Fix exception message whenever a dictionary is not found (resolves issue #13459).

h2. %(#10404)canvas% version:1.04.04, 2016/08/02 ([[art:Release Notes 2.02.01|art suite 2.02.01]]).

* Upgrade to ROOT 6.06.04b, which includes fixes to some memory leaks.

h2. %(#10403)canvas% version:1.04.03, 2016/08/02 ([[art:Release Notes 2.02.00|art suite 2.02.00]]).

* Remove explicit template instantiations in @classes.h@ files.

h2. %(#10402)canvas% version:1.04.02, 2016/06/08 ([[art:Release Notes 2.01.02|art suite 2.01.02]]).

* Fix comparison of unsigned and signed integers in aggregation test suite.

h2. %(#10401)canvas% version:1.04.01, 2016/06/07 ([[art:Release Notes 2.01.01|art suite 2.01.01]]).

h2. %(#10400)canvas% version:1.04.00, 2016/06/06 ([[art:Release Notes 2.01.00|art suite 2.01.00]]).

* @art::Wrapper<T>@ includes an additional datum called @rangeSetID@ that corresponds to the @rowid@ of the appropriate SQLite range-set table.

* Product aggregation supported for @art::Wrapper<T>@.

h2. %(#10302)canvas% version:1.03.02, 2016/05/24 ([[art:Release Notes 2.00.02|art suite 2.00.02]]).

h2. %(#10301)canvas% version:1.03.01, 2016/05/16 ([[art:Release Notes 2.00.01|art suite 2.00.01]]).