WHALE ENGINE
Documentation

Lowest Bars (lowestbars)

[[lowestbars]] indique où se trouve le minimum récent d’une série, sans renvoyer la valeur de ce minimum. Sur chaque bougie, il recherche la valeur la plus faible parmi les length dernières bougies et produit son décalage par rapport à la bougie courante.

Le résultat vaut 0 si le minimum se trouve sur la bougie courante. Les valeurs négatives désignent le passé : -1 correspond à la bougie précédente et -3 à celle située trois bougies plus tôt. Si plusieurs bougies partagent le même minimum, le bloc renvoie la position de la plus ancienne occurrence encore présente dans la fenêtre.

La série observée est définie par source. Avec la source par défaut low, le bloc localise le plus bas récent des bougies. Avec close ou la sortie d’un autre indicateur, il localise le minimum récent de cette série.

Déclaration du bloc

Une stratégie peut contenir plusieurs blocs [[lowestbars]]. Chaque bloc produit une série numérique : le décalage vers la plus basse valeur de la fenêtre.

Exemples

Configuration minimale

Ce bloc utilise la source implicite "low" et renvoie la position du plus bas observé sur les 20 dernières barres.

[[lowestbars]]
id     = "lowest_pos"
length = 20

Source personnalisée et recherche de la longueur optimale

Ce bloc calcule la position du minimum des clôtures pour chaque valeur de length testée par la grille.

[[lowestbars]]
id           = "close_lowest_pos"
source       = "close"
length.start = 10
length.stop  = 30

Position testée dans une condition

Cet exemple teste si la plus basse valeur de la fenêtre se trouve sur la bougie courante.

[[lowestbars]]
id     = "recent_low_pos"
length = 20

[[condition]]
id            = "current_low_is_window_low"
condition     = "recent_low_pos == 0"
next_block_id = "..."

Symbole et timeframe dédiés

Ce bloc calcule la position du plus bas journalier de BINANCE:ETHUSDT, indépendamment du symbole et du timeframe principaux définis dans [backtest]. Voir la page Exchanges, Symboles et Timeframes pour les règles d’alignement.

[[lowestbars]]
id        = "daily_low_pos"
symbol    = "BINANCE:ETHUSDT"
timeframe = "D"
length    = 20

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 : "low"
length
 Entier
 Obligatoire		Taille de la fenêtre, doit être ≥ 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 utilise le symbole principal 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

Le bloc lowestbars expose une série numérique et ses paramètres (length, source, symbol, timeframe). Ces variables sont disponibles dans les expressions après le calcul de la série.

Supposons le bloc configuré ainsi :

[[lowestbars]]
id     = "lowest_pos"
length = 20

Alors :

VariableDescription
lowest_pos ou lowest_pos[0]
Décimal		Décalage courant vers le minimum de la fenêtre. 0 signifie que le minimum est sur la bougie courante ; une valeur négative indique combien de bougies séparent ce minimum de la bougie courante.
lowest_pos[n]
Décimal		Décalage calculé il y a n bougies (lowest_pos[1] pour la bougie précédente).
lowest_pos.length
Décimal		Longueur effectivement utilisée.
lowest_pos.source
Texte		Source réelle (low, close, autre indicateur).
lowest_pos.symbol
Texte		Symbole employé par ce bloc.
lowest_pos.timeframe
Texte		Timeframe appliqué à l’indicateur.

Notes

Les length - 1 premières valeurs de la série ne sont pas disponibles, car la fenêtre n’est pas encore complète. Après cet amorçage, si source vaut NaN sur la bougie courante, [[lowestbars]] renvoie 0.

Préc
Lowest
Suiv
Money Flow Index (mfi)