tsmp (version 0.3.1)

find_motif: Search for Motifs

Description

Search for Motifs

Usage

find_motif(.mp, ...)
# S3 method for MatrixProfile
find_motif(.mp, data, n_motifs = 3, radius = 3,
  exclusion_zone = NULL, ...)
# S3 method for MultiMatrixProfile
find_motif(.mp, data, n_motifs = 3,
  mode = c("guided", "unconstrained"), n_bit = 4,
  exclusion_zone = NULL, n_dim = NULL, ...)

Arguments

.mp

a TSMP object of class MatrixProfile or MultiMatrixProfile.

...

further arguments to be passed to class specific function.

data

the data used to build the Matrix Profile, if not embedded.

n_motifs

an int. Number of motifs to find. (Default is 3).

radius

an int. Radius. (Default is 3).

exclusion_zone

if a number will be used instead of embedded value. (Default is NULL).

mode

a string. Guided or Unconstrained search. Allow partial match. (Default is guided).

n_bit

an <U+00EC>nt. Bit size for discretization. Ignored on Guided search. (Default is 4).

n_dim

an int. Number of dimensions to use on Guided search instead of embedded value. (Default is NULL).

Value

For class MatrixProfile, returns the input .mp object with a new name motif. It contains: motif_idx, a list of motif pairs founded and motif_neighbor a list with respective motif's neighbors.

For class MultiMatrixProfile, returns the input .mp object with a new name motif. It contains: motif_idx, a vector of motifs founded and motif_dim a list the dimensions where the motifs were founded.

Examples

# NOT RUN {
# Single dimension data
w <- 50
data <- mp_gait_data
mp <- tsmp(data, window_size = w, exclusion_zone = 1/4, verbose = 0)
mp <- find_motif(mp)

# Multidimension data
w <- mp_toy_data$sub_len
data <- mp_toy_data$data[1:300, ]
mp <- tsmp(data, window_size = w, mode = "mstomp", verbose = 0)
mp <- find_motif(mp)
# }