bennet: Calculating the Bennet price and quantity indicators

View source: R/f_bilateral_indicators.R

bennetR Documentation

Calculating the Bennet price and quantity indicators

Description

This function returns the Bennet price and quantity indicators and optionally also the price and quantity contributions of individual products.

Usage

bennet(
  data,
  start,
  end,
  interval = FALSE,
  matched = FALSE,
  contributions = FALSE,
  prec = 2
)

Arguments

data

The user's data frame with information about sold products. It must contain columns: time (as Date in format: year-month-day,e.g. '2020-12-01'), prices (as positive numeric) and prodID (as numeric, factor or character). A column quantities (as positive numeric) is also needed because this function uses unit values as monthly prices.

start

The base period (as character) limited to the year and month, e.g. "2020-03".

end

The research period (as character) limited to the year and month, e.g. "2020-04".

interval

A logical parameter indicating whether calculations are to be made for the whole time interval (TRUE) or no (FALSE).

matched

A logical parameter indicating whether the matched sample approach is to be used (if yes, the parameter has the value TRUE).

contributions

A logical parameter indicating whether contributions of individual products are to be displayed. If it is TRUE, then contributions are calculated for the the base period start and the current period end.

prec

A numeric vector indicating precision, i.e. the number of decimal places for presenting results.

Value

This function returns the Bennet price and quantity indicators and optionally also the price and quantity contributions of individual products.

References

Bennet, T. L., (1920). The Theory of Measurement of Changes in Cost of Living. Journal of the Royal Statistical Society, 83, 455-462.

Examples

bennet(milk, "2018-12", "2019-12", matched=TRUE, contributions=TRUE)
bennet(coffee, start="2018-12", end="2019-03", interval=TRUE)

PriceIndices documentation built on July 9, 2023, 6:20 p.m.