The hardware and bandwidth for this mirror is donated by dogado GmbH, the Webhosting and Full Service-Cloud Provider. Check out our Wordpress Tutorial.
If you wish to report a bug, or if you are interested in having us mirror your free-software or open-source project, please feel free to contact us at mirror[@]dogado.de.
depictr provides exploratory plots, estimation plots and a
descriptive table. The plots share the package theme and palette. An
argument that names one column, such as x, y
or group, takes it quoted or unquoted. One that names
several, such as cols, takes a character vector, and
summary_table() takes its vars and
group as strings. The examples use the bundled
lexical_decision, wellbeing_survey and
crop_yield datasets. A closing section shows how to
customise any of these plots with ordinary ggplot2 code.
explore_distribution() plots a numeric variable and
explore_categorical() a categorical one. A unimodal density
leaves its upper corners empty, so legend_inside = TRUE
moves the colour legend from the right-hand margin into the top-right
corner. Several plots take this argument, and it is off by default
because the empty corner depends on the data.
explore_distribution(lexical_decision, RT, group = condition, type = "density",
legend_inside = TRUE)An overlay gets crowded once there are several groups, so
facet = TRUE gives each group its own panel:
explore_distribution(wellbeing_survey, life_satisfaction, group = region,
type = "both", facet = TRUE)ecdf_plot() is a bin-free alternative. The empirical
cumulative distribution lets you read medians and quantiles off the
curve and makes a shift between groups obvious. Here the related
condition is faster throughout.
ecdf_plot(lexical_decision, RT, group = condition,
reference_quantiles = c(0.25, 0.5, 0.75), legend_inside = TRUE)explore_categorical(wellbeing_survey, education, group = region,
proportion = TRUE, position = "dodge")explore_bivariate() chooses the plot from the variable
types: a scatter plot for two numeric variables, box plots for a numeric
variable against a categorical one, and a filled bar chart for two
categorical variables.
For a focused scatter with a fitted trend, use
scatter_trend(). The data-generating process of
crop_yield contains a fertiliser-by-treatment interaction,
visible here as two diverging slopes.
explore_pairs() is a scatter-plot matrix, and
correlation_heatmap() condenses the same information into a
single coloured grid.
reorder = TRUE orders the variables by hierarchical
clustering, so blocks of mutually correlated variables sit together:
raincloud_plot() shows the density, the box summary and
the raw points together. group_comparison_plot() draws the
group means with confidence intervals over the raw data. Because it
shows each estimate with its uncertainty, it conveys more faithfully
than a bar chart whether the groups differ.
To compare the shape of a distribution across several groups
at once, ridgeline_plot() stacks one partially overlapping
density per group:
An estimation plot puts the effect size and its uncertainty
at the centre of the comparison. estimation_plot() draws a
Cumming estimation plot, with the raw data and group means on top.
Beneath them, each group’s difference from the reference group is drawn
with a bootstrap confidence interval, in that group’s column. Each
difference is annotated with a standardised effect size (Hedges’
g by default).
set.seed(1)
estimation_plot(lexical_decision, RT, condition,
title = "RT difference: unrelated vs. related priming")group_comparison_plot(differences = TRUE) turns the
group-means plot into an estimation plot by appending the difference
panel. With more than two groups, every other group is compared against
a chosen reference.
set.seed(1)
group_comparison_plot(crop_yield, yield, treatment, differences = TRUE,
title = "Yield difference: enhanced vs. standard")dumbbell_plot() compares one value between two groups
across a set of categories. A segment joins the two group values in each
category and shows the size and direction of the gap. Here the plot
contrasts younger and older respondents’ life satisfaction by
region.
wb <- wellbeing_survey
wb$age_group <- ifelse(wb$age < median(wb$age), "younger", "older")
dumbbell_plot(wb, region, life_satisfaction, age_group, legend_inside = TRUE)outlier_plot() draws the distribution as a box or violin
plot and highlights the points beyond the 1.5 * IQR fences. Use it to
check for unusual values before modelling.
wellbeing_survey has informative missingness,
with income missing more often at higher stress, so its missingness map
is worth checking before modelling.
summary_table() builds a ‘Table 1’: mean (SD) for
numeric variables, counts and percentages for categorical ones,
optionally by group. The first row always reports the sample size
(N), and any variable with missing values gets a
Missing, n (%) row. The wellbeing_survey table
below shows both. summary_table() returns a plain data
frame, ready for knitr::kable().
tab <- summary_table(
wellbeing_survey,
vars = c("life_satisfaction", "income", "stress", "education"),
group = "region"
)
knitr::kable(tab)| variable | statistic | Overall | East | North | South | West |
|---|---|---|---|---|---|---|
| N | 300 | 69 | 82 | 67 | 82 | |
| life_satisfaction | Mean (SD) | 4.3 (1.1) | 4.7 (0.9) | 4.8 (1.0) | 3.6 (1.0) | 4.1 (1.0) |
| Missing, n (%) | 7 (2%) | 1 (1%) | 3 (4%) | 1 (1%) | 2 (2%) | |
| income | Mean (SD) | 31343.7 (14099.0) | 32410.2 (13381.5) | 36070.5 (15999.9) | 25508.6 (11332.3) | 30094.6 (12902.8) |
| Missing, n (%) | 23 (8%) | 6 (9%) | 4 (5%) | 9 (13%) | 4 (5%) | |
| stress | Mean (SD) | 4.1 (1.4) | 3.7 (1.2) | 3.4 (1.5) | 5.0 (1.1) | 4.3 (1.3) |
| education | secondary | 140 (47%) | 31 (45%) | 37 (45%) | 33 (49%) | 39 (48%) |
| undergraduate | 113 (38%) | 28 (41%) | 29 (35%) | 22 (33%) | 34 (41%) | |
| postgraduate | 47 (16%) | 10 (14%) | 16 (20%) | 12 (18%) | 9 (11%) |
Every depictr plotting function returns a plain ggplot2
object, or a patchwork for a composite figure, so you can
keep adding layers, scales, labels and theme tweaks with the usual
+:
library(ggplot2)
scatter_trend(crop_yield, fertiliser, yield, group = treatment) +
labs(title = "Yield rises with fertiliser",
subtitle = "More steeply under the enhanced treatment") +
theme(legend.position = "bottom")depictr centres a legend title over its keys by default. When the
level names are self-explanatory, drop the title by setting it to
NULL. Reversing a discrete colour legend at the same time
makes it read top-to-bottom in the order the curves are stacked:
ecdf_plot(lexical_decision, RT, group = condition) +
labs(colour = NULL) +
guides(colour = guide_legend(reverse = TRUE))Several plots take legend_inside = TRUE to place the
legend in a corner they usually leave empty (see
e.g. ?ecdf_plot). For any other plot, one
theme() call does the same. A dodged bar chart, for
instance, leaves the top-right clear when the right-most category is
short, so the legend fits there. We drop the title too, as the region
names are self-explanatory, and use element_blank() because
this plot sets the legend name on its fill scale:
explore_categorical(wellbeing_survey, education, group = region,
proportion = TRUE, position = "dodge") +
theme(legend.position = "inside",
legend.position.inside = c(0.98, 0.98),
legend.justification = c(1, 1),
legend.title = element_blank())Many functions also have layout controls of their own.
explore_distribution(facet = TRUE) and
ridgeline_plot() separate groups,
correlation_heatmap(reorder = TRUE) clusters variables, and
the model-estimate plots take facet to keep coefficients on
very different scales legible. coefficient_plot() also
takes standardise to the same end (see
vignette("model-estimates")).
These binaries (installable software) and packages are in development.
They may not be fully stable and should be used with caution. We make no claims about them.
Health stats visible at Monitor.