plotCIPearson: Function outputting a plot of confidence interval around a...

In cpsyctc/CECPfuns: Package of Utility Functions for Psychological Therapies, Mental Health and Well-being Work (Created by Chris Evans and Clara Paz)

Function outputting a plot of confidence interval around a correlation for a range of sample sizes

Description

Function outputting a plot of confidence interval around a correlation for a range of sample sizes

Usage

plotCIPearson(
  corr,
  minN,
  maxN,
  step = 1,
  conf = 0.95,
  minY = NULL,
  maxY = NULL
)

Arguments

corr	numeric: Pearson correlation
minN	numeric: the smallest n for which you want the CI
maxN	numeric: the largest n for which you want the CI
step	numeric: the step by which you want n to increment (default is 1), with minN and maxN should give no more than 200 values of n
conf	numeric: the confidence interval you want, defaults to .95
minY	numeric: if you want to set the y axis limits input a number greater than -1 here
maxY	numeric: if you want to set the y axis limits input a number smaller than 1 here

Value

a ggplot object so if you don't capture it it will plot to your default plot device

Background

This is another function like plotBinconf which plots the width of confidence intervals (CIs) for a range of sample/dataset sizes.

History/development log

Version 1: 5.iv.21 Version 2: 25.xi.23 Renamed to plotCIPearson to allow for addition of plotCISpearman soon.

Author(s)

Chris Evans

See Also

Other confidence interval functions: getCIPearson(), getCISpearman(), plotBinconf()

Other demonstration functions: plotBinconf()

Examples

## Not run: 
### simple example for observed 95% confidence interval (CI) around observed correlation of .7
### for sample sizes between 10 and 100
plotCIPearson(.7, 10, 100)

### similar but for dataset sizes between 10 and 500 by steps of 5
plotCIPearson(.7, 10, 500, 5)

### similar but asking for 99% CI
plotCIPearson(.7, 10, 500, 5, conf = .99)

### similar but setting lower y axis limit to -1
plotCIPearson(.7, 10, 500, 5, conf = .99, minY = -1)

### and you can set the upper y limit, observed R = 0 for a change
plotCIPearson(0, 10, 500, 5, conf = .99, minY = -1, maxY = 1)

### same but exporting to tmpPlot and then changing plot
plotCIPearson(0, 10, 500, 5, conf = .99, minY = -1, maxY = 1) -> tmpPlot
tmpPlot +
   ggtitle("95% CI around observed Pearson correlation of zero for n from 10 to 500") +
   theme_bw()


## End(Not run)

cpsyctc/CECPfuns documentation built on Nov. 16, 2024, 10:43 a.m.