model antenna or antenna array accounting for incident power wave (rx) and radiated power wave (tx)

since r2020b

libraries:
rf blockset / circuit envelope / elements

description

model an antenna or antenna array using the antenna block. use this block to:

convert a simulink^® input of an incident power wave vector into rf blockset™ voltage signal at the antenna or antenna array ports.
convert current at rf blockset antenna or antenna array ports to a simulink output of a radiated power wave vector.
introduce antenna impedance into an rf system.

by default, the antenna block is an isotropic radiator producing a simulink output signal. for an isotropic radiator, specify the gain and impedance of the antenna in the block parameters. the radiated carrier frequencies parameter is a set of carrier frequencies over-which the antenna block creates the radiated power wave. for more information, see radiated wave and incident wave.

the antenna block mask icons are dynamic: the icons show the current state of the noise parameter, indicate if you have specified an antennaarray object in the antenna object parameter, and update the number of ports based on the number of elements in the antennaarray object. this table shows how the block icons vary based on the state of the simulate noise and antenna object parameters.

antenna object	simulate noise: `on`	simulate noise: `off`
antenna catalog objects
antenna array catalog objects

examples

simulation of rf systems with antenna blocks

use the antenna block to incorporate the effect of an antenna into an rf simulation. in this model, a single tone is fed to the transmitter and the power of the received signal at the output of the receiver is calculated.

ports

input

rx — received signal
scalar | vector | matrix | m-by-n-by-k array

received signal, specified as a scalar, vector, matrix, or an array of size m-by-n-by-k. in the array:

m — represents the frame size
n — represents the number of interferers
k — represents horizontal or vertical polarization. the value of the k must be 2.

data types: double

output

tx — transmitted signal
scalar | vector | matrix | m-by-n-by-k array

transmitted signal, specified as a scalar, vector, matrix, or an array of size m-by-n-by-k. in the array:

m — represents the frame size
n — represents the number of interferers
k — represents horizontal or vertical polarization. the value of the k must be 2.

data types: double

parameters

main

source of antenna model — antenna model
`isotropic radiator` (default) | `antenna designer` | `antenna object`

antenna model, specified as one of the following:

isotropic radiator
antenna designer
antenna object

note

to use antenna designer and antenna object options you will need antenna toolbox™.

create antenna — open antenna toolbox antenna designer app
button

open the antenna designer app from the antenna toolbox to create an antenna.

dependencies

to enable this parameter, set the source of antenna model to antenna designer.

antenna object — antenna or array element input from workspace
antenna catalog object | antenna array catalog object | `pcbstack` object

antenna or array element input from the workspace, specified as a single port antenna element or up to 65 port antenna array elements, or (antenna toolbox) object created using the antenna toolbox. analyze the antenna, array, or pcb stack objects in the workspace for at least one frequency before using them in the block.

for a complete list of the type of antenna and array objects that you can use in this block, see antenna catalog (antenna toolbox) and array catalog (antenna toolbox).

dependencies

to enable this parameter, set source of antenna model to antenna object.

antenna gain — antenna gain
`0` `dbi` (default) | real scalar or vector | positive scalar or vector

antenna gain, specified as real scalar or vector if you set units to dbi or positive scalar or vector if you set units are none. if the antenna gain is a vector, the vector length must be equal to the vector length of incident carrier frequencies and radiated carrier frequencies.

dependencies

to enable this parameter, set source of antenna model to isotropic radiator and check input incident wave or output radiated wave or both

impedance (ohm) — input impedance
`50` (default) | complex-valued scalar or vector

input impedance, specified as a complex-valued scalar or vector in ohms. if the impedance is a vector, the vector length must be equal to the length of incident carrier frequencies and radiated carrier frequencies.

dependencies

to enable this parameter, set source of antenna model to isotropic radiator.

data types: double
complex number support: yes

input incident wave — input incident wave for simulating receiving antenna
`'off'` (default) | `'on'`

select this parameter if you want to simulate a receiving antenna.

output radiated wave — output radiated wave for transmitting antenna
`'on'` (default) | `'off'`

select this parameter if you want a simulate a transmitting antenna.

incident carrier frequencies — carrier frequencies for receiving signal
`2.1` `ghz` (default) | nonnegative scalar or row vector

carrier frequencies for a receiving signal, specified as a nonnegative scalar in hertz or a row vector with each element unit in hertz. if the value of antenna gain or impedance is a vector, then the values of incident carrier frequencies and radiated carrier frequencies must be identical.

dependencies

to enable this parameter, select input incident wave.

radiated carrier frequencies — carrier frequencies for transmitting signal
`2.1` `ghz` (default) | nonnegative scalar or row vector

