Convertit un signal d'amplitude ou de puissance en décibels.
Syntaxe
dB(DataSet [ , le SignalType Variable DB_POWER + DB_NORMALIZE ])
ou
dB(DataSet, le Reference, le 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. Pour les amplitudes, on multiplie par la valeur 20 après logarithme et pour les puissances par la valeur 10. Le facteur 10 résulte de l'unité décibel, qui signifie dixième de bel. Le facteur supplémentaire 2 pour les amplitudes correspond à une quadrature des amplitudes avant le logarithme, 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.
Le cas échéant, il faut d'abord normaliser, puis calculer la fonction logarithme réel en base 10 et enfin multiplier par la valeur 20 ou 10. Si vous n'indiquez pas de valeur de référence et que vous ne choisissez pas non plus de normalisation à la valeur maximale ou si vous choisissez une valeur individuelle DataSet est une valeur unique, cela correspond à une normalisation à la valeur 1 dans l'unité de DataSet. DataSet doit être positive. Pour chaque valeur négative DataSet, la fonction renvoie une valeur invalide (void). Le résultat est du type de données à 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. |