WHALE ENGINE
Documentation

Lowest

[[lowest]] produit la borne inférieure glissante d’une série : sur chaque bougie, il renvoie la valeur la plus faible observée dans la fenêtre des length dernières bougies. La bougie courante fait partie de cette fenêtre, de sorte qu’un nouveau minimum apparaît immédiatement dans la série produite.

La borne reste inchangée tant qu’aucune valeur plus faible n’entre dans la fenêtre et que le minimum existant n’en sort pas. Lorsqu’il en sort, il est remplacé par la plus petite des valeurs restantes. Contrairement à une moyenne, [[lowest]] ne combine pas les observations de la fenêtre : il en conserve uniquement l’extrême inférieur. Avec la source par défaut low, cet extrême est le plus bas récent des bougies ; avec une autre source, il est le minimum récent de cette série.

Déclaration du bloc

Une stratégie peut contenir plusieurs blocs [[lowest]]. Chaque bloc produit une série numérique : la valeur du minimum glissant.

Exemples

Configuration minimale

Ce bloc utilise la source implicite "low" et suit donc le plus bas observé sur les 20 dernières barres.

[[lowest]]
id     = "lowest"
length = 20

Source personnalisée et recherche de la longueur optimale

Ce bloc explore une plage de valeurs pour length à partir des clôtures afin d’identifier la longueur la plus performante.

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

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

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

Supposons le bloc configuré ainsi :

[[lowest]]
id     = "lowest"
length = 20

Alors :

VariableDescription
lowest ou lowest[0]
Décimal		Minimum glissant courant (première valeur valide après length - 1 bougies).
lowest[n]
Décimal		Valeur du minimum il y a n bougies (lowest[1] pour la bougie précédente).
lowest.length
Décimal		Longueur effectivement utilisée (utile en optimisation).
lowest.source
Texte		Source réelle (low, close, autre indicateur).
lowest.symbol
Texte		Symbole employé par ce bloc.
lowest.timeframe
Texte		Timeframe appliqué à l’indicateur.
Préc
Linear Regression (linreg)
Suiv
Lowest Bars (lowestbars)