Change

[[change]] mesure la variation signée d’une série en soustrayant à sa valeur courante celle observée length bougies plus tôt. La sortie est exprimée dans la même unité que la source et n’est pas bornée. Une valeur positive indique une hausse sur cet intervalle, une valeur négative une baisse, et zéro une valeur inchangée.

La source peut être un prix ou la sortie d’un autre indicateur. Chaque valeur produite représente le déplacement net de cette source entre les deux extrémités de l’intervalle, sans décrire le chemin suivi entre elles. Il s’agit d’une différence arithmétique, et non d’une valeur absolue ni d’une variation en pourcentage.

Déclaration du bloc

Une stratégie peut contenir plusieurs blocs [[change]]. Chaque bloc produit une série numérique correspondant à la différence avec un décalage fixe.

Exemples

Configuration minimale

Ce bloc mesure la variation d’une clôture à l’autre. Comme length est omis, le bloc utilise la longueur par défaut 1.

[[change]]
id = "change"

Source personnalisée et recherche de la longueur optimale

Ce bloc explore une plage de valeurs pour length sur la série des clôtures afin d’identifier la longueur la plus performante.

[[change]]
id           = "change"
source       = "close"
length.start = 1
length.stop  = 10
length.step  = 1

Variation d’un autre indicateur

Cet exemple applique change à une moyenne mobile exponentielle déjà calculée. Il mesure la variation d’un signal lissé au lieu de travailler directement sur les prix bruts.

[[ma]]
id     = "ema_fast"
type   = "ema"
length = 20

[[change]]
id     = "ema_slope"
source = "ema_fast"

Paramètres

ParamètreDescription
id
 Texte
 Obligatoire
Identifiant unique de la série produite.
source
 Texte
 ou Tableau
 Optionnel
Série d’entrée utilisée pour le calcul.
Formats acceptés : source = "hl2" ou source = ["close", "hl2"].
Chaque valeur peut être soit une source de prix standard (open, close, high, low, hl2, hlc3, ohlc4, hlcc4, volume), soit l’id d’un autre indicateur.
Valeur par défaut : "close"
length
 Entier
 Optionnel
Décalage en nombre de barres ; doit être ≥ 1 lorsqu’il est renseigné.
Si length est omis, la valeur par défaut est 1.

Usage :
• Fixe : length = valeur
• Grille :
 – length.start = valeur_minimale
 – length.stop = valeur_maximale
 – length.step = valeur (optionnel, par défaut 1)
symbol
 Texte
 ou Tableau
 Optionnel
Symbole(s) de marché utilisé(s) lorsque source ne contient que des prix standard (open, close, high, low, hl2, hlc3, ohlc4, hlcc4, volume).
Si source mélange des prix standard et des identifiants d’indicateurs, symbol s’applique uniquement aux combinaisons basées sur des prix standard.
Si source ne contient que des identifiants d’indicateurs, symbol est ignoré.
Si symbol est omis, le bloc hérite du symbole défini dans [backtest].
Pour le format, les tableaux et l’alignement, voir Exchanges, Symboles et Timeframes.
timeframe
 Texte ou Tableau
 Optionnel
Timeframe sur lequel cet indicateur est calculé.
Si timeframe est omis, le calcul se fait sur le timeframe principal de la grille défini dans [backtest].
Pour les formats acceptés et les règles d’alignement entre timeframes, voir Exchanges, Symboles et Timeframes.

Variables disponibles

Utilisez directement l’id dans vos expressions.
Avec id = "change" :

VariableDescription
change ou change[0]
Décimal
Différence courante (par exemple close - close[1]). Les length premières valeurs sont NaN.
change[n]
Décimal
Valeur il y a n bougies (change[1] pour la bougie précédente).
change.length
Décimal
Décalage effectif utilisé pour la combinaison courante.
change.source
Texte
Source réelle (close, high, autre indicateur).
change.symbol
Texte
Symbole employé par ce bloc.
change.timeframe
Texte
Timeframe utilisé pour le calcul.