Engee documentation

DPCA Canceller

Offset Phase Center Antenna Array Pulse Suppression Device (DPCA) for a homogeneous linear antenna array.

blockType: DPCACanceller

Path in the library:

/Phased Array Systems/SpaceTimeAdaptiveProcessing/DPCA Canceller

Description

Block DPCA Canceller filters out interference falling on a homogeneous linear antenna array using a pulse suppressor with an offset phase center.

Ports

Input

# X — The input signal
complex matrix M by N by P

Details

The input signal, specified as a complex matrix on on , where – number of range counts, – the number of channels, and – the number of pulses.

Data types

Float64

Complex numbers support

Yes

# Idx — index of the range cells
a positive integer

Details

The index of the range cells for calculating the processing weights.

Data types

Float64

Complex numbers support

No

# Dop — frequency of Doppler positioning
scalar

Details

The frequency of the Doppler positioning of the current pulse, set as a scalar.

Dependencies

To use this port, check the box for the parameter Output pre-Doppler result and for the parameter Specify targeting Doppler as value `Input port'.

Data types

Float64

Complex numbers support

No

# Ang — directions of arrival of signals
a 2-by-1 real vector

Details

The direction of arrival of the signals, set as a real vector 2 by 1. The vector has the form [AzimuthAngle;ElevationAngle]. The azimuth angle should be in the range from -180° to 180° inclusive, and the elevation angle should be in the range from -90° to 90° inclusive. The angles are determined relative to the local coordinate system of the array.

The angle measurement units are degrees.

Dependencies

To use this port, set the Specify direction as parameter to Input port.

Data types

Float64

Complex numbers support

No

# PRF — pulse repetition rate
positive scalar

Details

The pulse repetition rate of the current pulse, set as a positive scalar.

Dependencies

To use this port, set the Specify PRF as parameter to Input port.

Data types

Float64

Complex numbers support

No

Output

# Y — output signal of the beam shaper
complex vector M by 1

Details

The output signal of the beamformer, specified as a complex vector on , where – the number of range samples on the input port X.

Data types

Float64

Complex numbers support

Yes

# W — weight factors
complex matrix N on P

Details

Weight coefficients given as a complex matrix on , where – this is the number of channels, and – the number of pulses.

If the Specify sensor array as parameter is set to Partitioned array or `Replicated subarray', then It represents the number of antenna sublattices. is the number of desired beamforming directions specified in the input port Ang or in the parameter Beamforming direction (deg). There is one set of weighting factors for each direction of beam formation.

Dependencies

To use this port, check the box for the Enable weights output option.

Data types

Float64

Complex numbers support

Yes

Parameters

Main

# Signal propagation speed (m/s) — signal propagation speed, m/s
Real number

Details

The propagation velocity of the signal in the form of a real positive scalar.

Default value

299792458

Program usage name

PropagationSpeed

Tunable

No

Evaluatable

Yes

# Operating frequency (Hz) — operating frequency of the system, Hz
Real number

Details

The operating frequency of the system, set as a positive scalar.

Default value

3e8

Program usage name

OperatingFrequency

Tunable

No

Evaluatable

Yes

# Specify PRF as — The source of the pulse repetition rate value
Property | Input port

Details

The source of the pulse repetition rate (PRF) value:

  • Property — parameter Pulse repetition frequency (Hz) sets the numerical value of the PRF value.

  • Input port — The numerical value of the PRF value is received through the input port PRF.

Values

Property | Input port

Default value

Property

Program usage name

PrfProp

Tunable

No

Evaluatable

No

# Pulse repetition frequency (Hz) — pulse repetition rate, Hz
Real number

Details

Pulse repetition rate (PRF), set as a positive scalar.

Set this parameter to the same value that is set in any library block used in modeling. Waveforms.

Dependencies

To enable this parameter, set the Specify PRF as parameter to Property.

Default value

1

Program usage name

Prf

Tunable

No

Evaluatable

Yes

# Specify direction as — the source of the positioning directions
Property | Input port

Details

The source of the positioning direction values:

  • Property — the Receiving mainlobe direction (deg) parameter sets the positioning direction.

  • Input port — The positioning directions are sent to the input port Ang.

Values

Property | Input port

Default value

Property

Program usage name

DirProp

Tunable

No

Evaluatable

