Summary
ForceIndex is RTTA's streaming implementation of: Price-change times volume oscillator.
Update API
result = rtta.ForceIndex().update(close, volume)
The update(...) call consumes one observation using close, volume. advance(...)
uses the same inputs when the caller wants to update state without materializing
a Python return value.
Theory Of Operation
ForceIndex normalizes recent directional movement into an oscillator. The implementation keeps only causal rolling or smoothed state and maps that state into the current oscillator value.
Recurrence
Let \(z_t = (close_t, volume_t)\) denote the observation consumed by one
update(...) call and let \(\theta\) denote constructor parameters such as
window lengths, thresholds, and smoothing constants.
The return value is the current scalar indicator value.
Implementation Notes
The recurrence is implemented in src/rtta/indicator.cpp in class ForceIndex.