Skip to main content

default

chainalign-backend

chainalign-backend / services/ForecastAccuracyService / default

Class: default

Defined in: services/ForecastAccuracyService.js:11

Fileoverview​

Service for comparing generated forecasts against actual performance data. This is a core component of the Forecast Accuracy & Model Improvement Feedback Loop (M26.3).

Constructors​

Constructor​

new default(): ForecastAccuracyService

Returns​

ForecastAccuracyService

Methods​

calculateBias()​

static calculateBias(forecasts, actuals): number

Defined in: services/ForecastAccuracyService.js:54

Calculates the Bias (Mean Forecast Error) between forecasts and actuals. Bias indicates whether the forecast is consistently over or under-predicting. Bias = (1/n) * Σ(Forecast - Actual) A positive bias means the forecast is generally over-predicting (forecast > actual). A negative bias means the forecast is generally under-predicting (forecast < actual).

Parameters​

forecasts​

number[]

An array of forecast values.

actuals​

number[]

An array of actual values.

Returns​

number

The bias value.

calculateMAPE()​

static calculateMAPE(forecasts, actuals): number

Defined in: services/ForecastAccuracyService.js:21

Calculates the Mean Absolute Percentage Error (MAPE) between forecasts and actuals. MAPE is a measure of prediction accuracy of a forecasting method in statistics. It expresses accuracy as a percentage, and is defined by the formula: MAPE = (1/n) * Σ(|Actual - Forecast| / |Actual|) * 100

Parameters​

forecasts​

number[]

An array of forecast values.

actuals​

number[]

An array of actual values.

Returns​

number

The MAPE value, or Infinity if any actual value is zero.

compareForecastToActuals()​

static compareForecastToActuals(forecastData, tenantId, period): Promise<any>

Defined in: services/ForecastAccuracyService.js:74

Compares a generated forecast against actual performance data.

Parameters​

forecastData​

any

The forecast data to compare (e.g., output from HybridForecastingService).

tenantId​

string

The ID of the tenant.

period​

string

The period for which to compare (e.g., '2025-Q4').

Returns​

Promise<any>

An object containing the comparison results.