NEWS

distrEx 2.9.7

bug fix

found a glitch in var-method for compound distributions (see comments in file Functionals.R for details)

distrEx 2.9.6 (2025-01-13)

taken up pkg "robustbase" into "Enhances" in DESCRIPTION to ensure all inter-pkg xrefs in Rd-files work under the hood:
adapted reference output for new startupmsg

distrEx 2.9.4

under the hood

with the help of K. Hornik identified spurious, platform dependent LF/CR issue

and capsulated calls to infoShow() in Rd files by

## IGNORE_RDIFF_BEGIN ## IGNORE_RDIFF_END

distrEx 2.9.3 (2024-08-22)

under the hood

to comply with _R_USE_STRICT_R_HEADERS_=true, we changed calls to PI to M_PI in GLaw.c

distrEx 2.9

user-visible CHANGES

taking up a suggestion by [email protected], we introduced new argument propagate.names in our functionals controlling whether names obtained from parameter coordinates should be propagated to return values of specific S4 methods for functionals
to this end there is a new distrExoption propagate.names.functionals used as default in the functionals

under the hood

KolmogorovDist methods gain argument "..." in order to enable them to digest argument validity.check in MCEstimator
fixed some broken URLs and changed URLs from http to https where possible
changed latin1 to UTF-8 encoding as requested by CRAN since latin1 encoding will be deprecated.

distrEx 2.8

user-visible CHANGES

