addFrequency: Pool absolute frequencies

In DistributionalDDA: Distributional Data Analysis in Bayes Spaces

Pool absolute frequencies

Description

Sum together the absolute frequencies of two representations with this information

Usage

addFrequency(x, y, ...)

## S3 method for class 'BDataFrequencyHistograms'
addFrequency.BDataFrequencyHistograms(x, y, ...)

## S3 method for class 'BDataUnivariateSamples'
addFrequency.BDataUnivariateSamples(x, y, ...)

## S3 method for class 'BDataUnivariateSamples'
addFrequency.BDataFrequencyHistograms(
  x,
  y,
  .baseSpaceBasis = getBayesSpaceBasis(x),
  ...
)

## S3 method for class 'BDataFrequencyHistograms'
addFrequency.BDataUnivariateSamples(
  x,
  y,
  .baseSpaceBasis = getBayesSpaceBasis(x),
  ...
)

Arguments

x	a compatible BData representation
y	another compatible BData representation
...	additional arguments (mostly internal)
.baseSpaceBasis	which base space basis to use, defaults to the one specified by the first argument 'x'

Value

An object of the least informative kind from the two pooled together, which contains the added absolute frequencies of both input objects. The Bayes Space basis is controlled by the first argument.

Functions

• addFrequency.BDataFrequencyHistograms(BDataFrequencyHistograms): method for two "BDataFrequencyHistograms" object. Returns a "BDataFrequencyHistograms" where the frequencies are summed (if breaks are equivalent), or where they are distributed uniformly along the interval bins and rebinned by summing with a break set resulting from the combination of both input bin sets.

• addFrequency.BDataUnivariateSamples(BDataUnivariateSamples): method for two "BDataUnivariateSamples" object. Returns a "BDataUnivariateSamples" where the observations are pooled together (in the order they are given), pair by pair. It can recycle a "BDataUnivariateSamples" of one single population with a multi-population "BDataUnivariateSamples", but will not work with any other combination of "BDataUnivariateSamples" of different lengths.

• addFrequency.BDataFrequencyHistograms(BDataUnivariateSamples): method for a "BDataFrequencyHistograms" and a "BDataUnivariateSamples" objects; classifies the data sets from "BDataUnivariateSamples" into the bins of "BDataFrequencyHistograms". As with other methods of this function, it only works for 'x' and 'y' of the same length, or else either 'x' or 'y' must have length 1.

• addFrequency.BDataUnivariateSamples(BDataFrequencyHistograms): method for a "BDataUnivariateSamples" and a "BDataFrequencyHistograms" objects; same as in the reverse order

Examples

xh = lapply(rep(1000,4), runif) |> as.BDataFrequencyHistograms(basis=B2Unif01Basis5)
yh = lapply(rep(1000,4), runif) |> as.BDataFrequencyHistograms(basis=B2Unif01Basis5)
addFrequency(xh,yh)
xh1 = list(runif(300)) |> as.BDataFrequencyHistograms(basis=B2Unif01Basis5)
addFrequency(xh,xh1)
xh1 = list(runif(300)) |> as.BDataFrequencyHistograms(basis=B2Unif01Basis5, breaks=c(0:4)/4)
addFrequency(xh,xh1)
xs = lapply(rep(200,4), runif) |> BDataSamples(B2Unif01Basis5)
ys = lapply(rep(10,4), runif) |> BDataSamples(B2Unif01Basis5)
addFrequency(xs,ys) |> summary()
x1 = BDataSamples(list(runif(100)), B2Unif01Basis5)
addFrequency(xs, x1)  |> summary()
xs = lapply(rep(200,4), runif) |> BDataSamples(B2Unif01Basis5)
yh = lapply(rep(1000,4), runif) |> as.BDataFrequencyHistograms(basis=B2Unif01Basis5)
addFrequency(xs,yh)

DistributionalDDA documentation built on Oct. 20, 2026, 5:06 p.m.