Facebook Prophet is an Open-Source library developed by Facebook’s in-house data science team to address time series based forecasting problems. This blog will give you insights on some of the key features that make this model stand out from the rest. A Practical guide on how to implement Prophet can be found here . So What are you waiting for – Let’s get started!
Before we jump into the blog, Let us quickly understand what time series forecasting is!
What is Time Series Forecasting?

Time Series Forecasting is a common machine learning problem with wide applicability across different domains! The main characteristics of Time Series Forecasting are understanding variations in Trend and Seasonal Patterns associated with time. This makes time series forecasting complex compared to other ML problems! Given the wide applicability of time series forecasting, many models have been developed off-late and in this post, we will be focusing on Facebook’s Prophet, a prominent Time series forecasting model used across the industry! Let’s get started!
Introduction to Facebook’s Prophet
Prophet is a powerful open-source library built by Facebook specifically to solve time-series problems. It has many inbuilt features to address some of the common challenges we have in time series forecasting. The model proceeds in a block-wise manner throughout the dataset, which leads to automatic capturing of trends, weekday/weekend movements, and seasonal patterns. In this blog, we will discuss some of the inbuilt features of the Prophet.
Official documentation on Prophet can be found here
Advantages of Prophet
So What makes Facebook Prophet special?. Well, it’s a full-blown library built taking into consideration most of the common challenges in time series forecasting. Following are few advantages we could list out:
- The primary advantage of Facebook’s Prophet is that any person without prior experience or in-depth knowledge in time series modeling can workaround.
- Facebook’s Prophet is accurate and fast ( which uses the Stan Platform for computation and predictions ).
- Prophet allows adjustment of parameters, customized seasonality components which may improve the forecasts.
- Prophet can also handle outliers and handles other data issues by itself.
Well, the list can go on and on!
Prophet’s Formulation
Before we deep-dive into features of Prophet let us understand the basic math used in the prophet:
y(t) = g(t) + s(t) + h(t) + e(t)
Where,
g(t) = linear or logistic growth with respect to time series data.
s(t) = seasonal component ( daily / weekly / quarterly / yearly ).
h(t) = holidays/events effects.
e(t) = error term caused due to unexpected occurrences.
Detailed explanation on Prophet’s Parameters
This part of the blog will provide you an in-depth understanding of different parameters of the Prophet and its features. These parameters can be fine-tuned which empowers the users to create complex time series forecasting models easily. Listed below are the parameters with a brief description of its function.
- Parameters of Trend
- Growth
- Saturating Growth
- Parameters of Seasonality
- Parameters of Holidays and Events
- Trend Changepoints
- Additional Regressor
Parameters of Trend
Based on the pattern of the trend present in the data , we will be able to define growth parameter of the Prophet Model.
Growth
This parameter has to be specified as ‘linear’ or ‘logistic’ based on the nature of the data.
- growth = ‘linear’ , If there is a linear trend in the data
Example : Rise in experience increases salary.
- growth = ‘logistic’ , If there is a non-linear trend
Example : Rise in the beginning and fall at the end of year.

