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. In the example Visualize Coordinate Axes Triad of Satellite, the x-axis (roll) is red in color, the y-axis (pitch) is green, and z-axis (yaw) is blue.

Creation

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

Properties

Scale — Scale size of coordinate axes triad graphic

1 (default) | positive scalar

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

Data Types: double

VisibilityMode — Visibility of body coordinate axes triad

'auto' (default) | 'inherit' | 'manual'

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

show	Show object in satellite scenario viewer
hide	Hide satellite scenario entity from viewer

Examples

Visualize Coordinate Axes Triad of Satellite

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);

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

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

Add a ground station to the scenario.

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

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);

Play the scenario.

play(sc); 

Version History

Introduced in R2023a