carrier frequencies for a transmitting signal, specified as a nonnegative scalar in hertz or a row vector with each element unit in hertz. if the value of antenna gain or impedance is a vector, then the values of incident carrier frequencies and radiated carrier frequencies must be identical.

dependencies

to enable this parameter, select output radiated wave.

direction of departure — azimuth and elevation angles towards which output signal power wave radiates
`[0 0]` `deg` (default) | finite real row vector of length 1-by-2 | finite real matrix of length m-by-2

azimuth and elevation angles towards which the output signal power wave radiates, specified as a finite real row vector of length 1-by-2 or finite real matrix of length m-by-2 (since r2023a) with each element unit in degrees or radians. m is an integer between in the range [2, 100].

dependencies

to enable this parameter, set source of antenna model to antenna designer or antenna object and select output radiated wave.

direction of arrival — azimuth and elevation angles from which input signal power wave arrives
`[180 0]` `deg` (default) | finite real row vector of length 1-by-2 | finite real matrix of length m-by-2

azimuth and elevation angles towards which the input signal power wave arrives, specified as a finite real row vector of length 1-by-2 or finite real matrix of length m-by-2 (since r2023a) with each element unit in degrees or radians. m is an integer between in the range [2, 100].

dependencies

to enable this parameter, set source of antenna model to antenna designer or antenna object and select input incident wave.

simulate noise — simulate thermal noise
`'on'` (default) | `'off'`

select this parameter to simulate thermal noise in the antenna due to the real part of the impedance see at the antenna terminals. you must select simulate noise in the block also.

ground and hide negative terminals — ground rf circuit terminals
`'on'` (default) | `'off'`

select this option to ground and hide the negative terminals. clear this parameter to expose the negative terminals. by exposing these terminals, you can connect them to other parts of your model.

by default, this option is selected.

modeling

modeling options — model frequency-dependent antenna parameters
`time domain (rationalfit)` (default) | `frequency domain`

model frequency-dependent antenna parameters, specified as:

time domain (rationalfit) — this technique creates an analytical rational model that approximates the whole range of the data.
frequency domain — this technique computes the baseband impulse response for each carrier frequency independently. this technique is based on convolution. there is an option to specify the duration of the impulse response. for more information, see .

the frequency-dependent parameters are:

antenna impedance — the input impedance at the antenna terminals. this is used in rf system simulation.
normalized vector effective length — a property used that ties between the current flowing at the antenna terminals and the radiated far-field at a given direction. due to reciprocity, the effective length also ties between the incident field and the induced open-circuit voltage on the antenna terminals.

dependencies

to set source source of antenna model of antenna designer or antenna object to activate the modeling tab that contains the modeling options parameters.

relative error desired (db) — relative error acceptable for the rational fit
`-40` (default) | scalar

relative error acceptable for the rational fit, specified as a scalar. applies to time domain modeling of both antenna impedance and normalized vector effective length. the corresponding rational fitting results for each property are displayed on the block mask.

dependencies

to set modeling options to time domain (rationalfit) in .

automatically estimate impulse response duration — automatically calculate impulse response
`'on'` | `'off'`

select this parameter to automatically calculate the impulse response duration. clear this parameter to manually specify the impulse response duration using impulse response duration. applies to frequency-domain modeling of both antenna impedance and normalized vector effective length.

dependencies

to set this parameter, select frequency domain in modeling options.

impulse response duration — impulse response duration
`1e-10s` (default) | scalar

impulse response duration, specified as a scalar. applies to frequency-domain modeling of both antenna impedance and normalized vector effective length.

dependencies

to set this parameter, first select frequency domain in modeling options. then, clear automatically estimate impulse response duration.

more about

radiated wave

the antenna block produces a simulink signal representing a normalized power wave similar to power waves in circuits. since an antenna radiates two independent field components in the far field, the signal is extended into the third dimension:

$\begin{array}{l} t x (:, :, 1) = t x_{θ} = \frac{e_{θ}}{\sqrt{η_{0}}} \cdot \sqrt{4 π} \cdot r \cdot e^{γ r} \\ t x (:, :, 2) = t x_{φ} = \frac{e_{ϕ}}{\sqrt{η_{0}}} \cdot \sqrt{4 π} \cdot r \cdot e^{γ r} \end{array}$

where

e_θ and e_φ are the electric field components radiated from the antenna and measured at a far-field location in the direction of departure.
η₀ is the free-space intrinsic impedance
r is the distance to the far-field measurement location.
$γ = \frac{j ω}{c}$ where ω is the angular frequency and c is the speed of light in free space.

