T2 LIBRARY RELEASE NOTES
2011-09-21/jpv
Copyright 2011 Hauser Olsson GmbH.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
ABOUT VERSION NUMBERS
Version numbers are in 3 parts: a major, a medium, and a minor number.
The major number is incremented very rarely, when the software is
modified in such a way that clients using it need to be recoded or even
redesigned. The medium number is incremented when modifications break
backward compatibility. For all other modifications, only the minor
number is incremented.
2011-07-15/jpv
The Time2 Library is released as a beta version on SourceForge
(http://time2.sourceforge.net).
The release consists of two jars:
- t2.jar (binaries)
- t2source.jar (sources only)
2011-08-17/jpv
The same version (1.0.0) of the Time2 Library is released again.
The library version number is now encoded into the names
of jars, a README file and RELEASE NOTES have been added to the library,
and line terminators in a few files have been standardized.
The release consists of two jars:
- t2-1.0.0.jar (binaries)
- t2-1.0.0.source.jar (sources only)
Compared to the 2011-07-15 release,
- 2 files have been added to the libraries:
- README_1st.html
- RELEASE_NOTES_v1.html
- and in 4 files, line terminators have been cleaned up (CRLFs replaced with LFs):
- ch/agent/core/KeyedException.java
- ch/agent/core/MessageBundle.java
- ch/agent/core/KeyedMessage.java
- ch/agent/t2/T2Msg.java
2011-08-22/jpv
Version 1.1.0 — Null elements forbidden unless they represent a missing value
There is now a consistently enforced rule that elements of time series cannot be
null unless null has been defined to represent missing values. The rule is not new,
but its implementation has been cleaned up.
The new version of the library includes
modifications in TimeIndexable and RegularTimeSeries which are not backward compatible.
These changes are highlighted below.
Various pieces of javadoc comment have been updated.
The release consists of two jars:
- t2-1.1.0.jar (binaries)
- t2-1.1.0.source.jar (sources only)
Compared to version 1.0.0, the following files have been modified
(new file version number in parentheses):
- ch/agent/t2/T2Msg.properties (1.0.1)
- header with copyright added
- 40116 modified
- 40117, 40118, 40121, 40124 added
- ch/agent/t2/time/{Adjustment, Resolution}.java (1.0.1)
- ch/agent/t2/time/Range.java (1.0.1)
- remove @version from javadoc of a nested class
- ch/agent/t2/timeseries/AbstractTimeSeries.java (1.0.1)
- normalizeMissingValue() modified
- ch/agent/t2/timeseries/Filler.java (1.0.1)
- fillHole() now throws an Exception
- ch/agent/t2/timeseries/RegularTimeSeries.java (1.1.0)
- fill(long) now defined in interface TimeIndexable
- fill(T, long) now throws a KeyedException (breaks backward compatibility)
- fill(Filler) now throws a KeyedException (breaks backward compatibility)
- ch/agent/t2/timeseries/SparseTimeSeries (1.0.1)
- remove @version from javadoc of a nested class
- ch/agent/t2/timeseries/TimeAddressable.java (1.0.1)
- all put() methods: javadoc modified
- ch/agent/t2/timeseries/TimeIndexable.java (1.1.0)
- fill(long) added
- fill(T, long) now throws a KeyedException (breaks backward compatibility)
- fill(Filler) now throws a KeyedException (breaks backward compatibility)
2011-09-21/jpv
Version 1.1.1 — Times from different domains now comparable
The new version provides a functional improvement in the comparison of times.
It also includes various bug fixes and documentation improvements.
The release consists of two jars:
- t2-1.1.1.jar (binaries)
- t2-1.1.1.source.jar (sources only)
Compared to version 1.1.0, the following files have been modified
(new file version number in parentheses):
- ch/agent/t2/T2Msg.properties (1.0.2)
- 32008 removed
- 32009 added
- ch/agent/t2/time/TimeDomain.java (1.0.1)
- maxTime(boolean) added
- minTime(boolean) added
- maxTime(): comment modified
- minTime(): comment modified
- ch/agent/t2/time/TimeDomainDefinition.java (1.0.1)
- ch/agent/t2/time/engine/Time2.java (1.0.1)
- class comment: new warning note about time comparisons
- convert(TimeDomain, Adjustment): bug fix.
When converting from YEAR or MONTH to higher resolution domains,
the month and day are now set to 1.
- compareTo(TimeIndex otherTime): better implementation. It is now
possible to compare times from different domains.
- ch/agent/t2/time/engine/TimeFactory.java (1.0.1)
- TimeDomain.maxTime(boolean) implementation added
- TimeDomain.minTime(boolean) implementation added
- ch/agent/t2/timeseries/RegularTimeSeries.java (1.1.1)
- fill(T, long): bug fix.
In a special case, the method was breaking the rule that
missing values are all represented by the same object or null.
- ch/agent/t2/time/timeutil/DayExpression.java (1.0.1)
- class comment: typo.
- getDate(TimeDomain): bug fix and comment update.
The method was producing an unintended side effect.