Main Content

attenuator

Create two-port attenuator element

    Description

    Use the attenuator object to attenuate the signal power by the insertion loss or attenuation factor that you specify. You can also use the attenuator object to compute attenuation in cascaded stages using an rfbudget object or the RF Budget Analyzer app.

    Creation

    Description

    att = attenuator creates a default attenuator object with the attenuation of 3 dB.

    example

    att = attenuator(Name,Value) sets Properties of the attenuator object using one or more name-value arguments. For example, att = attenuator('Attenuation',3.2) creates an attenuator object with attenuation set to 3.2 dB. Properties you do not specify retain their default values.

    Properties

    expand all

    Name of the attenuator element, specified as a string scalar or a character vector.

    Example: att = attenuator('Name','Attenuator1') creates an attenuator element called Attenuator1.

    Insertion loss or attenuation applied to the signal, specified as a scalar in dB.

    Example: att = attenuator('Attenuation',20) creates a 20 dB attenuator element.

    Input impedance of the attenuator element, specified as a positive scalar in ohms.

    Example: att = attenuator('Zin',200) creates an attenuator element with the input impedance of 200 ohms.

    Output impedance of the attenuator element, specified as a positive scalar in ohms.

    Example: att = attenuator('Zout',200) creates an attenuator element with the output impedance of 200 ohms.

    This property is read-only.

    Number of input and output ports in attenuator element, returned as a positive scalar.

    This property is read-only.

    Terminals of the attenuator element, returned as a cell array.

    Object Functions

    sparametersS-parameter object

    Examples

    collapse all

    Design an attenuator element to reduce the amplitude level of an audio signal by 18 dB while matching the impedance of a network of 600 ohms.

    att = attenuator('Attenuation',18,'Zin',600,'Zout',600);

    Calculate the S-parameters of the attenuator element at 3 KHz.

    spar = sparameters(att,3e3)
    spar = 
      sparameters: S-parameters object
    
           NumPorts: 2
        Frequencies: 3000
         Parameters: [2x2 double]
          Impedance: 50
    
      rfparam(obj,i,j) returns S-parameter Sij
    
    
    Introduced in R2021a