the above definition makes the transmit (tx) signal independent of the distance r. the total power carried by this normalized radiated power wave is the equivalent isotropically radiated power wave (eirp) of the transmitter in the direction of departure:

${‖ t x ‖}^{2} = {| t x_{θ} |}^{2} {| t x_{ϕ} |}^{2} = e i r p = p_{t} g_{t}$

where total

p_t is the input power at the antenna terminals
g_t is transmitter antenna gain at the direction of departure.

the eirp is a commonly used concept in communication systems. this value represents the amount of power radiated from an isotropic antenna such that the same power density is obtained in the direction of departure.

in case of an isotropic radiator, you resolve the ambiguity in polarization by assuming that the antenna is radiating a single field component. you also assume that this field component is always aligned for full reception by a receiving antenna. thus, the tx signal and the expected rx in a receiving antenna is two dimensional. following the above definitions, the transmit signal for an isotropic radiator is:

$t x (:, :) = \sqrt{g_{t} r_{e} {z_{i n}}} . i_{i n}$

where:

z_in is the input impedance of the antenna.
i_in is the current at antenna terminals.

in all definitions of tx, the array elements are arranged in the first two dimensions in a manner similar to the of the output signal of an rf blockset outport block. if the signal is framed, the column size corresponds to the number of frame bits and the row size corresponds to the number of carrier frequencies. if the signal is not framed, then the column size corresponds to the number of carrier frequencies and the row size is one.

effect of free space channel

the effect of free space channel between the antennas is not captured by antenna block. you can model it externally using simulink blocks. for a free-space channel the effect is given by the transfer function:

$p l = \frac{λ}{4 π r} \cdot e^{- γ r}$

where

λ is the wavelength modeled outside the antenna.
r is the distance between the antennas
exponential term at the end of the equation represents the time delay occurring over the distance r.
pl is free-space path loss.

you can model a free-space channel using the communications toolbox™ (communications toolbox). the effect of the power wave is described using the friis equation. the free space path loss block operates for a single carrier frequency and is narrow band. for multiple carriers with narrow bands, the signal must be split and passed through multiple free space path loss blocks. with carrier frequencies specified in the antenna block. when the antenna blocks are not isotropic radiators, the output signal is a 3d array and needs to be split and reshaped before being send to the free space path loss

incident wave

the antenna block can also accept a simulink signal representing a normalized incident power wave. since an antenna also receives two independent field components, the signal is extended in the third dimension:

$\begin{array}{l} r x (:, :, 1) = r x_{θ} = t x_{θ} \cdot p l = \frac{e_{θ}}{\sqrt{η_{0}}} \cdot \frac{λ}{\sqrt{4 π}} \\ r x (:, :, 2) = r x_{ϕ} = t x_{ϕ} \cdot p l = \frac{e_{ϕ}}{\sqrt{η_{0}}} \cdot \frac{λ}{\sqrt{4 π}} \end{array}$

where

tx_θ and tx_φ are signals from transmitting antenna.
pl free-space channel transfer function.
e_θ and e_φ are the electrical field components measured from transmitting antenna.
η₀ is the free-space intrinsic impedance.
λ is the wavelength.
rx is the incident power wave normalized such that is the power received by the isotropic antenna.

using the above equations, the total power carried by the normalized incident power wave, ${‖ r x ‖}^{2} = {| r x_{θ} |}^{2} {| r x_{ϕ} |}^{2}$ is available power received by ideal isotropic receiving antenna. the available power received by a true antenna is:

$p_{r} = {‖ r x ‖}^{2} g_{r}$

where g_r is the receiver antenna gain at the direction of arrival.

in case the receiving antenna is an isotropic radiator, you can resolve the ambiguity in polarization by assuming that the antenna is receiving a single field component that it is aligned for full reception. thus, the rx signal is expected to be two dimensional. in all definitions of the rx signal, the array elements are arranged in the first two dimensions in a manner similar to that of the input signal of an rf blockset inport block.

references

[1] stutzman, warren l., and gary a. thiele. antenna theory and design. 3rd ed. hoboken, nj: wiley, 2013

[2] farr, everett g. “characterizing antennas in the time and frequency domains [education corner].” ieee antennas and propagation magazine 60, no. 1 (february 2018): 106–10. https://doi.org/10.1109/map.2017.2774200.

version history

introduced in r2020b

r2023a: multiple directions of arrival and departure in antenna block

you can now use the antenna block to transmit and receive signals in multiple directions using the direction of arrival and direction of departure properties.

r2022a: model transmit and receive antenna array

to model a transmit and receive antenna, specify an antenna array from the array catalog (antenna toolbox) in the antenna object parameter.

