CCI — Commodity Channel Index¶
Measures how far the typical price deviates from its simple moving average, normalised by mean absolute deviation. Values above +100 suggest overbought conditions; values below -100 suggest oversold conditions.
Inputs: [high, low, close] | Options: [period] | Outputs: [cci]
Basic¶
use tulip_rs::indicators::cci::indicator;
let high = vec![82.15, 81.89, 83.03, 83.30, 83.85,
83.90, 83.33, 84.30, 84.84, 85.00_f64];
let low = vec![81.29, 80.64, 81.31, 82.65, 83.07,
83.11, 82.49, 82.30, 84.15, 84.11_f64];
let close = vec![81.59, 81.06, 82.87, 83.00, 83.61,
83.15, 82.84, 83.99, 84.55, 84.36_f64];
let inputs = [high.as_slice(), low.as_slice(), close.as_slice()];
let (outputs, _state) = indicator(&inputs, &[20.0], None).unwrap();
println!("CCI(20): {:?}", outputs[0]);
// State continuation
let inputs2 = [&high[..8], &low[..8], &close[..8]];
let (outputs2, mut state) = indicator(&inputs2, &[20.0], None).unwrap();
println!("Partial CCI: {:?}", outputs2[0]);
let new_inputs = [&high[8..], &low[8..], &close[8..]];
let continued = state.batch_indicator(&new_inputs, None).unwrap();
println!("Continued CCI: {:?}", continued[0]);
import numpy as np
import tulip_rs
high = np.array([82.15, 81.89, 83.03, 83.30, 83.85,
83.90, 83.33, 84.30, 84.84, 85.00], dtype=np.float64)
low = np.array([81.29, 80.64, 81.31, 82.65, 83.07,
83.11, 82.49, 82.30, 84.15, 84.11], dtype=np.float64)
close = np.array([81.59, 81.06, 82.87, 83.00, 83.61,
83.15, 82.84, 83.99, 84.55, 84.36], dtype=np.float64)
outputs, state = tulip_rs.indicators.cci.indicator([high, low, close], [20.0])
print("CCI(20):", outputs[0])
# State continuation
outputs2, state = tulip_rs.indicators.cci.indicator([high[:8], low[:8], close[:8]], [20.0])
continued = state.batch_indicator([high[8:], low[8:], close[8:]])
print("Continued CCI:", continued[0])
import * as ti from 'tulip-rs-node';
const high = [82.15, 81.89, 83.03, 83.30, 83.85, 83.90, 83.33, 84.30, 84.84, 85.00, 85.90, 86.58, 86.98, 88.00, 87.87];
const low = [81.29, 80.64, 81.31, 82.65, 83.07, 83.11, 82.49, 82.30, 84.15, 84.11, 84.03, 85.39, 85.76, 87.17, 87.01];
const close = [81.59, 81.06, 82.87, 83.00, 83.61, 83.15, 82.84, 83.99, 84.55, 84.36, 85.53, 86.54, 86.89, 87.77, 87.29];
const [outputs, state] = ti.cci.indicator([high, low, close], [20]);
console.log('CCI(20):', outputs[0]);
// State continuation
const n = high.length - 5;
const [, state2] = ti.cci.indicator([high.slice(0, n), low.slice(0, n), close.slice(0, n)], [20]);
const continued = state2.batchIndicator([high.slice(n), low.slice(n), close.slice(n)]);
console.log('Continued CCI:', continued[0]);
import { init } from 'tulip-rs-wasm';
import * as ti from 'tulip-rs-wasm';
await init(); // bundler resolves the WASM asset automatically
const high = [82.15, 81.89, 83.03, 83.30, 83.85, 83.90, 83.33, 84.30, 84.84, 85.00, 85.90, 86.58, 86.98, 88.00, 87.87];
const low = [81.29, 80.64, 81.31, 82.65, 83.07, 83.11, 82.49, 82.30, 84.15, 84.11, 84.03, 85.39, 85.76, 87.17, 87.01];
const close = [81.59, 81.06, 82.87, 83.00, 83.61, 83.15, 82.84, 83.99, 84.55, 84.36, 85.53, 86.54, 86.89, 87.77, 87.29];
const [outputs, state] = ti.cci.indicator([high, low, close], [20]);
console.log('CCI(20):', outputs[0]);
// State continuation
const n = high.length - 5;
const [, state2] = ti.cci.indicator([high.slice(0, n), low.slice(0, n), close.slice(0, n)], [20]);
const continued = state2.batchIndicator([high.slice(n), low.slice(n), close.slice(n)]);
console.log('Continued CCI:', continued[0]);
Optional Outputs¶
cci exposes 3 optional outputs: sma, md, typprice. Pass a boolean mask as the third argument — one bool per optional output, in order.
use tulip_rs::indicators::cci::indicator;
let high = vec![82.15, 81.89, 83.03, 83.30, 83.85,
83.90, 83.33, 84.30, 84.84, 85.00_f64];
let low = vec![81.29, 80.64, 81.31, 82.65, 83.07,
83.11, 82.49, 82.30, 84.15, 84.11_f64];
let close = vec![81.59, 81.06, 82.87, 83.00, 83.61,
83.15, 82.84, 83.99, 84.55, 84.36_f64];
let mask = [true, true, true]; // one per optional output
let inputs = [high.as_slice(), low.as_slice(), close.as_slice()];
let (outputs, _state) = indicator(&inputs, &[20.0], Some(&mask)).unwrap();
let cci = &outputs[0]; // cci (primary)
let sma = &outputs[1]; // sma (optional — requested)
let md = &outputs[2]; // md (optional — requested)
let typprice = &outputs[3]; // typprice (optional — requested)
import numpy as np
import tulip_rs
high = np.array([82.15, 81.89, 83.03, 83.30, 83.85,
83.90, 83.33, 84.30, 84.84, 85.00], dtype=np.float64)
low = np.array([81.29, 80.64, 81.31, 82.65, 83.07,
83.11, 82.49, 82.30, 84.15, 84.11], dtype=np.float64)
close = np.array([81.59, 81.06, 82.87, 83.00, 83.61,
83.15, 82.84, 83.99, 84.55, 84.36], dtype=np.float64)
outputs, state = tulip_rs.indicators.cci.indicator(
[high, low, close], [20.0],
optional_outputs=[True, True, True],
)
cci = outputs[0] # cci (primary)
sma = outputs[1] # sma (optional — requested)
md = outputs[2] # md (optional — requested)
typprice = outputs[3] # typprice (optional — requested)
cci exposes 3 optional outputs: sma, md, typprice.
const [allOut] = ti.cci.indicator([high, low, close], [20], [true, true, true]);
const cci = allOut[0]; // primary
const sma = allOut[1]; // optional 0: sma
const md = allOut[2]; // optional 1: md
const typprice = allOut[3]; // optional 2: typprice
// Request only sma
const [partial] = ti.cci.indicator([high, low, close], [20], [true, false, false]);
SIMD¶
By assets — same period applied to 4 assets in parallel:
use tulip_rs::indicators::cci::indicator_by_assets;
let h1 = vec![82.15, 81.89, 83.03, 83.30, 83.85, 83.90, 83.33, 84.30, 84.84, 85.00_f64];
let l1 = vec![81.29, 80.64, 81.31, 82.65, 83.07, 83.11, 82.49, 82.30, 84.15, 84.11_f64];
let c1 = vec![81.59, 81.06, 82.87, 83.00, 83.61, 83.15, 82.84, 83.99, 84.55, 84.36_f64];
let h2 = h1.clone(); let l2 = l1.clone(); let c2 = c1.clone();
let h3 = h1.clone(); let l3 = l1.clone(); let c3 = c1.clone();
let h4 = h1.clone(); let l4 = l1.clone(); let c4 = c1.clone();
let inputs: [&[&[f64]; 3]; 4] = [
&[h1.as_slice(), l1.as_slice(), c1.as_slice()],
&[h2.as_slice(), l2.as_slice(), c2.as_slice()],
&[h3.as_slice(), l3.as_slice(), c3.as_slice()],
&[h4.as_slice(), l4.as_slice(), c4.as_slice()],
];
let results = indicator_by_assets::<4>(&inputs, &[20.0], None).unwrap();
for (i, asset_outputs) in results.0.iter().enumerate() {
println!("Asset {}: {:?}", i + 1, asset_outputs[0]);
}
By options — same asset, 4 different periods in parallel:
use tulip_rs::indicators::cci::indicator_by_options;
let high = vec![82.15, 81.89, 83.03, 83.30, 83.85,
83.90, 83.33, 84.30, 84.84, 85.00_f64];
let low = vec![81.29, 80.64, 81.31, 82.65, 83.07,
83.11, 82.49, 82.30, 84.15, 84.11_f64];
let close = vec![81.59, 81.06, 82.87, 83.00, 83.61,
83.15, 82.84, 83.99, 84.55, 84.36_f64];
let opts: [&[f64; 1]; 4] = [&[10.0], &[14.0], &[20.0], &[30.0]];
let inputs = [high.as_slice(), low.as_slice(), close.as_slice()];
let results = indicator_by_options::<4>(&inputs, &opts, None).unwrap();
for (i, opt_outputs) in results.0.iter().enumerate() {
println!("Period set {}: {:?}", i + 1, opt_outputs[0]);
}
By assets — same period applied to N assets in parallel (must be 2, 4, 8, or 16):
import numpy as np
import tulip_rs
high = np.array([82.15, 81.89, 83.03, 83.30, 83.85,
83.90, 83.33, 84.30, 84.84, 85.00], dtype=np.float64)
low = np.array([81.29, 80.64, 81.31, 82.65, 83.07,
83.11, 82.49, 82.30, 84.15, 84.11], dtype=np.float64)
close = np.array([81.59, 81.06, 82.87, 83.00, 83.61,
83.15, 82.84, 83.99, 84.55, 84.36], dtype=np.float64)
simd_inputs = [
[high, low, close],
[high + 0.5, low + 0.5, close + 0.5],
[high - 0.5, low - 0.5, close - 0.5],
[high * 1.01, low * 1.01, close * 1.01],
]
outputs_list, states = tulip_rs.indicators.cci.simd_by_assets(simd_inputs, [20.0])
for i, out in enumerate(outputs_list):
print(f"Asset {i + 1}: {out[0]}")
By options — same asset, N different periods in parallel:
import numpy as np
import tulip_rs
high = np.array([82.15, 81.89, 83.03, 83.30, 83.85,
83.90, 83.33, 84.30, 84.84, 85.00], dtype=np.float64)
low = np.array([81.29, 80.64, 81.31, 82.65, 83.07,
83.11, 82.49, 82.30, 84.15, 84.11], dtype=np.float64)
close = np.array([81.59, 81.06, 82.87, 83.00, 83.61,
83.15, 82.84, 83.99, 84.55, 84.36], dtype=np.float64)
simd_options = [[10.0], [14.0], [20.0], [30.0]]
outputs_list, states = tulip_rs.indicators.cci.simd_by_options([high, low, close], simd_options)
for i, out in enumerate(outputs_list):
print(f"Period set {i + 1}: {out[0]}")
By assets — same period applied to 4 assets in parallel:
const simdInputs = [
[[...high], [...low], [...close]],
[high.map(v => v * 1.1), low.map(v => v * 1.1), close.map(v => v * 1.1)],
[high.map(v => v * 0.9), low.map(v => v * 0.9), close.map(v => v * 0.9)],
[high.map(v => v * 1.02), low.map(v => v * 1.02), close.map(v => v * 1.02)],
];
const [results] = ti.cci.simdByAssets(simdInputs, [20]);
results.forEach((out, i) => console.log(`Asset ${i + 1}:`, out[0]));
By options — same asset, 4 different periods in parallel: