Falling

[[falling]] vérifie si une série diminue strictement d’une valeur valide à la suivante pendant plusieurs comparaisons successives. Il renvoie 1.0 lorsque toute la séquence est décroissante et 0.0 dès qu’une nouvelle valeur valide reste stable ou augmente.

Le paramètre length compte les comparaisons, et non les valeurs observées. Avec length = 3, le bloc compare donc quatre valeurs valides successives : la valeur courante à la précédente, puis les deux paires qui les précèdent.

Déclaration du bloc

Une stratégie peut contenir plusieurs blocs [[falling]]. Chaque bloc produit une série numérique unique, exposée sous l’id du bloc.

Exemples

Configuration minimale

Ce bloc vérifie si la série close baisse sur trois comparaisons successives.

[[falling]]
id     = "falling"
length = 3

Source personnalisée

Ce bloc applique le même test à la source hlc3.

[[falling]]
id     = "falling_hlc3"
source = "hlc3"
length = 5

Recherche de la longueur optimale

Ce bloc explore plusieurs valeurs de length afin de tester différentes durées de baisse continue.

[[falling]]
id           = "falling"
source       = "close"
length.start = 2
length.stop  = 10
length.step  = 2

Confirmation de baisse récente

Cet exemple utilise falling pour vérifier que close diminue sur trois comparaisons successives. La condition devient vraie lorsque close_falling vaut 1.0.

[[falling]]
id     = "close_falling"
source = "close"
length = 3

[[condition]]
id            = "recent_fall_filter"
condition     = "close_falling = 1"
next_block_id = "..."

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
 Obligatoire
Nombre de comparaisons strictement baissières à vérifier, doit être compris entre 1 et 10000.

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

Vous pouvez utiliser directement les identifiants ci-dessous dans vos expressions. Le bloc Falling expose une série numérique et ses paramètres (length, source, symbol, timeframe).

Supposons le bloc configuré ainsi :

[[falling]]
id     = "falling"
length = 3

Alors :

VariableDescription
falling ou falling[0]
Décimal
Valeur courante du test. Elle vaut 1.0 lorsque la source baisse sur length comparaisons successives, sinon 0.0.
falling[n]
Décimal
Valeur du test il y a n bougies.
falling.length
Décimal
Longueur utilisée pour la combinaison courante.
falling.source
Texte
Nom de la série d’entrée.
falling.symbol
Texte
Symbole de marché utilisé.
falling.timeframe
Texte
Timeframe utilisé pour le calcul.

Notes

  • Le bloc falling produit toujours une valeur numérique 0.0 ou 1.0.
  • Les valeurs NaN sont ignorées : elles n’interrompent pas la séquence et la sortie conserve son état jusqu’à la prochaine valeur valide. La comparaison reprend alors avec la dernière valeur valide rencontrée.
  • Les variables numériques peuvent être combinées librement dans vos formules.
  • Les variables textuelles sont des chaînes destinées aux comparaisons d’égalité/inégalité uniquement.