ez (version 4.1-1)

ezMixedProgress: Retrieve information saved to file by a call to ezMixed

Description

When running ezMixed with a value supplied to the progress_dir argument, summary results are saved to file. ezMixedProgress retrieves those results, even from partial or discontinued runs.

Usage

ezMixedProgress(
    progress_dir
    , return_models = TRUE
)

Arguments

progress_dir

Character string specifying the name of the progress directory. (Should match the string supplied as the value to the progress_dir argument in the original call to ezMixed)

return_models

Logical. If TRUE, the returned list object will also include each lmer model (can become memory intensive for complex models and/or large data sets).

Value

• A list with the following elements:
• summary
  A data frame summarizing the results, including whether warnings or errors occurred during the assessment of each effect, raw natural-log likelihood of the unrestricted and restricted models (RLnLu and RLnLr, respectively), degrees of freedom of the unrestricted and restricted models (DFu and DFr, respectively), and log-base-10 likelihood ratios corrected via AIC and BIC (L10LRa and L10LRb, respectively)
• formulae
  A list of lists, each named for an effect and containing two elements named unrestricted and restricted, which in turn contain the right-hand-side formulae used to fit the unrestricted and restricted models, respectively.
• errors
  A list similar to formulae, but instead storing errors encountered in fitting each model.
• warnings
  A list similar to formulae, but instead storing warnings encountered in fitting each model.
• models
  (If requested by setting return_models=TRUE) A list similar to formulae but instead storing each fitted model.

See Also

ezMixed

Examples

#Read in the ANT data (see ?ANT).
data(ANT)
head(ANT)
ezPrecis(ANT)

#Run ezMixed on the accurate RT data
rt_mix = ezMixed(
    data = ANT[ANT$error==0,]
    , dv = .(rt)
    , random = .(subnum)
    , fixed = .(cue,flank,group)
    , progress_dir = 'rt_mix'
)

rt_mix = ezMixedProgress('rt_mix')
print(rt_mix$summary)