Engee documentation

Amplifier

A complex main bandwidth amplifier model with noise and nonlinearities.

amplifier

Description

The Amplifier block is a comprehensive main band amplifier model with thermal noise. This block includes four nonlinearity models and three options for specifying the noise representation.

Ports

Input

# In — baseband signal
real scalar | real column | complex scalar | complex column

Details

A baseband signal specified as a real scalar or column, complex scalar or column.

Data types

Float64 | Single.

Complex numbers support

Yes

Output

# Out — baseband signal
real scalar | real column | complex scalar | complex column

Details

A baseband signal specified as a real scalar or column, complex scalar or column. The output signal has the same data type as the input signal.

For example, if the input signal is specified as a real scalar with data type Float64, the output signal is also specified as a real signal with data type Float64.

Data types

Float64 | Single.

Complex numbers support

Yes

Parameters

Main

# Model — amplifier nonlinearity model
cubic | ampm | modified-rapp | saleh

Details

A model of the nonlinearity of an amplifier. Defined as:

  • cubic - uses the linear power gain to determine the linear coefficient of the third-order polynomial and either IP3, P1dB, or Psat to determine the coefficient of the third-order polynomial.

  • ampm - uses a lookup table to calculate the power characteristics of the amplifier.

  • modified-rapp - uses a normalised transfer function to calculate the power characteristics of the amplifier.

  • saleh - uses a normalised transfer function to calculate the power characteristics of the amplifier.

Values

cubic | ampm | modified-rapp | saleh

Default value

cubic

Program usage name

Model

Tunable

No

Evaluatable

No

# Linear power gain (dB) — linear amplifier gain
Real number

Details

The linear gain specified as a scalar.

Dependencies

To use this parameter, set the Model parameters to cubic or modified-rapp.

Default value

0

Program usage name

PolyLinPowGain

Tunable

No

Evaluatable

Yes

# Type of Non-linearity — third-order nonlinearity type
IIP3 | OIP3 | IP1dB | OP1dB | IPsat | OPsat

Details

Third-order nonlinearity type, specified as IIP3, OIP3, IP1dB, OP1dB, IPsat or OPsat.

Values

IIP3 | OIP3 | IP1dB | OP1dB | IPsat | OPsat

Default value

OIP3

Program usage name

NonLinearityType

Tunable

No

Evaluatable

No

# Input third-order intercept point (dBm) — third-order intercept input point
Real number

Details

The input point of a third-order intercept specified as a positive real number.

Dependencies

To use this parameter, set the Model parameters to cubic and the Type of Non-Linearity to IIP3.

Default value

Inf

Program usage name

IIP3

Tunable

No

Evaluatable

Yes

# Output third-order intercept point (dBm) — third-order intercept output point
Real number

Details

The output point of a third-order intercept specified as a positive real number.

Dependencies

To use this parameter, set the Model parameters to cubic and the Type of Non-Linearity to OIP3.

Default value

Inf

Program usage name

OIP3

Tunable

No

Evaluatable

Yes

# Input 1 dB compression point (dBm) — input compression point 1 dB
Real number

Details

1 dB input compression point specified as a positive real number.

Dependencies

To use this parameter, set the Model parameters to cubic and the Type of Non-Linearity to IP1dB.

Default value

Inf

Program usage name

IP1dB

Tunable

No

Evaluatable

Yes

# Output 1 dB compression point (dBm) — output compression point 1 dB
Real number

Details

1 dB compression output point specified as a positive real number.

Dependencies

To use this parameter, set the Model parameters to cubic and the Type of Non-Linearity to OP1dB.

Default value

Inf

Program usage name

OP1dB

Tunable

No

Evaluatable

Yes

# Input saturation point (dBm) — input saturation point
Real number

Details

The saturation point of the input signal, specified as a positive real number.

Dependencies

To use this parameter, set the Model parameters to cubic and the Type of Non-Linearity to IPsat.

Default value

Inf

Program usage name

IPsat

Tunable

No

Evaluatable