No

# Receiving mainlobe direction (deg) — pointing direction of the antenna array pattern
Vector / matrix of real numbers

Details

Specify the direction of the radiation pattern of the antenna array of the antenna element in the form of a 2-by-1 real vector. The direction is set in the format [AzimuthAngle; ElevationAngle]. The azimuth angle should be in the range from -180° to 180°, and the elevation angle should be from -90° to 90°.

Dependencies

To enable this parameter, set the Specify direction as parameter to Property.

Example

[100;-45]

Default value

[0; 0]

Program usage name

Direction

Tunable

No

Evaluatable

Yes

# Number of bits in phase shifters — number of phase shift quantization bits
Real number

Details

The number of bits used to quantize the phase shift component of the beamformer or control vector weights. Specify the number of bits as a non-negative integer. A value of zero means that quantization is not performed.

Default value

0

Program usage name

NumPhaseShifterBits

Tunable

No

Evaluatable

Yes

# Specify targeting Doppler as — source of Doppler guidance on target
Property | Input port

Details

Source of Doppler guidance on target:

  • Property — parameter Targeting Doppler (Hz) sets the Doppler positioning values.

  • Input port — Doppler positioning values are sent to the input port Dop.

Values

Property | Input port

Default value

Property

Program usage name

DopProp

Tunable

No

Evaluatable

No

# Targeting Doppler (Hz) — Doppler positioning of the STAP processor
Real number

Details

The Doppler positioning of the STAP processor, set as a scalar.

Dependencies

To use this parameter, uncheck the Output pre-Doppler result parameter and set the Specify targeting Doppler as parameter to Property.

Default value

0

Program usage name

Doppler

Tunable

No

Evaluatable

Yes

# Enable weights output — enabling the output of the beam shaper weights
Logical

Details

Check this box to get the beam shaper weights via the output port W.

Default value

false (switched off)

Program usage name

EnableWeightOut

Tunable

No

Evaluatable

No

# Output pre-Doppler result — enabling output of results before Doppler filtering
Logical

Details

Select this option to display the results before Doppler filtering.

Uncheck this box to display the result of processing after Doppler filtering.

Default value

false (switched off)

Program usage name

OutputPreDoppler

Tunable

No

Evaluatable

No

Sensor Array

Main

# Specify sensor array as — the method of specifying the antenna array
Array (no subarrays)

Details

The method of setting the antenna array, specified as Array (no subarrays).

Values

Array (no subarrays)

Default value

Array (no subarrays)

Program usage name

SpecifySensorArray

Tunable

No

Evaluatable

No

Element

# Element type — types of antenna array elements
Isotropic Antenna | Cardioid Antenna | Cosine Antenna | Custom Antenna | Gaussian Antenna | Sinc Antenna | Omni Microphone | Custom Microphone

Details

The type of antenna or microphone specified as one of the following:

  • Isotropic Antenna

  • Cardioid Antenna

  • Cosine Antenna

  • Custom Antenna

  • Gaussian Antenna

  • Sinc Antenna

  • Omni Microphone

  • Custom Microphone

Values

Isotropic Antenna | Cardioid Antenna | Cosine Antenna | Custom Antenna | Gaussian Antenna | Sinc Antenna | Omni Microphone | Custom Microphone

Default value

Isotropic Antenna

Program usage name

ElementType

Tunable

No

Evaluatable

No

# Operating frequency vector (Hz) — operating frequency range of custom antenna or microphone elements
Vector / matrix of real numbers

Details

Specify the frequencies at which you want to set the frequency characteristics of the antenna and microphone, as a vector of lines 1 to with increasing real values. The antenna or microphone has no response outside the frequency range specified by the minimum and maximum elements of this vector.

Dependencies

To enable this parameter, set the Element type parameter to Custom Antenna or Custom Microphone. Use Frequency responses (dB) to set responses at these frequencies.

Frequency measurement units

Hz

Default value

[0, 1e20]

Program usage name

FrequencyVector

Tunable

No

Evaluatable

Yes

# Frequency responses (dB) — frequency characteristics of the antenna and microphone
Vector / matrix of real numbers

Details

The frequency response of the user antenna or user microphone for the frequencies defined by the parameter Operating frequency vector (Hz). The dimension of Frequency responses (dB) must match the dimension of the vector specified by the parameter Operating frequency vector (Hz).

