Package: superb 1.0.1

superb: Summary Plots with Adjusted Error Bars

Computes standard error and confidence interval of various descriptive statistics under various designs and sampling schemes. The main function, superb(), return a plot. It can also be used to obtain a dataframe with the statistics and their precision intervals so that other plotting environments (e.g., Excel) can be used. See Cousineau and colleagues (2021) <doi:10.1177/25152459211035109> or Cousineau (2017) <doi:10.5709/acp-0214-z> for a review as well as Cousineau (2005) <doi:10.20982/tqmp.01.1.p042>, Morey (2008) <doi:10.20982/tqmp.04.2.p061>, Baguley (2012) <doi:10.3758/s13428-011-0123-7>, Cousineau & Laurencelle (2016) <doi:10.1037/met0000055>, Cousineau & O'Brien (2014) <doi:10.3758/s13428-013-0441-z>, Calderini & Harding <doi:10.20982/tqmp.15.1.p001> for specific references. The documentation is available at <https://dcousin3.github.io/superb/> .

Authors:Denis Cousineau [aut, cre], Bradley Harding [ctb], Marc-Andre Goulet [ctb], Jesika Walker [art, pre]

superb_1.0.1.tar.gz
superb_1.0.1.zip(r-4.7)superb_1.0.1.zip(r-4.6)superb_1.0.1.zip(r-4.5)
superb_1.0.1.tgz(r-4.6-any)superb_1.0.1.tgz(r-4.5-any)
superb_1.0.1.tar.gz(r-4.7-any)superb_1.0.1.tar.gz(r-4.6-any)
superb_1.0.1.tgz(r-4.6-emscripten)
manual.pdf |manual.html
DESCRIPTION |NEWS
card.svg |card.png
superb/json (API)

# Install 'superb' in R:
install.packages('superb', repos = c('https://dcousin3.r-universe.dev', 'https://cloud.r-project.org'))

Bug tracker:https://github.com/dcousin3/superb/issues

Pkgdown/docs site:https://dcousin3.github.io

Datasets:

On CRAN:

Conda:

error-barsplottingstatisticssummary-plotssummary-statisticsvisualization

8.80 score 18 stars 2 packages 154 scripts 596 downloads 97 exports 52 dependencies

Last updated from:229267eb18. Checks:9 OK. Indexed: yes.

TargetResultTimeFilesSyslog
linux-devel-x86_64OK259
source / vignettesOK363
linux-release-x86_64OK303
macos-release-arm64OK251
macos-oldrel-arm64OK178
windows-develOK141
windows-releaseOK196
windows-oldrelOK199
wasm-releaseOK156

Exports:biasCorrectionTransformbootstrapPI.gmeanbootstrapPI.hmeanbootstrapPI.meanbootstrapPI.medianbootstrapPI.sdbootstrapPI.varbootstrapSE.gmeanbootstrapSE.hmeanbootstrapSE.meanbootstrapSE.medianbootstrapSE.sdbootstrapSE.varCI.fisherkurtosisCI.fisherskewCI.gmeanCI.hmeanCI.IQRCI.MADCI.meanCI.meanNArmCI.medianCI.pearsonskewCI.sdCI.varCIwithDF.meanCousineauLaurencelleLambdacustomextentfisherkurtosisfisherskewgeom_flat_violingeom_superberrorbargmeanGRDhas.cbind.termshas.crange.termshas.nested.termshmeanHyunhFeldtEpsilonin.formulais.formulais.one.sidedMADmakeTransparentMauchlySphericityTestmeanNArmpearsonskewpoolSDTransformRexpressionrunDebugSE.fisherkurtosisSE.fisherskewSE.gmeanSE.hmeanSE.IQRSE.MADSE.meanSE.meanNArmSE.medianSE.pearsonskewSE.sdSE.varshowHorizontalSignificanceshowSignificanceshowVerticalSignificanceShroutFleissICC1ShroutFleissICC11ShroutFleissICC1kslopesub.formulassubjectCenteringTransformsuperbsuperbDatasuperbPlotsuperbPlot.barsuperbPlot.boxplotsuperbPlot.circularlinesuperbPlot.circularlineBandsuperbPlot.circularpointsuperbPlot.circularpointjittersuperbPlot.circularpointlinejittersuperbPlot.corsetsuperbPlot.halfwidthlinesuperbPlot.linesuperbPlot.lineBandsuperbPlot.pointsuperbPlot.pointindividuallinesuperbPlot.pointjittersuperbPlot.pointjitterviolinsuperbPlot.pointlinejittersuperbPlot.raincloudsuperbShinysuperbToWidetwoStepTransformWelchDegreeOfFreedomWinerCompoundSymmetryTest

