Main Content

aer

Calculate azimuth angle, elevation angle, and range in NED frame from another satellite or ground station

    Description

    az = aer(objIn,target) returns the history of azimuth angles, between satellite or ground station objIn and another satellite or ground station target belonging to a given satelliteScenario object.

    [az,el] = aer(objIn,target) returns the history of elevation angles, el, between satellite or ground station objIn and another satellite or ground station target.

    [az,el,range] = aer(objIn,target) returns the history of the range of target with respect to objIn.

    [az,el,range,timeOut] = aer(objIn,target) returns the corresponding time in timeOut.

    [___] = aer(objIn,target,timeIn) returns the outputs at the specified datetime timeIn. Specify any output argument combinations from previous syntaxes.

    Input Arguments

    collapse all

    First scenario component, specified as a Satellite or GroundStation object.

    Second scenario component, specified as a Satellite or GroundStation object.

    Time at which output is calculated, returned as a scalar, vector, matrix, or N-D array. If no time zone is specified in timeIn, the time zone is assumed to be UTC.

    Output Arguments

    collapse all

    Azimuth angles of target in the local azimuth, elevation and range (AER) system, returned as a scalar or vector. Azimuths are measured clockwise from North. Values are specified in degrees in the interval [0, 360). The vector elements correspond to the time samples from the satellite scenario StartTime to StopTime properties, as specified by the SampleTime property. The azimuth angle is defined in the North-East-Down (NED) frame of (and centered at) objIn such that 0 degrees is North, 90 degrees is East, 180 degrees is South, and 270 degrees is West.

    Elevation angles of target in the local AER system, returned as a scalar or vector. Elevations are measured with respect to a plane that is perpendicular to the normal of the surface of the earth. If objIn is on the surface of the Earth, then the plane is tangent to the Earth.

    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. The elevation angle is defined in the NED frame of (and centered at) objIn such that 0 deg implies target is on the North East (NE) plane, 90 degrees implies target is directly above objIn, and -90 degrees implies target is directly below objIn.

    Distances from the local origin in meters, returned as a scalar or vector.

    Time samples corresponding to az, el, and range, returned as a scalar or vector.

    Introduced in R2021a