Visualizations of Distributions and Uncertainty
Overview
Provides primitives for visualizing distributions using 'ggplot2' that are particularly tuned for visualizing uncertainty in either a frequentist or Bayesian mode. Both analytical distributions (such as frequentist confidence distributions or Bayesian priors) and distributions represented as samples (such as bootstrap distributions or Bayesian posterior samples) are easily visualized. Visualization primitives include but are not limited to: points with multiple uncertainty intervals, eye plots (Spiegelhalter D., 1999) https://ideas.repec.org/a/bla/jorssa/v162y1999i1p45-58.html, density plots, gradient plots, dot plots (Wilkinson L., 1999) doi:10.1080/00031305.1999.10474474, quantile dot plots (Kay M., Kola T., Hullman J., Munson S., 2016) doi:10.1145/2858036.2858558, complementary cumulative distribution function barplots (Fernandes M., Walls L., Munson S., Hullman J., Kay M., 2018) doi:10.1145/3173574.3173718, and fit curves with multiple uncertainty ribbons.
Major changes:
- Require R > 4.0 due to several dependencies now requiring it.
- To complement the
subguides forgeom_slab(), there are nowsubscales, which can be used to adjust thelimitsor theexpandparameter of thethicknessper-geometry sub-scales (in much the same way those parameters can be set onscale_thickness_shared()) (#219). - Default subscales and subguides can be set by assigning
subscale_thickness,subguide_slab,subguide_dots, andsubguide_spikein the global environment (#225). - Allow use of square
shapes ingeom_blur_dots(). - More arguments to
stat_slabinterval()now usewaiver()s so that they can be set either in the call to the stat or in the call to the density estimator (#220).
Show all changes in 3.3.3Hide the rest of the changes in 3.3.3
- Bin edge openness can now be set via the
right_closedandoutermost_closedarguments todensity_histogram()(#238). - New helper functions
interval_widths()andpretty_widths()make it easier to create nicely-spaced sets of nested intervals.
Documentation:
- Almost all parameter documentation (except some inherited from other packages) now includes an annotation listing valid data types for that parameter (#243).
Bug fixes:
- Stats and geoms now pass down
check.aesandcheck.paramtolayer()so that aesthetics can be used to carry data to later stages of the pipeline without spurious warnings (#248). - Ensure
point_interval(<distribution>)supports tidy evaluation on the.pointand.intervalarguments (#221). point_interval(<tibble>)always returns atibble()(#224).
From NEWS.md in the release
Install
Health
- OK13 OK2026-08-05
- NOTE12 OK, 1 NOTE2026-08-01
- OK13 OK2026-06-09
- ERROR12 OK, 1 ERROR2026-06-08
- OK14 OK2026-04-22
Show 2 earlier changesHide 2 earlier changes
- ERROR13 OK, 1 ERROR2026-04-18
- OK14 OK2026-03-10
Documentation
- Help pages
- 74 (2 internal)includes a package overview page
- Examples that run
- 97%60 run in a plain check (3 of them under a condition) · 2 hold no code
- Exported functions with examples
- 86%
- Documented parameters
- 89%
- Return-value docs
- 90%
- Help pages citing references
- 19%
Downloads
Repository
- PRs merged (all time)
- 73%
- Median days to close, 50 most recently updated closed issues
- 15
- Median days to close, 50 most recently updated closed PRs
- 1
Stars over time
Forks over time
Releases over time
Issues over time
PRs over time
12 development-tooling and community-health practices detected across 7 families in the upstream repository
Checks run against github.com/mjskay/ggdist on 2026-10-22.
The R CMD check workflow runs on Linux, macOS and Windows, and on R-devel
GitHub Pages site last deployed 2025-11-06
pkgdown site last built 2025-10-05
Show all practicesHide 3 practices
Dependencies
Installing ggdist adds 27 packages (12 with compiled code, 17 MB of source tarballs). Heaviest: ggplot2 6.0 MB, Rcpp 1.8 MB, isoband 1.5 MB.
Show the 48 most downloaded packagesHide the 48 most downloaded packages
Code & Tests
Datasets
People & History
Pick two releases to compare their code metrics.
- RR 4.6.0 released · 2026-04-24
- 3.3.3Latest2025-04-23 · current release · diff ↗ ·
added 7 exports
interval_widths, pretty_widths, subguide_dots, subguide_slab, subguide_spike, subscale_identity, subscale_thickness - RR 4.5.0 released · 2025-04-11
- RR 4.4.0 released · 2024-04-24
- 3.3.22024-03-05 · diff ↗ ·
added 15 exports
GeomBlurDots, blur_gaussian, blur_interval, breaks_quantiles, geom_blur_dots, partial_colour_ramp, ramp_colours, stat_mcse_dots, subguide_axis, subguide_count, subguide_inside, subguide_integer, subguide_none, subguide_outside, waiver - 3.3.1
- 3.3.02023-05-13 · diff ↗ ·
removed 1 export
density_autoadded 22 exports
GeomSpike, StatSpike, align_boundary, align_center, align_none, bandwidth_SJ, bandwidth_bcv, bandwidth_dpi, bandwidth_nrd, bandwidth_nrd0, bandwidth_ucv, bounder_cdf, bounder_cooke, bounder_range, breaks_FD, breaks_Scott, breaks_Sturges, breaks_fixed, density_histogram, geom_spike, stat_spike, weighted_ecdf - RR 4.3.0 released · 2023-04-21
- 3.2.12023-01-18 · diff ↗ ·
added 19 exports
GeomSwarm, GeomWeave, Pr_, density_auto, density_bounded, density_unbounded, geom_swarm, geom_weave, p_, scale_side_mirrored, scale_slab_linewidth_continuous, scale_slab_linewidth_discrete, smooth_bar, smooth_bounded, smooth_discrete, smooth_none, smooth_unbounded, weighted_quantile, weighted_quantile_fun - 3.2.02022-07-19 · diff ↗ ·
added 4 exports
guide_rampbar, scale_thickness_identity, scale_thickness_shared, thickness - RR 4.2.0 released · 2022-04-22
- 3.1.12022-02-27 · diff ↗
- 3.1.02022-02-13 · diff ↗ ·
added 10 exports
AbstractStatSlabinterval, ll, mean_ll, mean_ul, median_ll, median_ul, mode_ll, mode_ul, stat_ribbon, ul - 3.0.12021-11-30 · diff ↗
- 3.0.02021-07-19 · diff ↗ ·
added 5 exports
PositionDodgejust, bin_dots, facet_title_horizontal, find_dotplot_binwidth, position_dodgejust - 2.4.12021-06-10 · diff ↗
Show 6 earlier eventsHide 6 earlier events
- RR 4.1.0 released · 2021-05-18
- 2.4.02021-01-04 · diff ↗ ·
added 7 exports
cut_cdf_qi, scale_color_ramp_continuous, scale_color_ramp_discrete, scale_colour_ramp_continuous, scale_colour_ramp_discrete, scale_fill_ramp_continuous, scale_fill_ramp_discrete - 2.3.0
- 2.2.02020-07-12 · diff ↗
- 2.1.12020-06-14
- RR 4.0.0 released · 2020-04-24
Package metadata
- First published
- 2020-06-14
- Total releases
- 15 / 6 yrs
- License
- GPL (>= 3) OSI
- Minimum R
- ≥ 4.0.0
- Bundled data
- 113 KB / 2 files
- Download size
- 1.7 MB
Cite
Cite this package
Run in R for the authors' preferred citation:
citation("ggdist")The package provides a citation file that builds its entry when R runs it. Run citation() to see it.
Cite the R Observatory
For a number measured here: a download total, a coverage figure, an archival date.
From data release v2026-10-24, which the citation names so these numbers can be found later. More on citing and the projects behind them.