// Ichimoku Kinko Hyo (一目均衡表): five lines derived from rolling
// high/low midpoints and displacements. All lines are O(n) via the base
// rolling primitives.
///|
/// Ichimoku decomposition: tenkan, kijun, senkou_a, senkou_b and chikou,
/// all of input length with NaN outside their valid ranges.
pub struct IchimokuResult {
tenkan : Array[Double]
kijun : Array[Double]
senkou_a : Array[Double]
senkou_b : Array[Double]
chikou : Array[Double]
}
///|
/// Number of leading NaN values of the tenkan/kijun lines for their periods.
pub fn ichimoku_lookback(tenkan : Int32, kijun : Int32) -> Int32 {
if kijun > tenkan {
kijun - 1
} else {
tenkan - 1
}
}
///|
/// Ichimoku Kinko Hyo.
///
/// - `tenkan[i] = (hh(tenkan) + ll(tenkan)) / 2` over the last `tenkan` bars;
/// - `kijun[i]` mirrors it over `kijun` bars;
/// - `senkou_a[i] = (tenkan[i - displacement] + kijun[i - displacement]) / 2`
/// (the midpoint computed `displacement` bars ago, plotted forward);
/// - `senkou_b[i] = (hh(senkou) + ll(senkou)) / 2` from the window ending
/// `displacement` bars ago;
/// - `chikou[i] = close[i + displacement]` (the close plotted backward).
///
/// All lines share the flat-window and NaN rules of the rolling extremes.
pub fn ichimoku(
candles : @base.Candles,
tenkan~ : Int32,
kijun~ : Int32,
senkou~ : Int32,
displacement~ : Int32,
) -> IchimokuResult raise @base.TaError {
@base.validate_candles(candles)
if tenkan <= 0 || kijun <= 0 || senkou <= 0 || displacement < 0 {
raise @base.InvalidPeriod(
"periods must be positive and displacement non-negative",
)
}
let n = candles.close.length()
let hh_t = @base.rolling_max(candles.high, tenkan)
let ll_t = @base.rolling_min(candles.low, tenkan)
let hh_k = @base.rolling_max(candles.high, kijun)
let ll_k = @base.rolling_min(candles.low, kijun)
let hh_s = @base.rolling_max(candles.high, senkou)
let ll_s = @base.rolling_min(candles.low, senkou)
let tenkan_line : Array[Double] = []
let kijun_line : Array[Double] = []
for i in 0..