General Amplifier

Model nonlinear amplifier described by object or file data

Library:
RF Blockset / Equivalent Baseband / Amplifiers

Description

The General Amplifier block models the nonlinear amplifier described by a data source. The data source consists of either an RF Toolbox™ data (rfdata.data) object or data from a file.

Parameters

expand all

Main

`Data source` — Data source that describes the amplifier behavior
`Data file` (default) | `RFDATA` object

Data source that describes the amplifier behavior, specified as a Data file or an RFDATA object.

`Data file` — Name of file that contains amplifier data
`default.s2d` (default) | string | character vector

Name of file that contains the amplifier data, specified as a string or a character vector. The file name must include the extension. If the file is not in your MATLAB^® path, specify the full path to the file or click the Browse button to find the file.

Dependencies

To enable this parameter, choose Data file in Data source.

`RFDATA object` — RF data object that contains amplifier data
`read(rfdata.data, 'default.amp')` (default) | `rfdata.data` object

RF data object that contains the amplifier data, specified as an RF Toolbox rfdata.data object, an RF toolbox command that creates the rfdata.data object, or a MATLAB expression that generates such an object.

`Interpolation method` — Method to interpolate network parameters
`Linear` (default) | `Spline` | `Cubic`

Method to interpolate the network parameters, specified as one of the following:

Method	Description
`Linear`	Linear interpolation
`Spline`	Cubic spline interpolation
`Cubic`	Piecewise cubic Hermite interpolation

Noise Data

`Noise type` — Type of noise data
`Noise figure` (default) | `Spot noise data` | `Noise factor` | `Noise temperature`

Type of noise data, specified as one of the following:

Noise figure
Spot noise data
Noise factor
Noise temperature

This parameter is disabled if the data source contains noise data.

`Noise figure (dB)` — Available signal-to-noise ratio at the input to available signal-to-noise ratio at the output
`0` (default) | scalar ratio | vector of ratios

Available signal-to-noise ratio at the input to available signal-to-noise ratio at the output, specified as a scalar ratio or a vector of ratios.

Dependencies

To enable this parameter, select Noise figure in Noise type.

`Minimum noise figure` — Minimum ratio of available signal-to-noise ratio at input to available signal-to-noise ratio at output
`0` (default) | scalar ratio | vector of ratios

Minimum ratio of available signal-to-noise ratio at the input to available signal-to-noise ratio at the output, specified as a scalar ratio or a vector of ratios.

Dependencies

To enable this parameter, select Spot noise data in Noise type.

`Optimal reflection coefficient` — Optimal source impedance
`1+0i` (default) | complex scalar | complex vector

Optimal source impedance, specified as a complex scalar or a complex vector.

Dependencies

To enable this parameter, select Spot noise data in Noise type.

`Equivalent normalized noise resistance` — Normalized resistance values used to take noise measurement
`1` (default) | positive scalar | positive vector

Normalized resistance values used to take noise measurement, specified as a positive scalar or a positive vector.

Dependencies

To enable this parameter, select Spot noise data in Noise type.

`Noise factor` — Ratio of available signal-to-noise power at input to available signal-to-noise power at output
`1` (default) | scalar ratio | vector of ratios

Ratio of available signal-to-noise power at the input to available signal-to-noise power at the output, specified as a scalar ratio or a vector of ratios.

Dependencies

To enable this parameter, select Noise factor in Noise type.

`Noise temperature (K)` — Equivalent temperature that produces the same amount of noise as amplifier
`0` (default) | nonnegative scalar | nonnegative vector

Equivalent temperature that produces the same amount of noise as the amplifier, specified as a nonnegative scalar in kelvins or nonnegative vector with each element unit in kelvins.

Dependencies

To enable this parameter, select Noise temperature in Noise type.

`Frequency (Hz)` — Domain of frequencies to express noise data
`2.0e9` (default) | nonnegative scalar | nonnegative vector

