Main Content

arrayConfig

Create phased array configuration

Since R2020b

    Description

    The arrayConfig object sets phased array configuration properties. Use an arrayConfig object to configure a uniform rectangular array (URA) with isotropic antenna elements, a uniform linear array (ULA) with isotropic antenna elements, or a single isotropic antenna element.

    Creation

    Description

    cfgArray = arrayConfig creates a configuration object with default property values. The x-axis is normal to the plane on which the elements are placed. The default array is a 2-by-2 URA with an element spacing of 0.5 meter.

    example

    cfgArray = arrayConfig(Name,Value) sets properties using one or more name-value pair arguments. Enclose each property name in quotes. For example, arrayConfig('Size',[8 1],'ElementSpacing',0.1) specifies an eight-element ULA along the z-axis with an element spacing of 0.1 meter.

    Properties

    expand all

    This property is read-only.

    Array element, returned as 'isotropic'. Array elements are isotropic radiators.

    Data Types: char | string

    Antenna array size, specified as a two-element row vector of positive integers. The first element specifies the number of rows of the antenna array and the second element specifies the number of columns of the antenna array. The rows of the array are along the z-axis. The columns of the array are along the y-axis.

    • When both elements of this vector are greater than 1, the array is a URA.

    • When one element of this vector is 1, the array is a ULA.

    • When both elements of this vector are 1, the array is a single isotropic element.

    Array elements are indexed from top to bottom along a column, continuing to the next column from left to right. For more information, see Array Alignment.

    Data Types: double

    Antenna array element spacing in meters, specified as one of these values.

    • A positive scalar — This value specifies the spacing between rows and the spacing between columns of the antenna array.

    • A two-element vector of positive values — The first element of the vector specifies the spacing between rows of the antenna array. The second element specifies the spacing between columns of the antenna array.

    The rows of the array are along the z-axis, and the columns of the array are along the y-axis. For more information, see Array Alignment.

    Dependencies

    To enable this property, set at least one element in the Size property vector to a value greater than 1.

    Data Types: double

    Examples

    collapse all

    Configure a 4-by-4 URA with an element spacing of 0.1 meter along rows and 0.2 meter along columns.

    cfgArray = arrayConfig("Size",[4 4],"ElementSpacing",[0.1 0.2])
    cfgArray = 
      arrayConfig with properties:
    
                  Size: [4 4]
        ElementSpacing: [0.1000 0.2000]
    
       Constant properties:
               Element: 'isotropic'
    
    

    Configure an eight-element ULA along the z-axis with an element spacing of 0.1 meter.

    cfgArray = arrayConfig("Size",[8 1],"ElementSpacing",0.1);

    Assign the array to a transmitter site and display the antenna pattern.

    tx = txsite("Antenna",cfgArray);
    pattern(tx,'Size',6);

    More About

    expand all

    Extended Capabilities

    C/C++ Code Generation
    Generate C and C++ code using MATLAB® Coder™.

    Version History

    Introduced in R2020b

    See Also

    Objects