# mergesigroi

Merge signal regions of interest

Since R2020b

## Syntax

``roilimsout = mergesigroi(roilims,s)``

## Description

example

````roilimsout = mergesigroi(roilims,s)` merges the signal regions of interest specified in `roilims` if they are separated by `s` samples or less.```

## Examples

collapse all

Consider a two-column matrix of integers that can represent regions of interest of a signal. Merge any regions that are separated by four samples or less.

```rois = [1 10; 17 26; 28 43; 47 57; 64 66]; xrois = mergesigroi(rois,4)```
```xrois = 3×2 1 10 17 57 64 66 ```

Specify the maximum separation as zero to merge contiguous or repeated regions.

```nrois = [rois; 57 65; 1 10]; xrois = mergesigroi(rois,0)```
```xrois = 5×2 1 10 17 26 28 43 47 57 64 66 ```

Consider a two-column matrix of integers that can represent regions of interest of a signal. Merge any regions that are separated by four samples or less. The function merges overlapping regions in all cases.

```rois = [1 10; 17 26; 24 32; 36 40]; xrois = mergesigroi(rois,4)```
```xrois = 2×2 1 10 17 40 ```

Specify the maximum separation as zero to merge contiguous or repeated regions.

```nrois = [rois; 41 45; 1 10]; xrois = mergesigroi(rois,0)```
```xrois = 3×2 1 10 17 32 36 40 ```

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

Maximum separation between regions of interest to merge, specified as a nonnegative integer.

If you specify `s` as `0`, `mergesigroi` merges contiguous, overlapping, or repeated regions specified in `roilims`.

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