# EDDM¶

Early Drift Detection Method.

EDDM (Early Drift Detection Method) aims to improve the detection rate of gradual concept drift in DDM, while keeping a good performance against abrupt concept drift.

This method works by keeping track of the average distance between two errors instead of only the error rate. For this, it is necessary to keep track of the running average distance and the running standard deviation, as well as the maximum distance and the maximum standard deviation.

The algorithm works similarly to the DDM algorithm, by keeping track of statistics only. It works with the running average distance ($$p_i'$$) and the running standard deviation ($$s_i'$$), as well as $$p'_{max}$$ and $$s'_{max}$$, which are the values of $$p_i'$$ and $$s_i'$$ when $$(p_i' + 2 * s_i')$$ reaches its maximum.

Like DDM, there are two threshold values that define the borderline between no change, warning zone, and drift detected. These are as follows:

• if $$(p_i' + 2 * s_i')/(p'_{max} + 2 * s'_{max}) < \alpha$$ -> Warning zone

• if $$(p_i' + 2 * s_i')/(p'_{max} + 2 * s'_{max}) < \beta$$ -> Change detected

$$\alpha$$ and $$\beta$$ are set to 0.95 and 0.9, respectively.

Input: value must be a binary signal, where 1 indicates error. For example, if a classifier's prediction $$y'$$ is right or wrong w.r.t the true target label $$y$$:

• 0: Correct, $$y=y'$$

• 1: Error, $$y \neq y'$$

## Parameters¶

• min_num_instances – defaults to 30

The minimum required number of analyzed samples so change can be detected. This is used to avoid false detections during the early moments of the detector, when the weight of one sample is important.

• warning_level – defaults to 0.95

Warning level.

• out_control_level – defaults to 0.9

Out-control level.

## Attributes¶

• change_detected

Concept drift alarm. True if concept drift is detected.

• warning_detected

Warning zone alarm. Indicates if the drift detector is in the warning zone. Applicability depends on each drift detector implementation. True if the change detector is in the warning zone.

## Examples¶

>>> import random
>>> from river import drift

>>> rng = random.Random(42)
>>> eddm = drift.EDDM()

>>> # Simulate a data stream as a uniform distribution of 1's and 0's
>>> data_stream = rng.choices([0, 1], k=2000)
>>> # Change the data distribution from index 999 to 1500, simulating an
>>> # increase in error rate (1 indicates error)
>>> data_stream[999:1500] =  * 500

>>> # Update drift detector and verify if change is detected
>>> for i, val in enumerate(data_stream):
...     in_drift, in_warning = eddm.update(val)
...     if in_drift:
...         print(f"Change detected at index {i}, input value: {val}")
Change detected at index 105, input value: 1
Change detected at index 245, input value: 1
Change detected at index 332, input value: 1
Change detected at index 451, input value: 1
Change detected at index 537, input value: 1
Change detected at index 843, input value: 1
Change detected at index 914, input value: 1
Change detected at index 1015, input value: 1


## Methods¶

clone

Return a fresh estimator with the same parameters.

The clone has the same parameters but has not been updated with any data. This works by looking at the parameters from the class signature. Each parameter is either - recursively cloned if it's a River classes. - deep-copied via copy.deepcopy if not. If the calling object is stochastic (i.e. it accepts a seed parameter) and has not been seeded, then the clone will not be idempotent. Indeed, this method's purpose if simply to return a new instance with the same input parameters.

reset

Reset the change detector.

update

Update the change detector with a single data point.

Parameters

• value (numbers.Number)

Returns

tuple: A tuple (drift, warning) where its elements indicate if a drift or a warning is detected.

1. Early Drift Detection Method. Manuel Baena-Garcia, Jose Del Campo-Avila, Raúl Fidalgo, Albert Bifet, Ricard Gavalda, Rafael Morales-Bueno. In Fourth International Workshop on Knowledge Discovery from Data Streams, 2006.