milia.anomaly.triage#

Alarm triage: rank entities by their worst event.

Functions

triage(events, entity[, severity, time])

Per-entity worst severity, number of event steps and first event time, ranked worst first.

milia.anomaly.triage.triage(events, entity, severity='severity', time='step')#

Per-entity worst severity, number of event steps and first event time, ranked worst first.

Ties in severity are broken by the number of event steps.

Parameters:
  • events (DataFrame) – One row per event step (e.g. a voltage violation).

  • entity (str) – Column naming the entity (meter, load, feeder).

  • severity (str) – Column with the event severity.

  • time (str) – Column with the event time.

Return type:

DataFrame

Returns:

One row per entity with worst, steps, first and rank (1 = most urgent).

Examples

>>> events = pd.DataFrame({"load": ["a", "a", "b"], "severity": [0.01, 0.05, 0.08], "step": [3, 4, 9]})
>>> triage(events, "load")[["load", "rank"]].values.tolist()
[['b', 1], ['a', 2]]