ez (version 4.3)

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

## Not run: 
# #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)
# ## End(Not run)