chgeary_khamis {PriceIndices}

Calculating the monthly chained Geary-Khamis price index

Description

This function returns a value (or vector of values) of the monthly chained Geary-Khamis price index.

Usage

chgeary_khamis(data, start, end, interval = FALSE)

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

interval

A logical value indicating whether the function is to compare the research period defined by end to the base period defined by start (then interval is set to FALSE) or all fixed base indices are to be calculated. In this latter case, all months from the time interval <start,end> are considered and start defines the base period (interval is set to TRUE).

Value

The function returns a value (or vector of values) of the monthly chained Geary-Khamis price index depending on the interval parameter (please use gk function to calculate the multilateral Geary-Khamis price index). If the interval parameter is set to TRUE, the function returns a vector of price index values without dates. 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 (see the final_index function).

References

Geary, R. G. (1958). A Note on Comparisons of Exchange Rates and Purchasing Power between Countries. Journal of the Royal Statistical Society, Series A, 121, 97-99.

Khamis, S. H. (1970). Properties and Conditions for the Existence of a new Type of Index Number. Sankhya Series B32, 81-98.

(2004). Consumer Price Index Manual. Theory and practice. ILO/IMF/OECD/UNECE/Eurostat/The World Bank, International Labour Office (ILO), Geneva.

Von der Lippe, P. (2007). Index Theory and Price Statistics. Peter Lang: Berlin, Germany.

Examples

chgeary_khamis(sugar, start="2018-12", end="2019-04")
chgeary_khamis(milk, start="2018-12", end="2020-01", interval=TRUE)