Domain of frequencies to express noise data, specified as a nonnegative scalar in hertz or nonnegative vector with each element unit in hertz. If you provide a scalar value for your noise data, the block ignores the Frequency (Hz) parameter and uses the same noise data for all frequencies. If you provide a vector of values for your noise data, it must be the same size as the vector of frequencies. The block uses the Interpolation method specified in the Main tab to interpolate noise data.

Nonlinearity Data

`IP3 type` — Type of third order intercept
`OIP3` (default) | `IIP3`

Type of third order intercept, specified as OIP3 (output intercept point) or IIP3 (input intercept point). This parameter is disabled if the data source contains power data or IP3 data.

`IP3 (dBm)` — IP3 value
`inf` (default) | scalar | vector

IP3 value, specified as a scalar in dBm for frequency independent nonlinear data or a vector with each element unit in dBm for frequency dependent nonlinear data. This parameter is disabled if the data source contains power data or IP3 data.

`1dB gain compression power (dBm)` — Output power value at which gain has decreased by 1 dB
`inf` (default) | scalar | vector

Output power value ( $P_{1 d B, o u t}$ ) at which the gain has decreased by 1 dB, specified as a scalar in dBm for frequency independent nonlinear data or vector with each element unit in dBm for frequency dependent nonlinear data. This parameter is disabled if the data source contains power data or IP3 data.

`Output saturation power (dBm)` — Output power value that amplifier produces when fully saturated
`inf` (default) | scalar | vector

Output power value ( $P_{s a t, o u t}$ ) that the amplifier produces when fully saturated, specified as a scalar in dBm for frequency independent nonlinear data or a vector with each element unit in dBm for frequency dependent nonlinear data. This parameter is disabled if the data source contains output saturation power data.

`Gain compression at saturation (dB)` — Decrease in gain value
`3` (default) | scalar | vector

Decrease in gain value ( $G C_{s a t}$ ) when the power is fully saturated, specified as a scalar in dB for frequency independent nonlinear data or a vector with each element unit in dB for frequency dependent nonlinear data.

`Frequency (Hz)` — Frequency points corresponding to third-order intercept or power data
`2.0e9` (default) | positive scalar | positive vector

Frequency points corresponding to third-order intercept or power data, specified as a positive scalar or positive vector in units of hertz. This parameter is disabled if the data source contains power data or IP3 data.

Dependencies

If you specify the frequency as a scalar, then the IP3 (dBm), 1 dB gain compression power (dBm), and Output saturation power (dBm) parameters must all be scalars.
If you specify the frequency as a vector, then or more of the IP3 (dBm), 1 dB gain compression power (dBm), and Output saturation power (dBm) parameters must also be a vector.

Visualization

`Source of frequency data` — Frequency data source
`Extracted from data source` (default) | `User-specified`

Frequency data source, specified as Extracted from data source or User-specified.

`Frequency data` — Frequency data range
`[1e9:1e8:2.9e9]` (default) | vector

Frequency data range, specified as a vector with each element unit in hertz.

`Reference impedance (ohms)` — Reference impedance
`50` (default) | nonnegative scalar

Reference impedance, specified as a nonnegative scalar in ohms.

`Plot type` — Type of data plot
`X-Y plane` (default) | `Composite data` | `Polar plane` | `Z Smith chart` | `Y Smith chart` | `ZY Smith chart`

Type of data plot to visualize using the given data, specified as one of the following:

X-Y plane — Generate a Cartesian plot of the data versus frequency. To create linear, semilog, or log-log plots, set the Y-axis scale and X-axis scale accordingly.
Composite data — Plot the composite data.
Polar plane — Generate a polar plot of the data. The block plots only the range of data corresponding to the specified frequencies.
Z smith chart, Y smith chart, and ZY smith chart — Generate a Smith^® chart. The block plots only the range of data corresponding to the specified frequencies.

`Y parameter1` — Type of parameters to plot
`S11` (default) | `S12` | `S21` | `S22` | `GroupDelay` | `OIP3` | `IIP3` | `NF` | ...

Type of S-Parameters to plot, specified as one of the following. When noise is spectral, NF plotting is possible.