r2021b: antenna block icon updated

the antenna block icon was updated in r2021b. the block icon is now dynamic and shows the current state of the noise parameter.

when you open a model created before r2021b containing an antenna block, the software replaces the block icon with the r2021b version.

model antenna or antenna array accounting for incident power wave (rx) and radiated power wave (tx) -凯发k8网页登录

description

examples

simulation of rf systems with antenna blocks

ports

input

rx — received signal scalar | vector | matrix | m-by-n-by-k array

output

tx — transmitted signal scalar | vector | matrix | m-by-n-by-k array

parameters

main

source of antenna model — antenna model isotropic radiator (default) | antenna designer | antenna object

create antenna — open antenna toolbox antenna designer app button

dependencies

antenna object — antenna or array element input from workspace antenna catalog object | antenna array catalog object | pcbstack object

dependencies

antenna gain — antenna gain 0 dbi (default) | real scalar or vector | positive scalar or vector

dependencies

impedance (ohm) — input impedance 50 (default) | complex-valued scalar or vector

dependencies

input incident wave — input incident wave for simulating receiving antenna 'off' (default) | 'on'

output radiated wave — output radiated wave for transmitting antenna 'on' (default) | 'off'

incident carrier frequencies — carrier frequencies for receiving signal 2.1 ghz (default) | nonnegative scalar or row vector

dependencies

radiated carrier frequencies — carrier frequencies for transmitting signal 2.1 ghz (default) | nonnegative scalar or row vector

dependencies

direction of departure — azimuth and elevation angles towards which output signal power wave radiates [0 0] deg (default) | finite real row vector of length 1-by-2 | finite real matrix of length m-by-2

dependencies

direction of arrival — azimuth and elevation angles from which input signal power wave arrives [180 0] deg (default) | finite real row vector of length 1-by-2 | finite real matrix of length m-by-2

dependencies

simulate noise — simulate thermal noise 'on' (default) | 'off'

ground and hide negative terminals — ground rf circuit terminals 'on' (default) | 'off'

modeling

modeling options — model frequency-dependent antenna parameters time domain (rationalfit) (default) | frequency domain

dependencies

relative error desired (db) — relative error acceptable for the rational fit -40 (default) | scalar

dependencies

automatically estimate impulse response duration — automatically calculate impulse response 'on' | 'off'

dependencies

impulse response duration — impulse response duration 1e-10s (default) | scalar

dependencies

more about

radiated wave

effect of free space channel

incident wave

references

version history

r2023a: multiple directions of arrival and departure in antenna block

r2022a: model transmit and receive antenna array

r2021b: antenna block icon updated

see also

wechat

rx — received signal
scalar | vector | matrix | m-by-n-by-k array

tx — transmitted signal
scalar | vector | matrix | m-by-n-by-k array

source of antenna model — antenna model
`isotropic radiator` (default) | `antenna designer` | `antenna object`

create antenna — open antenna toolbox antenna designer app
button

antenna object — antenna or array element input from workspace
antenna catalog object | antenna array catalog object | `pcbstack` object

antenna gain — antenna gain
`0` `dbi` (default) | real scalar or vector | positive scalar or vector

impedance (ohm) — input impedance
`50` (default) | complex-valued scalar or vector

input incident wave — input incident wave for simulating receiving antenna
`'off'` (default) | `'on'`

output radiated wave — output radiated wave for transmitting antenna
`'on'` (default) | `'off'`

incident carrier frequencies — carrier frequencies for receiving signal
`2.1` `ghz` (default) | nonnegative scalar or row vector

radiated carrier frequencies — carrier frequencies for transmitting signal
`2.1` `ghz` (default) | nonnegative scalar or row vector

direction of departure — azimuth and elevation angles towards which output signal power wave radiates
`[0 0]` `deg` (default) | finite real row vector of length 1-by-2 | finite real matrix of length m-by-2

direction of arrival — azimuth and elevation angles from which input signal power wave arrives
`[180 0]` `deg` (default) | finite real row vector of length 1-by-2 | finite real matrix of length m-by-2

simulate noise — simulate thermal noise
`'on'` (default) | `'off'`

ground and hide negative terminals — ground rf circuit terminals
`'on'` (default) | `'off'`

modeling options — model frequency-dependent antenna parameters
`time domain (rationalfit)` (default) | `frequency domain`

relative error desired (db) — relative error acceptable for the rational fit
`-40` (default) | scalar

automatically estimate impulse response duration — automatically calculate impulse response
`'on'` | `'off'`

impulse response duration — impulse response duration
`1e-10s` (default) | scalar