# extendsigroi

Extend signal regions of interest to left and right

## Syntax

``roilimsout = extendsigroi(roilims,sl,sr)``

## Description

example

````roilimsout = extendsigroi(roilims,sl,sr)` extends the signal regions of interest specified in `roilims` to the left by `sl` samples and to the right by `sr` samples.```

## Examples

collapse all

Consider a two-column matrix of integers that can represent regions of interest of a signal. Extend the regions of interest by two samples to the left and three samples to the right. `extendsigroi` does not extend regions to the left beyond the first sample.

```rois = [1 8; 17 20; 27 31; 38 40]; xrois = extendsigroi(rois,2,3)```
```xrois = 4×2 1 11 15 23 25 34 36 43 ```

Consider a two-column matrix of integers that can represent overlapping regions of interest of a signal. Extend the regions of interest by two samples to the left and three samples to the right. `extendsigroi` does not extend regions to the left beyond the first sample.

```rois = [1 10; 17 26; 24 32; 38 40]; xrois = extendsigroi(rois,2,3)```
```xrois = 4×2 1 13 15 29 22 35 36 43 ```

## Input Arguments

collapse all

Region-of-interest limits, specified as a two-column matrix of positive integers. The ith row of `roilims` contains nondecreasing indices corresponding to the beginning and end samples of the ith region of interest of a signal.

Example: `[5 8; 12 20; 18 25]` specifies a two-column region-of-interest matrix with three regions.

Data Types: `single` | `double` | `int8` | `int16` | `int32` | `int64` | `uint8` | `uint16` | `uint32` | `uint64`

Number of samples to extend to the left, specified as a nonnegative integer.

Data Types: `single` | `double` | `int8` | `int16` | `int32` | `int64` | `uint8` | `uint16` | `uint32` | `uint64`

Number of samples to extend to the right, specified as a nonnegative integer.

Data Types: `single` | `double` | `int8` | `int16` | `int32` | `int64` | `uint8` | `uint16` | `uint32` | `uint64`

## Output Arguments

collapse all

Modified region-of-interest limits, returned as a two-column matrix of positive integers. Output limits are returned in sorted order using the `sortrows` function.

## Version History

Introduced in R2020b