apollo_fitsTest: Compares log-likelihood of model across categories

View source: R/apollo_fitsTest.R

apollo_fitsTestR Documentation

Compares log-likelihood of model across categories

Description

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

Usage

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

Details

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

Value

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


apollo documentation built on Oct. 2, 2024, 1:08 a.m.