trendtestR (version 1.0.1)

plot_weekly_cases: Visualize Weekly Aggregated Values / Woechentliche aggregierte Werte visualisieren

Description

This function aggregates time series data by calendar week and generates three plots trend line, histogram, and boxplot based on a specified retrospective period (either a number of weeks or a date range). It also shows a 95

Usage

plot_weekly_cases(
  df,
  datum_col = "datum",
  value_col = NULL,
  weeks_back = 51,
  agg_fun = "sum",
  plottype = NULL,
  save_plot = FALSE,
  save_path = "."
)

Value

A list containing:

data

Aggregated weekly data

trend_plot

Trend plot

hist_plot

Histogram

box_plot

Boxplot

Arguments

df

A data.frame with date and value columns. / Ein Data Frame mit Datums- und Wertespalten

datum_col

Name of the date column, default is "datum". / Name der Datumsspalte, Standard: "datum"

value_col

Name of the value column. / Name der Wertespalte /

weeks_back

Number of recent weeks or a length-2 numeric vector. / Anzahl der zurueckliegenden Wochen oder ein Vektor mit zwei Werten

agg_fun

Aggregation function (e.g., "sum", "mean"). / Aggregationsfunktion, z.B. "sum", "mean"

plottype

Optional plot type: 1 for all, 2 for hist+box, 3 for trend+box. / Optionaler Plottyp: 1 fuer alle, 2 fuer hist+box, 3 fuer trend+box

save_plot

Logical, whether to save the plots. / Logisch, ob die Plots gespeichert werden sollen

save_path

Folder to save the plots. / Zielpfad zum Speichern der Plots

Details

Diese Funktion aggregiert Zeitreihendaten nach Kalenderwochen und erstellt fuer den angegebenen Rueckblickzeitraum (als Anzahl der Wochen oder Zeitfenster) drei Diagramme: Trendverlauf, Histogramm und Boxplot. Zusaetzlich wird ein 95

Examples

df <- data.frame(
  datum = as.Date("2022-01-01") + 0:100,
  neue_faelle = rpois(101, lambda = 20)
)
result <- plot_weekly_cases(df, value_col = "neue_faelle", weeks_back = 20)