random_event: Zufaelliges Ereignisse

In dnlvgt/rktiq: Toolbox zur Verarbeitung von Sensorsignalen

Description

Hilfsfunktion zum zufaelligen Platzieren eines Ereignisses innerhalb eines Zeitraums. Der Gesamtzeitraum wird durch einen Start- und einen Endzeitpunkt festgelegt. In diesem Zeitraum koennen zusaetzliche Offtime-Intervalle definiert werden, fuer die beim Platzieren sichergestellt wird, dass keine Ueberlappung auftritt. D.h. sollte ein Ueberlappung auftreten, wird das Ereignis verworfen und ein neuer Platzierungsversuch gestartet. Um an dieser Stelle einen Deadlock zu vermeiden, gibt es eine Obergrenze fuer die durchzufuehrenden Versuche.

Usage

random_event(int_start, int_end, offtime, event_length_in_sec, .max_run = 1000)

Arguments

int_start	POSIXct-Zeitstempel mit Startzeitpunkt des Sample-Zeitraums.
int_end	POSIXct-Zeitstempel mit Endzeitpunkt des Sample-Zeitraums.
offtime	Dataframe, der die Offtime-Ereignisse beinhaltet. Die Ereignisse sind anhand ihrer Start-/Endzeitpunkte beschrieben, die jeweils in den Spalten start und end uebergeben werden.
event_length_in_sec	Numerischer Wert mit der Laenge der Ereignisse (in Sekunden).
.max_run	Numerischer Wert mit Anzahl der Versuche, die je Ereignis unternommen werden sollen, um es im Zeitraum zu platzieren (Default: 1E3).

Value

Dataframe mit zufaelligem Ereignis im Zeitraum bzw. NULL, wenn Platzierung nicht erfolgreich.

See Also

sample_random

Other Sampling-Funktionen: sample_balanced(), sample_random()

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