bennet: Calculating the Bennet price and quantity indicators

In JacekBialek/PriceIndices: Calculating Bilateral and Multilateral Price Indexes

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.

Białek, J. (2024). The use of the Bennet indicators and their transitive versions for scanner data analysis. Statistics in Transition new series, 25(3), 155-173.

Examples

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

JacekBialek/PriceIndices documentation built on Jan. 27, 2025, 6:14 a.m.