Skip to contents

Generate spliced timeline using a Metre object

Usage

# S3 method for Metre
splice_time(
  x,
  window_duration = NULL,
  window_proportion = NULL,
  tactus = NULL,
  ...
)

Arguments

x

Metre object.

window_duration

duration of window around beat (may lead to overlapping windows if large).

window_proportion

sets the window duration around beat based on a proportion (0, 0.5] of the gap to the previous and following cycles. The first and last beats in each Metre are removed.

tactus

vector of Metres to subset on.

...

ignored.

Value

a Splice object.

Examples

r <- get_sample_recording()
m <- get_metre_data(r)
splicing_df <- splice_time(m, window_duration = 1)
head(splicing_df)
#>                   Segment  Tempo_Hz    Start      End
#> 1 VilambitTeental_Cycle_1 0.7541745 1146.500 1147.500
#> 2 VilambitTeental_Cycle_2 0.7738285 1167.715 1168.715
#> 3 VilambitTeental_Cycle_3 0.7680991 1188.392 1189.392
#> 4 VilambitTeental_Cycle_4 0.7471384 1209.222 1210.222
#> 5 VilambitTeental_Cycle_5 0.7697990 1230.637 1231.637
#> 6 VilambitTeental_Cycle_6 0.7825659 1251.422 1252.422
splicing_df <- splice_time(m, window_proportion = 0.25)
head(splicing_df)
#>                   Segment  Tempo_Hz    Start      End
#> 1 VilambitTeental_Cycle_2 0.7738285 1162.911 1173.384
#> 2 VilambitTeental_Cycle_3 0.7680991 1183.723 1194.099
#> 3 VilambitTeental_Cycle_4 0.7471384 1204.515 1215.076
#> 4 VilambitTeental_Cycle_5 0.7697990 1225.784 1236.334
#> 5 VilambitTeental_Cycle_6 0.7825659 1246.726 1257.033
#> 6 VilambitTeental_Cycle_7 0.7602259 1267.256 1277.629