returnLoss

Calculate and plot return loss of antenna or scan return loss of array

Syntax

returnLoss(antenna,frequency)

returnLoss(antenna,frequency,z0)

rl = returnLoss(antenna,frequency,z0)

returnLoss(array,frequency)

returnLoss(array,frequency,z0,elementnumber)

rl = returnLoss(array,frequency,z0,elementnumber)

rl = returnLoss(___,UseParallel = true)

Description

returnLoss(antenna,frequency) calculates and plots the return loss of an antenna, over a specified frequency and at a reference impedance of 50 ohm.

returnLoss(antenna,frequency,z0) calculates and plots the return loss of an antenna, over a specified frequency and a given reference impedance, z0.

rl = returnLoss(antenna,frequency,z0) returns the return loss of an antenna.

returnLoss(array,frequency) calculates the return loss of the individual array elements over the specified frequency at a reference impedance of 50 ohm and opens an interactive return loss plot. You can switch between the individual element plots by specifying the element number in the Elements box at the bottom of the plot.

returnLoss(array,frequency,z0,elementnumber) calculates and plots the scan return loss of a specified antenna element in an array.

rl = returnLoss(array,frequency,z0,elementnumber) returns the scan return loss of a specified antenna element in an array.

rl = returnLoss(___,UseParallel = true) uses the Parallel Computing Toolbox™ to perform return loss calculations for each frequency in parallel. To use this feature, you need a license to the Parallel Computing Toolbox.

Examples

Calculate and Plot Return Loss of Antenna

This example shows how to calculate and plot the return loss of a circular loop antenna over a frequency range of 50MHz-100MHz.

h = loopCircular;
returnLoss (h, 50e6:1e6:100e6);

Input Arguments

antenna — Antenna to calculate return loss

antenna object | customAntenna object | customAntennaMesh object | customAntennaGeometry object | customAntennaStl object | pcbStack object | installedAntenna object

Antenna to calculate return loss, specified as one of the following options:

• Antenna object from the antenna catalog.

• customAntenna object.

• customAntennaMesh object.

• customAntennaGeometry object.

• customAntennaStl object.

• pcbStack object.

• installedAntenna object.

Example: dipole

array — Array to calculate scan return loss

array object | customArrayMesh object | customArrayGeometry object | array of pcbStack object

Array to calculate scan return loss, specified as one of the following options:

• Array object from the array catalog.

• customArrayMesh object.

• customArrayGeometry object.

• Array of pcbStack object.

Example: linearArray

Example: array(pcbStack,"linear")

frequency — Frequency range to calculate return loss

positive vector

Frequency range to calculate return loss, specified as a positive vector in Hertz.

Example: 50e6:1e6:100e6

Data Types: double

z0 — Reference impedance

50 (default) | scalar

Reference impedance, specified as a scalar in ohms.

Example: 40

Data Types: double

elementnumber — Antenna element number in array

positive integer scalar

Antenna element number in array, specified as a positive integer scalar.

Example: 1

Data Types: double

UseParallel — Option to enable parallel pool

false or 0 (default) | true or 1

Option to enable parallel pool, specified as a logical value. The default value is false. Set the flag to true or 1 to enable the parallel pool. Use parallel pool to speedup the return loss calculations at multiple frequencies for computationally large antennas and arrays.

Example: UseParallel=true

Data Types: logical

Output Arguments

rl — Return loss of antenna or scan return loss of array

vector in dB

Return loss of antenna or scan return loss of array, returned as a vector in dB. The return loss is calculated using the formula

$$RL=-20{\log }_{10}\left|\frac{(Z-Z_0)}{(Z+Z_0)}\right|$$

where,

• Z = input impedance of antenna or scan impedance of array

• Z₀ = reference impedance

Version History

Introduced in R2015a