`S11`	`S12`	`S21`	`S22`
`GroupDelay`	`GammaIn`	`GammaOut`	`VSWRIn`
`VSWROut`	`OIP3`	`IIP3`	`NF`
`NFactor`	`NTemp`	`TF1`	`TF2`
`TF3`	`Gt`	`Ga`	`Gp`
`Gmag`	`Gmsg`	`GammaMS`	`GammaML`
`K`	`Delta`	`Mu`	`MuPrime`

`Y parameter2` — Type of parameters to plot
`S11` (default) | `S12` | `S21` | `S22` | `GroupDelay` | `OIP3` | `IIP3` | `NF` | ...

Type of S-Parameters to plot, specified as one of the following. When noise is spectral, NF plotting is possible.

`S11`	`S12`	`S21`	`S22`
`GroupDelay`	`GammaIn`	`GammaOut`	`VSWRIn`
`VSWROut`	`OIP3`	`IIP3`	`NF`
`NFactor`	`NTemp`	`TF1`	`TF2`
`TF3`	`Gt`	`Ga`	`Gp`
`Gmag`	`Gmsg`	`GammaMS`	`GammaML`
`K`	`Delta`	`Mu`	`MuPrime`

`Y format1` — Plot format
`Magnitude (decibels)` (default) | `Abs` | `Mag` | `Magnitude (linear)` | `Angle` | `Real` | `Imaginary` | ...

Plot format, specified as one of the following.

`dB`	`Magnitude (decibels)`	`Abs`	`Mag`
`Magnitude (linear)`	`Angle`	`Angle(degrees)`	`Angle(radians)`
`Real`	`Imag`	`Imaginary`

`Y format2` — Plot format
`Magnitude (decibels)` (default) | `Abs` | `Mag` | `Magnitude (linear)` | `Angle` | `Real` | `Imaginary` | ...

Plot format, specified as one of the following.

`dB`	`Magnitude (decibels)`	`Abs`	`Mag`
`Magnitude (linear)`	`Angle`	`Angle(degrees)`	`Angle(radians)`
`Real`	`Imag`	`Imaginary`

`X parameter` — Frequency plot
`Freq` (default)

Frequency plot, specified as Freq.

`X format` — Frequency plot format
`Hz` (default) | `Auto` | `kHz` | `MHz` | `GHz` | `THz`

Frequency plot format, specified as one of the following.

`Auto`	`Hz`	`kHz`	`MHz`
`GHz`	`THz`

`Y scale` — Y-axis scale
`Linear` (default) | `Log`

Y-axis scale, specified as Linear or Log.

`X scale` — X-axis scale
`Linear` (default) | `Log`

X-axis scale, specified as Linear or Log.

`Plot` — Plot specified data
button

Plot specified data using the plot button.

More About

expand all

Network Parameters

If network parameter data and corresponding frequencies exist as S-parameters in the data source, the General Amplifier block interpolates the S-parameters to determine their values at the modeling frequencies. If the network parameters are Y- or Z-parameters, the block first converts them to S-parameters. For more information, see Map Network Parameters to Modeling Frequencies.

Nonlinearity

If power data exists in the data source, the block extracts the AMAM/AMPM nonlinearities from the power data.

If the data source contains no power data, then you can introduce nonlinearities into your model by specifying parameters in the Nonlinearity Data tab of the General Amplifier block dialog box. Depending on which of these parameters you specify, the block computes up to four of the coefficients $c_{1}$ , $c_{3}$ , $c_{5}$ , and $c_{7}$ of the polynomial

$F_{A M / A M} (s) = c_{1} s + c_{3} {| s |}^{2} s + c_{5} {| s |}^{4} s + c_{7} {| s |}^{6} s$

that determines the AM/AM conversion for the input signal $s$ . The block automatically calculates $c_{1}$ , the linear gain term. If you do not specify additional nonlinearity data, the block operates as a linear amplifier. If you do, the block calculates one or more of the remaining coefficients as the solution to a system of linear equations, determined by the following method.

