Main Content

gimbalAngles

Steering angles of gimbal

Description

az = gimbalAngles(gim) returns the gimbal azimuth of the specified gimbal, in degrees. The gimbal is steered to the desired pointing direction by first rotating it about its body z - axis (gimbal azimuth) and secondly rotating it about its body y - axis (gimbal elevation).

[az,el] = gimbalAngles(gim) returns the gimbal azimuth and gimbal elevation of the specified gimbal.

[az,el,timeOut] = gimbalAngles(gim) also returns the corresponding time in UTC.

[___] = gimbalAngles(gim,timeIn) returns the gimbal azimuth and gimbal elevation (depending on the specified output arguments) of the gimbal at the specified time. If you do not specify a time zone, the time zone is assumed to be Universal Time Coordinated (UTC).

Input Arguments

expand all

Gimbal whose steering angle is being calculated, specified as a scalar Gimbal object.

Time at which the output is calculated, specified as a scalar. If you do not specify a time zone, then the time zone is assumed to be UTC.

Output Arguments

expand all

Gimbal azimuth, returned as a scalar or row vector. This represents the angle of rotation of the gimbal about its z-axis.

Values are specified in degrees in the interval [-180, 180]. The vector elements correspond to the time samples from the satellite scenario StartTime to StopTime properties, as specified by the SampleTime property.

Gimbal elevation, returned as a scalar or row vector. This represents the angle of rotation of the gimbal about its y-axis.

Values are specified in degrees in the closed interval [0, 180]. The vector elements correspond to the time samples from the satellite scenario StartTime to StopTime properties, as specified by the SampleTime property.

Time samples between start and stop time of the scenario, returned as a scalar or vector. If az and el histories are returned, timeOut is a row vector.

Introduced in R2021a