platform

Create platform object for installed antenna setup

Description

The platform object creates a platform to be used in an installed antenna setup.

Installed antenna analysis involves an electrically large structure called a platform. Around this platform different antenna elements are placed. You can analyze the effects of the platform on the antenna performance. Installed antenna analysis is commonly used in aerospace, defense, and auto applications. The platforms in this case are planes, ships, or inside the bumper of a car.

Another common application of installed antenna analysis is to determine the interference of different antennas placed on a large platform.

Creation

Description

example

plat = platform creates a platform object for an installed antenna setup. The default platform is a rectangular reflector in the X-Y plane stored in the plate.stl file.

plat = platform(Name,Value) sets properties using one or more name-value pairs. For example, ant = platform('FileName','reflector.stl') creates a platform object defined by the data in the file reflector.stl

Output Arguments

expand all

Platform for installed antenna setup, returned as a platform object.

Properties

expand all

STL file defining the platform, specified as a string or a character vector.

Example: plat = platform('FileName','reflector.stl') creates a platform with file name reflector.stl.

Example: plat = platform; plat.FileName = 'reflector.stl' creates a platform with file name reflector.stl.

Data Types: char | string

Units for the STL file, specified as a string array or character vector.

Example: plat = platform('Units','m') Creates a platform with STL file units in meters.

Example: plat = platform;plat.Units = 'm' Creates a platform with STL file units in meters.

Data Types: char | string

Use .stl file directly as a mesh for analysis, specified as '0' for false or '1' for true.

Example: plat = platform('UseFileAsMesh','1') Uses the .stl file in the FileName property directly as a mesh.

Example: plat = platform;plat.UseFileAsMesh = '1' Uses the .stl file in the FileName property directly as a mesh.

Data Types: logical

Tilt angle of the antenna, specified as a scalar or vector with each element unit in degrees. For more information, see Rotate Antennas and Arrays.

Example: 'Tilt',90

Example: 'Tilt',[90 90],'TiltAxis',[0 1 0;0 1 1] tilts the antenna at 90 degree about two axes, defined by vectors.

Data Types: double

Tilt axis of the antenna, specified as:

  • Three-element vectors of Cartesian coordinates in meters. In this case, each vector starts at the origin and lies along the specified points on the X-, Y-, and Z-axes.

  • Two points in space, each specified as three-element vectors of Cartesian coordinates. In this case, the antenna rotates around the line joining the two points in space.

  • A string input describing simple rotations around one of the principal axes, 'X', 'Y', or 'Z'.

For more information, see Rotate Antennas and Arrays.

Example: 'TiltAxis',[0 1 0]

Example: 'TiltAxis',[0 0 0;0 1 0]

Example: ant.TiltAxis = 'Z'

Object Functions

showDisplay antenna or array structure; Display shape as filled patch
meshMesh properties of metal or dielectric antenna or array structure
meshconfigChange mesh mode of antenna structure
stlwriteWrite mesh to STL file

Examples

collapse all

Create a waveguide antenna for operation at 8 GHz and compute the impedance.

w = design(waveguide,8e9);
Z = impedance(w,8e9);

Create an STL file for the above antenna.

stlwrite(w,'waveguide_8GHz.stl')

You will see the waveguide_8GHz.stl file in your current folder.

Load waveduide_8GHz.stl and visualize the platform.

plat = platform('FileName','waveguide_8GHz.stl','Units','m')
plat = 
  platform with properties:

         FileName: 'waveguide_8GHz.stl'
            Units: 'm'
    UseFileAsMesh: 0
             Tilt: 0
         TiltAxis: [1 0 0]

show(plat)

Introduced in R2019a