Macro POWER

Le POWER est disponible dans Unica Campaign et Unica Interact.

Syntaxe

base POWER exponent base ^ exponent

Paramètres

base

Valeurs numériques à élever à une puissance exponentielle. Il peut s'agir d'une valeur constante, d'une colonne, d'une plage de cibles ou d'une expression convertie comme l'une de ces valeurs. Pour la définition du format de base (identique à data), voir la section "Paramètres des fonctions macro" du chapitre du présent document correspondant à votre produit .

exponent

Nombres exponentiels desquels les valeurs de data doivent être élevées. Il peut s'agir d'une valeur constante, d'une colonne, d'une plage de cibles ou d'une expression convertie comme l'une de ces valeurs. Le nombre de colonnes dans exponent doit correspondre au nombre de colonnes dans base, à moins que base ne soit une constante. Pour la définition du format de exponent (identique à data), voir la section "Paramètres des fonctions macro" du chapitre du présent document correspondant à votre produit .

Description

POWER élève les valeurs de la première plage de données à la puissance spécifiée dans la deuxième plage de données (il calcule ). Il renvoie une nouvelle colonne pour chaque colonne d'entrée, chacune contenant le résultat de l'élévation de base à la puissance exponent (à savoir, la première colonne de data1 est élevée à la première colonne de data, la deuxième colonne à la deuxième colonne et ainsi de suite).

Si exponent est une constante, chaque valeur de base est élevée à cette valeur. Si exponent contient une ou plusieurs colonnes, les calculs sont effectués ligne par ligne, entre une colonne de base et une colonne de exponent. La première ligne de base est élevée à la première ligne de exponent, la seconde ligne, par la seconde ligne, etc. Ce calcul ligne par ligne génère un résultat pour chaque ligne jusqu'à la dernière valeur de la colonne la plus courte.

Remarque : L'opérateur POWER peut être abrégé en accent circonflexe (^). Par exemple, TEMP = 2^8 est identique à TEMP = 2 POWER 8.

Remarque : Si la valeur x est trop faible, une erreur de dépassement est renvoyée. Cela se produit si base^exponent dépasse la valeur à virgule flottante sur 32 bits maximale ou minimale.

Exemples


`TEMP = 2 POWER 3` ou `TEMP = 2^3` Crée une nouvelle colonne nommée `TEMP` contenant la valeur huit.
`TEMP = V1 ^ 0.5` Crée une colonne nommée `TEMP`, dans laquelle chaque valeur correspond à la racine carrée du contenu de la colonne `V1` (équivalent à `SQRT(V1)`).
`TEMP = V1 ^ V3` Crée une colonne nommée `TEMP`, dans laquelle chaque valeur est la valeur de ligne de la colonne `V1` élevée à la valeur de ligne correspondante de la colonne `V2`.
`TEMP = V1:V3 ^ V4:V6` Crée trois colonnes nommées `TEMP`, `VX` et `VY`. La colonne `TEMP` contient les valeurs de `V1` élevées aux valeurs de ligne correspondantes de la colonne `V4`. La colonne `VX` contient le résultat de la colonne `V2` élevée aux valeurs correspondantes dans la colonne `V5`. La colonne `VY` contient le résultat de la colonne `V3` élevée aux valeurs correspondantes dans la colonne `V6`.
`TEMP = V1[10:20] POWER V2` ou `TEMP = V1[10:20] POWER V2[1:11]` Crée une colonne nommée `TEMP`, dans laquelle les 11 premières cibles contiennent le résultat de l'élévation des valeurs des lignes 10 à 20 de la colonne `V1` par les valeurs des lignes 1 à 10 de la colonne `V2`. Les autres cibles de `TEMP` sont vides.

Fonctions associées


Fonction	Description
`EXP`	Calcule le nombre naturel (e) élevé à la puissance du contenu de chaque cible de la plage de données spécifiée
`LN` ou `LOG`	Calcule le logarithme naturel du contenu de la plage de données spécifiée
`LN2`	Calcule le logarithme base 2 du contenu de la plage de données spécifiée
`LN10`	Calcule le logarithme base 10 du contenu de la plage de données spécifiée