DESCRIPTION tag SVNRevision changed to VCS/SVNRevision
the return values of distrExIntegrate and all E()-methods gain an optional attribute "diagnostic" which is filled if argument diagnostic is TRUE (the E()-methods whenever they use distrExIntegrate in (parts of) their computation.
particular functionality to inspect/access this diagnostic information through showDiagnostic, getDiagnostic and the S3method for print for class DiagnosticClass

under the hood

moved quantile integration methods for expectation for Weibull and Gamma distribution from pkg RobExtremes to distrEx; this is now also used for Cauchy distributions
introduce exported helper function .qtlIntegrate to achieve this (is reused in RobExtremes for the GEV methods there)
cleaned .Rd file E.Rd: It contained still some references to methods for extreme value distributions which are now in RobExtremes and some old mail reference [email protected]
DiscreteMVDistribution gains a (matrix valued) slot .FinSupport in analogy to the univariate DiscreteDistribution (idea: coordinatewise checking whether a multivariate observation could, in principle, lie in the support -- the 1st row states whether the ith marginal distribution has a finite left endpoint, and the 2nd row if it is has a finite right endpoint); not yet further used
for consistency to the univariate methods, the liesInSupport() method for DiscreteMVDistribution gains an argument checkFin, which is not yet used.
introduced filter functions to warrant some safety that only those args from "..." become arguments of the integrand, of distrExIntegrate, of E(), of integrate, of GLIntegrate, of quantiles and IQR, which are within the formals of the respective function... as a consequence: * functions with more than one formal argument have to have named arguments, as these are then attached internally by name in wrapper functions; CAVEAT: integrands of form function(x, ...) will no longer get their arguments right -- this is intentional to safeguard against passing arguments to the integrand that it cannot digest; * For a call like E(distr, fun = myfun, ...), it is advisable to do something like dotsFun <- .filterFunargs(list(...), myfun) funwD <- function(x) do.call(fun,c(list(x), dotsFun)) dotsInt <- .filterEargs(list(...)) do.call(E, c(list(object = distr, fun = funwd), dotsInt)) to be on the safe side that both E() and myfun() obtain the correct parts of "..." Calls with E(distr, fun=myfun, cond = mycond, withCond = TRUE) are automatically treated in a way s.t. they do not break existing code, i.e., in case of random variables, argument "cond" is suitably attached to argument "x" of the Map of the random variable -- something like c(x,cond)
.qtlIntegrate now uses smaller values for args subdivisions and order in case partitioning into left/middle/right is used: they are multiplied by factors fac.L/fac.R/fac.M according to if( .withRightTail && .withLeftTail){fac.R <- fac.L <- 0.1; fac.M <- 0.8} if( .withRightTail && !.withLeftTail){fac.R <- 0.2; fac.M <- 0.8} if(!.withRightTail && .withLeftTail){fac.L <- 0.2; fac.M <- 0.8} if(!.withRightTail && !.withLeftTail){fac.M <- 1.0} => so at order 5000 we come up with orders in L/M/R of 500 / 4000 / 500 instead of 5000 / 5000 / 5000
fixed a bug in .qtlIntegrate: forgot to call funwD (instead of fun) in case useApply = FALSE
additional .AW-grid values into sysdata.rda for orders 50, 400, 800, 4000, 8000, 40000, 80000, 100000 as these grid values are needed in the partitioned integration in .qtlIntegrate
in addition grid value 100000 so far was not used as it is parsed to .AW.1e5 instead to .AW.100000
code to produce the grid values .AW.xxx in sysdata.rda is now contained in distrExIntegrate.R in an if(FALSE) { block }
new S3 class DiagnosticClass and helper functions .showallNamesDiagnosticList, .reorganizeDiagnosticList to ease inspection of the diagnostic information; exported constant .nmsToGather captures the names of items in diagnostic attributes which are "easily" shown (numeric, logical, character)
Expectations, .qtlIntegrate and distances based on integration (i.e., TotalVarDist, OAsymTotalVarDist, AsymTotalVarDist, HellingerDist, CvMDist) if (diagnostic==TRUE) return diagnostic attributes of S3 class "DiagnosticClass"

distrEx 2.7

user-visible CHANGES

triggered by mail from Peng Rui, [email protected], implemented Hellinger and TotalVariation distance for DiscreteMVDistributions
alias q.l(X) for q(X) to provide functionality in RStudio / Jupyter IRKernel
fixed some URLs in https style

under the hood

added more detailed author information in DESCRIPTION
registered native code for GL integration
recreated sysdata.rda file with new tables .AW.5000, .AW.10000, .AW.50000, .AW.100000
changed defaults in distrExIntegrate / GLIntegrateOrder (with finer grids)

bug fixes

fixed a bug in CvMDist

distrEx 2.6 (2016-04-24)

user-visible CHANGES

changed default integration measure from e2 to e1 in CvMdist
title changed to title style / capitalization
added generating function "EmpiricalMVDistribution" for computing empirical distribution of multivariate data
removed N. Horbenko from authors in DESCRIPTION; her contribution was moved to pkg RobExtremes

under the hood

use particular S3-class "moved2RobExtremeClass" for former package internal constants EULERMASCHERONICONSTANT and APERYCONSTANT
enhanced imports in DESCRIPTION by explicating second order imports

distrEx 2.5 (2013-09-13)

user-visible CHANGES

GENERAL ENHANCEMENTS

cleaned DESCRIPTION and NAMESPACE file as to Imports/Depends

under the hood

use some newly exmported routines which had been internal so far to avoid calls by :::
added .Rbuildignore

BUGFIXES

distrEx 2.4 (2013-02-07)

user-visible CHANGES

moved functionality for extreme value distribution to package RobExtremes -> concerns distributions Gumbel, GEVD, GPareto, and Pareto
moved functional and estimator kMAD to package RobExtremes

under the hood

added DESCRIPTION tag "ByteCompile" to all our packages
updating maintainer email address and URL.
added argument no.readonly = TRUE to assignments of form opar <- par()
deleted no longer needed chm folders

BUGFIXES

corrected bug in var() (with argument fun in case of symmetry)

distrEx 2.3 (2011-01-20)

user-visible CHANGES

new default method for CvMDist (i.e. for mu=e2) instead of numerical integration uses explicit terms => by factor 30 faster!
Nataliya produced a C-version of kMad; integrated to distrEx now
Generalized Extreme Value Distribution is ported to distrEx
Gumbel in distrEx has different parametrization as GEV with shape = 0

under the hood

DESCRIPTION files and package-help files gain a tag SVNRevision to be filled by get[All]RevNr.R from utils in distr

BUGFIXES

found a bug in setMethod("var", signature(x = "UnivariateDistribution")) for spherical symmetric distributions
Small bug in Expectation.R was found
Gumbel in distrEx has different parametrization as GEV with shape = 0
fixed several buglets in GEV * small error for xi = 0 in Functionals.R and Expecation.R * completed unfinished documentation

distrEx 2.2 (2009-11-03)

user-visible CHANGES

enhanced E() methods * expectation gains ... argument to pass on accuracy arguments
enhanced m1df(),m2df() methods * m1df, m2df gain ... argument to be able to pass on accuracy arguments to E(); * m1df, m2df can now digest cond, fun arguments... * particular m1df versions (for Binom, Norm, Chisq, Exp, Pois) are used in E(object, [fun, cond, ] low=.., upp=.., ...) calls
GPareto * implemented GPareto class (Nataliya) [including functionals) * allow for negative shape parameter in generalized Pareto ...

GENERAL ENHANCEMENTS

added tests/Examples folder with file distrEx-Ex.Rout.save to have some automatic testing
added field "Encoding: latin1" to all DESCRIPTION files in order to avoid problems with e.g. Windows locale when svn replaces $LastChangedDate
added TOBEDONE (sic!) files for each package (by accident also in trunc; these are empty so far)

INTERNALLY

introduced helper function .getIntbounds
reorganized help for PrognCondDistribution
functionals in distrEx now make use of this symmetry slot ...
catch errors thrown by qgumbel and qpareto1 when args are not in (0,1) --> corresp. q-methods now consistently return NaN.
m1df,m2df: *particular methods for m2df for AbscontDistribution, DiscreteDistribution are no longer necessary. *new/revised methods for m1df, m2df for AfflinDistribution
enhanced/corrected methods for Kolmogorov distance * when one operand is DiscreteDistribution * yet another (speed) improvement — important for MDE with KolmogorovDist: Kolmogorov-dist e1 (discrete) : e2 (ac) is x <- support(e1) res <- max(p(e1)(x)-p(e2)(x),p(e2)(x)-p.l(e1)(x))
merged Expectation_LebDec.R into Expectation.R according to proposal by Kurt Hornik (different Collation order caused problem in English locale)
new expectation methods for UnivarMixingDistribution
included new methods for E(): * for GPareto as well as for Gammad -> increase the precision for the numerical calculation of certain integrals; in particular, integrals involving "log" as integrand. * Expectation for GPareto now has IQR.fac accuracy set to max(1e4,getdistrExOption("IQR.fac") to enhance accuracy for integration;

BUGFIXES

forgot to commit branches/distr-2.2/pkg/distrEx/man/distrExConstants.Rd
forgot some source files (GPD)
fixed a buglet in m2df method for LatticeDistribution (a catch for existing fun argument was missing).
forgot to set corresponding distrExoptions()-default values for accuracy for m1df, m2df
fixed a bug in E-method for AbscontDistribution, function, cond
fix for the bug in distrEx: m2df now only uses mc <- match.call() instead of mc <- match.call(call = sys.call(sys.parent(1))) (do not completely understand why: there is method dispatch, though, as in plot(), where sys.call(sys.parent(1)) is needed, but here match.call() does it... )
fixed some --hard-to-detect/localize-- bug induced with lazy evaluation: Data-Examples in scripts to ROptEst threw errors: reason — need an explicit assignment im ClippedMomemts.R (distrEx) mc$object <- object to force evaluation of object (otherwise only transmitted as name...)
R CMD check threw an error for distrEx .Rd file distrExConstants.Rd : probably because of a multi-line \deqn{}{} expression modified
corrected some bug with match.call() in Var()...
forgot to write the expectations of different components into different coordinates
Definition for KolmogorovDist for numeric, UnivariateDistribution by means of ks.test was only oK for AbscontDistributions; changed to KolmogorovDist(DiscreteDistribution(e1),e2)
fixed errors in expectation methods (with upper & lower bounds) as well as in m1df, m2df methods

distrEx 2.1 (2009-04-19)

Rd-style: + several buglets detected with the fuzzier checking mechanism cf [Rd] More intensive checking of R help files, Prof Brian Ripley, 09.01.2009 10:25) [Rd] Warning: missing text for item ... in \describe? , Prof Brian Ripley,
FUNCTIONALS --Expectation +expectation gains (optional) low and upp arguments; these can be passed through to var, skewness, kurtosis +expectation gains explicit arguments to set accuracy locally; +also both quantile and scale based methods is used to determine a sensible integration range in expectation --Quantiles: -median and IQR are now defined for UnivariateCondDistribution --general bug fixes: -checked and fixed functionals (stirred up by mail by Jay Kerns, [email protected]) -bug corrected in E for Hyper (thanks to Jay G. Kerns!) ... -corrected small bug in mad, added new implementation for skewness and kurtosis for signature "ANY". -corrected small bug in skewness for AffLinDistribution.
DISTRIBUTIONS + gains distribution Pareto; ported from pkg actuar by Nataliya Horbenko +new slots d,p,q for Gumbel distribution catching errors, vectorization and lower.tail, log[.p] argument ... + new methods for Gumbel distribution ...
DISTANCES + introduced distance OAsymTotalVarDist (minimal asymmetric total variation distance) + introduced new asymmetric total variation distance AsymTotalVarDist + TotalVarDist and HellingerDist gain extra arguments to better control the integration range and exactness
NEW FUNCTIONALS + m1df for AffLinDistribution + Expectation, var, IQR, median, skewness, kurtosis available for Pareto +... and: had forgotten to document the plot-methods in distrExsome typo's in integration range selection

distrEx 2.0.3 (2008-11-29)

under the hood: + enhanced plotting (correct dispatch; opening of new device is controlled by option("newDevice") ) + after JMC's changes: +gone through setIs relations to ensure "correct" inheritance in Expectation, all the distance functionals (ContaminationSize, HellingerDist,...), m1df,m2df + buglet for AffLinDistribution in Skewness + corrected small bug in mad, added new implementation for skewness and kurtosis for signature "ANY"
moved license to LGPL-3
new methods for Gumbel distribution ...

distrEx 2.0 (2008-09-12)

moved teaching illustrations to new package 'distrTeach'
E methods for class[es] '[AffLin]UnivarLebDecDistribution'
distance methods for class '[AffLin]UnivarLebDecDistribution'
CvM distance is implemented

distrEx 1.9 (2007-07-30)

'distrEx' now behaves exactly the same as the other members of the distrXXX family as to 'distrExOptions()', 'getdistrExOption()'
substantial contributions by Jay Kerns, [email protected]: + skewness & kurtosis are now available as functionals + E(), var() return NA in case of T-distribution if not defined
disclaimer for possible collisions with other definitions of kurtosis and skewness
added note on masking on startup as well as disrExMASK()
enhanced 'illustrateCLT' + plot includes a title + for 'DiscreteDistributions' in the "d"-panel, the support is thinned out if length too long + Komogoroff-distance is printed out + 'illustrateCLT' no longer is a generic function but a regular function + the plotting feature of 'illustrateCLT' is extracted and has become a generic function 'plotCLT' (now with title and the summands mentioned in the header) + there is a TclTk-based demo now (therefore TclTk is a suggested package now) replaced recursive summation in illustrate-CLT method by 'convpow'
new demo 'illustLLN' and function 'illustrateLLN' + preset strings similar to those of plot-methods from package 'distr'
moved some parts from package 'distrEx' to package 'distr' + generating function 'DiscreteDistribution' + univariate methods of 'liesInSupport()' + classes 'DistrList' and 'UnivariateDistrList' + generating functions EuclideanSpace() ,Reals(), Naturals()
mentioned in package-help: startup messages may now also be suppressed by suppressPackageStartupMessages() (from package 'base')
adapted demo() to comply with change in return value of require() from R-2.5.0patched on
formals for slots p,q,d as in package stats to enhance accuracy + p(X)(q, [cond,] lower.tail = TRUE, log.p = FALSE) + q(X)(p, [cond,] lower.tail = TRUE, log.p = FALSE) + d(X)(x, [cond,] log = FALSE) used wherever possible; but backwards compatibility: always checked whether lowert.tail / log / log.p are formals
some exact formulas for mad, median, and IQR
new method for IQR for DiscreteDistributions taking care that between upper and lower quartile there is 50% probability
E-, var-, IQR-, mad-, median-, kurtosis-, skewness- methods for new class union AffLinDistribution

distrEx 1.8 (2006-12-18)

changed to version counting of the remaining distrXXX packages
corrected minor error in E() and var() method for Nbinom (thanks to Spencer Graves for drawing our attention to this)
fixed error in definition of Hellinger distance (HellingerDist)

distrEx 0.4-4 (2006-11-23)

dim() method for DiscreteMVDistribution
var() + E() overloaded for DExp-Class
sd()-method overwritten for Norm-Class to allow function / condition argument

distrEx 0.4-3 (2006-05-12)

Implementation of functionals: o evaluation of exact expressions of E (expectation functional) for most specific distributions from stats package o var, sd methods for UnivariateDistributions; these include calls like N <- Norm() var(N,function(t)abs(t)^(1/2)) # calculates Var[|N|^(1/2)] also (factorized) conditional variance is available o evaluation of exact expressions of var for most specific distributions from stats package o median, IQR, mad methods for UnivariateDistributions o for var, sd, median, IQR, mad: all functionality/arguments of stats methods is/are preserved and only if first argument / argument x is of class UnivariateDistribution (or descendant) a different method is applied
Internationalization: use of gettext, gettextf in output
C-interface .GLaw() to replace respective R-Code in distrExintegrate.R
PrognCondDistribution, PrognCondition are included as classes and generating functions (incl. show-method);
Inclusion of demos (see above) + PrognCondDistribution, PrognCondition are included as classes and generating functions (incl. show-method); + illustrateCLT is included and rd-file is done

distrEx 0.4-2 (2005-11-22)

ContaminationSize, HellingerDist, KolmogorovDist, TotalVarDist now return a list which consists of the corresponding distributions and their distance
minor changes in m1df and m2df to increase speed of computation
minor changes in DiscreteMVDistribution to increase speed of computation
introduction of a new parameter useApply in methods for function E with default value TRUE