Averages individual-specific likelihood across inter-individual draws.
apollo_avgInterDraws(P, apollo_inputs, functionality)
Argument P
with (for most functionalities) the original contents averaged over inter-individual draws. Shape depends on argument functionality
.
"components"
: Returns P
without changes.
"conditionals"
: Returns P
without averaging across draws. Drops all components except "model"
.
"estimate"
: Returns P
containing the likelihood of the model averaged across inter-individual draws. Drops all components except "model"
.
"gradient"
: Returns P
containing the gradient of the likelihood averaged across inter-individual draws. Drops all components except "model"
.
"output"
: Returns P
containing the likelihood of all model components averaged across inter-individual draws.
"prediction"
: Returns P
containing the probabilities/likelihoods of all alternatives for all model components averaged across inter-individual draws.
"preprocess"
: Returns P
without changes.
"raw"
: Returns P
without changes.
"report"
: Returns P
without changes.
"shares_LL"
: Returns P
without changes.
"validate"
: Returns P
containing the likelihood of the model averaged across inter-individual draws. Drops all components except "model"
.
"zero_LL"
: Returns P
without changes.
List of vectors, matrices or 3-dim arrays. Likelihood of the model components.
List grouping most common inputs. Created by function apollo_validateInputs.
Character. Setting instructing Apollo what processing to apply to the likelihood function. This is in general controlled by the functions that call apollo_probabilities
, though the user can also call apollo_probabilities
manually with a given functionality for testing/debugging. Possible values are:
"components"
: For further processing/debugging, produces likelihood for each model component (if multiple components are present), at the level of individual draws and observations.
"conditionals"
: For conditionals, produces likelihood of the full model, at the level of individual inter-individual draws.
"estimate"
: For model estimation, produces likelihood of the full model, at the level of individual decision-makers, after averaging across draws.
"gradient"
: For model estimation, produces analytical gradients of the likelihood, where possible.
"output"
: Prepares output for post-estimation reporting.
"prediction"
: For model prediction, produces probabilities for individual alternatives and individual model components (if multiple components are present) at the level of an observation, after averaging across draws.
"preprocess"
: Prepares likelihood functions for use in estimation.
"raw"
: For debugging, produces probabilities of all alternatives and individual model components at the level of an observation, at the level of individual draws.
"report"
: Prepares output summarising model and choiceset structure.
"shares_LL"
: Produces overall model likelihood with constants only.
"validate"
: Validates model specification, produces likelihood of the full model, at the level of individual decision-makers, after averaging across draws.
"zero_LL"
: Produces overall model likelihood with all parameters at zero.