Package: reviser 0.3.0

Marc Burri

reviser: Analyzing Revisions in Real-Time Time Series Vintages

Analyzes revisions in real-time time series vintages. The package converts between wide revision triangles and tidy long vintages, extracts selected releases, computes revision series, visualizes vintage paths, and summarizes revision properties such as bias, dispersion, autocorrelation, and news-noise diagnostics. It also identifies efficient releases and estimates state-space models for revision nowcasting. Methods are based on Howrey (1978) <doi:10.2307/1924972>, Jacobs and Van Norden (2011) <doi:10.1016/j.jeconom.2010.04.010>, and Kishor and Koenig (2012) <doi:10.1198/jbes.2010.08169>.

Authors:Marc Burri [aut, cre, cph], Philipp Wegmueller [aut, cph]

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

# Install 'reviser' in R:
install.packages('reviser', repos = c('https://packages.ropensci.org', 'https://cloud.r-project.org'))

Reviews:rOpenSci Software Review #709

Bug tracker:https://github.com/ropensci/reviser/issues

Pkgdown/docs site:https://docs.ropensci.org

Datasets:
  • gdp - Vintages Data

On CRAN:

Conda:

forecastingmacroeconomicsnowcastingrevisionstime-series

6.84 score 10 stars 14 scripts 439 downloads 21 exports 74 dependencies

Last updated from:411cd720f2 (on main). Checks:10 OK. Indexed: yes.

TargetResultTimeFilesSyslog
linux-develOK282
pkgdown docsOK346
source / vignettesOK281
linux-releaseOK279
macos-releaseOK175
macos-oldrelOK174
windows-develOK227
windows-releaseOK239
windows-oldrelOK256
wasm-releaseOK147

Exports:colors_reviserdiagnoseget_days_to_releaseget_first_efficient_releaseget_first_releaseget_fixed_releaseget_latest_releaseget_nth_releaseget_releases_by_dateget_revision_analysisget_revisionsjvn_nowcastkk_nowcastplot_vintagesscale_color_reviserscale_fill_reviserstatestheme_reviservalidate_vintagesvintages_longvintages_wide

Dependencies:abindbackportsbootbroomcalculuscarcarDataclicolorspacecowplotcpp11DerivdoBydplyrfarverforecastFormulafracdiffgenericsggplot2gluegtableisobandKFASlabelinglatticelifecyclelme4lmtestlubridatemagrittrMASSMatrixMatrixModelsmgcvminqamodelrnlmenloptrnnetnumDerivpbkrtestpillarpkgconfigpurrrquantregR6rbibutilsRColorBrewerRcppRcppArmadilloRcppEigenRdpackreformulasrlangS7sandwichscalesSparseMstringistringrsurvivalsystemfittibbletidyrtidyselecttimechangetimeDateurcautf8vctrsviridisLitewithrzoo

Nowcasting revisions using the generalized Kishor-Koenig family
Revision system | Nested models | Durbin-Koopman state-space form | Estimation in reviser | Example: Euro Area GDP revisions | Other KK-family specifications

Last update: 2026-08-28
Started: 2026-01-12

Nowcasting revisions using the Jacobs-Van Norden model
Revision decomposition | Durbin-Koopman state-space form | The reviser implementation | Measurement equation | Transition equation | Shock-loading matrix | Nested JVN specifications | Example: Euro Area GDP revisions | Other JVN specifications

Last update: 2026-08-28
Started: 2026-01-12

Introduction to reviser
Package conventions | Convert Long to Wide Format | Convert Wide to Long Format | Handling Multiple Series with id | Extracting Releases | Visualizing Vintage Data | Analyzing Data Revisions and Releases

Last update: 2026-08-22
Started: 2025-03-04

Identifying an Efficient Release in Data Subject to Revisions
Optimal Properties of Revisions | Initial Estimates as Truth Measured with Noise | The Challenge of Defining a Final Release | Iterative Approach for Identifying ( e ) | Importance of an Efficient Release | Example: Identifying an Efficient Release in GDP Data with reviser | References

Last update: 2026-03-19
Started: 2025-03-04

