Skip to content

Between-Participants Designs

Latest
Compare
Choose a tag to compare
@hardmanko hardmanko released this 07 Oct 21:04
· 25 commits to master since this release

The main new feature added in this release is support for between-participants designs. See New Features below. Supporting between-participants designs ended up requiring a nearly complete rewrite of the R code (C++ code didn't change much), so I expect that some bugs have crept in. Please let me know about any bugs you find.

This release is likely to be the last release of this package with major new features. I will release bugfixes as I become aware of the bugs (send bug reports to me) and I may release some minor new features.

New Features

  • This release adds support for between-participants designs and mixed between/within designs.
    • See the new Between-Participants Designs section of the package manual for information on how to use the package with such designs.
    • There are also two new examples showing how to work with between-participants designs. The new examples are factorialMixedDesign and ubalancedFactorialMixedDesign.
    • The default priors introduced in version 0.7.5 are appropriate default priors for between-participants designs and were chosen with between-participants designs in mind.
  • Parameter estimation can now be interrupted without crashing R (you will still lose the partial results from the parameter estimation run). Interrupts are checked for every config$iterationsPerStatusUpdate iterations, so it the interruption may take some amount of time to happen once it has been requested.
  • The argument asPdf has been added to plotParameterSummary, which allows the plot to be made directly to a pdf. This helps with making the plot readable.

New functions

  • Some parameter plotting functions: plotParameter, plotParameterHistogram, and plotParameterLineChart.
  • combineGroupResults.BP is critical for between-participants designs. See the manual.
  • compareResults for comparing various elements of two within-participants results objects.
  • getAllParameterPosteriors, which is basically getParameterPosterior, but for all participants, conditions, and groups.
  • Some utility functions related to factors: normalizeFactors, removeConstantFactors, updateFactorsForConditionEffects, getFactorsForConditionEffect, getAllFactorNames, getFactorNameToType, getFactorTypeToName.
  • Other utility functions: getAllParams.

Renamed/Removed functions

These functions were either renamed or removed in this release, so if you used them, you will need to update your code.

Other functions were changed as well, but those changes were mostly adding function arguments with default values that result in the previous function behavior. I won't list those changes here as they are non-breaking changes, but know that there may be new functionality for existing functions.

  • plotPosteriorLineChart and plotFactorialPosteriorLineChart both replaced with plotParameterLineChart.
  • getTransformedParameters renamed to getSingleIterationParameters.
  • getEffectParameterPosteriors renamed to getMEIParameters.
  • Removed getFactorsLevelsFromConds, addFactorsToDataFrame. These functions were not intended to be available for use.