Dependencies

To enable this parameter, set the Element type parameter to Custom Antenna or Custom Microphone.

Default value

[0, 0]

Program usage name

FrequencyResponse

Tunable

No

Evaluatable

Yes

# Input pattern coordinate system — The coordinate system of the custom antenna pattern
az-el | phi-theta

Details

The coordinate system of the custom antenna pattern, set as az-el or phi-theta.

  • If the Input Pattern Coordinate System is set as az-el, use the Azimuth angles (deg) and Elevations angles (deg) parameters to set the coordinates of the directional pattern points.

  • If the Input Pattern Coordinate System is set as phi-theta, use the Phi angles (deg) and Theta angles (deg) parameters to specify the coordinates of the template points.

Dependencies

To enable this parameter, set the Element type parameter to Custom Antenna.

Values

az-el | phi-theta

Default value

az-el

Program usage name

CoordinateSystem

Tunable

No

Evaluatable

No

# Azimuth angles (deg) — azimuthal angles of the antenna radiation pattern
Vector / matrix of real numbers

Details

Specify the azimuthal angles by which the antenna radiation pattern is calculated as a vector of lines 1 on . must be more than 2. The azimuthal angles should lie between -180° and 180°, inclusive, and be arranged in strictly ascending order.

Dependencies

To enable this parameter, set the Element type parameter to Custom Antenna and for the parameter Input Pattern Coordinate System the value az-el.

Default value

-180:180

Program usage name

AzimuthAngle

Tunable

No

Evaluatable

Yes

# Elevation angles (deg) — the angles of the antenna radiation location
Vector / matrix of real numbers

Details

Specify the angles of the location at which the radiation pattern will be calculated, in the form of a vector 1 on . it must be more than 2.

The angles of the seat should be in the range from -90° to 90° inclusive and arranged in strictly ascending order.

Dependencies

To enable this parameter, set the Element type parameter to Custom Antenna, and for the parameter Input Pattern Coordinate System the value az-el.

Units of measurement

degrees

Default value

-90:90

Program usage name

ElevationAngle_R

Tunable

No

Evaluatable

Yes

# Phi angles (deg) — angular coordinates of the Phi radiation pattern of the user antenna
Vector / matrix of real numbers

Details

Phi-the angles of the points at which the antenna radiation pattern is set are given as a real vector 1 on . it must be more than 2.

The Phi angles should range from 0° to 360° and be arranged in strictly ascending order.

Dependencies

To enable this parameter, set the Element type parameter to Custom Antenna and for the parameter Input Pattern Coordinate System the value phi-theta.

Units of measurement

degrees

Default value

0:360

Program usage name

PhiAngles

Tunable

No

Evaluatable

Yes

# Theta angles (deg) — angular coordinates of the Theta radiation diagram of the user antenna
Vector / matrix of real numbers

Details

Theta-the angles of the points at which the antenna radiation pattern is set are given as a real vector 1 on . it must be more than 2.

The theta angles should range from 0° to 360° and be arranged in strictly ascending order.

Dependencies

To enable this parameter, set the Element type parameter to Custom Antenna and for the parameter Input Pattern Coordinate System the value phi-theta.

Units of measurement

degrees

Default value

0:180

Program usage name

ThetaAngles

Tunable

No

Evaluatable

Yes

# Magnitude pattern (dB) — the magnitude of the radiation pattern of the combined antenna
String

Details

The value of the radiation pattern of the combined antenna, set as a matrix on or an array on on .

  • If the Input Pattern Coordinate System parameter is set to az-el, is equal to the length of the vector specified by the Elevation angles (deg) parameter, and is equal to the length of the vector specified by the Azimuth angles (deg) parameter.

  • If the Input Pattern Coordinate System parameter is set to phi-theta, is equal to the length of the vector specified by the Theta Angles (deg) parameter, and is equal to the length of the vector specified by the Phi Angles (deg) parameter.

Meaning is equal to the length of the Operating frequency vector (Hz) vector.

  • If the parameter Magnitude pattern (dB) is a matrix on , the same pattern is applied to all frequencies specified in the Operating frequency vector (Hz) parameter.

  • If the parameter Magnitude pattern (dB) is an array on on , each page on The array defines a template for the corresponding frequency specified in the parameter Operating frequency vector (Hz).

