Main Content

linkIntervals

Intervals during which link is closed

    Description

    example

    int = linkIntervals(lnk) returns a table of intervals during which the link between the first node and last node in each link object input vector is closed.

    Examples

    collapse all

    Create a satellite scenario object.

    startTime = datetime(2020,10,13,7,25,0);
    stopTime = startTime + days(1);
    sampleTime = 60;                                       % seconds
    sc = satelliteScenario(startTime,stopTime,sampleTime);

    Add a satellite to the scenario.

    semiMajorAxis = 10000000;                               % meters
    eccentricity = 0;
    inclination = 10;                                       % degrees
    rightAscensionOfAscendingNode = 0;                      % degrees
    argumentOfPeriapsis = 0;                                % degrees
    trueAnomaly = 210;                                      % degrees
    sat = satellite(sc,semiMajorAxis,eccentricity, ...
        inclination,rightAscensionOfAscendingNode, ...
        argumentOfPeriapsis,trueAnomaly);

    Add a transmitter to the satellite.

    tx = transmitter(sat);

    Add a ground station to the scenario.

    latitude = 0;                             % degrees
    longitude = 30;                           % degrees
    gs = groundStation(sc,latitude,longitude);

    Add a receiver to the ground station.

    rx = receiver(gs,"MountingAngles",[0; 180; 0]);

    Create a downlink.

    lnk = link(tx,rx);

    Obtain the intervals table of the closed downlink.

    intervals = linkIntervals(lnk)
    intervals =
    
      0x8 empty table
    

    Input Arguments

    collapse all

    Link analysis object, specified as a Link object vector or scalar.

    Outputs Arguments

    collapse all

    Intervals during which the link is closed, returned as a table.

    Each row of the table denotes a specific interval, and the columns of the table are named Source, Target, IntervalNumber, StartTime, EndTime, Duration (in seconds), StartOrbit, and EndOrbit. Source and Target are the names of the first and last node, respectively, that define the link analysis.

    • If Source is directly or indirectly attached to a satellite, then StartOrbit and EndOrbit correspond to the satellite associated with Source.

    • If Target is directly or indirectly attached to a satellite, then StartOrbit and EndOrbit correspond to the satellite associated with the Target. Otherwise, StartOrbit and EndOrbit are NaN because they are associated with ground stations.

    Note

    When AutoSimulate of the satellite scenario is true, the intervals between StartTime and StopTime are returned. When it is false, the intervals between StartTime and SimulationTime are returned.

    Version History

    Introduced in R2021a