Skip to content

RateOfChangeEvents¤

Detect rapid changes and step jumps in a numeric signal.

Module: ts_shape.events.engineering.rate_of_change
Guide: Process Engineering

When to Use¤

Use for detecting sudden process upsets, valve jumps, or rapid thermal changes. Complements threshold monitoring by catching the rate of change, not just the absolute level. Especially useful as an early-warning mechanism before a threshold is actually breached.

Quick Example¤

from ts_shape.events.engineering.rate_of_change import RateOfChangeEvents

detector = RateOfChangeEvents(
    df=process_data,
    uuid="flow_rate_01"
)

# Detect intervals where rate exceeds 10 units/min
rapid = detector.detect_rapid_change(threshold=10.0, window="1m")

# Get rate statistics per hour for trend reporting
stats = detector.rate_statistics(window="1h")

# Find sudden step jumps (large delta in short time)
steps = detector.detect_step_changes(min_delta=20.0, max_duration="5s")

Key Methods¤

Method Purpose Returns
detect_rapid_change(threshold, window='1m') Rapid change intervals DataFrame of rapid-change events
rate_statistics(window='1h') Rate statistics per window DataFrame with rate stats
detect_step_changes(min_delta, max_duration='5s') Sudden value jumps DataFrame of step events

Tips & Notes¤

Pair with threshold monitoring for defense-in-depth

A rapid rate of change often precedes a threshold breach. Use detect_rapid_change() as an early warning, and ThresholdMonitoringEvents as the definitive alarm. This two-layer approach gives operators more lead time.

Related modules

See Also¤