Skip to content

njudd/ggrain

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

471 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

R-CMD-check Bugs CRAN/METACRAN Version

CRAN_Download_Badge total Vignette

ggrain is an R-package that allows you to create Raincloud plots - following the 'Grammar of Graphics' (i.e., ggplot2) - that are:

  • Highly customizable
  • Connect longitudinal observations
  • Handles Likert data
  • Allows mapping of a covariate.

Citation

ggrain was developed by Nicholas Judd, Jordy van Langen, Micah Allen, and Rogier Kievit.

- Judd, N., van Langen, J., Allen, M., & Kievit, R.A.
    ggrain: A Rainclouds Geom for 'ggplot2'.
    R package version 0.0.4.
    CRAN 2023, https://doi.org/10.32614/CRAN.package.ggrain,
    https://CRAN.R-project.org/package=ggrain

Example

ggplot(iris, aes(x = 1, y = Sepal.Length)) +
  geom_rain()

Installation

There are two ways to install this package.

  1. Download the CRAN version
install.packages("ggrain")

library(ggrain)
  1. Download through GitHub
if (!require(remotes)) {
    install.packages("remotes")
}
remotes::install_github('njudd/ggrain')

library(ggrain)

Simple examples

  1. Raincloud per group

    ggplot(iris, aes(x = Species, y = Sepal.Length, fill = 	Species)) +
    	geom_rain(rain.side = 'l')
  2. Different groups overlapped

    ggplot(iris, aes(x = 1, y = Sepal.Length, fill = Species)) +
    	geom_rain(alpha = .5)

img

Vignette

For a complete overview of ggrain such as a 2-by-2 raincloud plot or multiple repeated measures, please see our Vignette.

ggrain specific features

geom_rain is a combination of 4 different ggplot2 geom's (i.e., point, line, boxplot & violin).

  • id.long.var: a grouping variable to connect the lines by
  • cov: a covariate to remap the color of the points
  • Likert: True or False response which adds y jittering
  • rain.side: Which side to display the rainclouds: 'l' for left, 'r' for right and 'f' for flanking

Specific geom arguments can be passed with a list to any of the 4 geom's with the argument {point/line/boxplot/violin}.args. Position-related arguments (e.g., jittering, nudging & width) can be passed with {point/line/boxplot/violin}.args.pos, see the help file of ?geom_rain for defaults

img

Contributions / Issues

We warmly welcome all contributions. You can open an issue or make a pull request if you would like to add something new!

Scientific papers that used & cited 👏 ggrain

* Yulugkural, Z., Yildiz, M., Topcu, E., Elmaslar Mert, H. T., & Temiz, A. (2026). 
	Epigenetic Modulation of IL‐7 and IL‐10: Toward Personalized Immune Therapies in Viral Epidemics. 
	Journal of Immunology Research, 2026(1), 9467657.
	https://doi.org/10.1155/jimr/9467657
* Birdsey, L. P., Brown, S., Dos’ Santos, T., Evans, D., Runacres, A., Weston, M., & Field, A. (2026).
	National‐Standard Middle‐Distance Runners Maintain 1500 m Time Trial Running Performance on Successive Days. 
	European journal of sport science, 26(3), e70142.
	https://doi.org/10.1002/ejsc.70142
* Yin, C., Kindt, A., Harms, A., Hartman, R., Hankemeier, T., & De Lange, E. (2026). 
	Lipidomic fingerprints reveal sex-, age-, and disease-dependent differences in the TgF344-AD transgenic rats. 
	Metabolomics, 22(1), 9.
	https://doi.org/10.1007/s11306-025-02350-z
* Weston, K. L., Burn, N. L., Goroski, A., Weston, M., Galna, B., Glossop, R., ... & Basterfield, L. (2026). 
	Feasibility of a school-based peer-led high-intensity interval training intervention: the Young Fitness Leaders project. 
	BMC Public Health, 26, 799.
	10.1186/s12889-026-26543-w
* Pawel, S., & Held, L. (2026). 
	Bayes Factor Group Sequential Designs. 
	arXiv preprint arXiv:2601.02851.
	https://doi.org/10.48550/arXiv.2601.02851
* Dutschke, R., Thiele, G., Schoemann, M., Surrey, C., & Scherbaum, S. 
	Assessing complex belief structures with the triads task: Reliability and validity.
	OSF
	https://sciety.org/articles/activity/10.31234/osf.io/ubc85_v1
* Urry, H. L., Plonski, P. E., Patel, P., Cathern, M. D., Taylor, H. A., & Brunyé, T. T. (2026). 
	Urgent, hurry up!!! Perceived time pressure affects fine motor performance via subjective distress in US adults. 
	Journal of Experimental Psychology: Human Perception and Performance.
	https://doi.org/10.1037/xhp0001386
