Bayesian Change-point Detection

hanaml.BCPD is a R wrapper for SAP HANA PAL Bayesian change-point detection algorithm.

hanaml.BCPD(
  data,
  key = NULL,
  features = NULL,
  max.tcp = 3,
  max.scp = 3,
  trend.order = NULL,
  max.harmonic.order = NULL,
  min.period = NULL,
  max.period = NULL,
  random.seed = NULL,
  max.iter = NULL,
  interval.ratio = NULL
)

Arguments

data

DataFrame
Input data for change-point detection.
key

character, optional
Column name for time-stamp of the input time-series data.
features

character, optional
Column name(s) for the value(s) of the input time-series data.
max.tcp

integer, optional
Maximum number of trend change points to be detected.
Defaults to 3.
max.scp

integer, optional
Maximum number of season change points to be detected.
Defaults to 3.
trend.order

integer, optional
Order of trend segments that used for decomposation.
Defaults to 1.
max.harmonic.order

integer, optional
Maximum order of harmonic waves within seasonal segments.
Defaults to 0.
min.period

integer, optional
Minimum possible period within seasonal segments.
Defaults to 0.
max.period

integer, optional
Maximum possible period within seasonal segments.
Defaults to 0.
random.seed

integer, optional
Indicates the seed used to initialize the random number generator:

  • 0 Uses the system time.

  • Not 0 Uses the provided value.

Defaults to 0.
max.iter

integer, optional
BCPD is iterative, the more iterations, the more precise will the result be rendered.
Defaults to 5000.
interval.ratio

double, optional
Regulates the interval between change points, which should be larger than the corresponding portion of total length.
Defaults to 0.1.

Value

Returns a list of two DataFrame:

  • DataFrame 1
    Detected the trend change-points of the input time-series data.

  • DataFrame 2
    Detected the season change-points of the input time-series data.

  • DataFrame 3
    Detected the period within each season segment of the input time-series data.

  • DataFrame 4
    The decomposed components.

Details

Bayesian change-point detection (BCPD) methods aim at detecting abrupt changes in the time series. It, to some extent, can been assumed as an enhanced version of seasonality test in additive mode.

Examples

Call the function:

> res <- hanaml.BCPD(data = df,
                     max.tcp = 5,
                     max.scp = 5)