Learn R Programming

MCI (version 1.2.0)

shares.total: Total market shares/market areas

Description

This function calculates the total sales and market shares (or total market area) of the suppliers based on a given interaction matrix which already contains (local) market shares.

Usage

shares.total(mcidataset, submarkets, suppliers, shares, localmarket, plotChart = FALSE, plotChart.title = "Total sales", plotChart.unit = "sales", check_df = TRUE)

Arguments

mcidataset
an interaction matrix which is a data.frame containing the submarkets, suppliers, the market shares and a variable for the local market potential (e.g. purchasing power, number of customers, population or another type of demand)
submarkets
the column in the interaction matrix mcidataset containing the submarkets
suppliers
the column in the interaction matrix mcidataset containing the suppliers
shares
the column in the interaction matrix mcidataset containing the the (local) market shares
localmarket
the column in the interaction matrix mcidataset containing the local market potential
plotChart
logical argument that indicates if the total values shall be visualized in a bar plot (default: plotChart = FALSE)
plotChart.title
If plotChart = TRUE: Title of the plot
plotChart.unit
If plotChart = TRUE: Unit of the plotted total values (e.g. a currency), used as plot subtitle
check_df
logical argument that indicates if the input (dataset, column names) is checked (default: check_df = TRUE (should not be changed, only for internal use))

Value

Returns a new data.frame with the total sales (sum_E_j) and the over-all market shares of the $j$ suppliers (share_j).

Details

In the MCI model the dependent variable is the market share of the $j$ suppliers in the $i$ submarkets ($p_{ij}$), in which the shares are logically consistent (that means: 0 < $p_{ij}$ < 1, $\sum_{j=1}^n{p_{ij} = 1}$). If the shares are estimated, it is possible to link them to a (local) market potential to estimate the total sales and shares of the given suppliers. In this function, the input dataset, an interaction matrix with (local) market shares, is used for the calculation of total sales (or total number of customers) and total market shares of all $j$ regarded suppliers. Optionally, the function also returns a simple bar plot of the total values.

References

Huff, D. L./McCallum, D. (2008): “Calibrating the Huff Model Using ArcGIS Business Analyst”. ESRI White Paper, September 2008. https://www.esri.com/library/whitepapers/pdfs/calibrating-huff-model.pdf

Nakanishi, M./Cooper, L. G. (1974): “Parameter Estimation for a Multiplicative Competitive Interaction Model - Least Squares Approach”. In: Journal of Marketing Research, 11, 3, p. 303-311.

Nakanishi, M./Cooper, L. G. (1982): “Simplified Estimation Procedures for MCI Models”. In: Marketing Science, 1, 3, p. 314-322.

Wieland, T. (2015): “Raeumliches Einkaufsverhalten und Standortpolitik im Einzelhandel unter Beruecksichtigung von Agglomerationseffekten. Theoretische Erklaerungsansaetze, modellanalytische Zugaenge und eine empirisch-oekonometrische Marktgebietsanalyse anhand eines Fallbeispiels aus dem laendlichen Raum Ostwestfalens/Suedniedersachsens”. Geographische Handelsforschung, 23. 289 pages. Mannheim : MetaGIS.

See Also

mci.fit, mci.transmat, mci.transvar, mci.shares

Examples

Run this code
data(Freiburg1)
data(Freiburg2)
# Loads the data

mynewmatrix <- mci.shares(Freiburg1, "district", "store", "salesarea", 1, "distance", -2)
# Calculating shares based on two attractivity/utility variables

mynewmatrix_alldata <- merge(mynewmatrix, Freiburg2)
# Merge interaction matrix with district data (purchasing power)

shares.total (mynewmatrix_alldata, "district", "store", "p_ij", "ppower")
# Calculation of total sales 

Run the code above in your browser using DataLab