ez: ezMixedProgress – R documentation

Become an expert in R — Interactive courses, Cheat Sheets, certificates and more!

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.

Author(s)

Michael A. Lawrence mike.lwrnc@gmail.com
Visit the ez development site at http://github.com/mike-lawrence/ez
for the bug/issue tracker and the link to the mailing list.

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)

ez

Easy Analysis and Visualization of Factorial Experiments

v4.4-0

GPL (>= 2)

Authors

Michael A. Lawrence <mike.lwrnc@gmail.com>

Initial release

2016-11-01