Dependencies

To enable this parameter, set the Element type parameter to Custom Antenna.

Default value

zeros(181,361)

Program usage name

MagnitudePattern

Tunable

No

Evaluatable

No

# Phase pattern (deg) — custom antenna radiation phase diagram
String

Details

The phase diagram of the combined antenna radiation, defined as a matrix on or an array on on .

  • If the Input Pattern Coordinate System parameter is set to az-el, is equal to the length of the vector specified by the Elevation angles (deg) parameter, and is equal to the length of the vector specified by the Azimuth angles (deg) parameter.

  • If the Input Pattern Coordinate System parameter is set to phi-theta, is equal to the length of the vector specified by the Theta Angles (deg) parameter, and is equal to the length of the vector specified by the Phi Angles (deg) parameter.

Meaning is equal to the length of the Operating frequency vector (Hz) vector.

  • If the Phase pattern (deg) parameter is a matrix on , the same pattern is applied to all frequencies specified in the Operating frequency vector (Hz) parameter.

  • If the Phase pattern (deg) parameter is an array on on , each page on The array defines a template for the corresponding frequency specified in the parameter Operating frequency vector (Hz).

Dependencies

To enable this parameter, set the Element type parameter to Custom Antenna.

Default value

zeros(181,361)

Program usage name

PhasePattern

Tunable

No

Evaluatable

No

# Align element normal with array normal — rotation of the antenna element in accordance with the normal of the array
Logical

Details

Select this option to rotate the antenna element template according to the array normal. If the checkbox is not checked, the element’s outline does not rotate.

  • If the antenna is used in an antenna array and the parameter Input Pattern Coordinate System is set to az-el check this box to rotate the element so that the axis The coordinate system of the element was directed along the grid normal. If the checkbox is not checked, the element template is used without rotation.

  • If the antenna is used in an antenna array and the parameter Input Pattern Coordinate System is set to phi-theta setting this check box rotates the template in such a way that -the axis of the coordinate system of the element was directed along the grid normal.

Use this parameter together with the Array normal parameter of the URA and UCA arrays.

Dependencies

To enable this parameter, set the Element type parameter to Custom Antenna.

Default value

true (switched on)

Program usage name

AlignElementNormal

Tunable

No

Evaluatable

No

# Polar pattern frequencies (Hz) — frequencies of the polar radiation pattern of the microphone
Real number

Details

The response frequencies of a microphone with a polar pattern, given as a real scalar or vector 1 on . The response frequencies are in the frequency range specified by the Operating frequency vector (Hz) vector.

Dependencies

To enable this parameter, set the Element type parameter to Custom Microphone.

Default value

1e3

Program usage name

FrequencyPattern

Tunable

No

Evaluatable

Yes

# Polar pattern angles (deg) — angles of the radiation pattern response
Vector / matrix of real numbers

Details

Specify the response angles of the polar radiation pattern in the form of a vector 1 on . The angles are measured from the central axis of the microphone and should be in the range from -180° to 180° inclusive.

Dependencies

To enable this parameter, set the Element type parameter to Custom Microphone.

Default value

-180:180

Program usage name

AnglePattern

Tunable

No

Evaluatable

Yes

# Polar pattern (dB) — custom microphone polar characteristic
Vector / matrix of real numbers

Details

Set the value of the polar characteristic of the user microphone in the form of a matrix on . is the number of frequencies specified in the Polar pattern frequencies (Hz). is the number of angles specified in the Polar pattern angles (deg). Each row of the matrix represents the value of the polar radiation pattern measured at the corresponding frequency specified in Polar pattern frequencies (Hz) and all angles specified in Polar pattern angles (deg).

The pattern is measured in the azimuthal plane. In the azimuthal plane, the elevation angle is 0°, and the central axis of capture is 0° degrees in azimuth and 0° degrees in elevation. The radiation pattern is symmetrical around the central axis. Based on the polar radiation pattern, you can build a microphone radiation pattern in three-dimensional space.

Dependencies

To enable this parameter, set the Element type parameter to Custom Microphone.

Default value

zeros(1, 361)

Program usage name

PolarPattern

Tunable

No

Evaluatable

Yes

# Operating frequency range (Hz) — the operating frequency range of the antenna or microphone
Array of real numbers

