Main Content

Pattern

Radiation pattern visualization

    Description

    The Pattern object defines a radiation pattern visualization for a transmitter or receiver.

    Creation

    You can create Pattern objects by using the pattern object function of the Transmitter or Receiver object.

    Properties

    expand all

    Size of the radiation pattern plot, specified as a numeric scalar in meters. This value represents the distance between the antenna position and the point on the plot with the highest gain.

    Data Types: double

    Colormap for coloring the pattern plot, specified as a predefined colormap name or an M-by-3 matrix of red, green, blue (RGB) triplets that define M individual colors. For more information on the colormap names, see map.

    Data Types: double | string | char

    Transparency of the pattern plot, specified as a scalar in the range [0, 1]. A value of 0 means the plot is completely transparent, and a value of 1 means the plot is opaque.

    Data Types: double

    Visibility of the graphic relative to its parent, specified as 'inherit' or 'manual'. This visibility mode determines the visibility of this graphic in the satelliteScenarioViewer object relative to its parent graphic. The parent graphic of the Pattern object is its corresponding satellite.

    • 'inherit'— Inherit visibility from the parent graphic. The visibility of the graphic matches the parent visibility.

    • 'manual'— Do not inherit visibility from the parent. The visibility of the graphic is independent of the parent visibility.

    Data Types: char | string

    Object Functions

    showShow object in satellite scenario viewer
    hideHides satellite scenario entity from viewer

    Examples

    collapse all

    Set up the satellite scenario.

    startTime = datetime(2021,2,12,13,30,0);
    stopTime = startTime + hours(5);
    sampleTime = 60;                                      %seconds
    sc = satelliteScenario(startTime,stopTime,sampleTime);

    Create a satellite, ground station, transmitter, and receiver.

    sat = satellite(sc,1e7,0,0,0,0,0);
    gs = groundStation(sc,"Latitude",30,"Longitude",74);
    tx = transmitter(sat,"Frequency",30e9);
    rx = receiver(gs);

    Visualize the scenario in the satellite scenario viewer.

    viewer = satelliteScenarioViewer(sc);

    Plot the radiation pattern of the transmitter antenna.

    pat = pattern(tx);

    Point the satellite at the ground station. The pattern rotates to reflect the new orientation of the antenna.

    pointAt(sat,gs);

    Increase the visual size of the radiation pattern.

    pat.Size = 2000000;
    pat.Colormap = "parula";

    Introduced in R2021b