energybf: BF Energy Analysis

View source: R/coetest.R

energybfR Documentation

BF Energy Analysis

Description

This function calculates the Energy of the evidence over time and evaluates its likelihood.

Usage

energybf(data, sims.df = sims)

Arguments

data

A seqbf object or vector containing Bayes Factors.

sims.df

A dataframe containing simulations, including columns "simid" and "bf".

Details

The Energy contains all areas above BF=1 minus all areas below BF=1. A positive energy therefore indicates an overall orientation of the evidence towards H1 over data collection. Energy is calculated using the trapezoidal integration "trapz" of the pracma-library. Mean and SD scores of the simulations' energies are provided.

Value

A list containing the Energy of the experimental data, the mean and SD of the energy values of all simulations, and the proportion of simulations with a higher energy than the experimental data.

Examples

r.energybf <- energybf(seqbf, sims)
r.energybf <- energybf(tbl$bf, sims.df = newsims)

mrzdcmps/changeofevidence documentation built on Feb. 27, 2025, 3:10 a.m.