Skip to content

fable.prophet

1.0.0Package record

Prophet Modelling Interface for 'fable'

1packages depend
11.3Kdownloads / year
96.4%test coverage
13/13flavors OK

Overview

About

Allows prophet models from the 'prophet' package to be used in a tidy workflow with the modelling interface of 'fabletools'. This extends 'prophet' to provide enhanced model specification and management, performance evaluation methods, and model combination tools.

Changes in 1.0.0

Breaking changes

  • R >= 4.1.0 and fabletools >= 0.5.0 are now required. Rcpp is no longer attached by this package (prophet still loads it).
  • tidy() now reports extra regressor estimates as coefficients on the original data scale (additive regressors in units of the response, multiplicative regressors as proportional effects), rather than prophet's internal scaled parameters. Other terms remain on the internal scale, as documented in ?tidy.fbl_prophet.
  • forecast() no longer forwards ... to prophet::predictive_samples(), which doesn't accept additional arguments. ... is now documented as unused.

New features

  • Added generate() for prophet models (#4), simulating sample paths (trend including future changepoints, seasonality, holidays and regressors) with normally distributed or, with bootstrap = TRUE, resampled-residual observation noise. Works in-sample and out-of-sample, including with MCMC estimation and transformed responses.
  • Added refit() for prophet models (#30). By default the estimated parameters are kept and the fitted values, residuals and components are recomputed for the new data; reestimate = TRUE fits the model again on the new data using the original estimation arguments. Prophet cannot be updated incrementally, so there is no stream() method.
  • growth() now supports type = "flat", for a constant trend without changepoints.
  • holiday() gains a country argument to include prophet's built-in country holidays (via prophet::add_country_holidays()), with or without a holidays table. tidy() now names (and orders) holiday terms from the fitted model, so country holidays and repeated holiday dates are supported.
  • season() gains a condition argument (a bare logical column name) for conditional seasonality (via prophet::add_seasonality(condition.name = )). The column must also be present in new_data when forecasting.
  • prophet() now documents and supports the mcmc.samples and backend arguments (passed to prophet::prophet()) for MCMC estimation and choosing the "rstan" or "cmdstanr" Stan backend. tidy() and glance() summarise MCMC draws by their posterior means.
  • forecast() now supports times = 0, which returns point forecasts (as degenerate distributions) without simulating sample paths. The times argument is now documented, including its speed and memory trade-off (#26).
Show all changes in 1.0.0Hide the rest of the changes in 1.0.0

Improvements

  • components() now includes the holidays, extra_regressors_additive and extra_regressors_multiplicative terms when they are present in the model.
  • Fitted models no longer keep prophet's raw Stan output (stan.fit), reducing model size (#26).
  • Regressors with non-syntactic names (e.g. log(x) or I(x^2)) are now supported, using make.names() to name them in the model and in tidy() (#32).
  • Documentation: added "Non-daily data" (#28), "Performance and memory" (#26) and model evaluation sections to ?prophet and the introduction vignette.

Bug fixes

  • The model is now fit with uncertainty.samples = 0 (previously the argument was misspelt and ignored), so fitting no longer computes unused uncertainty samples.
  • Removed an unused prediction in forecast() (#33).

From NEWS.md in the release

Install

Health

CRAN checks
13OK
Slowest check: 6.8 min · r-oldrel-macos-x86_64
Status changes
  • OK13 OK2026-08-20
  • ERROR12 OK, 1 ERROR2026-08-18
  • OK13 OK2026-08-05
  • NOTE12 OK, 1 NOTE2026-08-01
  • OK13 OK2026-07-29
Show 5 earlier changesHide 5 earlier changes
  • ERROR12 OK, 1 ERROR2026-07-27
  • OK13 OK2026-07-22
  • ERROR12 OK, 1 ERROR2026-07-18
  • OK12 OK2026-04-25
  • NOTE11 OK, 3 NOTE2026-03-10
Advisories

none known

Documentation

In release 1.0.0
READMEYes · 418 wordsVignettesYes · 1 · dynamicNEWSYes · 100% structured · mentions 1.0.0Citation fileNoWebsiteYes · pkgdown
Help pages
10includes a package overview page
Examples that run
43%3 run in a plain check · 4 only when donttest examples are enabled (R CMD check --as-cran)
Exported functions with examples
100%
Documented parameters
100%
Return-value docs
0%
Help pages citing references
0%

Downloads

11.3K
CRAN downloads in the past year
Rank #3,916 · ~31/day · ~940/mo
Daily download trend is not available in this view yet.
1.1K30 days
2.4K90 days
11.3K1 year
Compare downloads with other packages →
Also on124 r2u15 autocran90 c2d4u

Repository

57Stars
8Forks
0Open issues
0Open PRs
3Releases
167Commits
1Commit identities
167 commits · Last activity 2026-10-11 · 0% stars, 30d · Default branch at 1.0.0.9000, ahead of CRAN 1.0.0 (checked 2026-10-11)
Responsiveness
How these are sampled
PRs merged (all time)
not measured
Median days to close, 50 most recently updated closed issues
18
Median days to close, 50 most recently updated closed PRs
not measured

Stars over time

2025-07-28 · 572026-07-07 · 57
PracticesBeta

14 development-tooling and community-health practices detected across 7 families in the upstream repository

Checks run against github.com/mitchelloharawild/fable.prophet on 2026-10-11.

Continuous integration (2)
GitHub ActionsR CMD check workflow

The R CMD check workflow runs on Linux

Governance and community (4)
Code of conductContributing guideIssue templatesSupport guide
Docs source (4)
README.Rmdpkgdown

GitHub Pages site last deployed 2020-08-20 · The repository has a site deploy workflow

Coverage (1)
Coverage reporting (Codecov)
Show all practicesHide 3 practices
Reproducibility and dev environment (1)
data-raw/
CRAN release process (1)
cran-comments.md
Lint, format, editor (1)
RStudio project
How this is detected·Detection ruleset v3 (2026-09-26)

Dependencies

Declared dependencies
14 external dependencies (excludes base and recommended)

Installing fable.prophet adds 90 packages (49 with compiled code, 81 MB of source tarballs). Heaviest: BH 14 MB, stringi 11 MB, ggplot2 6.0 MB.

Depends (2)
R >= 4.1.0fabletools
LinkingTo (0)
none
Enhances (0)
none
Reverse dependencies
1direct
0indirect
Depends 1
Depends, Imports or LinkingTo, most downloaded first

People & History

People (3)
Author, Maintainer since 0.1.0 (2020)
Contributor
Prophet library, https://facebook.github.io/prophet/
Contributor
Prophet library, https://facebook.github.io/prophet/
Releases (3)

Pick two releases to compare their code metrics.

  • 1.0.0Latest
    record
    2026-10-11 · current release · diff ↗
  • 0.1.1
    record
    2026-10-03 · diff ↗
  • R
    R 4.6.0 released · 2026-04-24
  • R
    R 4.5.0 released · 2025-04-11
  • R
    R 4.4.0 released · 2024-04-24
  • R
    R 4.3.0 released · 2023-04-21
  • R
    R 4.2.0 released · 2022-04-22
  • R
    R 4.1.0 released · 2021-05-18
  • 0.1.0
    record
    2020-08-20
  • R
    R 4.0.0 released · 2020-04-24

Package metadata

First published
2020-08-20
Total releases
3 / 6 yrs
License
GPL-3 OSI
Minimum R
≥ 4.1.0
Download size
523 KB
Appears in task views

Cite

Cite this package

Run in R for the authors' preferred citation:

citation("fable.prophet")
O'Hara-Wild, M., Letham, B., & Taylor, S. (2026). fable.prophet: Prophet Modelling Interface for 'fable' (Version 1.0.0) [Computer software]. https://doi.org/10.32614/CRAN.package.fable.prophet

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.

APA

Balamuta, J. J. (2026). R Observatory: Metrics for fable.prophet version 1.0.0 [Data set]. HJJB, LLC. Data release v2026-10-18. https://doi.org/10.5281/zenodo.21843040

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.

Report a problem with this page →

Privacy choices

These apply to this browser and are stored on this device only. Nothing about your choice is sent to us.

Read the privacy policy