geksl: Calculating the multilateral GEKS-L price index

View source: R/f_full_multilateral_indices.R

gekslR Documentation

Calculating the multilateral GEKS-L price index

Description

This function returns a value of the multilateral GEKS-L price index (to be more precise: the GEKS index based on the Laspeyres formula).

Usage

geksl(data, start, end, wstart = start, window = 13)

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), quantities (as positive numeric) and prodID (as numeric, factor or character).

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".

wstart

The beginning of the time interval (which is used by multilateral methods) limited to the year and month, e.g. "2020-01".

window

The length of the time window (as positive integer: typically multilateral methods are based on the 13-month time window).

Value

This function returns a value of the multilateral GEKS-L price index (to be more precise: the GEKS index based on the Laspeyres formula) which considers the time window defined by wstart and window parameters. It measures the price dynamics by comparing period end to period start (both start and end must be inside the considered time window). To get information about both price index values and corresponding dates, please see functions: price_indices or final_index. The function does not take into account aggregating over outlets or product subgroups (to consider these types of aggregating, please use the final_index function).

References

Gini, C. (1931). On the Circular Test of Index Numbers. Metron 9:9, 3-24.

Elteto, O., and Koves, P. (1964). On a Problem of Index Number Computation Relating to International Comparisons. Statisztikai Szemle 42, 507-518.

Szulc, B. (1983). Linking Price Index Numbers. In: Price Level Measurement, W. E. Diewert and C. Montmarquette (eds.), 537-566.

Białek, J. (2022). The general class of multilateral indices and its two special cases. Paper presented at the 17th Meeting of the Ottawa Group on Price Indices, Rome, Italy.

Białek, J. (2022). Improving quality of the scanner CPI: proposition of new multilateral methods, Quality & Quantity, https://doi.org/10.1007/s11135-022-01506-6.

Examples

geksl(milk, start="2019-01", end="2019-08",window=10)
geksl(milk, start="2018-12", end="2019-12")

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