sample_random: Zufaellige Ereignisse

In dnlvgt/rktiq: Toolbox zur Verarbeitung von Sensorsignalen

Description

Bestimmt in einem Zeitraum zufaellig eine feste Anzahl an Ereignissen (Sampling). Dabei wird wiederholt ein Ereignis an zufaelliger Position innerhalb des Zeitraums platziert (sample_random) bzw. sequentiell die Menge aller im Zeitraum moeglichen Ereignisse gebildet und anschliessend daraus eine zufaellige Stichprobe gezogen (sample_random_seq).

Usage

sample_random(
  n,
  int_start,
  int_end,
  offtime = NULL,
  event_length_in_sec,
  event_overlap_in_sec = 0,
  .seed = NULL,
  .max_run = 1000
)

sample_random_seq(
  n,
  int_start,
  int_end,
  offtime = NULL,
  event_length_in_sec,
  event_overlap_in_sec = 0,
  from_start_to_end = TRUE,
  .seed = NULL
)

Arguments

n	Numerischer Wert mit Anzahl der zu samplenden Ereignisse
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).
event_overlap_in_sec	Numerischer Wert mit der Laenge des Intervalls (in Sekunden), in dem sich zwei aufeinanderfolgende Ereignisse ueberlappen duerfen (Default: 0, d.h. keine Ueberlappung erlaubt).
.seed	Numerischer Wert mit Seed-Wert, mit dem der Zufallsgenerator initialisiert wird. Darf auch NULL sein, dann wird zur Initialisierung die aktuelle Systemzeit herangezogen (Default: NULL, d.h. bei jedem Aufruf sollten unterschiedliche Ergebnisse erzeugt werden).
.max_run	Numerischer Wert mit Anzahl der Versuche, die je Ereignis unternommen werden sollen, um es im Zeitraum zu platzieren (Default: 1E3).
from_start_to_end	Logischer Wert, ob Ereignisse von int_start nach int_end erzeugt werden oder andersrum (Default: TRUE, d.h. es wird bei int_start begonnen).

Details

Der Gesamtzeitraum wird durch einen Start- und einen Endzeitpunkt festgelegt. In diesem Zeitraum koennen zusaetzliche Offtime-Intervalle definiert werden, in denen kein Sampling stattfindet (d.h. erzeugte Ereignisse ueberlappen sich nicht mit Offtimes). Neben der Ereignislaenge kann auch eine potentielle zeitliche Ueberlappung zwischen Ereignissen gesteuert werden.

Value

Dataframe mit zufaelligen Ereignissen aus Zeitraum.

See Also

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

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