The block checks whether you have specified a value other than Inf for:
- The third-order intercept point ( $O I P 3$ or $I I P 3$ ).
- The output power at the 1-dB compression point ( $P_{1 d B, o u t}$ ).
- The output power at saturation ( $P_{s a t, o u t}$ ).
In addition, if you have specified $P_{s a t, o u t}$ , the block uses the value for the gain compression at saturation ( $G C_{s a t}$ ). Otherwise, $G C_{s a t}$ is not used. You define each of these parameters in the block dialog box, on the Nonlinearity Data tab.
The block calculates a corresponding input or output value for the parameters you have specified. In units of dB and dBm,

$\begin{matrix} P_{s a t, o u t} + G C_{s a t} = P_{s a t, i n} + G_{l i n} \\ P_{1 d B, o u t} + 1 = P_{1 d B, i n} + G_{l i n} \\ O I P 3 = I I P 3 + G_{l i n} \end{matrix}$
where $G_{l i n}$ is $c_{1}$ in units of dB.
The block formulates the coefficients $c_{3}$ , $c_{5}$ , and $c_{7}$ , where applicable, as the solutions to a system of one, two, or three linear equations. The number of equations used is equal to the number of parameters you provide. For example, if you specify all three parameters, the block formulates the coefficients according to the following equations:

$\begin{matrix} \sqrt{P_{s a t, o u t}} = c_{1} \sqrt{P_{s a t, i n}} + c_{3} {(\sqrt{P_{s a t, i n}})}^{3} + c_{5} {(\sqrt{P_{s a t, i n}})}^{5} + c_{7} {(\sqrt{P_{s a t, i n}})}^{7} \\ \sqrt{P_{1 d B, o u t}} = c_{1} \sqrt{P_{1 d B, i n}} + c_{3} {(\sqrt{P_{1 d B, i n}})}^{3} + c_{5} {(\sqrt{P_{1 d B, i n}})}^{5} + c_{7} {(\sqrt{P_{1 d B, i n}})}^{7} \\ 0 = \frac{c_{1}}{I I P 3} + c_{3} \end{matrix}$
The first two equations are the evaluation of the polynomial $F_{A M / A M} (s)$ at the points $(\sqrt{P_{s a t, i n}}, \sqrt{P_{s a t, o u t}})$ and $(\sqrt{P_{1 d B, i n}}, \sqrt{P_{1 d B, o u t}})$ , expressed in linear units (such as W or mW) and normalized to a 1-Ω impedance. The third equation is the definition of the third-order intercept point.
The calculation omits higher-order terms according to the available degrees of freedom of the system. If you specify only two of the three parameters, the block does not use the equation involving the parameter you did not specify, and eliminates any $c_{7}$ terms from the remaining equations. Similarly, if you provide only one of the parameters, the block uses only the solution to the equation involving that parameter and omits any $c_{5}$ or $c_{7}$ terms.

If you provide vectors of nonlinearity and frequency data, then the block calculates the polynomial coefficients using values for the parameters interpolated at the center frequency.

Active Noise

You can specify active block noise in one of the following ways:

Spot noise data in the data source.
Spot noise data in the block dialog box.
Spot noise data object in the block dialog box.
Noise figure, noise factor, or noise temperature value in the block dialog box.
Frequency-dependent noise figure data (rfdata.nf) object in the block dialog box.

The latter four options are only available if noise data does not exist in the data source.

If you specify block noise as spot noise data, the block uses the data to calculate noise figure. The block first interpolates the noise data for the modeling frequencies, using the specified Interpolation method. It then calculates the noise figure using the resulting values.

Operating Conditions

Agilent^® P2D and S2D files define block parameters for several operating conditions. Operating conditions are the independent parameter settings that are used when creating the file data. By default, RF Blockset™ Equivalent Baseband software defines the block behavior using the parameter values that correspond to the operating conditions that appear first in the file. To use other property values, you must select a different operating condition in the General Amplifier block dialog box.

Data Consistency

If the data source is a MathWorks™ AMP file or an Agilent S2D file that contains both network parameter data and power data, the blockset checks the data for consistency and reconciles it as necessary.

