StraightLine (FPScript)
Établit une équation de ligne droite basée sur l'intersection et la pente Y ou sur deux paires de valeurs XY et l'évalue aux positions X spécifiées.
Syntaxe
StraightLine(X, b, m)
ou
StraightLine(X, Y1, X1, Y2, X2)
La syntaxe de la fonction StraightLine se compose des éléments suivants :
Section |
Description |
|---|---|
X |
Les valeurs X pour lesquelles la ligne droite doit être évaluée. Toutes les structures de données sont autorisées. Tous les types de données numériques sont autorisés. Pour les types de données complexes, un nombre est formé. Si l'argument est une liste, alors la fonction est exécutée pour chaque élément de la liste et le résultat est également une liste. |
b |
C'est l'intersection de la ligne droite avec l'axe des y. Les structures de données autorisées sont Scalaire. Tous les types de données numériques sont autorisés. Si l'argument est une liste, alors son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété. |
m |
La pente de la ligne droite. L'unité doit être compatible pour les quotients de l'unité de b et X. Les structures de données autorisées sont Scalaire. Tous les types de données numériques sont autorisés. Si l'argument est une liste, alors son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété. |
Y1 |
La valeur Y du premier point par lequel la ligne droite doit passer. Les structures de données autorisées sont Scalaire. Tous les types de données numériques sont autorisés. Si l'argument est une liste, alors son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété. |
X1 |
La valeur X du premier point par lequel la ligne droite doit passer. Les structures de données autorisées sont Scalaire. Tous les types de données numériques sont autorisés. L'unité doit être compatible avec celle du paramètre X . Si l'argument est une liste, alors son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété. |
Y2 |
La valeur Y du deuxième point par lequel la ligne droite doit passer. Les structures de données autorisées sont Scalaire. Tous les types de données numériques sont autorisés. L'unité doit être compatible avec celle du paramètre Y1 . Si l'argument est une liste, alors son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété. |
X2 |
La valeur X du deuxième point par lequel la ligne droite doit passer. Les structures de données autorisées sont Scalaire. Tous les types de données numériques sont autorisés. L'unité doit être compatible avec celle du paramètre X1 . Si l'argument est une liste, alors son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété. |
Remarques
Le type de données du résultat est toujours Virgule flottante de 64 bits.
La structure du résultat correspond à celle de l'argument X, si nécessaire, le calcul est effectué élément par élément.
La première variante de la StraightLine utilise la forme des coordonnées de l'équation de la ligne droite : Y = m*Xb. La deuxième variante calcule la ligne droite à partir de la forme à deux points : Y = Y1 + (Y2 - Y1) / (X2 - X1) * (X - X1).
Pour les structures de données composées, seule la composante Y est prise en compte et la composante X ou, le cas échéant, Z est copiée dans le résultat sans modification.
Disponible dans
FlexPro Basic, Professional, Developer Suite
Exemples
Dim x = Series(0 s, 10 s, 1 ms) |
Génère une ligne droite avec une fréquence d'échantillonnage de 1 kHz dans la plage X de 0 s à 10 s avec une interception Y de -1 V et un gradient de 3 V/s. |
Dim x = Series(0 s, 10 s, 1 ms) |
Calcule la ligne droite du premier exemple à partir de la forme en deux points de l'équation de la ligne droite. |