Packages and Functions for 'CourseKata' Courses
Overview
Easily install and load all packages and functions used in 'CourseKata' courses. Aid teaching with helper functions and augment generic functions to provide cohesion between the network of packages. Learn more about 'CourseKata' at https://www.coursekata.org.
Breaking changes
- coursekata now requires ggplot2 4.0.2 and ggformula 1.0.0 or later. The compatibility paths for the older graphics stack have been removed.
- Plot helpers now require
object =,show_cutoffs()requiresshow_labels =, andstat_cutoff()usespart =. The retiredplot,labels, andfuncarguments are no longer translated. Intentionalgf_*()aliases remain. - Line layers use
linewidthfor line width. A suppliedsizeis translated for compatibility, and an explicitlinewidthtakes precedence. Point, text, and annotation-marker sizes are unchanged.
Native ggplot2 layers
- Add
geom_model()andstat_model()for fitted and inferred models. The exportedGeomModelandStatModelextensions now also powergf_model().
Show all changes in 0.21.0Hide the rest of the changes in 0.21.0
- Add
geom_resid(),geom_square_resid(),geom_reduce(),geom_square_reduce(),stat_resid(), andstat_reduce(). The ggplot2 and ggformula interfaces share model planning, prediction, and drawing. Facets, omitted rows, inherited mappings, weights, orientation, and jitter now follow the same contract through either interface. - Add
geom_b()for annotating a ggplot2 model layer with its coefficients. It uses the same coefficient planning asgf_b()andgf_coef(). - Add
geom_squareplot()andstat_squareplot()for the countable squareplot drawn bygf_squareplot(). Counts, mappings, delayed aesthetics, coordinates, and layer data now pass through one ggplot2 lifecycle. - Add
stat_sd_ruler()beneathgf_sd_ruler(), and complete the distribution annotation surface withstat_dist_mean(),stat_cutoff(),geom_cutoff(),guide_cutoff(), and their exported ggplot2 extension classes. Native and formula interfaces now share their calculations andna.rm = FALSEdefault.
Plot annotations and themes
- Rebuild
show_dgp()with position guides. Population and estimate frames stay outside the data panel and remain aligned after scale, coordinate, zoom, and facet changes. show_cutoffs()preserves the numeric axis and draws scale-aligned triangles, leaders, and translucent callouts in the panel. Labels use compact lanes and reflow in narrow or flipped panels; leaders fall back to elbow connections when a direct route does not fit.- Coefficient labels avoid their arrows, segments, and b0 marks, including with transposed formulas, reversed scales, and flipped coordinates.
- Residuals stay aligned with jittered points across facets when jitter width or height uses its default. Seeded
position_jitter()is supported by the native layers while fitted endpoints and grand means remain fixed. - Discrete palette defaults use ggplot2 4 theme settings. Set
palette.colour.discreteandpalette.fill.discreteintheme(), or addscale_discrete_coursekata()when colour and fill should share one scale. Loading and unloading the CourseKata theme restores the caller's settings. - Model layers resolve ggplot2's themed defaults even when coursekata is used through namespace-qualified calls without attaching the package.
From NEWS.md in the release
Install
Health
- OK13 OKNow
- OK7 OK2026-08-23
- ERROR13 OK, 1 ERROR2026-04-07
- OK14 OK2026-03-10
Documentation
The repository also keeps web-only articles.
- Help pages
- 61 (2 internal)includes a package overview page
- Examples that run
- 100%29 run in a plain check
- Exported functions with examples
- 64%
- Documented parameters
- 77%
- Return-value docs
- 82%
- Help pages citing references
- 7%
Downloads
Repository
- PRs merged (all time)
- 80%
- Median days to close, 50 most recently updated closed issues
- 120
- Median days to close, 50 most recently updated closed PRs
- 0
Stars over time
Releases over time
Issues over time
PRs over time
Commits over time
Commit identities over time
13 development-tooling and community-health practices detected across 7 families in the upstream repository
Checks run against github.com/coursekata/coursekata-r on 2026-10-11.
The R CMD check workflow runs on Linux, macOS and Windows, and on R-devel
GitHub Pages site last deployed 2026-09-22 · The repository has a site deploy workflow
Show all practicesHide 3 practices
Dependencies
Installing coursekata adds 82 packages (37 with compiled code, 78 MB of source tarballs). Heaviest: stringi 11 MB, ggformula 6.0 MB, ggplot2 6.0 MB.
Code & Tests
Datasets
People & History
Pick two releases to compare their code metrics.
- 0.21.0Latest2026-09-21 · current release · diff ↗ ·
added 24 exports
GeomCutoff, GeomModel, GuideCutoff, GuideDgp, StatDistMean, StatModel, StatReduce, geom_b, geom_cutoff, geom_model, geom_reduce, geom_resid, geom_square_reduce, geom_square_resid, geom_squareplot, guide_cutoff, guide_dgp, stat_cutoff, stat_dist_mean, stat_model, stat_reduce, stat_resid, stat_sd_ruler, stat_squareplot - unarchivedReturned to CRAN2026-08-22
- 0.20.12026-08-22 · diff ↗ ·
removed 1 export
.conflicts.OKadded 14 exports
GeomResid, GeomSquareResid, GeomSquareplot, StatCutoff, StatResid, StatSdRuler, StatSquareplot, gf_b, gf_coef, gf_reduce, gf_square_reduce, gf_squareduce, show_dgp, show_mean - archivedRemoved from CRAN2026-05-11issues were not corrected despite reminders
- RR 4.6.0 released · 2026-04-24
- 0.19.22026-03-10 · diff ↗ ·
added 8 exports
.conflicts.OK, gf_resid_fun, gf_sd_ruler, gf_square_resid, gf_square_resid_fun, gf_squareplot, outer, show_cutoffs - 0.19.0
- RR 4.5.0 released · 2025-04-11
- 0.18.12024-12-12 · diff ↗
- 0.18.02024-08-16 · diff ↗
- unarchivedReturned to CRAN2024-05-26
- 0.17.02024-05-26 · diff ↗
- RR 4.4.0 released · 2024-04-24
- archivedRemoved from CRAN2024-01-13issues were not corrected in time
- 0.15.02023-12-14 · diff ↗
- 0.14.12023-10-27 · diff ↗
Show 2 earlier eventsHide 2 earlier events
- 0.14.02023-10-12
- RR 4.3.0 released · 2023-04-21
Package metadata
- First published
- 2023-10-12
- Total releases
- 10 / 3 yrs
- License
- GPL (>= 3) OSI · relicensed from AGPL (>= 3) in 0.20.1
- Minimum R
- ≥ 4.1
- Bundled data
- 31 KB / 14 files
- Download size
- 454 KB
Cite
Cite this package
Run in R for the authors' preferred citation:
citation("coursekata")This package has no citation file, so citation() returns this entry built from DESCRIPTION.
Cite the R Observatory
For a number measured here: a download total, a coverage figure, an archival date.
From data release v2026-10-18, which the citation names so these numbers can be found later. More on citing and the projects behind them.