Convierte una señal de amplitud o potencia en decibelios.
Sintaxis
dB(DataSet [ , SignalType = DB_POWER + DB_NORMALIZE ])
o
dB(DataSet, Reference, SignalType)
La sintaxis de la función dB consta de los siguientes elementos:
Parte |
Descripción |
||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
DataSet |
Los datos que deben convertirse a decibelios. Todas las estructuras de datos están permitidas. Se permiten todos los tipos de datos numéricos excepto Tiempo de calendario y Intervalo de tiempo. En los tipos de datos complejos se calcula un valor absoluto. Si el argumento es una lista, la función se ejecuta para cada elemento de la lista y el resultado también es una lista. |
||||||||||
Reference |
Valor de referencia por el que se dividen todos los valores de DataSet antes de la logaritmización. Las estructuras de datos permitidas son Valor escalar. Se permiten todos los tipos de datos numéricos. La unidad debe ser compatible con la del parámetro DataSet. En los tipos de datos complejos se calcula un valor absoluto. Si el argumento es una lista, se toma su primer elemento. Si se trata de nuevo de una lista, se repite el proceso. |
||||||||||
SignalType |
Especifica si los datos deben interpretarse como amplitud o potencia. Para amplitudes, después de la logaritmización, se multiplica por el valor 20, y para potencias, por el valor 10. El factor 10 se deriva de la unidad decibelio, que significa décima parte de bel. El factor adicional 2 para las amplitudes corresponde a una cuadratura de las amplitudes antes de la logaritmización, necesaria para formar la potencia de la señal a partir de la amplitud. El argumento SignalType puede tener los siguientes valores:
Si el argumento es una lista, se toma su primer elemento. Si se trata de nuevo de una lista, se repite el proceso. Se establece el valor predeterminado DB_POWER + DB_NORMALIZE si no se especifica el argumento. |
Notas
El resultado tiene la misma estructura que el argumento DataSet, si es necesario, el cálculo se realiza elemento por elemento.
El resultado tiene la unidad dB.
Si es necesario, primero se normaliza, después se calcula la función logaritmo real en base 10 y, por último, se multiplica por el valor 20 o 10. Si no especifica ningún valor de referencia y tampoco selecciona una normalización respecto al valor máximo, o si DataSet es un valor escalar, entonces esto corresponde a la normalización al valor 1 en la unidad de DataSet. DataSet debe ser positivo. Por cada valor negativo de DataSet la función devuelve un valor inválido. El resultado tiene entonces el tipo de datos número en coma flotante de 64 bits.
Disponibilidad
FlexPro View, Basic, Professional, Developer Suite
Ejemplos
dB(1) |
Devuelve 0. |
dB(10) |
Devuelve 10. |
dB(10, DB_AMPLITUDE) |
Devuelve 20. |
dB(-1) |
Devuelve ?. |
dB(FFTn(Signal), DB_AMPLITUDE + DB_NORMALIZE) |
Calcula un espectro de magnitud normalizado a 0 dB en dB. |
dB(PSD, PSDRef, DB_POWER) |
Calcula un espectro de densidad de potencia normalizado al valor PSDRef en dB. |