Yes

# Output saturation point (dBm) — output saturation point
Real number

Details

The saturation point of the output signal, set as a positive real number.

Dependencies

To use this parameter, set the Model parameters to cubic and the Type of Non-Linearity to OPsat.

Default value

Inf

Program usage name

OPsat

Tunable

No

Evaluatable

Yes

# Lookup table (Pin(dBm), Pout(dBm), deg) — search table
Matrix of real numbers

Details

Lookup table values given as a real matrix at . This table expresses the model output power level in dBm in the 2nd column of the matrix and the model phase change in degrees in the 3rd column of the matrix as a function of the absolute value of the input signal power in the 1st column of the matrix for the AM/AM - AM/PM model. The power of the input signal in 1 column should monotonically increase.

The interp1 function with linear method is used to extrapolate and interpolate the data points specified in the lookup table. In addition, the slope of function 1 and a constant phase value equal to the phase of the lowest input power specified in the lookup table are used in AM/AM extrapolation to extrapolate input data points that are less than the lowest input power value specified in the lookup table.

Dependencies

To use this parameter, set the Model parameter to ampm.

Default value

[-25 5 -1; -10 20 -2; 0 27 5; 5 28 12]

Program usage name

LookupTable

Tunable

No

Evaluatable

Yes

# Linear power gain (dB)description missing
Real number

Details

Description missing.

Default value

0

Program usage name

RappLinPowGain

Tunable

No

Evaluatable

Yes

# Output saturation level (V) — output saturation level
Real number

Details

The saturation level of the output voltage, set as a positive real number.

Dependencies

To use this parameter, set the Model parameter to modified-rapp.

Default value

1

Program usage name

OutSatLevel

Tunable

No

Evaluatable

Yes

# Magnitude smoothness factor — magnitude smoothing factor
Real number

Details

Magnitude smoothing factor for modified-rapp AM/AM model calculations, specified as a positive real number.

Dependencies

To use this parameter, set the Model parameter to modified-rapp.

Default value

2

Program usage name

MagSmooth

Tunable

No

Evaluatable

Yes

# Phase gain (rad) — phase gain
Real number

Details

The phase gain for AM/PM model calculations is specified as a real scalar in radians.

Dependencies

To use this parameter, set the Model parameter to modified-rapp.

Default value

-0.45

Program usage name

PhaseGain

Tunable

No

Evaluatable

Yes

# Phase saturation — phase saturation
Real number

Details

Phase saturation for AM/PM calculations of the modified-rapp model, set as a positive real number.

Dependencies

To use this parameter, set the Model parameter to modified-rapp.

Default value

0.88

Program usage name

PhaseSat

Tunable

No

Evaluatable

Yes

# Phase smoothness factor — phase smoothing factor
Scalar / matrix of real numbers

Details

The phase smoothing coefficient for modified-rapp AM/PM model calculations, specified as a positive real number or a vector of two tuples.

Dependencies

To use this parameter, set the Model parameter to modified-rapp.

Default value

[3.43 3.43]

Program usage name

PhaseSmooth

Tunable

No

Evaluatable

Yes

# Input scaling (dB) — input signal level scaling factor
Real number

Details

The input signal level scaling factor for the saleh model, set as a non-negative real number.

Dependencies

To use this parameter, set the Model parameter to saleh.

Default value

0

Program usage name

InScale

Tunable

No

Evaluatable

Yes

# AM/AM parameters [alpha beta] — AM/AM conversion parameters
Matrix of real numbers

Details

The parameters of the AM/AM transformation into two tuples for the saleh model, are given as a two-element vector of non-negative real numbers.

Dependencies

To use this parameter, set the Model parameter to saleh.

Default value

[2.1587 1.1517]

Program usage name

AmAm

Tunable

No

Evaluatable

Yes

# AM/PM parameters [alpha beta] — AM/FM conversion parameters
Matrix of real numbers

Details

The parameters of AM/FM conversion into two tuples for saleh model, are set as a two-element vector of non-negative real numbers.