The blockset compares the small-signal amplifier gain defined by the network parameters, S₂₁, and by the power data, P_out-P_in. The discrepancy between the two is computed in dBm using the following equation:

$\begin{matrix} Δ P = S_{21} (f_{P}) - P_{o u t} (f_{P}) + P_{i n} (f_{P}) & (d B m) \end{matrix}$

where f_P is the lowest frequency for which power data is specified.

If ΔP is more than 0.4 dB, a warning appears, and the blockset adds ΔP to the output power values at each specified input power value to resolve the discrepancy for simulation. The following graph shows this discrepancy.

Documentation

General Amplifier

Description

Parameters

Main

Data source — Data source that describes the amplifier behavior Data file (default) | RFDATA object

Data file — Name of file that contains amplifier data default.s2d (default) | string | character vector

Dependencies

RFDATA object — RF data object that contains amplifier data read(rfdata.data, 'default.amp') (default) | rfdata.data object

Interpolation method — Method to interpolate network parameters Linear (default) | Spline | Cubic

Noise Data

Noise type — Type of noise data Noise figure (default) | Spot noise data | Noise factor | Noise temperature

Noise figure (dB) — Available signal-to-noise ratio at the input to available signal-to-noise ratio at the output 0 (default) | scalar ratio | vector of ratios

Dependencies

Minimum noise figure — Minimum ratio of available signal-to-noise ratio at input to available signal-to-noise ratio at output 0 (default) | scalar ratio | vector of ratios

Dependencies

Optimal reflection coefficient — Optimal source impedance 1+0i (default) | complex scalar | complex vector

Dependencies

Equivalent normalized noise resistance — Normalized resistance values used to take noise measurement 1 (default) | positive scalar | positive vector

Dependencies

Noise factor — Ratio of available signal-to-noise power at input to available signal-to-noise power at output 1 (default) | scalar ratio | vector of ratios

Dependencies

Noise temperature (K) — Equivalent temperature that produces the same amount of noise as amplifier 0 (default) | nonnegative scalar | nonnegative vector

Dependencies

Frequency (Hz) — Domain of frequencies to express noise data 2.0e9 (default) | nonnegative scalar | nonnegative vector

Nonlinearity Data

IP3 type — Type of third order intercept OIP3 (default) | IIP3

IP3 (dBm) — IP3 value inf (default) | scalar | vector

1dB gain compression power (dBm) — Output power value at which gain has decreased by 1 dB inf (default) | scalar | vector

Output saturation power (dBm) — Output power value that amplifier produces when fully saturated inf (default) | scalar | vector

Gain compression at saturation (dB) — Decrease in gain value 3 (default) | scalar | vector

Frequency (Hz) — Frequency points corresponding to third-order intercept or power data 2.0e9 (default) | positive scalar | positive vector

Dependencies

Visualization

Source of frequency data — Frequency data source Extracted from data source (default) | User-specified

Frequency data — Frequency data range [1e9:1e8:2.9e9] (default) | vector

Reference impedance (ohms) — Reference impedance 50 (default) | nonnegative scalar

Plot type — Type of data plot X-Y plane (default) | Composite data | Polar plane | Z Smith chart | Y Smith chart | ZY Smith chart

Y parameter1 — Type of parameters to plot S11 (default) | S12 | S21 | S22 | GroupDelay | OIP3 | IIP3 | NF | ...

Y parameter2 — Type of parameters to plot S11 (default) | S12 | S21 | S22 | GroupDelay | OIP3 | IIP3 | NF | ...

Y format1 — Plot format Magnitude (decibels) (default) | Abs | Mag | Magnitude (linear) | Angle | Real | Imaginary | ...

Y format2 — Plot format Magnitude (decibels) (default) | Abs | Mag | Magnitude (linear) | Angle | Real | Imaginary | ...

X parameter — Frequency plot Freq (default)

X format — Frequency plot format Hz (default) | Auto | kHz | MHz | GHz | THz

Y scale — Y-axis scale Linear (default) | Log

