Package: ggchangepoint 0.4.0

ggchangepoint: Combines Changepoint Analysis with 'ggplot2'

A unified, tidy, 'ggplot2'-native interface to changepoint detection in R. Provides the 'ggcpt' S3 result class with 'broom'-style tidy/glance/augment methods, 'autoplot()' (with confidence intervals, fitted signals, and multivariate facets), composable geoms ('geom_changepoint()', 'geom_cpt_segment()', 'geom_cpt_ci()', 'stat_changepoint()'), and a 'cpt_detect()' dispatcher covering over thirty methods with introspection via 'cpt_methods()': penalised/optimal partitioning (PELT, BinSeg, SegNeigh, AMOC, FPOP, CROPS penalty paths, 'fastcpd', change-in-slope via 'cpop'), multiscale and search methods (WBS, WBS2, NOT, MOSUM, Isolate-Detect, TGUH, SMUCE/HSMUCE with confidence intervals), nonparametric and kernel methods ('changepoint.np', 'ecp', 'kcpRS', 'CptNonPar', sequential 'cpm', self-normalisation via 'SNSeg'), Bayesian methods ('bcp', online 'ocp', 'Rbeast'), high-dimensional and multivariate methods ('InspectChangepoint', 'ocd', 'changepoint.geo'), regression breaks ('strucchange', 'segmented', 'EnvCpt'), and robust detection under drift and autocorrelation ('DeCAFS'). Also includes method comparison, batch/panel detection, bootstrap stability diagnostics, accuracy metrics, Bayesian posterior and run-length plots, interactive rendering, data simulation with canonical test signals, and per-method citations.

Authors:Youzhi Yu [aut, cre]

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

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

Bug tracker:https://github.com/pursuitofdatascience/ggchangepoint/issues

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

On CRAN:

Conda:

changepointchangepoint-detectiondatavizggplot2

5.39 score 3 stars 18 scripts 441 downloads 63 exports 33 dependencies

Last updated from:bcf54c4293. Checks:9 OK. Indexed: yes.

TargetResultTimeFilesSyslog
linux-devel-x86_64OK774
source / vignettesOK369
linux-release-x86_64OK457
macos-release-arm64OK198
macos-oldrel-arm64OK202
windows-develOK266
windows-releaseOK231
windows-oldrelOK278
wasm-releaseOK188

Exports:annotate_segmentsas_tibbleaugmentautoplotbcp_wrapperbeast_wrapperbocpd_wrappercpm_wrappercpop_wrappercpt_batchcpt_citecpt_cropscpt_detectcpt_methodscpt_metricscpt_metrics_annotatedcpt_penaltycpt_simulatecpt_stabilitycpt_wrapperdecafs_wrapperecp_wrapperenvcpt_wrapperfastcpd_wrapperfpop_wrappergeom_changepointgeom_cpt_cigeom_cpt_segmentgeomcp_wrapperggcpt_compareggcpt_compare_tableggcpt_evalggcpt_interactiveggcpt_posteriorggcpt_runlengthggcptplotggecpplotglanceidetect_wrapperinspect_wrapperis_ggcptkcp_wrappermosum_wrappernew_ggcptnot_wrappernpmojo_wrapperocd_wrapperrcptsegmented_wrappersignal_blockssignal_fmssignal_mixsignal_stairssignal_teethsmuce_wrappersn_wrapperstat_changepointstrucchange_wrappertguh_wrappertheme_ggcpttidywbs_wrapperwbs2_wrapper

Dependencies:changepointchangepoint.npclicpp11dplyrecpfarvergenericsggplot2gluegtableisobandlabelinglatticelifecyclemagrittrpillarpkgconfigR6rbibutilsRColorBrewerRcppRdpackrlangS7scalestibbletidyselectutf8vctrsviridisLitewithrzoo

The ggchangepoint Feature Tour: A Complete Map of the Package Surface
Abstract | The result object and its methods | Unified detection | Engine wrappers | The classical wave | The 0.4.0 wave | The penalty path | The visualization layer | Comparing methods | Batch detection and stability | Evaluation against ground truth | Simulation and canonical signals | Citing the methodology | Closing note | References

Last update: 2026-07-02
Started: 2026-06-25

Comparing and Evaluating Changepoint Methods with ggchangepoint
Abstract | Introduction | Problem setup | Visual comparison | Accuracy metrics | Multi-annotator evaluation | Visual evaluation | Uncertainty beyond point sets | Engine-native confidence intervals | Bootstrap stability | Penalty-path sensitivity: CROPS | A benchmarking workflow | Discussion | References

Last update: 2026-07-02
Started: 2026-06-20

