subtracks {celltrackR}

Decompose Track(s) into Subtracks

Description

Creates a tracks object consisting of all subtracks of 'x' with 'i' segments (i.e., 'i'+1 positions).

Usage

subtracks(x, i, overlap = i - 1)

Arguments

x

a single track or a tracks object.

i

subtrack length. A single integer, lists are not supported.

overlap

the number of segments in which each subtrack shall overlap with the previous and next subtrack. The default i - 1 returns all subtracks. Can be negative, which means that space will be left between subtracks.

Details

The output is always a single tracks object, which is convenient for many common analyses. If subtracks are to be considered separately for each track, use the function staggered together with lapply. Subtrack extraction always starts at the first position of the input track.

Value

A tracks object is returned which contains all the subtracks of any track in the input tracks object that consist of exactly 'i' segments and overlap adjacent subtracks in 'overlap' segments.

See Also

prefixes to extract all subtracks of a given length starting from the first coordinate in each track, subtracksByTime to extract all subtracks of a given length starting at some fixed timepoint, and selectSteps to extract single steps starting at a fixed timepoint from a subset of trackids.