linkIntervals

Intervals during which link is closed

collapse all in page

    Syntax

    interval = linkIntervals(lnk)

    Description

    interval = 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.

    Note

    This calculation uses the standard free‑space path loss model (FSPL) when computing received power.

    example

    Examples

    collapse all

    Open Live Script

    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);
pattern(tx);

    Add a ground station to the scenario.

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

    Add a receiver to the ground station.

    rx = receiver(gb);
pattern(rx,tx.Frequency);

    Create a downlink.

    pointAt(gb,sat);
pointAt(sat,gs);
lnk = link(tx,rx);

    Obtain the intervals table of the closed downlink.

    intervals = linkIntervals(lnk)
    intervals=8×8 table
        Source            Target       IntervalNumber         StartTime                EndTime           Duration    StartOrbit    EndOrbit
    _______________    ____________    ______________    ____________________    ____________________    ________    __________    ________

    "Transmitter 2"    "Receiver 5"          1           13-Oct-2020 07:25:00    13-Oct-2020 07:26:00        60          1            1    
    "Transmitter 2"    "Receiver 5"          2           13-Oct-2020 09:42:00    13-Oct-2020 10:33:00      3060          1            2    
    "Transmitter 2"    "Receiver 5"          3           13-Oct-2020 12:50:00    13-Oct-2020 13:41:00      3060          2            3    
    "Transmitter 2"    "Receiver 5"          4           13-Oct-2020 15:58:00    13-Oct-2020 16:49:00      3060          4            4    
    "Transmitter 2"    "Receiver 5"          5           13-Oct-2020 19:05:00    13-Oct-2020 19:56:00      3060          5            5    
    "Transmitter 2"    "Receiver 5"          6           13-Oct-2020 22:12:00    13-Oct-2020 23:03:00      3060          6            6    
    "Transmitter 2"    "Receiver 5"          7           14-Oct-2020 01:20:00    14-Oct-2020 02:10:00      3000          7            7    
    "Transmitter 2"    "Receiver 5"          8           14-Oct-2020 04:27:00    14-Oct-2020 05:18:00      3060          8            8

    Input Arguments

    collapse all

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

    Output 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 as Source, Target, IntervalNumber, StartTime, EndTime, Duration (in seconds), StartOrbit, and EndOrbit. Both StartTime and EndTime are expressed in UTC. Source and Target are the names of the first and last node, respectively, which 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 Target. Otherwise, StartOrbit and EndOrbit are NaN because they are associated with ground stations.

    Note

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

    Version History

    Introduced in R2021a

    See Also

    Objects

    Functions

    Topics