ggchangepoint: A Unified Tidy Interface for Changepoint Analysis in R
Abstract | Introduction | The changepoint problem | Penalised cost minimisation | Search-based and multiscale methods | Beyond the mean | Design of the package | The ggcpt result contract | Tidy methods and the plotting layer | Design principles | The unified dispatcher | A tour of the method families | Penalised and optimal partitioning | Multiscale and search methods | Changes in slope | Bayesian detection | Nonparametric and sequential detection | Robustness to drift, autocorrelation, and model ambiguity | Multivariate and high-dimensional detection | Structural breaks in regression | Beyond detection | Batch detection over many series | Stability diagnostics | Evaluation, interactivity, and citations | Discussion | Acknowledgements | References

Last update: 2026-07-02
Started: 2022-02-21

Readme and manuals

Help Manual

Help pageTopics
Annotate segments with alternating shadingannotate_segments
Augment a ggcpt objectaugment.ggcpt
Autoplot a ggcpt objectautoplot.ggcpt
Bayesian changepoint wrapper (Barry-Hartigan product partition model)bcp_wrapper
BEAST wrapper — Bayesian estimation of abrupt change, seasonality, and trendbeast_wrapper
Bayesian online changepoint detection wrapper (BOCPD)bocpd_wrapper
Sequential change point model wrapper (CPM)cpm_wrapper
CPOP wrapper — optimal change-in-slope detectioncpop_wrapper
Batch changepoint detection over many seriesautoplot.ggcpt_batch cpt_batch print.ggcpt_batch tidy.ggcpt_batch
Cite the method behind a resultcpt_cite
CROPS — the full penalty path of a penalised changepoint methodautoplot.ggcpt_path cpt_crops print.ggcpt_path tidy.ggcpt_path
Unified changepoint detection dispatchercpt_detect
Introspect available changepoint detection methodscpt_methods
Changepoint accuracy metricscpt_metrics
Multi-annotator evaluationcpt_metrics_annotated
Construct changepoint penaltiescpt_penalty
Generate simulated changepoint datacpt_simulate rcpt
Changepoint stability diagnostics via bootstrapautoplot.ggcpt_stability cpt_stability print.ggcpt_stability
Changepoint wrappercpt_wrapper
DeCAFS wrapper — changes amid drift and autocorrelated noisedecafs_wrapper
ecp wrapperecp_wrapper
EnvCpt wrapper — changepoints versus trends versus autocorrelationenvcpt_wrapper
fastcpd wrapper — fast changepoint detection via sequential gradient descentfastcpd_wrapper
FPOP wrapper — Functional Pruning Optimal Partitioningfpop_wrapper
Changepoint vertical rules geomgeom_changepoint
Changepoint confidence interval geomgeom_cpt_ci
Changepoint segment level geomgeom_cpt_segment
Geometrically-inspired multivariate changepoint wrapper (geomcp)geomcp_wrapper
Compare multiple changepoint detection methodsggcpt_compare
Comparison tableggcpt_compare_table
Evaluation visualizationggcpt_eval
Interactive changepoint plotggcpt_interactive
Coerce, format, and plot ggcpt objectsas.data.frame.ggcpt as_tibble.ggcpt format.ggcpt ggcpt_methods plot.ggcpt
Posterior probability plot for Bayesian resultsggcpt_posterior
Run-length posterior heatmap for Bayesian online resultsggcpt_runlength
Plot for the changepoint packageggcptplot
Plot for the ecp packageggecpplot
Glance at a ggcpt objectglance.ggcpt
Isolate-Detect wrapperidetect_wrapper
inspect wrapper — high-dimensional changepoints via sparse projectioninspect_wrapper
Test if an object is a ggcpt objectis_ggcpt
Kernel changepoint wrapper (KCP on running statistics)kcp_wrapper
MOSUM wrapper — Moving Summosum_wrapper
Create a ggcpt objectnew_ggcpt
NOT wrapper — Narrowest-Over-Thresholdnot_wrapper
Nonparametric MOSUM wrapper (NP-MOJO)npmojo_wrapper
ocd wrapper — online high-dimensional changepoint detectionocd_wrapper
Print a ggcpt objectprint.ggcpt
Broken-line regression wrapper (segmented)segmented_wrapper
Blocks test signalsignal_blocks
FMS (Four-Metric-Segments) test signalsignal_fms
Mix test signalsignal_mix
Stairs test signalsignal_stairs
Teeth test signalsignal_teeth
SMUCE / HSMUCE wrapper — multiscale changepoint inferencesmuce_wrapper
Self-normalisation wrapper (SNSeg)sn_wrapper
Changepoint detection statstat_changepoint
Bai-Perron structural break wrapper (strucchange)strucchange_wrapper
Summary of a ggcpt objectprint.summary.ggcpt summary.ggcpt
TGUH wrappertguh_wrapper
ggchangepoint themetheme_ggcpt
Tidy a ggcpt objecttidy.ggcpt
WBS wrapper — Wild Binary Segmentationwbs_wrapper
WBS2 wrapper — Wild Binary Segmentation 2wbs2_wrapper