dB (FPScript)
Convertit un signal d'amplitude ou de puissance en décibels.
Syntaxe
dB(DataSet [ , SignalType = DB_POWER + DB_NORMALIZE ])
ou
dB(DataSet, Reference, SignalType)
La syntaxe de la fonction dB se compose des éléments suivants :
Section |
Description |
||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
DataSet |
Les données à convertir en décibels. Toutes les structures de données sont autorisées. Tous les types de données numériques sont autorisés, à l'exception de Temps calendaire et Période de temps. 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. |
||||||||||
Reference |
Une valeur de référence par laquelle toutes les valeurs de DataSet sont divisés avant la logarithmisation. 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 DataSet . 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é. |
||||||||||
SignalType |
Précise si les données doivent être interprétées en termes d'amplitude ou de puissance. Après logarithmisation, la valeur 20 est multipliée pour les amplitudes et la valeur 10 est multipliée pour les puissances. Le facteur 10 est le résultat de l'unité décibel, qui est un dixième de bel. Le facteur supplémentaire de 2 pour les amplitudes correspond à une élévation au carré des amplitudes avant la logarithmisation, qui est nécessaire pour former la puissance du signal à partir de l'amplitude. L'argument SignalType peut avoir les valeurs suivantes :
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 DB_POWER + DB_NORMALIZE . |
Remarques
Le résultat a la même structure que l'argument DataSet, si nécessaire, le calcul est effectué élément par élément.
Le résultat a l'unité dB.
Si nécessaire, elle est d'abord normalisée, puis la fonction logarithme réel est calculée en base 10 et enfin multipliée par la valeur 20 ou 10. Si vous ne spécifiez pas de valeur de référence et ne choisissez pas la normalisation à la valeur maximale, ou si DataSet est une valeur scalaire, alors cela correspond à une normalisation à la valeur 1 dans l'unité de DataSetDataSet doit être positif. Pour chaque valeur négative de DataSet la fonction renvoie une valeur invalide. Le résultat est du type de données valeur à virgule flottante de 64 bits.
Disponible dans
FlexPro View, Basic, Professional, Developer Suite
Exemples
dB(1) |
Renvoie 0. |
dB(10) |
Renvoie 10. |
dB(10, DB_AMPLITUDE) |
Renvoie 20. |
dB(-1) |
Renvoie ?. |
dB(FFTn(Signal), DB_AMPLITUDE + DB_NORMALIZE) |
Calcule un spectre de magnitude en dB normalisé à 0 dB. |
dB(PSD, PSDRef, DB_POWER) |
Calcule un spectre de densité de puissance en dB normalisé à la valeur PSDRef. |