DTSg v2.0.0
- Added
"timechange" funbyApproach utilising
timechange::time_floor() as the main function for
transforming timestamps. This new approach generally is way faster than
the existing ones for both families of TALFs and all time zones, hence
it is the new package’s default.
- Sped up the
byY_____() and byYm____()
TALFs of the "base" funbyApproach.
- The
print() method does not print its values’ key
anymore, as it used to be data.table’s default before
v1.15.0.
- Fixed a bug in the
aggregate() method, which could lead
to incorrect results under the following conditions:
- The time zone of the
DTSg object is not UTC or
equivalent.
- The
ignoreDST argument is TRUE.
- A single column with missing values is aggregated.
- Related to the above fix are the following breaking changes when
aggregating a single column with missing values:
- A possible
.n column now contains 0
instead of NA in case all values of a certain temporal
aggregation level are missing.
- The stripping of missing values within summary functions now depends
on the value of a possible
na.rm argument.
- Fixed the support for
data.table’s GForce
optimisation when the fun argument of the
aggregate() method is provided with a character vector
specifying summary functions. Please note that the column order of the
resulting DTSg object is now different due to this
fix.
- Fixed that the
set() method was too anxious about
removing all value columns.
- It is no longer possible to use the deprecated
byFasttime*() TALFs. Please use the "fasttime"
or even better the new "timechange"funbyApproach` from now
on.
- Removed
magrittr from the suggested packages list
(vignettes now use R’s native pipe operator).
- Slightly improved the documentation.
- Improved tests.
- Major internal code improvements.
DTSg v1.1.3
- Ceased the use of legacy time zone symlinks in tests.
- Bumped the minimum tested R version from 4.0.2 to 4.2.3 using the
corresponding Posit public package manager snapshot.
- Slightly improved the documentation.
- Minor internal code improvements.
DTSg v1.1.1
- Column names can often now be additionally specified by a character
string containing either comma separated column names, for example,
"x,y,z", or the start and end column separated by a colon,
for example, "x:z".
- Fixed a bug in the
interpolateLinear() function causing
partial last observation carried forward behaviour when its
roll argument was specified smaller than the size of the
gap to be interpolated.
- Fixed a bug in the
interpolateLinear() function causing
partial interpolation in certain cases when its roll
argument was specified smaller than the size of the gap to be
interpolated.
- Slightly improved the documentation.
DTSg v1.0.0
- Added
funbyApproach argument to the new(),
aggregate(), colapply() and
subset() methods: allows for specifying the flavour of the
applied temporal aggregation level functions (either "base"
utilising as.POSIXct() or "fasttime" utilising
fasttime::fastPOSIXct() or "RcppCCTZ"
utilising RcppCCTZ::parseDatetime() as the main function
for transforming timestamps). Custom approaches for user defined TALFs
are also possible. Please note that the byFasttime*
versions of the TALFs are now deprecated. Use this argument from now on
instead.
- Added
funbyApproach also to the list of
helper data (funbyHelpers argument) passed on to
TALFs.
- Added
funbyApproach field reflecting the individual
funbyApproach of a DTSg object (can also be
actively set in order to change the utilised approach).
- Added undocumented
names() method exclusive only to the
R6 interface acting as an alias for the cols() method.
- Added
mode and typeof arguments to the
cols() method: allows for getting column names with a
certain mode() and/or typeof(). This can be
especially handy when making use of the units package.
- Added
DTSgFast, DTSgFunbyApproach and
DTSgNA.status options providing default values for the
fast, funbyApproach and na.status
arguments of the new() method.
- Added
DTSgDeprecatedWarnings option: allows for
disabling warnings from deprecated features.
- Greatly sped up the
by______() and
byFasttime______() TALFs.
- It is no longer possible to use the deprecated value
"all" with the class argument of the
cols() method in order to get all column names. Use the
default value NULL instead for this. "all" is
treated as a filter for classes of type all from now
on.
- Added an example to the
setCols() method showing how to
set measurement units with the help of the units
package.
- Added an example to the documentation of the
colapply()
method showing how to calculate running correlations with the help of
the runner package.
- Bumped the minimum tested R version from 3.5.2 to 4.0.2 using the
corresponding MRAN repository snapshot.
- Slightly improved the documentation.
- Minor internal code improvements.
DTSg v0.8.1
- Added a “special class” called
".numerary" available to
the class argument of the cols() method:
allows for querying the names of integer and
numeric columns in one go.
- Added undocumented
raggregate(), rbind(),
set() and setnames() methods exclusive only to
the R6 interface acting as aliases for the rowaggregate(),
rowbind(), setCols() and
setColNames() methods.
- The
print() method now truncates the number of printed
rows of the values more aggressively.
- Created a
pkgdown website.
- Improved the vignettes and documentation.
DTSg v0.7.1
- Fixed error “Error in prettyNum(.Internal(format(x, trim, digits,
nsmall, width, 3L, : invalid value 0 for ‘digits’ argument” related to
tests in upcoming R 4.2.0.
- Slightly improved the documentation.
- Minor internal code improvements.
DTSg v0.7.0
- Added
rowaggregate() method: allows for applying
summary functions row-wise to a DTSg object.
- Added
rowbind() method: allows for combining the rows
of a DTSg object.
- Added
setColNames() method: allows for renaming columns
of a DTSg object.
- Added
multiplier and funbyHelpers
arguments to the aggregate(), colapply() and
subset() methods: allows for adjusting the temporal
aggregation level of TALFs and for passing on user defined helper data
to TALFs.
- Added
multiplier also to the list of
helper data passed on to TALFs.
- Added
helpers argument to the colapply()
and rollapply() methods: controls if helper data is passed
on to an applied function (makes occasionally needed anonymous function
wrappers obsolete,
e.g. x$colapply(fun = function(x, ...) {cumsum(x)}, funby = byYm____)
can now be written as
x$colapply(fun = cumsum, helpers = FALSE, funby = byYm____)).
- TALFs based on the
fasttime package now also support
time zones equivalent to UTC (execute
grep("^(Etc/)?(UCT|UTC)$|^(Etc/)?GMT(\\+|-)?0?$", OlsonNames(), ignore.case = TRUE, value = TRUE)
for a full list of supported time zones).
- Fixed that a
DTSg object with only one timestamp did
not set the name of its .dateTime column as expected.
- Improved the vignettes and documentation.
- Minor internal code improvements.
DTSg v0.6.0
- Added
subset() method: allows for filtering rows and/or
selecting columns of a DTSg object.
- Added
setCols() method: allows for setting the values
of columns of, adding columns to and/or removing columns from a
DTSg object.
- Added
[ extract operator: acts as a shortcut for the
getCol() method.
- Added examples to the documentation of the
colapply()
method showing how to calculate moving averages with the help of the
runner package instead of the rollapply()
method.
- The
aggregate() method can benefit from
data.table’s GForce optimisation now when its
fun argument is provided with a character vector specifying
summary functions.
- Greatly sped up the
nas() method.
- Temporal aggregation level functions supplied to the
funby argument of the colapply() method are
not forced to return a POSIXct timestamp any longer. They
are, however, forced to return an atomic mode (the same goes for the
subset() method).
- The
getCol() method now is capable of also querying the
.dateTime column.
- The
R6Method argument of the
S3WrapperGenerator() function now also takes a public
method of an R6ClassGenerator as a function and not only as
an expression.
- Fixed that not all missing values were made explicit after a call to
the
merge() method despite an "explicit"
na.status in some cases.
- Fixed that the
getCol() method tried to query all
numeric columns instead of only the first one by default.
- Improved the vignettes and documentation.
- Minor internal code improvements.
DTSg v0.5.0
- Added
getCol() method: allows for querying the values
of a single column of a DTSg object.
- Added
funby and ignoreDST arguments to the
colapply() method: allows for applying functions like
cumsum() to a certain temporal level.
- Added
na.status argument to the new() and
alter() methods: allows for making missing values either
"explicit" (default) or "implicit" or leaving
them alone via "undecided".
- Added
na.status field reflecting the status of missing
values (can also be actively set).
- Added
na.status also to the list of helper
data passed on to temporal aggregation level functions.
- The
funby argument of the aggregate()
method now also accepts a named list of functions: allows
for calculating several summary statistics at once.
- The
periodicity field can now be actively set in order
to change the periodicity of the time series.
- The
timezone field can now be actively set in order to
convert the time zone of the series.
- Fixed that a
DTSg object with only one timestamp
accepted a missing value in its .dateTime column.
- Improved the vignettes and documentation.
- Minor internal code improvements.
DTSg v0.4.1
- Fixed error “Error in as.POSIXct.numeric(e) : ‘origin’ must be
supplied” related to the
rollback() function in upcoming R
4.1.0.
- Slightly improved the vignettes.
- Minor internal code improvements.
DTSg v0.4.0
- Added
memoryOverCPU argument to the
rollapply() method: allows for preferring CPU over memory
usage which makes the method more flexible in terms of resource
consumption.
- Settings of the option
DTSgClone in
e.g. .RProfile are now respected and not overwritten by
TRUE when the package is loaded.
- Fixed useless coercion of
POSIXct .dateTime
columns to POSIXct upon object creation in case they
contained at least one missing value.
- Switched to the unit testing framework of the
tinytest
instead of the testthat package.
- Slightly improved the vignettes and documentation.
- Minor internal code improvements.
DTSg v0.3.0
- Added
resultCols and suffix arguments to
the colapply() and rollapply() methods: allows
for adding return values of applied functions as new columns instead of
replacing existing ones.
class argument of the cols() method now
accepts a character vector of class names.
- Changed the default value of the
class argument of the
cols() method from "all" to NULL,
however, for backward compatibility "all" can still be used
for the same result, but will eventually be treated as a filter for
classes of type all.
- Added
pattern and ... arguments to the
cols() method: allows for searching column names.
- Switched to the argument check functions of the
checkmate package instead of the
assertive.base, assertive.numbers,
assertive.sets and assertive.types
packages.
- Slightly improved the vignettes and documentation.
- Minor internal code improvements.
DTSg v0.2.1
- Fixed error “Unsupported type passed to argument ‘data’.” related to
the
dygraphs package in at least some releases of R
≤ 3.5.3.
DTSg v0.2.0
- Added
swallow argument to the new()
method: allows for a more resource efficient object creation.
- Added
drop argument to the values()
method: allows for a resource efficient destruction of a
DTSg object while preserving its values.
- Added
class argument to the values()
method: can be used to return the values of a DTSg object
as a data.frame instead of a data.table.
- The
alter() method and linked with it the
new() and other methods are now way more resource efficient
in some cases.
- Added
timestamps field providing the total number of
timestamps.
- The
print() method now omits empty metadata
fields.
- Added means to measure code coverage with the help of the
covr package.
- Removed
xts from the suggested packages list (already
comes along with the dygraphs package).
- Slightly improved the vignettes and documentation.
- Minor internal code improvements.
DTSg v0.1.3
- Slightly improved the vignettes and documentation.
DTSg v0.1.2