Skip to content

ROC — Rate of Change — roc

The percentage change between the current price and the price period bars ago.

Inputs: [real] | Options: [period] | Outputs: [roc]

Basic

use tulip_rs::indicators::roc::indicator;

let (outputs, _) = indicator(&[close.as_slice()], &[10.0], None).unwrap();
println!("{:?}", outputs[0]);

outputs, state = tulip_rs.indicators.roc.indicator([close], [10.0])
print(outputs[0])

import * as ti from 'tulip-rs-node';

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.roc.indicator([close], [10]);
console.log('ROC(10):', outputs[0]);

// State continuation
const [, state2] = ti.roc.indicator([close.slice(0, -5)], [10]);
const continued = state2.batchIndicator([close.slice(-5)]);
console.log('Continued ROC:', continued[0]);

import { init } from 'tulip-rs-wasm';
import * as ti from 'tulip-rs-wasm';

await init(); // bundler resolves the WASM asset automatically

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.roc.indicator([close], [10]);
console.log('ROC(10):', outputs[0]);

// State continuation
const [, state2] = ti.roc.indicator([close.slice(0, -5)], [10]);
const continued = state2.batchIndicator([close.slice(-5)]);
console.log('Continued ROC:', continued[0]);

Optional Outputs

roc exposes 1 optional output: mom. Pass a boolean mask as the third argument — one bool per optional output, in order.

use tulip_rs::indicators::roc::indicator;

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]; // one per optional output
let (outputs, _state) = indicator(&[close.as_slice()], &[10.0], Some(&mask)).unwrap();

let roc = &outputs[0]; // roc (primary)
let mom = &outputs[1]; // mom (optional — requested)

import numpy as np
import tulip_rs

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.roc.indicator(
    [close], [10.0],
    optional_outputs=[True],
)

roc = outputs[0]  # roc (primary)
mom = outputs[1]  # mom (optional — requested)

roc exposes 1 optional output: mom.

const [allOut] = ti.roc.indicator([close], [10], [true]);
const roc = allOut[0]; // primary
const mom = allOut[1]; // optional 0: mom

SIMD

By assets — same options, N assets in parallel:

use tulip_rs::indicators::roc::indicator_by_assets;

let inputs: [&[&[f64]; 1]; 4] = [&[a1.as_slice()], &[a2.as_slice()], &[a3.as_slice()], &[a4.as_slice()]];
let results = indicator_by_assets::<4>(&inputs, &[10.0], None).unwrap();

By options — same asset, N option sets in parallel:

use tulip_rs::indicators::roc::indicator_by_options;

let opts: [&[f64; 1]; 4] = [&[5.0], &[10.0], &[20.0], &[50.0]];
let results = indicator_by_options::<4>(&[close.as_slice()], &opts, None).unwrap();

By assets — same options, N assets in parallel (must be 2, 4, 8, or 16):

simd_inputs = [[a1], [a2], [a3], [a4]]
outputs_list, states = tulip_rs.indicators.roc.simd_by_assets(simd_inputs, [10.0])

By options — same asset, N option sets in parallel:

simd_options = [[5.0], [10.0], [20.0], [50.0]]
outputs_list, states = tulip_rs.indicators.roc.simd_by_options([close], simd_options)

By assets — same period applied to 4 assets in parallel:

const simdInputs = [[[...close]], [close.map(v => v * 1.1)], [close.map(v => v * 0.9)], [close.map(v => v * 1.02)]];
const [results] = ti.roc.simdByAssets(simdInputs, [10]);
results.forEach((out, i) => console.log(`Asset ${i + 1}:`, out[0]));

By options — same asset, 4 different periods in parallel:

const simdOptions = [[5], [10], [20], [50]];
const [results] = ti.roc.simdByOptions([close], simdOptions);
results.forEach((out, i) => console.log(`Period ${simdOptions[i][0]}:`, out[0]));