Dependencies

To use this parameter, set the Model parameter to saleh.

Default value

[4.0033 9.1040]

Program usage name

AmPm

Tunable

No

Evaluatable

Yes

# Output scaling (dB) — output level scaling factor
Real number

Details

The output level scaling factor for the saleh model, set as a non-negative real number.

Dependencies

To use this parameter, set the Model parameter to saleh.

Default value

0

Program usage name

OutScale

Tunable

No

Evaluatable

Yes

Основные

# Include noise — noise activation
Logical

Details

Select this check box to add system noise to the input signal. Once selected, the parameters associated with the Noise tab are displayed.

Default value

false (switched off)

Program usage name

IncludeNoise

Tunable

No

Evaluatable

No

# Specify noise type — noise type
noise-temperature | NF | noise-factor

Details

Noise type, set as:

  • noise-temperature - noise temperature.

  • NF - noise figure.

  • noise-factor - noise factor.

Dependencies

To use this parameter, tick the Include noise parameters checkbox.

Values

noise-temperature | NF | noise-factor

Default value

NF

Program usage name

NoiseType

Tunable

No

Evaluatable

No

# Noise temperature (K) — amplifier noise temperature
Real number

Details

The noise temperature for modelling noise in an amplifier, set as a non-negative real number.

Dependencies

To use this parameter, check the Include Noise parameters and set Specify noise type to noise-temperature.

Default value

290

Program usage name

noise-temperature

Tunable

No

Evaluatable

Yes

# NF (dB) — amplifier noise figure
Real number

Details

The noise figure for modelling noise in an amplifier, specified as a non-negative real number.

Dependencies

To use this parameter, check the Include Noise parameters and set Specify noise type to NF.

Dependencies

To use this parameter, select the Include noise parameter check box.

Default value

10 * log10(2)

Program usage name

NF

Tunable

No

Evaluatable

Yes

# Noise factor — amplifier noise figure
Real number

Details

The noise figure for modelling noise in an amplifier, is given as a positive integer scalar, .

Dependencies

To use this parameter, check the Include Noise parameters and set Specify noise type to noise-factor.

Default value

2

Program usage name

noise-factor

Tunable

No

Evaluatable

Yes

# Seed source — initial value source
auto | user

Details

The initial value source used to prepare the Gaussian random number noise generator. Defined as:

  • auto - the source for each amplifier is generated using a random number generator. The instance reset method has no effect.

  • user - the value specified in Seed is used to initialise the random number generator, and the reset method resets the random number generator using the value of the Seed property.

Dependencies

To use this parameter, check the Include Noise parameters checkbox.

Values

auto | user

Default value

auto

Program usage name

SeedSource

Tunable

No

Evaluatable

No

# Seed — initial value of the random number generator
Real number

Details

The initial value for the random number generator, specified as a non-negative integer, is . Use this value to initialise the random number generator.

Dependencies

To use this parameter, check the Include Noise parameters and set Seed source to user.

Default value

67987

Program usage name

Seed

Tunable

No

Evaluatable

Yes

Literature

  1. Razavi, Behzad. "Basic Concepts in RF Microelectronics.", 2nd edition, Prentice Hall, 2012.

  2. Rapp, C., "Effects of HPA-Nonlinearity on a 4-DPSK/OFDM-Signal for a Digital Sound Broadcasting System." Proceedings of the Second European Conference on Satellite Communications, Liege, Belgium, Oct. 22-24, 1991, pp. 179-184.

  3. Saleh, A.A.M., "Frequency-independent and frequency-dependent nonlinear models of TWT amplifiers." IEEE Trans. Communications, vol. COM-29, pp.1715-1720, November 1981.

  4. IEEE 802.11-09/0296r16. "TGad Evaluation Methodology." Institute of Electrical and Electronics Engineers.https://www.ieee.org/

  5. Kundert, Ken. "Accurate and Rapid Measurement of IP2 and IP3," The Designer Guide Community, May 22, 2002.