Prophet is a procedure for forecasting time series data based on an additive model where non-linear trends are fit with yearly, weekly, and daily seasonality, plus holiday effects.

Ben Letham 7c95c62cf0 Move plotting into a separate file (Py) 7 tahun lalu
R 0c30f6efcf Merge in some minor fixes from master 7 tahun lalu
docs e78f583f90 Merge in bugfixes from master (#349) 7 tahun lalu
examples b93f71540d Notebook example with sub-daily data 8 tahun lalu
notebooks e78f583f90 Merge in bugfixes from master (#349) 7 tahun lalu
python 7c95c62cf0 Move plotting into a separate file (Py) 7 tahun lalu
.gitattributes a4bd78276c Fix repo language details 8 tahun lalu
.gitignore 1a57d19148 Allow to build models in-place. (#100) 8 tahun lalu
.travis.yml 29275ac6e9 Add R setting for Travis CI (#385) 7 tahun lalu
LICENSE e51b42b336 Initial commit 8 tahun lalu
PATENTS e51b42b336 Initial commit 8 tahun lalu
README.md 0c30f6efcf Merge in some minor fixes from master 7 tahun lalu

README.md

Prophet: Automatic Forecasting Procedure

Build Status

Prophet is a procedure for forecasting time series data. It is based on an additive model where non-linear trends are fit with yearly and weekly seasonality, plus holidays. It works best with daily periodicity data with at least one year of historical data. Prophet is robust to missing data, shifts in the trend, and large outliers.

Prophet is open source software released by Facebook's Core Data Science team. It is available for download on CRAN and PyPI.

Important links

Installation in R

Prophet is a CRAN package so you can use install.packages:

# R
> install.packages('prophet')

After installation, you can get started!

Windows

On Windows, R requires a compiler so you'll need to follow the instructions provided by rstan. The key step is installing Rtools before attempting to install the package.

If you have custom Stan compiler settings, install from source rather than the CRAN binary.

Installation in Python

Prophet is on PyPI, so you can use pip to install it:

# bash
$ pip install fbprophet

The major dependency that Prophet has is pystan. PyStan has its own installation instructions.

After installation, you can get started!

Windows

On Windows, PyStan requires a compiler so you'll need to follow the instructions. The key step is installing a recent C++ compiler.

Linux

Make sure compilers (gcc, g++, build-essential) and Python development tools (python-dev, python3-dev) are installed. If you are using a VM, be aware that you will need at least 4GB of memory to install fbprophet, and at least 2GB of memory to use fbprophet.

Anaconda

Use conda install gcc to set up gcc. The easiest way to install Prophet is through conda-forge: conda install -c conda-forge fbprophet.

Changelog

Version 0.2.1 (2017.11.08)

  • Bugfixes

Version 0.2 (2017.09.02)

  • Forecasting with sub-daily data
  • Daily seasonality, and custom seasonalities
  • Extra regressors
  • Access to posterior predictive samples
  • Cross-validation function
  • Saturating minimums
  • Bugfixes

Version 0.1.1 (2017.04.17)

  • Bugfixes
  • New options for detecting yearly and weekly seasonality (now the default)

Version 0.1 (2017.02.23)

  • Initial release