Main Content

platform

Create platform object for installed antenna setup

Description

The platform object creates a platform to install an antenna. You can import platform geometry from the STL, STEP, and IGES file formats.

Installed antenna analysis involves an electrically large structure called a platform. Antenna elements are placed on this platform at desired locations. You can analyze the effects of the platform on the antenna performance. Installed antenna analysis is commonly used in aerospace, defense, marine, and automotive applications. Common platforms are airplanes, satellites, drones, ships, trains, trucks, and cars.

Another common application of installed antenna analysis is to determine and mitigate the interference between multiple antennas operating at different frequencies on a large platform.

Creation

Description

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

example

plat = platform(Name=Value) sets properties using one or more name-value arguments. Name is the property name and Value is the corresponding value. You can specify several name-value arguments in any order as Name1=Value1,...,NameN=ValueN. Properties that you do not specify, retain their default values.

For example, ant = platform(FileName="reflector.stl",Units="m") creates a platform object defined by the data in the file reflector STL file and sets the unit of measurement to meters.

example

Output Arguments

expand all

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

Properties

expand all

Name of the platform geometry information file to import, specified as a string scalar. The supported file formats are STL, STEP, and IGES.

Example: "reflector.stl"

Data Types: string

Units for the geometry imported from the STL, STEP, or IGES file, specified as "m", "mm", "cm", "um", "ft", or "in".

Note

This property is read-only for STEP and IGES files.

Example: "m"

Data Types: string

Option to use the input geometry file directly as a mesh for analysis, specified as a numeric or logical 1 (true) or 0 (false). To use the input file as a mesh, set this property to 1 (true).

Example: 1

Data Types: logical

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

Example: 90

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

Data Types: double

Tilt axis of the antenna, specified as one of these values:

  • Three-element vector of Cartesian coordinates in meters. In this case, each coordinate in the vector starts at the origin and lies along the specified points on the x-, y-, and z-axes.

  • Two points in space, specified as a 2-by-3 matrix corresponding to two three-element vectors of Cartesian coordinates. In this case, the antenna rotates around the line joining the two points.

  • "x", "y", or "z" to describe a rotation about the x-, y-, or z-axis, respectively.

For more information, see Rotate Antennas and Arrays.

Example: [0 1 0]

Example: [0 0 0;0 1 0]

Example: "Z"

Data Types: double | string

Object Functions

infoDisplay information about antenna, array, or platform
meshMesh properties of metal, dielectric antenna, or array structure
meshconfigChange meshing mode of antenna, array, custom antenna, custom array, or custom geometry
rcsCalculate and plot monostatic and bistatic radar cross section (RCS) of platform, antenna, or array
showDisplay antenna, array structures, shapes, or platform
stlwriteWrite mesh information to STL file

Examples

collapse all

Create a rectangular shape. Divide the shape into two triangles. Extract the shape vertices to determine the vertices of the triangles. Define the points connectivity list and use the triangulation function on this list and vertices.

w = shape.Rectangle;
v = getShapeVertices(w)
v = 4×3

   -0.5000   -1.0000         0
    0.5000   -1.0000         0
    0.5000    1.0000         0
   -0.5000    1.0000         0

c = [1 2 4; 2 3 4]
c = 2×3

     1     2     4
     2     3     4

tr = triangulation(c,v(:,1),v(:,2))
tr = 
  triangulation with properties:

              Points: [4x2 double]
    ConnectivityList: [2x3 double]

Create an STL file from the triangulation object.

stlwrite(tr,"customPlatForm.stl")

The software creates the customPlatform STL file. in your current folder. Use this file to create a platform object and visualize the platform.

plat = platform(FileName="customPlatForm.stl", Units="m")
plat = 
  platform with properties:

         FileName: "customPlatForm.stl"
            Units: "m"
    UseFileAsMesh: 0
             Tilt: 0
         TiltAxis: [1 0 0]

figure
show(plat)

Figure contains an axes object. The axes object with title Platform object, xlabel x (m), ylabel y (m) contains 2 objects of type patch. This object represents PEC.

This example shows how to create a platform from geometry files.

Create the first platform using an STL file and display the result.

p1 = platform(FileName="plateMesh.stl");
figure
show(p1)

Figure contains an axes object. The axes object with title Platform object, xlabel x (mm), ylabel y (mm) contains 2 objects of type patch. This object represents PEC.

Create the second platform using a STEP file and display the result.

p2 = platform(FileName="cylinder.step");
figure
show(p2)

Figure contains an axes object. The axes object with title Platform object, xlabel x (mm), ylabel y (mm) contains 2 objects of type patch. This object represents PEC.

Create the third platform using an IGES file and display the result.

p3 = platform(FileName="cube.iges");
figure
show(p3)

Figure contains an axes object. The axes object with title Platform object, xlabel x (mm), ylabel y (mm) contains 2 objects of type patch. This object represents PEC.

Version History

Introduced in R2019a

expand all