Dependencies:base64encbslibcachemclicommonmarkcpp11digestfarverfastmapfontawesomeforeignfsggplot2gluegtablehtmltoolshttpuvisobandjquerylibjsonlitelabelinglaterlifecyclelsrmagrittrMASSmemoisemimeotelplyrpromisesR6rappdirsrbibutilsRColorBrewerRcppRdpackreshape2rlangrrapplyS7sassscalesshinyshinyBSsourcetoolsstringistringrvctrsviridisLitewithrxtable

Customizing superb plots
Figure 2 of Hofer, Langmann, Burkart and Neubauer, 2022. | Generating mock data | Making the top-row plot | Adding a color layer to the plot | Adding graphic directives for fine-tuning the plot | Making the second row of the figure | Combining and saving both plots | Figure 2 of Ma and Abrams, 2023. | References

Last update: 2025-12-03
Started: 2022-04-12

Plotting frequencies using superb
How to plot frequencies along with confidence intervals using superb | Why multiply the stand-alone CI length by 2? | One illustration | Define the confidence interval function | Make a count plot with confidence intervals | The benefit of the plot | Are we sure? | In summary | References

Last update: 2025-12-03
Started: 2022-12-19

Plotting proportions with superb
An example | The arcsine transformation | Defining the data | Defining the transformation in R | Reversing the transformation to see proportions. | Returning to the example | In summary | References

Last update: 2025-12-03
Started: 2021-07-20

Adding labels to superb plots
Adding labels to your superb plot | 1- the labels are actually summary statistics computed by superb | 2- the labels are other information not contained in the summary statistics. | In summary

Last update: 2025-08-02
Started: 2022-11-18

Plotting radar plots for illustrating profiles
An example. | Turning the plot into a radar plot | Interpreting the plot | Customizing the plot | Difference adjustments | Generating random data | In summary | References

Last update: 2025-08-02
Started: 2024-10-27

Three steps to make your plot
Data format | Step 1: Decide of the purpose of the plot | Step 2: Decide how to handle the within-subject measures | Step 3: Specify the sampling procedure and the population size | References

Last update: 2025-08-02
Started: 2021-03-06

Why use correlation-adjusted confidence intervals?
An example | A few words on the underlying theory (optional) | Centering the participants to better see the trend | What is the impact on confidence intervals? | Getting a plot | Making it simple | Refining the plots | Illustrating the various decorrelatin techniques. | Illustrating individual differences | In conclusion | References

Last update: 2025-08-02
Started: 2021-03-06

Why use difference-adjusted confidence intervals?
A paradoxical example | The origin of the paradox | Adjusting the error bars | Illustrating the impact of the adjustments | Two options | In conclusion | References

Last update: 2025-08-02
Started: 2021-03-06

Generating ready-to-analyze datasets with GRD
Simplest specification | Data from a design with between-subject factors and within-subject factors. | Deciding the sample sizes | Choosing the population distribution | Getting effects on one or some of the factors | Contaminate your samples! | In summary | References

Last update: 2025-01-24
Started: 2021-03-06

Unequal variances, Welch test, Tryon adjustment, and superb
A simple example | Averaging the error bars, sort of... | A real Welch test with your eyes | Averaging in the square sense, do you expect me to do that visually? | Finally, are the groups different or not? | In summary | References

Last update: 2025-01-24
Started: 2021-04-08

(advanced) Alternate ways to decorrelate repeated measures from transformations
In summary | References

Last update: 2025-01-17
Started: 2021-04-10

(advanced) Local decorrelation for time series
The structure of correlations | Implications for precision | How is correlation assessed then? | Illustration with fMRI data | A plot without decorrelation | Plots with decorrelation | The radius parameter | Difference adjustments | In summary | References

Last update: 2025-01-17
Started: 2024-05-06

(advanced) Non-factorial within-subject designs in superb
An example | Informing superb of a non-full factorial within-subject design | Returning to the example | In summary

Last update: 2025-01-17
Started: 2021-05-27

superb and SPSS
First option: Using R | Second option: Using SPSS | Third option: Using a graphical user interface | In summary | References

Last update: 2025-01-17
Started: 2021-10-19

Plotting Cohen's d with superb
What is the Cohen's $d_p$? | Plotting $d_1$ with its confidence interval | Checking the results | References

Last update: 2025-01-17
Started: 2021-04-29

Plotting Reference Intervals with superb
What is a reference interval? | Displaying a reference interval | Uncertainty in the reference interval limits | Is that it? | Reference intervals vs. confidence intervals of the means | In summary | References

Last update: 2025-01-17
Started: 2021-05-26

The making-of the figures in the article
Making Figure 1 | Making Figure 2 | Making Figure 3 | Making Figure 4 | References

