Main Content

accessStatus

Status of access between first and last node defining access analysis

    Description

    s = accessStatus(ac) returns the access status history between the first and last node defining each access object in the input vector.

    s = accessStatus(ac,timeIn) returns the status of each access analysis object at the specified datetime in timeIn.

    [s,timeOut] = accessStatus(___) returns the status of each access analysis object and the corresponding datetime in Universal Time Coordinated (UTC).

    Input Arguments

    collapse all

    Access analysis, specified as a row vector of Access objects.

    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.

    Outputs Arguments

    collapse all

    Access analysis status, returned as a scalar or row vector of logical values. If timeIn is specified, s is a row vector, otherwise, the output is a scalar. The status at a given instant is 1 (true) if access exists between each pair of adjacent nodes defined by Sequence. For example, in a given pair, say defined by node1 and node2, node1 has access to node2 and vice versa.

    • If a node is a satellite, then the satellite has access to the adjacent node if both nodes are in line of sight of each other.

    • If a node is a ground station, then the ground station has access to the adjacent node if the elevation angle of the node with respect to the ground station is greater than or equal to the MinElevationAngle property of GroundStation.

    • If a node is a conical sensor, then the conical sensor has access to the adjacent node if the latter is in the field of view of the former. If the conical sensor is attached to a ground station directly or via a gimbal, then the elevation angle of the adjacent node with respect to the ground station must be greater than or equal to the MinElevationAngle property of GroundStation.

    Time samples of the output access status, returned as a scalar or vector. If the time history of the access status is returned, timeOut is a row vector.

    Introduced in R2021a