Documentation

This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English verison of the page.

Note: This page has been translated by MathWorks. Please click here
To view all translated materals including this page, select Japan from the country navigator on the bottom of this page.

winner2.AntennaArray

Create antenna array

Download Required: To use this function, first download the WINNER II Channel Model for Communications System Toolbox™ from the Add-On Explorer. For more information on downloading add-ons, see Get Add-Ons (MATLAB) and Manage Your Add-Ons (MATLAB).

Syntax

antArray = winner2.AntennaArray
antArray = winner2.AntennaArray(Name,Value)

Description

antArray = winner2.AntennaArray returns a structure representing an antenna array with one isotropic antenna element. Both the antenna array and the single element have no rotation and are located at the origin, [0;0;0].

example

antArray = winner2.AntennaArray(Name,Value) returns a structure representing an antenna array defined using one or more Name,Value pair arguments.

For more information, see Antenna Array Model.

Examples

Create WINNER2 Eight Element Uniform Circular Array

Use the winner2.AntennaArray function to create an eight element uniform circular array (UCA-8) with a 1 cm radius.

UCA8 = winner2.AntennaArray('UCA',8,0.01);

Plot element positions

pos = {UCA8.Element(:).Pos};
plot(cellfun(@(x) x(1),pos),cellfun(@(x) x(2),pos),'+');
xlim([-0.02 0.02]); 
ylim([-0.02 0.02]);
title('UCA-8 Element Positions');

Create WINNER2 Two Element Uniform Linear Array

Use the winner2.AntennaArray function to create a two element uniform linear array (ULA-2) with 50 cm spacing and the dipole elements slanted at +45 and -45 degrees.

az = -180:179; % 1-degree spacing
pattern = cat(1,shiftdim(winner2.dipole(az,45),-1), ...
    shiftdim(winner2.dipole(az,-45),-1));
ULA2 = winner2.AntennaArray('ULA',2,0.5, ...
    'FP-ECS',pattern,'Azimuth',az);

Input Arguments

collapse all

Name-Value Pair Arguments

Specify optional comma-separated pairs of Name,Value arguments. Name is the argument name and Value is the corresponding value. Name must appear inside single quotes (' '). You can specify several name and value pair arguments in any order as Name1,Value1,...,NameN,ValueN.

Example: 'Pos',[1 0 0; 0 1 0],'Rot',[0 0 0; 0 pi() 0] indicates the coordinates and rotation angles for two antenna elements.

collapse all

Position of each antenna element, specified as the comma-separated pair consisting of 'Pos' and a column vector or an NE-by-3 matrix. The three columns represent the x-, y-, and z-coordinates in meters from the origin. NE indicates the number of elements in the antenna array. The elements have no rotation. When there is more than one element, the 'Element' field of antArray is a row vector of structures representing all the elements.

Example: 'Pos',[63.1 10.2 11.5; 62 11 12] indicates the coordinates for two antenna elements.

Data Types: double

Rotation angle of each antenna element, specified as the comma-separated pair consisting of 'Rot' and a column vector or an NE-by-3 matrix. The three columns represent the RotX, RotY, and RotZ rotation angles of each antenna element in radians. NE indicates the number of elements in the antenna array. Rot only applies when Pos is specified. If not specified with Pos, the rotation angle is 0.

Example: 'Rot',[2 1.5 0; 0 pi() 0] indicates the rotation angles for two antenna elements.

Data Types: double

Uniform circular antenna array, specified as the comma-separated pair consisting of 'UCA' and N,Rad. In this argument, N indicates the number of elements (NE) and Rad indicates the radius in meters. If Rad is not specified, the default radius is 1 meter.

Example: 'UCA',8,0.5 indicates an eight element uniform circular array with 0.5 meter radius.

Data Types: double

Uniform linear antenna array, specified as the comma-separated pair consisting of 'ULA' and N,Spacing. In this argument, N indicates the number of elements (NE) and Spacing indicates the separation between adjacent elements in meters. If Spacing is not specified, the default separation is 1/N meters.

