KSTOscillator

Incremental, causal technical analysis documentation

Summary

KSTOscillator is RTTA's streaming implementation of: Pring Know Sure Thing smoothed multi-ROC oscillator.

Update API

result = rtta.KSTOscillator().update(close)

The update(...) call consumes one observation using close. advance(...) uses the same inputs when the caller wants to update state without materializing a Python return value.

Theory Of Operation

KSTOscillator 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\) denote the observation consumed by one update(...) call and let \(\theta\) denote constructor parameters such as window lengths, thresholds, and smoothing constants.

\[U_t,D_t = \operatorname{directional\_components}(z_t,z_{t-1})\]
\[y_t = 100\frac{\operatorname{smooth}(U_t)} {\operatorname{smooth}(U_t)+\operatorname{smooth}(D_t)}\]

update(...) returns a result struct with fields kst, signal, difference.

Implementation Notes

The recurrence is implemented in src/rtta/indicator.cpp in class KSTOscillator.

Reference