Details

Specify the operating frequency range of the antenna or microphone as a 1 by 2 vector in the form [LowerBound,UpperBound]. The element has no response outside this frequency range.

Dependencies

To enable this parameter, set the Element type parameter to Isotropic Antenna, Cardioid Antenna, Cosine Antenna, Gaussian Antenna, Sinc Antenna or Omni Microphone.

Frequency measurement units

Hz

Default value

[0 1e20]

Program usage name

OperatingFrequencyRange

Tunable

No

Evaluatable

Yes

# Radiation pattern beamwidth (deg) — angles of the radiation pattern solution
Scalar / array of real numbers

Details

The angles of the radiation pattern solution in degrees.

Dependencies

To use this parameter, set the Element type parameter to Gaussian Antenna or Sinc Antenna.

Default value

[10, 10]

Program usage name

RadiationPatternBeamwidth

Tunable

No

Evaluatable

Yes

# Null axis direction — direction of the zero radiation axis
String

Details

The direction of the zero radiation axis.

Dependencies

To use this parameter, set the Element type parameter to Cardioid Antenna.

Default value

-x

Program usage name

NullAxisDirection

Tunable

No

Evaluatable

No

# Exponent of cosine pattern — setting the exponents of azimuthal and altitude cosine radiation patterns
Scalar / array of real numbers

Details

Exponentials of the cosine model in the form of a non-negative scalar or a 1 by 2 real matrix of non-negative values. If the Exponent of cosine pattern is a 1 by 2 vector, then the first element is the exponent in the azimuth direction, and the second is in the location direction. With a scalar value of this parameter, the cosines in the azimuthal and elevation directions are raised to one power.

Dependencies

To use this parameter, set the Element type parameter to Cosine Antenna.

Default value

[1.5 1.5]

Program usage name

ExponentCosinePattern

Tunable

No

Evaluatable

Yes

# Baffle the back of the element — zero element feedback Isotropic Antenna or an element Omni Microphone
Logical

Details

Select this option to mute the feedback of the element. With the reverse deflector, the responses at all azimuth angles exceeding 90° from the wide side, set to zero. The wide side is defined as 0° azimuth angle and 0° elevation angle.

Dependencies

To enable this checkbox, set the Element type parameter to Isotropic Antenna or Omni Microphone.

Default value

false (switched off)

Program usage name

BaffleBackElement

Tunable

No

Evaluatable

No

Array

# Geometry — type of antenna array elements
ULA | URA | UCA | Conformal array

Details

Specify the type of antenna array elements as one of the following:

  • ULA

  • URA

  • UCA

  • Conformal array

Values

ULA | URA | UCA | Conformal array

Default value

ULA

Program usage name

Geometry

Tunable

No

Evaluatable

No

# Number of elements — number of antenna array elements in ULA
Real number

Details

The number of antenna array elements for ULA arrays, set as an integer greater than or equal to two.

Example

11

Default value

2

Program usage names

NumberElementsULA, NumberElementsUCA, NumberElementsULAPart

Tunable

No

Evaluatable

Yes

# Radius of UCA (m) — the radius of the UCA antenna array
Real number

Details

The radius of the UCA antenna array, set as a positive scalar.

Dependencies

To enable this parameter, set the Geometry parameter to UCA.

Default value

0.5

Program usage name

RadiusUCA

Tunable

No

Evaluatable

Yes

# Array size — the dimension of the URA antenna array
Scalar / array of real numbers

Details

The dimension of the URA antenna array, specified as a positive integer or a vector of positive integers 1 by 2.

  • If Array size is a 1 by 2 vector, then the vector has the form [NumberOfArrayRows,NumberOfArrayColumns].

  • If Array size is an integer, then the grid has the same number of rows and columns.

  • If you set the Specify sensor array as parameter to Replicated subarray, this parameter is applied to each subarray.

For URA, the grid elements are indexed from top to bottom in the leftmost column, and then move to the next columns from left to right.

In this picture, the value is [3,2] The Array size parameter creates a grid consisting of three rows and two columns.

angle doppler response 1

Dependencies

To enable this parameter, set the Geometry parameter to URA.

Default value

[2 2]

Program usage name

ArraySize

Tunable

No

Evaluatable

Yes

# Element spacing (m) — distance between ULA elements
Scalar / array of real numbers

