Main Content

CoordinateAxes

Coordinate axes triad graphic object

Since R2023a

    Description

    CoordinateAxes object defines a coordinate axes triad graphic that corresponds to the body frame of a satellite scenario asset.

    Creation

    You can create a CoordinateAxes object using the coordinateAxes object function of the Satellite, Platform (Satellite Communications Toolbox), GroundStation, Gimbal, or ConicalSensor.

    Properties

    expand all

    Scale size of coordinate axes triad, specified as a positive scalar.

    Data Types: double

    Visibility of coordinate axes triad graphic relative to the parent in the Satellite Scenario Viewer, specified as:

    • 'auto' — Hide coordinate axes triad.

    • 'inherit' — Inherit visibility from the asset.

    • 'manual' — Manually specify visibility. In this mode, the visibility of the coordinate axes triad is independent of the visibility of the asset.

    Data Types: string

    Object Functions

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

    Examples

    collapse all

    Create a satelliteScenario object.

    startTime = datetime(2020,4,25); % April 25, 2020, 12:00 AM UTC
    stopTime = datetime(2020,4,26);  % April 26, 2020, 12:00 AM UTC
    sampleTime = 60;                 % seconds
    sc = satelliteScenario(startTime,stopTime,sampleTime);

    Launch a satellite scenario viewer with ShowDetails set to false.

    v = satelliteScenarioViewer(sc,ShowDetails=false);

    coordinateAxes_example_1.png

    Add a low-earth orbit satellite constellation to the scenario from a TLE file.

    tleFile = "leoSatelliteConstellation.tle";
    sat = satellite(sc,tleFile);

    coordinateAxes_example_2.png

    Add a ground station to the scenario.

    gs = groundStation(sc);
    gs.ShowLabel = true;

    coordinateAxes_example_3.png

    Visualize the coordinate axes triads of the satellites.

    ax = coordinateAxes(sat)
    ax=1×40 object
      1×40 CoordinateAxes array with properties:
    
        Scale
        VisibilityMode
    
    

    Point the satellites towards the ground station. The coordinate axes triad object updates to represent the new direction of the satellites.

    pointAt(sat,gs);

    coordinateAxes_example_4.png

    Play the scenario.

    play(sc); 

    coordinateAxes_example_5.png

    Version History

    Introduced in R2023a