Documentation

This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English verison of the page.

Note: This page has been translated by MathWorks. Please click here
To view all translated materals including this page, select Japan from the country navigator on the bottom of this page.

db

Convert energy or power measurements to decibels

Syntax

dboutput = db(x)
dboutput = db(x,SignalType)
dboutput = db(x,R)
dboutput = db(x,'voltage',R)

Description

dboutput = db(x) converts the elements of x to decibels (dB). This syntax assumes that x contains voltage measurements across a resistance of 1 Ω.

dboutput = db(x,SignalType) specifies the signal type represented by the elements of x as either 'voltage' or 'power'.

example

dboutput = db(x,R) specifies the resistance, R, for voltage measurements.

dboutput = db(x,'voltage',R) is equivalent to db(x,R).

Examples

collapse all

Express a unit voltage in decibels. Assume that the resistance is 2 ohms. Compare the answer to the definition, .

V = 1;
R = 2;
dboutput = db(V,2);
compvoltage = [dboutput 10*log10(1/2)]
compvoltage = 

   -3.0103   -3.0103

Convert a vector of power measurements to decibels. Compare the answer to the result of using the definition.

rng default
X = abs(rand(10,1));
dboutput = db(X,'power');
comppower = [dboutput 10*log10(X)]
comppower = 

   -0.8899   -0.8899
   -0.4297   -0.4297
   -8.9624   -8.9624
   -0.3935   -0.3935
   -1.9904   -1.9904
  -10.1082  -10.1082
   -5.5518   -5.5518
   -2.6211   -2.6211
   -0.1886   -0.1886
   -0.1552   -0.1552

Input Arguments

collapse all

Signal measurements, specified as a scalar, vector, matrix, or N-D array.

Data Types: single | double
Complex Number Support: Yes

Type of signal measurements, specified as either 'voltage' or 'power'. If you specify SignalType as 'power', then all elements of x must be nonnegative.

Data Types: char

Resistive load, specified as a positive scalar expressed in ohms. This argument is ignored if you specify SignalType as 'power'.

Data Types: single | double

Output Arguments

collapse all

Energy or power measurements in decibels, returned as an array with the same dimensions as x.

  • If x contains voltage measurements, then dboutput is 10log10(|x|2/R).

  • If the input x contains power measurements, then dboutput is 10log10x.

See Also

| | |

Introduced in R2011b

Was this topic helpful?