Details

The distance between neighboring ULA elements, specified as a positive scalar.

Example

1.5

Default value

0.5

Program usage names

ElementSpacingULA, ElementSpacingURA

Tunable

No

Evaluatable

Yes

# Array axis — direction of the ULA linear axis
x | y | z

Details

The direction of the ULA linear axis, defined as y, x or z. All elements of the ULA grid are uniformly distributed along this axis in the local grid coordinate system.

Dependencies

To enable this parameter, set the Geometry parameter to ULA.

Values

x | y | z

Default value

y

Program usage name

ArrayAxis

Tunable

No

Evaluatable

No

# Element lattice — positions of the URA grid elements
Rectangular | Triangular

Details

The positions of the elements of the URA grid, given as Rectangular or Triangular.

  • Rectangular – aligns all elements in the row and column directions.

  • Triangular – shifts the elements of an even row of a rectangular grid towards the positive direction of the row axis. The offset is half the distance between the elements according to the size of the row.

Dependencies

To enable this parameter, set the Geometry parameter to URA.

Values

Rectangular | Triangular

Default value

Rectangular

Program usage name

ElementLattice

Tunable

No

Evaluatable

No

# Array normal — the direction of the lattice normal
x | y | z

Details

The direction of the lattice normal, indicated as x, y or z.

The elements of the plane lattices lie in a plane orthogonal to the chosen direction of the sublattice normal.

The viewing directions of the elements point along the direction of the grid normal:

The value of the Array Normal parameter

Positions of the elements and directions of sight

x

The elements of the lattice lie in yz-planes. All the height vectors of the elements are directed along the x axis.

y

The lattice elements lie in the zx-plane. All the high beam vectors of the elements are directed along the y-axis.

z

The lattice elements lie in the xy-plane. All the high beam vectors of the elements are directed along the z axis.

Dependencies

To enable this parameter, set the Geometry parameter to URA or UCA.

Values

x | y | z

Default value

x

Program usage names

ArrayNormalURA, ArrayNormalUCA

Tunable

No

Evaluatable

No

# Element positions (m) — positions of the elements of the conformal lattice
Array of real numbers

Details

The positions of the elements in the conformal lattice, given as a real matrix 3 on N, where N is the number of elements in the conformal lattice. Each column of this matrix represents a coordinate [x;y;z] an element of the lattice in the local coordinate system of the lattice. The origin of the local coordinate system is (0,0,0).

The units of measurement are m.

Dependencies

To enable this parameter, set the Geometry parameter to Conformal Array.

Default value

[0, 0, 0]

Program usage names

ElementPositions, ElementPositionsPart

Tunable

No

Evaluatable

Yes

# Element normals (deg) — the direction of the normal vectors of the elements of the conformal lattice
Array of real numbers

Details

The direction of the normal vectors of the elements in a conformal lattice, defined as a column vector 2 by 1 or a matrix 2 by N. N indicates the number of elements in the grid. For the matrix, each column sets the direction of the normal of the corresponding element in the form [azimuth;elevation] relative to the local coordinate system.

The local coordinate system aligns the positive x-axis with the direction of the normal to the conformal lattice.

If the parameter value is a column vector 2 by 1, then the same direction is used for all grid elements.

You can use the Element positions (m) parameters and Element normals (deg) to represent any arrangement in which pairs of elements differ by certain transformations. Transformations can combine translation, azimuth rotation, and elevation rotation. However, you cannot use transformations that require rotation relative to the direction of the normal.

Dependencies

To enable this parameter, set the Geometry parameter to Conformal Array.

Default value

[0, 0]

Program usage name

ElementNormals

Tunable

No

Evaluatable

Yes

# Taper — complex weighting coefficients for amplitude weighing
Scalar / array of real and/or complex numbers

Details

Complex weighting coefficients for antenna array elements, given as a complex scalar, a complex string vector on or a complex column vector on , where It represents the number of antenna array elements. Weighting factors are applied to each antenna element of the antenna array and change the amplitude and phase of the received data.

  • If Taper is a scalar, the same coefficient value is applied to all elements of the antenna array.

  • If Taper is a vector, its own coefficient value is applied to each element of the antenna array.

Default value

1

Program usage name

Taper

Tunable

No

Evaluatable

Yes