i.jump.locator: Removing artefacts due to manual adjustments of dendrometers...

In dendRoAnalyst: A Tool for Processing and Analyzing Dendrometer Data

Removing artefacts due to manual adjustments of dendrometers interactively

Description

Dendrometers generally have limited memory capacity beyond which they stop recording. To keep the measurement ongoing, they should be adjusted periodically, which can cause positive or negative jumps in the data. This function locates these artefacts and interactively adjusts them one by one.

Usage

i.jump.locator(
  df,
  TreeNum,
  detection_method = c("manual", "auto"),
  manual_threshold = NULL,
  auto_method_penalty = 10,
  adjustment_method = c("window_median", "point_diff"),
  adjust_window = 5,
  plot_window = 20,
  auto_every_second = TRUE,
  set_jump_point_na = FALSE
)

Arguments

df	Data frame with first column containing date and time in the format yyyy-mm-dd HH:MM:SS and the dendrometer data in following columns.
TreeNum	Numerical value indicating the tree to be analysed. E.g. 1 refers to the first dendrometer data column in df.
detection_method	Either "manual" for threshold-based jump detection or "auto" for automatic detection using changepoint::cpt.mean() with penalty = "Manual".
manual_threshold	Numeric threshold considered as artefact when detection_method = "manual".
auto_method_penalty	Numeric manual penalty value used in changepoint::cpt.mean() when detection_method = "auto". Larger values generally lead to fewer detected jumps.
adjustment_method	Either "window_median" (recommended) or "point_diff". The former estimates the jump offset from local medians before and after the jump, while the latter uses the raw consecutive difference at the jump.
adjust_window	Integer window size used for robust jump-size estimation when adjustment_method = "window_median".
plot_window	Integer number of points shown before and after each jump in the interactive plot.
auto_every_second	Logical. If TRUE, keeps every second detected changepoint in automatic mode to mimic the legacy behavior.
set_jump_point_na	Logical. If TRUE, sets the exact jump point to NA after correction.

Value

A dataframe containing jump-free dendrometer data.

dendRoAnalyst documentation built on May 20, 2026, 5:07 p.m.