Revision Patterns and Statistics
Summary Statistics | Revision Size | 1. Mean Revision ("Bias (mean)") | 2. Mean Absolute Revision ("MAR") | 3. Minimum and Maximum Revisions ("Minimum", "Maximum") | 4. Percentiles of Revisions ("10Q", "Median", "90Q") | 5. Standard Deviation of Revisions ("Std. Dev.") | 6. Noise-to-Signal Ratio ("Noise/Signal") | Correlation of Revisions | 1. Correlation Between Revisions and Initial Releases ("Correlation") | 2. 1st order Autocorrelation of Revisions ("Autocorrelation (1st)") | 3. Autocorrelation of Revisions up to 1 year ("Autocorrelation up to 1yr (Ljung-Box p-value)") | Sign Switches | 1. Fraction of sign changes | 2. Fraction of sign changes in the growth rate | Hypothesis Tests | News and Noise Tests for Data Revisions | 1. The Noise Test | 2. The News Test | Test of Seasonality in Revisions | Friedman Test | Theil’s U Statistics | 1. Theil’s U1 Statistic ("Theil's U1") | 2. Theil’s U2 Statistic ("Theil's U2") | References

Last update: 2026-03-19
Started: 2025-03-04

Understanding Data Revisions
Introduction: Why do data revisions occur? | Incorporation of newly available or updated data | Base data revisions | Benchmark revisions (methodological changes) | Minor changes in estimation methods | Technical adjustments & error corrections | Economic events & shocks | Technological advances in data collection | Some mathematical notation | Extracting revisions with reviser | The get_revisions() function | Example usage | Example 1: Revisions Using an Interval | Example 2: Revisions Relative to a Fixed Reference Date | Example 3: Revisions to the Nth Release | Example 4: How does the growth rate of GDP change over time? | References

Last update: 2026-03-19
Started: 2025-03-04

The Role and Importance of Revisions in Time Series Data
Introduction | Understanding the Magnitude of Revisions | The Dynamics of Revisions and What They Reveal | The Uses of Studying Revisions in Time Series Data | Conclusion

Last update: 2025-03-14
Started: 2025-03-04

Readme and manuals

Help Manual

Help pageTopics
Extract Parameter Estimates from a Revision Modelcoef.revision_model
Diagnose Revision Qualitydiagnose
Diagnose Method for Revision Summarydiagnose.revision_summary
Fitted Latent Values from a Revision Modelfitted.revision_model
Vintages Datagdp
Calculate the Number of Days Between Period End and First Releaseget_days_to_release
Identify the First Efficient Release in Vintage Dataget_first_efficient_release
Extract the First Data Release (Vintage)get_first_release
Extract Vintage Values from a Data Frameget_fixed_release
Extract the Latest Data Release (Vintage)get_latest_release
Extract the Nth Data Release (Vintage)get_nth_release
Get Data Releases for a Specific Dateget_releases_by_date
Revision Analysis Summary Statisticsget_revision_analysis
Calculate Revisions in Vintage Dataget_revisions
Jacobs-Van Norden Model for Data Revisionsjvn_nowcast
Generalized Kishor-Koenig Model for Nowcastingkk_nowcast
Extract the Log-Likelihood of a Revision ModellogLik.revision_model
Number of Observations Used to Fit a Revision Modelnobs.revision_model
Plot Vintages Dataplot_vintages
Plot Revision Model Resultsplot.revision_model
Plot Method for Vintages Dataplot.tbl_vintage
Forecasts from a Revision Modelpredict.revision_model
Print Method for Efficient Release Resultsprint.lst_efficient
Print Method for Revision Modelsprint.revision_model
Print Method for Revision Summaryprint.revision_summary
Print Method for Vintages Dataprint.tbl_vintage
Residuals of a Revision Modelresiduals.revision_model
Fitted Revision Modelsrevision_model
Extract the Latent State Estimates of a Revision Modelstates states.revision_model
Summary of Efficient Release Modelssummary.lst_efficient
Summary Method for Revision Modelssummary.revision_model
Summary Method for Revision Summarysummary.revision_summary
Summary Method for Vintages Datasummary.tbl_vintage
Tibble Summary for Vintages Datatbl_sum.tbl_vintage
Vintages Data Objectstbl_vintage
Custom Visualization Theme and Color Scales for revisercolors_reviser scale_color_reviser scale_fill_reviser theme_reviser
Vintages Data Classes and Their Validationreviser-vintages-classes validate_vintages
Extract the Parameter Covariance Matrix of a Revision Modelvcov.revision_model
Convert Vintages Data to Long Formatvintages_long
Convert Vintages Data to Wide Formatvintages_wide