Skip to content

Forecast API

Een plugin die van elke tijdgrafiek een prognose maakt, die toekomstige stappen projecteert met een betrouwbaarheidsband; voor het volledige verhaal, zie de Insights-gids.

Probeer het - schakel de prognose, de band en de verteller aan of uit:

forecast · line

Import

ts
import { forecast } from "@michi-vz/insights/forecast";

forecast(options?) retourneert een plugin die je meegeeft in de mount-opties van de grafiek. Het werkt op Line-, Fan-, Range-, Area-, Vertical-Stack-Bar-, Ribbon- en Bar-Bell-grafieken.

ts
mountLineChart(el, props, { plugins: [forecast({ horizon: 4 })] });

Signatuur & opties

NaamTypeStandaardWat het doet
method"holt-winters" of "linear" (lazy "arima")"holt-winters"Prognosemodel dat wordt gebruikt om toekomstige stappen te projecteren.
horizonnumber4Aantal toekomstige stappen om te voorspellen.
levelnumber0.95Betrouwbaarheidsniveau voor de voorspellingsband.
levelsnumber[]optioneelExtra geneste bandniveaus voor een fan-grafiek.
targetstring of string[]alleBeperk de prognose tot deze serielabels.
scenariosArray<{ name: string; growth: number }>optioneelWhat-if-lijnen getekend op basis van aangepaste groeipercentages.
trendlinebooleanfalseOverlay een regressielijn.
threshold{ value: number; label?: string }optioneelReferentielijn plus een geprojecteerd "omslagpunt".
onThresholdBreach(b) => voidoptioneelWordt geactiveerd wanneer de prognose naar verwachting de drempel overschrijdt.
zonebooleantrueArceer het prognosegebied om voorspelling versus werkelijkheid te benadrukken.

Ook geëxporteerd vanuit dit subpad: forecastFan(history, options?, label?), computeForecast, decompose, detectPeriod, detectChangepoints, monteCarloForecast, requiredGrowth, requiredRunRate, pacingToGoal, en FORECASTABLE_CHARTS.

Voorbeeld

ts
import { mountLineChart } from "@michi-vz/core";
import { forecast } from "@michi-vz/insights/forecast";

mountLineChart(el, props, {
  plugins: [
    forecast({
      method: "holt-winters",
      horizon: 4,
      threshold: { value: 200, label: "Target" },
      zone: true,
    }),
  ],
});

Insights-gids