The above image clearly shows the difference between linear and non – linear trends.
Saturating Growth
Saturating growth comes into play when there is an increasing growth such as an increase in revenue of the company. We will require our forecasts to saturate at some point (threshold – level) in the future. This threshold level is known as Carrying capacity denoted by ‘cap’.
In the same manner, the forecasts should go down to a point , a minimum threshold level. This is represented as ‘floor’.
Note :
There should be two columns named ‘cap’ and ‘floor’ assigned to the
- training set before fitting the model
- future set before forecasting
Parameters of Seasonality
Seasonal components play a vital role in time series forecasting. These components are periodic events that are mostly stable with respect to time. This is referred to as the seasonality of time series.
Prophet comes with the following three parameters to tune the seasonality
- Seasonality_mode
- In Built Seasonality
- Custom seasonality
seasonality_mode
Prophet fits the additive seasonality to its model, an effect added to the trend for forecasting. By default, Prophets uses additive seasonality. There is an option for seasonality mode to be multiplicative, which can be specified when there are rise and fall in the trend.
Data with “linear trend” shows that there is an additive seasonality whereas data with “non-linear trend” shows that there is a rise at the beginning of the hour and a fall at some points, which decides the mode to be multiplicative.
In-Built seasonality
By default, Prophet will be able to automatically fit seasonalities based on daily, weekly and yearly basis. Inorder to use these default parameter, the value should be set to ‘True’.
Inorder to use custom values for the seasonal components, the value should be set to ‘False’.
Custom Seasonality
Custom Seasonality can be specified using add_seasonality function.
- Hourly,
- Daily,
- Weekly,
- Monthly,
- Quarterly,
- Yearly basis.
There should be three arguments which are to be specified in add_seasonality function.
- name
- period
- fourier_order
name : The name of the seasonality should be specified in this argument as a string.
period
Period is a numeric value ( days ) which represents the repetition of the seasonal pattern.
Here, period = 1 means there is a daily seasonal trend repeating every 1 day once.
Here, if the name is set to yearly, then there will be a repetition of the pattern every 365 days.
fourier_order
Fourier order represents the movement of data in the trend.
Playing around different values of fourier_order gives a better understanding.
Figure 1.1 : Yearly seasonality with different fourier_order
Images shown in Figure 1.1 shows the seasonality pattern captured using different fourier orders. The image on the top has fourier_order set to 1. The image on the bottom shows the difference in the graph with many wavy patterns as its value of fourier_order = 48.
Parameters of Holiday / Events
We may deal with many holidays and events that take place in a time series data. It is necessary to include these important dates to our forecasting model as there may be different patterns on these dates.
Prophet allows us to specify these dates based on two ways :
- In – built function
- External variable
In-Built Holidays Effects
Prophet provides in-built functionality for adding these holidays and passing the trend captured to the forecasting model.
add_country_holidays is an argument which receives country code. This will get us all the holidays in the country’s calendar.
There are approximately 13 countries for which Prophet provides in-built holidays for the specified country.
Custom Holidays
Apart from in-built holidays, there may be many other important dates ( events in the past / in future ) that should be specified to the forecasting model.
Custom holidays should be assigned as a dataframe with two columns namely ‘holiday’ and ‘ds’.
Additional Regressor
Prophet additionally allows to add regressors that may add effect to the forecasting model.
These can be implemented using the ‘add_regressor’ function. The regressor should be added to
- Training set before fit method,
- Future set before forecast method.
Trend Changepoints
One main feature of Facebook’s Prophet is it is fully automatic and it is capable of capturing trends and seasonal patterns on its own. Changepoints meaning any changes in points on timely-ordered data. These can either be left at the default level or customized.
‘add_changepoints_to_plot’ is a function that allows us to visualize the changepoints in our data.
Changepoints come into play when the model faces problems of overfitting or underfitting. These can be addressed using ‘changepoint_prior_scale’. The trend will become flexible when the changepoint_prior_scale is increased and vice versa.
Future and Forecasts
Defining Future datasets
It is important to define the period ( number of days ) of the future set with frequency.
‘make_future_dataframe’ is a function that consists of two arguments namely ‘period’ and freq’.
- period is the number of days the model should forecast.
- freq is the frequency (a measurement of time ) of the future set.
- It can be ‘30min’ for 30 minutes time period,
- ‘H’ for hourly,
- ‘D’ for daily.
If frequency is not mentioned, the default value will be in ‘days’.
Features of Forecasts
Forecasting time series using Prophet will provide predictions made on defined future sets and components of forecasts.
Forecasts can be made using the ‘predict’ function on the Prophet instance for the future sets.
The forecasts can be visualized using the ‘plot’ function on the forecast variable.
Similarly, the components of forecasts can be visualized using ‘plot_components’ on future sets. Plot components will result in trends in the data, seasonality added in Prophet model. This helps to understand the patterns captured by the forecast function.
A plot of forecasts and its components generated on the future set:
Diagnostics in Prophet
Prophet’s other impressive functionality is Diagnostics which provides a cross-validation method in forecasting and measuring performance errors. The function can be used by importing cross_validation from Prophet.
from fbprophet.diagnostics import cross_validation (Diagnostics | Prophet)
- The training samples are the specified initial number of days/hours.
- The samples for forecasting will be taken from cutoff and cutoff + horizon.
- The forecast will take place every number of periods defined.
- The number of samples as forecasts will be equal to the horizon value.
Brief description on functions of Diagnostics
It is important to understand the parameters while working on Diagnostics. Like other modules of Prophet, Diagnostics also comes with a range of parameters that makes this model very flexible.
Initial
Initial value is the number of training samples that is required for the model to forecast.
Period
The value of period is the number of days / hours , the forecasts should be done.
Horizon
This parameter is important for initializing the cutoff value. Horizon values are the output of cross-validation. Metrics will be generated based on the specified number of days/hours in the horizon.
Cutoff
Parameter Cutoff value is a measurement in days/hours. The cutoff value is the difference between the maximum ‘ds’ in the dataset and the specified horizon.
Conclusion
This concludes our introductory post on Facebook Prophet! Facebook’s Prophet is a solid library with many inbuilt features to handle challenges faced in time series forecasting. Users can create complex time series forecasting models with very little programming knowledge. I hope you got a grip on the basic features of Prophet!. You can find a coded example of the Facebook Prophet – Experimenting Facebook Prophet!
Thanks to you! I hope you will now be able to kick start your work on Time Series Forecasting using Facebook’s Prophet. If you find the blog helpful, Do Like and Share.
Stay Tuned and follow Digital Tesseract for many more such blogs on Data Science .
Reference Articles
Official page of Prophet – https://facebook.github.io/prophet/
An Introductory Study on Time Series Modeling and Forecasting – https://arxiv.org/ftp/arxiv/papers/1302/1302.6613.pdf
Subscribe To Our Newsletter
Join our mailing list to receive the latest news and updates from our team.
You have Successfully Subscribed!