<< cummin | FOSSEE_Signal_Processing_Toolbox | db2pow >>

FOSSEE_Signal_Processing_Toolbox >> FOSSEE_Signal_Processing_Toolbox > db

# db

Converts the elements of the vector or matrix X to decibels (dB

### Syntax

    [dboutput] = db(X)
    [dboutput] = db(X, SignalType)
    [dboutput] = db(X, R)
    [dboutput] = db(X, 'voltage', R)

### Parameters

X:

  Signal measurements. X must be a vector or matrix. If the elements of X are power measurements, all elements must be nonnegative.

SignalType:

  Type of signal measurements. Valid entries for SignalType are 'voltage' or 'power'. The entries are not case sensitive. If you specify SignalType as 'power', the elements of X must be nonnegative. Default: 'voltage'

R:

  Resistive load in ohms. You can specify resistance only when the SignalType is 'voltage'. Default: 1

dboutput:

  The elements of the vector or matrix X converted to decibels (dB). The elements of X are voltage measurements across a resistance of 1 ohm.

### Description

dboutput = db(X) converts the elements of the vector or matrix X to decibels (dB). The elements of X are voltage measurements across a resistance of 1 ohm. dboutput = db(X,SignalType) specifies the signal type represented by the elements of X as 'voltage' or 'power'. The entries are not case sensitive. The default value is 'voltage'. For voltage measurements, the resistance defaults to 1 ohm. If you specify SignalType as 'power', the elements of X must be nonnegative. dboutput = db(X,R) specifies the resistance R for voltage measurements. You can specify a resistance only when the signal measurements are voltages. dboutput = db(X,'voltage',R) specifies the resistance R for voltage measurements. This syntax is equivalent to db(X,R).

### Examples

    // Convert voltage measurements to decibels
    X = [1, 2; 3, 4] // Voltage measurements
    SignalType = 'voltage'
    R = 2 // Resistance in ohms
    dboutput = db(X, SignalType, R)

### Authors

- Pratik Kapoor

Report an issue
<< cummin | FOSSEE_Signal_Processing_Toolbox | db2pow >>