event_match_seq: Aufeinanderfolgende Ereignisse

In dnlvgt/rktiq: Toolbox zur Verarbeitung von Sensorsignalen

Description

Ordnet jedem Startereignis aus Menge x ein passendes Endereignis aus y zu. Dabei wird standardmaessig davon ausgegangen, dass der zugehoerige Startzeitpunkt der (zeitlich gesehen) letzte ist, der vor dem Endzeitpunkt liegt. Falls gewuenscht, werden die Spalten des resultierenden Dataframes umbenannt, um eine eindeutige Zuordnung zu ermoeglichen.

Usage

event_match_seq(
  x,
  y,
  time_var_x = "time",
  time_var_y = "time",
  last_before = TRUE,
  is_strict = TRUE,
  remove_na = TRUE,
  .progress = FALSE
)

Arguments

x	Dataframe mit der Startereignismenge x.
y	Dataframe mit der Endereignismenge y.
time_var_x	Spaltenname (Symbol oder String) der Zeitvariable in Dataframe x (Default: "time").
time_var_y	Spaltenname (Symbol oder String) der Zeitvariable in Dataframe y (Default: "time").
last_before	Logischer Wert, ob letzter Startzeitpunkt vor Endzeitpunkt bestimmt werden soll oder erster Startzeitpunkt nach Endzeitpunkt (Default: TRUE, d.h. letzter Zeitpunkt wird gefunden).
is_strict	Logischer Wert, ob eine minimale zeitliche Differenz zwischen den Ereignissen vorliegen muss, damit sie als aufeinanderfolgend gelten. Anderenfalls gelten Ereignisse mit identischem Start/Ende ebenfalls als aufeinanderfolgend (Default: TRUE, d.h. die strengere Definition gilt).
remove_na	Logischer Wert, ob NA-Eintraege im resultierenden Dataframe entfernt werden. D.h. Elemente aus y, denen kein Zeitpunkt aus x zugeordnet werden kann, werden verworfen (Default: TRUE, d.h. NA-Werte werden entfernt).
.progress	Logischer Wert, ob Fortschrittsbalken angezeigt wird.

Value

Dataframe mit den zugeordneten Zeitpunkten.

Anmerkung

Prinzipiell liesse sich diese Funktion auch mit einem Join realisieren, allerdings kommt es dabei zu Speicherplatzproblemen.

Future

Da dieser Verarbeitungsschritt u.U. etwas laenger dauern kann, kann hierfuer mittels future::plan eine parallele Verarbeitung zugeschaltet werden. Durch das Argument .progress kann ggf. ein Forschrittsbalken angezeigt werden.

See Also

Other Ereignisfunktionen: event_detect(), event_target(), event_test()

dnlvgt/rktiq documentation built on Jan. 6, 2020, 10:26 p.m.