Last update: 2025-01-17
Started: 2021-04-03

Using a custom statistic with its error bar within superb
Changing the summary function to be plotted | Determining that a summary function is valid to use in superbPlot | Creating a custom-made descriptive statistic function to be used in superbPlot

Last update: 2025-01-17
Started: 2021-03-06

Using a custom plot layout within superb
The built-in plot layouts | Illustrating some of the built-in layouts | Devising a custom-made plot layout | The simplest example | Optional arguments | Getting feedback information | An example | References

Last update: 2024-12-30
Started: 2021-03-06

Readme and manuals

Help Manual

Help pageTopics
bias-correction transformbiasCorrectionTransform
Bootstrapped measures of precisionbootstrapPI.gmean bootstrapPI.hmean bootstrapPI.mean bootstrapPI.median bootstrapPI.sd bootstrapPI.var bootstrapPrecisionMeasures bootstrapSE.gmean bootstrapSE.hmean bootstrapSE.mean bootstrapSE.median bootstrapSE.sd bootstrapSE.var
Cousineau-Laurencelle's lambda correction for cluster-randomized samplingCousineauLaurencelleLambda
Data for Figure 1dataFigure1
Data for Figure 2dataFigure2
Data for Figure 3dataFigure3
Data for Figure 4dataFigure4
geom_flat_violin for expanded density displaysgeom_flat_violin
geom_superberrorbar for expanded error bar displaysgeom_superberrorbar
Generate random dataGRD
Hyunh and Feldt's epsilon measure of sphericityHyunhFeldtEpsilon
logical functions for formulashas.cbind.terms has.crange.terms has.nested.terms in.formula is.formula is.one.sided sub.formulas
makes ggplots with transparent elementsmakeTransparent
Mauchly's test of SphericityMauchlySphericityTest
Measures with missing dataCI.meanNArm meanNArm meanNArm, measuresWithMissingData SE.meanNArm
pooled standard deviation transformpoolSDTransform
Precision measuresCI.fisherkurtosis CI.fisherskew CI.gmean CI.hmean CI.IQR CI.MAD CI.mean CI.median CI.pearsonskew CI.sd CI.var precisionMeasures SE.fisherkurtosis SE.fisherskew SE.gmean SE.hmean SE.IQR SE.MAD SE.mean SE.median SE.pearsonskew SE.sd SE.var
Confidence intervals with custom degree of freedomCIwithDF.mean precisionMeasureWithCustomDF
runDebugrunDebug
Annotate significance of results on plotsshowHorizontalSignificance showSignificance showVerticalSignificance
Shrout and Fleiss intra-class correlation functionsShroutFleissICC1 ShroutFleissICC11 ShroutFleissICC1k
Effect descriptioncustom extent Rexpression slope
subject-centering transformsubjectCenteringTransform
Additional summary statisticsfisherkurtosis fisherskew gmean hmean MAD pearsonskew summaryStatistics
superbsuperb
Obtain summary statistics with correct error bars.superbData
summary plot of any statistics with adjusted error bars.superbPlot
superbPlot 'bar' layoutsuperbPlot.bar
superbPlot 'boxplot' layoutsuperbPlot.boxplot
superbPlot 'circularline' layoutsuperbPlot.circularline
superbPlot 'circularlineBand' layoutsuperbPlot.circularlineBand
superbPlot 'circularpoint' layoutsuperbPlot.circularpoint
superbPlot 'circularpointjitter' layoutsuperbPlot.circularpointjitter
superbPlot 'circularpointlinejitter' layoutsuperbPlot.circularpointlinejitter
superbPlot 'corset' layoutsuperbPlot.corset
superbPlot 'halfwidthline' layoutsuperbPlot.halfwidthline
superbPlot 'line' layoutsuperbPlot.line
superbPlot 'lineBand' layoutsuperbPlot.lineBand
superbPlot 'point' layoutsuperbPlot.point
superbPlot point and individual-line layout for within-subject designsuperbPlot.pointindividualline
superbPlot point-and-jitter dots layoutsuperbPlot.pointjitter
superbPlot point, jitter and violin plot layoutsuperbPlot.pointjitterviolin
superbPlot point-and-jitter lines layoutsuperbPlot.pointlinejitter
superbPlot 'raincloud' layoutsuperbPlot.raincloud
User Interface to get summary plot of any statistics with adjusted error bars.superbShiny
superbToWide: Reshape long data frame to wide, suitable for superbPlotsuperbToWide
Data of Tulving, Mandler, & Baumal, 1964 (reproduction of 2021)TMB1964r
two-step transform for subject centering and bias correctiontwoStepTransform
Welch's rectified degree of freedomWelchDegreeOfFreedom
Winer's test of compound symmetryWinerCompoundSymmetryTest