apollo_fitsTest function

Compares log-likelihood of model across categories

Given the estimates of a model, it compares the log-likelihood at the observation level across categories of observations.

apollo_fitsTest(model, apollo_probabilities, apollo_inputs, fitsTest_settings)

Arguments

• 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 ‘"components"’ , ‘"conditionals"’ , ‘"estimate"’ (default), ‘"gradient"’ , ‘"output"’ , ‘"prediction"’ , ‘"preprocess"’ , ‘"raw"’ , ‘"report"’ , ‘"shares_LL"’ , ‘"validate"’ or ‘"zero_LL"’ .

• apollo_inputs: List grouping most common inputs. Created by function apollo_validateInputs .

• fitsTest_settings: List. Contains settings for this function. User input is required for all settings except those with a default or marked as optional.

  • 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).

Returns

Matrix with average log-likelihood at observation level per category (invisibly).

Details

Prints a table comparing the average log-likelihood at the observation level for each category.