Create a new Forecast

Simply click the “plus” icon next to “Forecasting” in the left-hand navigation menu.

Then complete the setup form. All types of analysis require a friendly name so you can identify this analysis later. Once essential fields are completed, the Save and Fit button becomes active.

Field Requirements
Name A name for the analysis to help you find it again later.
Connection An existing connection. To create and manage connections, see Creating and Managing Database Connections

Only the first tab is required for a basic forecast - all other tabs offer customization and/or additional capabilities but are not required to get started.

Data Selection

image-20250429-100224.png

Field Requirements
Table An existing table or view in your data source.
Date Column This can be a date, datetime or timestamp typed field. In the case of uploaded data, ensure date or timestamps are formatted as ISO8601 values. Data is aggregated to hourly, daily or weekly level prior to forecasting future values based on the settings in “Model Fitting” below. The default is “Daily”.
Value The value you wish to forecast. This should be a numeric type and could refer to a monetary amount, or a quantity.
Filters (Optional) A filter comprises of a filter-column, an operator (=, , =) and a value. If multiple filters are added, they will be “and”ed together.

There is no requirement to pre-summarise or aggregate data, therefore a sales-order, sales-invoice or transaction table with appropriate analysis data fields (see below) can be used directly.

Holidays / Events

To model standard and custom holidays and events, use the settings in this tab.

Data element Requirements
Holiday Calendar (Optional) Select the national holidays applicable to your sales data. If you operate in multiple geographies each with different holiday calendars, it may be appropriate to split the data by geography and create a separate forecast for each. This value is an ISO-3166 code. This can be confusing, for example the United Kingdom is represented by “GB” and not “UK”.
Subdivision (Optional) Some Holiday calendars have subdivisions, e.g. US States, Autralian Terrotiroes and so on. If you choose a holiday calendar, but not a subdivision, then only those public holidays common to all subdivisions will be included. Choosing a specific subdivision will include all holidays both in the country and the given subdivision.
Include Observed Holidays (Optional) Some holidays “float” to the next weekday if they would otherwise occur on a weekend, for example Boxing Day. Ticking this box will fit parameters both for the original date and it’s amended date.

image-20250429-100312.png

Custom Events

Each custom events required a name, plus a list of event dates and their durations. The example below shows Wimbledon dates:

image-20250429-100708.png

Ensure to enter historic and future occurance of the custom events to ensure accurate forecasts.

Model Fitting

Parameter Requirements
Frequency (Optional) Hourly - Hourly data truncates the time part of a datetime/datestamp to the start of each hour. Daily (Default) - this will truncate the time off any timestamp/datetime value to leave just the date. No timezone conversion is performed, although if your data spans timezone boundaries it makes sense for your data source to always use UTC dates and times. Weekly - Weekly data is summarised using Monday as the first day of the week.
Model Type (Optional) If you think the uplift in sales due to day of week or holidays provides a percentage uplift in sales, choose “Multiplicative”. If you think the uplift in sales due to day of week or holidays provides a fixed additional level of sales, choose “Additive”.
Advanced Tuning Parameters (Optional) You may override the model settings for Changepoint Prior Scale, Seasonability Prior Scale, Holidays Prior Scale and/or Changepoint Data Range, however sensible defaults are provided. For more details on these parameters, see https://facebook.github.io/prophet/docs/diagnostics.html#hyperparameter-tuning in the prophet documentation.

Cross-validation

During model fitting, many forecasts are created from ranges of historic data and the forecasts compared with known actuals. This helps to assess the likely model accuracy of making predictions into the future.

Regardless of whether the model frequency is hourly, daily or weekly, all of these parameters are specified in days.

The default values below would mean that;

  • A “forecast window” is taken from the first 90 days of available data
  • Predictions would be made 7 days into the future and compared to actuals
  • The window is extended by an additional 14 days and the above two steps are repeated on the larger dataset This is repeated as many times as possible until there are no more actual value to compare forecasts to
Parameter Default value
Initial Period 90
Period for cross-validation 14
Horizon for cross-validation 7

Additional Fields / Regressors

It’s possible to include the effects of other fields in the analysis which may influence forecasts.

You must provide data for historic and future dates, although future values can be in a different table to the historic data. When requesting forecasts, only future dates with available values for additional fields will be included.

Parameter Requirements
Additional Fields (Optional) One or more numeric fields. Data is standardized prior to model fitting, so the units/scale do not matter
Future Values of Regressors are in a different table (Optional) Tick the box if future values of the additional fields are in a different table to the source data
Table for Future Values (Optional) If ticking the box above, provide an alternative table name
Date Column for Future Values (Optional) If ticking the box above, provide an alternative date column.

image-20250429-113242.png

Create the analysis

Once all fields are completed, you will see a preview of the data that you can use to sanity check that the correct fields are chosen. Then click “Save and Fit” and choose a model infrastructure type to continue.

Fitting

After clicking “Save and Fit”, infrastructure will be created and queries are issued to your data source. A summary of the analysis is displayed along with its status.

It may take a few seconds, a few minutes, or even a few hours, depending on data size to fit (or build) the model that provides the analysis.

The page will refresh automatically as the status moves from Created, to Fitting, to Fitted.

You may navigate away from this tab, or the whole application, without interrupting the build.

image-20250429-113509.png

View and export the forecast values

The “Forecast” tab shows a chart a table of actual and forecasted values.

The number of days of history, as well as the forecast horizon (days into the future) displayed can be adjusted using the sliders.

The data can be exported in CSV format using the “Export“ button. To export back to the source database, create a workflow and use the “Export Forecasts” task.

image-20250429-113805.png

Assess the quality of the forecasting model

Crossvalidation

The likely performance of a forecasting model is assessed using _crossvalidation, _a method by which many forecasts are re-fit on a sliding window of available data and comparing the predictions to the actuals. See the section earlier on crossvalidation parameters to understand more detail on how this works.

Forecasts are prepared using the prophet library - more details on the methodology for forecasts and crossvalidation can be found on their documentation page

image-20250429-114258.png

The columns in the cross-validation tab contain statistics split by the horizon - how far into the future you are looking.

Column Description
Horizon The number of days into the future you want to look. Performance (difference between forecasted values and actual values) is likely to worsen as the horizon increases.
MAE The Mean Absolute Error - the average difference between the forecast and actual values
MDAPE The Median Absolute Percentage Error
MSE The Mean Square Error
RMSE The (Squre) Root Mean Square Error
SMAPE The Symmetric Mean Absolute Percentage Error
MAPE The Mean Absolute Percentage Error. If some estimates are close to zero, this number is not provided.

Additional Variables

If you included additional variables in the model, the regressor coefficients are provided:

image-20250429-114337.png

The coefficient in this example suggests that for each additional unit of weather_temp, the forecasted value will increase by 29.3 (on average).

Re-fit the model on the latest available data

The data available via the configured data source may be constantly changing as new transactions are recorded. You may re-fit/re-build the underlying model for a given analysis without having to fill out all of the information again. Simple click the “Re-fit on latest data” icon next to the drop-down list of available builds.

image-20250429-114457.png

You may also set the Active model or delete a particular build. For more information on what the active model refers to, see Manage Existing Analysis Models .