## burst.BurstPairCollection


Collection of Sentinel-1 burst pairs for interferometric processing.


Usage

``` python
burst.BurstPairCollection(df=None)
```


Each entry contains a primary and secondary burst with matching spatial parameters but different acquisition times.


## Methods

| Name | Description |
|----|----|
| [from_pairs()](#from_pairs) | Create a BurstPairCollection from a collection of BurstPair objects. |
| [starting_within()](#starting_within) | Select the pairs whose primary burst was acquired on a day of a time range. |
| [unpair()](#unpair) | Convert burst pairs back into individual bursts. |

------------------------------------------------------------------------


#### from_pairs()


Create a BurstPairCollection from a collection of BurstPair objects.


Usage

``` python
from_pairs(pairs)
```


##### Parameters


`pairs: Collection[BurstPair]`  
Collection of BurstPair instances.


##### Returns


`BurstPairCollection`  
New BurstPairCollection instance.


------------------------------------------------------------------------


#### starting_within()


Select the pairs whose primary burst was acquired on a day of a time range.


Usage

``` python
starting_within(time_range)
```


The secondary burst may fall after the window, so a pair spanning its end is kept.


##### Parameters


`time_range: TimeRange`  
Inclusive window of calendar days, compared with the UTC day of the primary acquisition (`date_1`).


##### Returns


`Self`  
New collection of the pairs starting in the window, possibly empty.


------------------------------------------------------------------------


#### unpair()


Convert burst pairs back into individual bursts.


Usage

``` python
unpair()
```


Separates each burst pair into its primary and secondary bursts, creating a BurstCollection containing all individual bursts.


##### Returns


`BurstCollection`  
Collection containing all primary and secondary bursts from the pairs.