apollo_emdc {apollo}R Documentation

MDC model with exogenous budget

Description

Calculates the likelihood function of the MDC model with exogenous budget. Can also predict and validate inputs.

Usage

apollo_emdc(emdc_settings, functionality = "estimate")

Arguments

emdc_settings

List of settings for the model. It includes the following.

  • continuousChoice: Named list of numeric vectors. Amount consumed of each inside good. Outside good must not be included. Can also be called "X".

  • budget: Optional numeric vector. Budget. Must be bigger that the expenditure on all inside goods. Can also be called "B".

  • avail: Named list of numeric vectors. Availability of each product. Can also be called "A".

  • utilityOutside: Numeric vector (or matrix or array). Shadow price of the budget. Must be normalised to 0 for at least one individual. Default is 0 for every observation. Can also be called "V0".

  • utilities: Named list of numeric vectors (or matrices or arrays). Base utility of each product. Can also be called "V".

  • gamma: Named list of numeric vectors. Satiation parameter of each product.

  • delta: Lower triangular numeric matrix, or list of lists. Complementarity/substitution parameter.

  • cost: Named list of numeric vectors. Price of each product.

  • sigma: Numeric vector or scalar. Standard deviation of the error term. Default is one.

  • nRep: Scalar positive integer. Number of repetitions used when prediction

  • tol: Positive scalar. Tolerance of the prediction algorithm.

  • timeLimit: Positive scalar. Maximum amount of seconds the optimiser can spend calculating a prediction before setting it to NA.

functionality

Character. Either "validate", "zero_LL", "estimate", "conditionals", "raw", "output" or "prediction"

Details

This model extends the traditional multiple discrete-continuous (MDC) framework by (i) making the marginal utility of the outside good deterministic, and (ii) including complementarity and substitution in the model formulation. See the following working paper for more details:

Palma, D. & Hess, S. (2022) Extending the Multiple Discrete Continuous (MDC) modelling framework to consider complementarity, substitution, and an unobserved budget. Transportation Reserarch 161B, 13 - 35. https://doi.org/10.1016/j.trb.2022.04.005

Value

The returned object depends on the value of argument functionality as follows.


[Package apollo version 0.3.3 Index]