* Petit, Q., Lecoq, S., Congnard, F., Cronier, N., de MĂŒllenheim, P. Y., Abraham, P., & Noury‐Desvaux, B. (2026). 
	Heart rate increase results in case of positional venous entrapment. 
	Clinical Physiology and Functional Imaging, 46(1), e70041.
	https://doi.org/10.1111/cpf.70041
* Cruz, T. D. D., & de Lucena, M. A. (2026). 
	Training and oversight of algorithms in social decision-making: Algorithms with prescribed selfish defaults breed selfish decisions.
	Computers in Human Behavior, 108924.
	https://doi.org/10.1016/j.chb.2026.108924
* Selvakumar, J., Havdal, L. B., Brodwall, E. M., Sommen, S., Berven, L. L., Stiansen-Sonerud, T., ... & Wyller, V. B. B. (2025). 
	Risk factors for fatigue severity in the post-COVID-19 condition: A prospective controlled cohort study of nonhospitalised adolescents and young adults. 
	Brain, Behavior, & Immunity-Health, 44, 100967.
	https://doi.org/10.1016/j.bbih.2025.100967

* Garofalo, S., Finotti, G., Orsoni, M., Giovagnoli, S., & Benassi, M. (2024). 
	Testing Bayesian Informative Hypotheses in Five Steps With JASP and R.
	Advances in Methods and Practices in Psychological Science, 7(4), 25152459241260259.
	https://doi.org/10.1177/25152459241260259
* de MĂŒllenheim, P. Y. (2024). Analyser des donnĂ©es avec R.
	https://pydemull.github.io/Analyser-des-donnees-avec-R/Analyser-des-donn%C3%A9es-avec-R.pdf
* Robison, M. K., Celaya, X., Ball, B. H., & Brewer, G. A. (2024). 
    Task sequencing does not systematically affect the factor structure of cognitive abilities. 
    Psychonomic Bulletin & Review, 31(2), 670-685.
    https://doi.org/10.3758/s13423-023-02369-0
* Han, C., Danzeng, Q., Li, L., Bai, S., & Zheng, C. (2024). 
    Machine learning reveals PANoptosis as a potential reporter and 
    prognostic revealer of tumour microenvironment in lung adenocarcinoma. 
    The Journal of Gene Medicine, 26(1), e3599.
    https://doi.org/10.1002/jgm.3599
* Jiang, S., Shang, W. Z., Cui, J. Y., Yan, Y. Y., Yang, T., Hu, Y., ... & Wu, B. (2023). 
    Prevalence and Predictors of Hemorrhagic Foci on Long-term 
    Follow-up MRI of Recent Single Subcortical Infarcts. 
    Translational Stroke Research, 1-11.
    https://doi.org/10.1007/s12975-023-01224-7
* Senftleben, U., Schoemann, M., & Scherbaum, S. (2024). 
    Choice repetition bias in intertemporal choice: An eye-tracking study.
    OSF (Open Science Framework) / PsyArXiv.
    https://doi.org/10.31234/osf.io/g3v9m
* Bognar, M., Gyurkovics, M., Aczel, B., & van Steenbergen, H. (2023).
    The curve of control: Non-monotonic effects of task difficulty on cognitive control.
    PsyArXiv
    https://doi.org/10.31234/osf.io/ywup9

Funding

In 2021, NWO (Dutch research council) announced their inaugural NWO Open Science Fund. The Open Science Fund aims to support researchers to develop, test and implement innovative ways of making research open, accessible, transparent and reusable, covering the whole range of Open Science. The Raincloud plots team was awarded this fantastic initiative and is specifically working on:

You can read more about our awarded project here: https://www.nwo.nl/en/projects/203001011 or you can watch the online webinar hosted by NWO about our project: Webinar Open Science series S1E2: Open tools for data enrichment and visualization

Raincloud Plots

Paper

- Allen, M., Poggiali, D., Whitaker, K., Marshall, T. R., van Langen, J., & Kievit, R. A.
    Raincloud plots: a multi-platform tool for robust data visualization [version 2; peer review: 2 approved] 
    Wellcome Open Research 2021, 4:63. https://doi.org/10.12688/wellcomeopenres.15191.2

There are now 4 ways in which you can use our Raincloud Plots tools:

About

{package} Make beautiful Raincloud plots in R!

Topics

Resources

License

Unknown, MIT licenses found

Licenses found

Unknown
LICENSE
MIT
LICENSE.md

Stars

Watchers

Forks

Releases

No releases published

Packages