ULA elements are placed along x-axis with the center of the array at [0;0;0]. For an even number of elements, there is no antenna element at [0;0;0].

Example: 'ULA',3,0.25 indicates a three element uniform linear array with 0.25 meter spacing between adjacent elements.

Data Types: double

Field pattern of element coordinate system, specified as the comma-separated pair consisting of 'FP-ECS' and a P-by-2-by1-by-NAZ array.

  • The first dimension, P, can be either 1 or any number greater than or equal to the number of elements in the antenna array (NE). When P = 1, the same pattern applies to all elements. When P > NE, the first NE rows apply.

  • The second dimension, 2, indicates that two polarizations characterize the field pattern. The first dimension in the field pattern stores vertical polarization, and the second one stores horizontal polarization.

  • The third dimension, 1, indicates that one elevation angle characterizes the field pattern.

  • The fourth dimension, NAZ, is the number of field pattern samples taken between –180 and 180 degrees. NAZ equals the number of elements specified in Azimuth or when Azimuth is not present it equals the number of equidistant field pattern samples taken over azimuth angle.

Data Types: double

Field pattern array coordinate system, specified as the comma-separated pair consisting of 'FP-ACS' and a P-by-2-by1-by-NAZ array. Array format is the same as the FP-ECS syntax, except that the field pattern is specified in the array-coordinate-system (ACS).

  • The first dimension, P, can be either 1 or any number greater than or equal to the number of elements in the antenna array (NE). When P = 1, the same pattern applies to all elements. When P > NE, the first NE rows apply.

  • The second dimension, 2, indicates that two polarizations characterize the field pattern. The first dimension in the field pattern stores vertical polarization, and the second one stores horizontal polarization. Missing polarization dimensions of the field pattern are substituted with zeros.

  • The third dimension, 1, indicates that one elevation angle characterizes the field pattern.

  • The fourth dimension, NAZ, is the number of field pattern samples taken between –180 and 180 degrees. NAZ equals the number of elements specified in Azimuth or when Azimuth is not present it equals the number of equidistant field pattern samples taken over azimuth angle.

Data Types: double

Azimuth angles for FP-ACS or FP-ECS field patterns in degrees , specified as the comma-separated pair consisting of 'Azimuth' and an 1-by-NAZ row vector. The values in the row vector indicate azimuth angles for elements in the field patterns.

Note

Azimuth applies only when FP-ACS or FP-ECS are defined. If Azimuth is not specified, uniform spacing is used for elements in the field pattern.

Example: 'Azimuth',[0 10 20 90 180 270 340 350]

Data Types: double

Output Arguments

collapse all

Antenna array definition, returned as a structure containing these fields.

Antenna array name, returned as a character vector.

Antenna array position, returned as a 3-by-1 vector, representing the x-, y-, and z-coordinates in meters from the origin.

Antenna array rotation, returned as a 3-by-1 vector, representing the RotX, RotY, and RotZ rotation angles of each antenna element in radians.

Element definition, returned as a row vector of structures, with each structure representing one element and containing these fields.

Antenna array position, returned as a 3-by-1 vector, representing the x-, y-, and z-coordinates in meters from the origin.

Antenna array rotation, returned as a 3-by-1 vector, representing the RotX, RotY, and RotZ rotation angles of each antenna element in radians.

Aperture definition, returned as a structure representing the antenna aperture.

More About

collapse all

Antenna Array Model

To create an antenna array model, you must define the geometry of array elements (positions and rotation) and the element field patterns. The arguments provided to winner2.AntennaArray are always processed such that the array geometry is created first, and then the field patterns are assigned.

For a detailed description of the antenna array specification for the WINNER channel model, see WINNER II Channel Models [1], Section 4.1.

References

[1] Kyosti, Pekka, Juha Meinila, et al. WINNER II Channel Models. D1.1.2 V1.2. IST-4-027756 WINNER II, September 2007.

Introduced in R2017a

Was this topic helpful?