Rejoignez-nous
Mathématiques/probuilder · probacktest · proorder · proscreener

Pow

Pow dans ProBuilder élève une valeur de base à un exposant, calculant la base à la puissance. Ordre des arguments, syntaxe, lien avec SQRT et SQUARE, et exemples détaillés.

Syntaxe

probuilder
POW(BaseValue, Power)

Paramètres

NomTypeDescription
BaseValuenombreLa base à élever.
PowernombreL'exposant auquel la base est élevée. Peut être un nombre entier ou une fraction.

Formule

code
POW(x, y) = x^y

POW(2, 3) est 8, POW(9, 0.5) vaut 3 (la racine carrée), et POW(x, 0) vaut 1 pour toute base non nulle.

Comment ça marche

POW élève le premier argument à la puissance du second. L'ordre des arguments importe : POW(2, 3) est 8 mais POW(3, 2) vaut 9. Un exposant entier donne une multiplication répétée, alors qu'un exposant fractionnaire donne une racine, donc POW(x, 0.5) égale SQRT(x) et POW(x, 2) égale SQUARE(x).

Pour la base fixe e, EXP est la fonction spécialisée. POW couvre n'importe quelle base, ce qui est utile pour capitaliser à un taux quelconque ou pour des pondérations en puissance personnalisées.

Exemples

Exemple 1, Deux au cube (Indicateur)

probuilder
// Raise 2 to the power of 3
result = POW(2, 3)   // 8
RETURN result AS "2^3"

La base 2 est élevée à l'exposant 3, ce qui donne 8. Inverser les arguments renverrait 9 à la place.

Exemple 2, Élever au cube un ratio normalisé (ProScreener)

probuilder
// Emphasize large ratios by cubing them
ratio = close / Average[50](close)
cubed = POW(ratio, 3)
SCREENER[cubed > 1.2](cubed AS "Ratio cubed")

L'élévation au cube amplifie les valeurs supérieures à 1 et réduit celles qui lui sont inférieures, accentuant la séparation entre instruments forts et faibles.

Exemple 3, Composer un taux de croissance par barre (ProOrder)

probuilder
// Project a fixed daily growth rate over 5 bars
rate = 1.002
factor = POW(rate, 5)
IF NOT LongOnMarket AND close > close[5] * factor THEN
  BUY 1 CONTRACT AT MARKET
ENDIF

POW(rate, 5) capitalise le taux par barre sur cinq barres, ce qui donne le facteur de croissance auquel le prix actuel est comparé.

Erreurs et pièges courants

  • La base d'abord, l'exposant ensuite. POW(2, 3) est 8, POW(3, 2) est 9. Inverser les arguments change le résultat.
  • Les exposants fractionnaires sont des racines. POW(x, 0.5) est la racine carrée de x et n'est réel que pour x >= 0, la même limite de domaine que SQRT.
  • Nom en majuscules dans le code. Le nom d'affichage documenté est Pow, mais l'appel s'écrit POW(...). Les mots-clés ProBuilder ne sont pas sensibles à la casse, les deux écritures fonctionnent donc.
  • SQRT, racine carrée, équivalent à POW(x, 0.5).
  • SQUARE, élève une valeur au carré, équivalent à POW(x, 2).
  • EXP, exponentielle de base fixe e.
  • LOG, logarithme naturel, l'inverse de l'exponentiation.
  • ABS, valeur absolue, utile avant des puissances fractionnaires.
  • MAX, la plus grande de deux valeurs.
  • MIN, la plus petite de deux valeurs.