Engee documentation

EngeePhased.IsotropicAntennaElement

Isotropic antenna.

Library

EngeePhased

Description

System object EngeePhased.IsotropicAntennaElement Simulates an antenna element with an isotropic radiation pattern. The antenna element diagram is the same in all directions. The isotropic antenna does not support polarization.

To create and use an isotropic antenna, follow these steps:

  1. Create an object EngeePhased.IsotropicAntennaElement and set its properties.

  2. Call an object with arguments as if it were a function.

To learn more about how to work with system objects, see Engee System Objects.

Syntax

Creation

  • antenna = EngeePhased.IsotropicAntennaElement() — Creates an isotropic antenna with by default property values.

  • antenna = EngeePhased.IsotropicAntennaElement(Name=Value) — creates an isotropic antenna with specified properties in the form of a pair Name=Value, where Name — the name of the property, and Value — appropriate value. You can specify multiple pairs «name-value» the order of the pairs does not matter. Unspecified properties retain their by default values.

Usage

  • RESP = antenna(FREQ,ANG) — returns the antenna pattern RESP at operating frequencies FREQ in directions ANG.

Arguments

Input arguments

FREQ — operating frequencies of the antenna element

+ scalar | vector-string of length L

Details

The operating frequencies of the antenna, specified in the form of a real positive scalar or a real vector-a string of length containing positive numbers.

Typical values are in the range FrequencyRange. Otherwise, the element does not have a directional pattern and returns it as −Inf.

Units of measurement — Hz.

Типы данных

Float64

ANG — azimuth angle and angle of the radiation pattern

+ vector-string of length M | matrix 2 by M

Details

The directions of the radiation pattern, specified as a real vector-a string of length or a real matrix on .

If ANG is a matrix, then each column specifies a direction in the form [azimuth; elevation]. The azimuthal angle should be in the range of −180° before 180° inclusive. The angle of the seat should be in the range of −180° before 180° inclusive.

If ANG is a string vector, each element specifies the azimuthal angle of the direction. In this case, the corresponding angle of the place is assumed to be equal .

The units of measurement are degrees.

For more information about the azimuth angle and the elevation angle, see Azimuthal angles and place angles.

Типы данных

Float64

Output arguments

RESP — antenna pattern

+ the complex matrix M on L

Details

The radiation pattern of the antenna element, returned as a complex matrix on , where — the number of angles specified in ANG, — the number of frequencies specified in FREQ.

Properties

# FrequencyRange — operating frequency range

+ [0.0 1.0e20] (by default) | a non-negative real vector is a 1 by 2 row

Details

The operating frequency range of the antenna, specified as a non-negative real vector on in the format [LowerBound HigherBound]. The antenna element does not have a radiation pattern outside the specified frequency range.

Units of measurement — Hz.

# BackBuffled — mute the echo of the element

+ false (by default) | true

Details

Mute the echo of an element, set as false or true.

Set this property to true so that on the reverse side of the antenna element, the radiation pattern is zero. That is, at all azimuthal angles exceeding ±90° from the wide side (azimuth angle and the angle of the place ), the radiation pattern is zero.

When the value of this property is false, the rear side of the antenna element has no reflection.

Methods

Common to all system objects

step!

Running the system object operation algorithm

release!

Permission to change the value of a system object property

reset!

Resetting the internal states of the system object