Main Content

pointAt

Target at which entity must be pointed

    Description

    Satellite Object

    pointAt(sat,coordinates) sets the attitude of the satellite sat such that its yaw (body z axis) tracks the geographical coordinates [latitude; longitude; altitude] specified by coordinates. The function constantly adjusts the attitude of the satellite so that its yaw (body z) axis points at the desired target. Its roll (body x) axis is aligned with the inertial velocity vector by minimizing the angle between them (exact alignment can be geometrically impossible).

    pointAt(sat,target) sets the attitude of the satellite sat such that its yaw axis tracks the specified target.The input target can be another satellite or ground station.

    pointAt(sat,'nadir') sets the attitude of the satellite sat such that its yaw axis points in the nadir direction.

    Gimbal Object

    pointAt(gim,'none') sets the steering angles (gimbal azimuth and gimbal elevation) of the gimbal gim to zero.

    pointAt(gim,coordinates) steers gim independent of the parent such that its body z- axis tracks the geographical coordinates [latitude; longitude; altitude] specified by coordinates.

    The desired orientation is achieved by rotating the gimbal about its body z-axis (gimbal azimuth) and secondly rotating the gimbal about its body y-axis (gimbal elevation). The function continuously steers the gimbal for the duration of the simulation so that the gimbal points at the desired target.

    pointAt(gim,target) steers gim such that its body z-axis tracks the specifiedtarget. target can be another satellite or ground station.

    pointAt(gim,'nadir') steers gim such that its body z-axis points in the nadir direction of the parent, namely, the parent's latitude, longitude, and 0 m altitude.

    Input Arguments

    collapse all

    Satellite, specified as a Satellite object.

    Gimbal, specified as a Gimbal object.

    Geographical coordinates of the satellite or gimbals' target, specified as a three-element row vector. The latitude and longitude are specified in degrees, and the altitude is specified as the height above the surface of the Earth in meters.

    Target at which input sat or gim is pointed, specified as a Satellite or GroundStation object.

    Introduced in R2021a