apollo_sharesTest: Compares predicted and observed shares
In byu-transpolab/apollo-byu: Tools for Choice Model Estimation and Application

Description Usage Arguments Details Value

Prints tables comparing the shares predicted by the model with the shares observed in the data.

apollo_sharesTest(
  model,
  apollo_probabilities,
  apollo_inputs,
  sharesTest_settings
)

`model`	Model object. Estimated model object as returned by function apollo_estimate.
`apollo_probabilities`	Function. Returns probabilities of the model to be estimated. Must receive three arguments: `apollo_beta`: Named numeric vector. Names and values of model parameters. `apollo_inputs`: List containing options of the model. See apollo_validateInputs. `functionality`: Character. Can be either "estimate" (default), "prediction", "validate", "conditionals", "zero_LL", or "raw".
`apollo_inputs`	List grouping most common inputs. Created by function apollo_validateInputs.
`sharesTest_settings`	List of arguments. It must include the following. `alternatives`: Named numeric vector. Names of alternatives and their corresponding value in `choiceVar`. `choiceVar`: Numeric vector. Contains choices for all observations. It will usually be a column from the database. Values are defined in `alternatives`. `subsamples`: Named list of boolean vectors. Each element of the list defines whether a given observation belongs to a given subsample (e.g. by sociodemographics). `modelComponent`: Name of model component. Set to model by default. `newAlts`: Optional list describing the new alternatives to be used by apollo_sharesTest. This should have as many elements as new alternatives, with each entry being a matrix of 0-1 entries, with one row per observation, and one column per alternative used in the model. `newAltsOnly`: Boolean. If TRUE, results will only be printed for the 'new' alternatives defined in newAlts, not the original alternatives used in the model. Set to FALSE by default.

This is an auxiliary function to help guide the definition of utility functions in a choice model. By comparing the predicted and observed shares of alternatives for different categories of the data, it is possible to identify what additional explanatory variables could improve the fit of the model.

Nothing

byu-transpolab/apollo-byu documentation built on Dec. 19, 2021, 12:49 p.m.