Sample (FPScript)
Échantillonne un signal en utilisant l'interpolation linéaire.
Syntaxe
Sample(Signal, X [ , Extrapolate = FALSE ])
ou
Sample(Amplitude, Time, X [ , Extrapolate = FALSE ])
La syntaxe de la fonction Sample se compose des éléments suivants :
Section |
Description |
|---|---|
Signal |
L'ensemble de données à échantillonner. Les structures de données autorisées sont Séries de données, Matrice de données, Signal et Série de signaux. 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. |
Amplitude |
La composante Y du signal à échantillonner. Si vous spécifiez un signal, alors sa composante Y est utilisée. Les structures de données autorisées sont Séries de données, Matrice de données, Signal et Série de signaux. 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 son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété. |
Time |
La composante X du signal à échantillonner. Si vous spécifiez un signal, alors sa composante Y est utilisée. Les structures de données autorisées sont Séries de données et Signal. 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é. |
X |
Une valeur scalaire ou une série de données avec les valeurs X, à laquelle le signal doit être échantillonné, ou un signal ou une série de signaux à transformer en utilisant la courbe caractéristique spécifiée comme premier argument. Les structures de données autorisées sont Scalaire, Séries de données, Matrice de données, Signal et Série de signaux. 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é. |
Extrapolate |
La valeur TRUE précise que le signal à échantillonner doit être extrapolé linéairement sur les bords. Les structures de données autorisées sont Scalaire. Les types de données pris en charge sont Valeur booléenne. 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é. Si l'argument n'est pas spécifié, il est défini à la valeur par défaut FALSE . |
Remarques
Le résultat est toujours du type de données Virgule flottante de 64 bits.
Les applications typiques de cette fonction sont l'adaptation des taux d'échantillonnage de deux signaux, l'échantillonnage d'un signal à X positions, où il n'y a pas de point d'échantillonnage, et la transformation d'un signal par une courbe caractéristique spécifiée comme un ensemble de données.
Si les valeurs X spécifiées ne correspondent pas exactement à un point d'échantillonnage du signal, une interpolation linéaire aura lieu. Pour les valeurs X qui se situent avant la première ou après la dernière valeur X du signal, le résultat dépend de l'argument Extrapolate. Si cette valeur est FALSE, une valeur invalide (void) est passée comme résultat ; sinon, une extrapolation linéaire est effectuée en utilisant le premier et le dernier point dans Signal.
Si X a été spécifié comme une valeur scalaire, le résultat est également une valeur scalaire. Sinon, la variante avec deux arguments, ou si X est un signal, renvoie un signal, et la variante avec trois arguments renvoie une série de données comme résultat.
Disponible dans
FlexPro Basic, Professional, Developer Suite
Exemples
Sample(Signal, 1.5 s) |
Évalue un signal à la position X=1,5 s. |
Sample(Signal2, Signal1.x) |
Ajuste le taux d'échantillonnage de "Signal2" à celui de "Signal1". |
Sample(CharacteristicCurve, Signal) |
Transforme un signal à l'aide d'une courbe caractéristique. |