Intervals during which link is closed

Since R2021a

## 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.```

example

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

Add a ground station to the scenario.

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

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

```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`. `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