X scale — X-axis scale Linear (default) | Log

Plot — Plot specified data button

More About

Network Parameters

Nonlinearity

Active Noise

Operating Conditions

Data Consistency

See Also

Topics

RF Blockset Documentation

Support

`Data source` — Data source that describes the amplifier behavior
`Data file` (default) | `RFDATA` object

`Data file` — Name of file that contains amplifier data
`default.s2d` (default) | string | character vector

`RFDATA object` — RF data object that contains amplifier data
`read(rfdata.data, 'default.amp')` (default) | `rfdata.data` object

`Interpolation method` — Method to interpolate network parameters
`Linear` (default) | `Spline` | `Cubic`

`Noise type` — Type of noise data
`Noise figure` (default) | `Spot noise data` | `Noise factor` | `Noise temperature`

`Noise figure (dB)` — Available signal-to-noise ratio at the input to available signal-to-noise ratio at the output
`0` (default) | scalar ratio | vector of ratios

`Minimum noise figure` — Minimum ratio of available signal-to-noise ratio at input to available signal-to-noise ratio at output
`0` (default) | scalar ratio | vector of ratios

`Optimal reflection coefficient` — Optimal source impedance
`1+0i` (default) | complex scalar | complex vector

`Equivalent normalized noise resistance` — Normalized resistance values used to take noise measurement
`1` (default) | positive scalar | positive vector

`Noise factor` — Ratio of available signal-to-noise power at input to available signal-to-noise power at output
`1` (default) | scalar ratio | vector of ratios

`Noise temperature (K)` — Equivalent temperature that produces the same amount of noise as amplifier
`0` (default) | nonnegative scalar | nonnegative vector

`Frequency (Hz)` — Domain of frequencies to express noise data
`2.0e9` (default) | nonnegative scalar | nonnegative vector

`IP3 type` — Type of third order intercept
`OIP3` (default) | `IIP3`

`IP3 (dBm)` — IP3 value
`inf` (default) | scalar | vector

`1dB gain compression power (dBm)` — Output power value at which gain has decreased by 1 dB
`inf` (default) | scalar | vector

`Output saturation power (dBm)` — Output power value that amplifier produces when fully saturated
`inf` (default) | scalar | vector

`Gain compression at saturation (dB)` — Decrease in gain value
`3` (default) | scalar | vector

`Frequency (Hz)` — Frequency points corresponding to third-order intercept or power data
`2.0e9` (default) | positive scalar | positive vector

`Source of frequency data` — Frequency data source
`Extracted from data source` (default) | `User-specified`

`Frequency data` — Frequency data range
`[1e9:1e8:2.9e9]` (default) | vector

`Reference impedance (ohms)` — Reference impedance
`50` (default) | nonnegative scalar

`Plot type` — Type of data plot
`X-Y plane` (default) | `Composite data` | `Polar plane` | `Z Smith chart` | `Y Smith chart` | `ZY Smith chart`

`Y parameter1` — Type of parameters to plot
`S11` (default) | `S12` | `S21` | `S22` | `GroupDelay` | `OIP3` | `IIP3` | `NF` | ...

`Y parameter2` — Type of parameters to plot
`S11` (default) | `S12` | `S21` | `S22` | `GroupDelay` | `OIP3` | `IIP3` | `NF` | ...

`Y format1` — Plot format
`Magnitude (decibels)` (default) | `Abs` | `Mag` | `Magnitude (linear)` | `Angle` | `Real` | `Imaginary` | ...

`Y format2` — Plot format
`Magnitude (decibels)` (default) | `Abs` | `Mag` | `Magnitude (linear)` | `Angle` | `Real` | `Imaginary` | ...

`X parameter` — Frequency plot
`Freq` (default)

`X format` — Frequency plot format
`Hz` (default) | `Auto` | `kHz` | `MHz` | `GHz` | `THz`

`Y scale` — Y-axis scale
`Linear` (default) | `Log`

`X scale` — X-axis scale
`Linear` (default) | `Log`

`Plot` — Plot specified data
button