% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/jump.locator.R
\name{i.jump.locator}
\alias{i.jump.locator}
\title{Removing artefacts due to manual adjustments of dendrometers interactively}
\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{
\item{df}{Data frame with first column containing date and time in the format
\code{yyyy-mm-dd HH:MM:SS} and the dendrometer data in following columns.}

\item{TreeNum}{Numerical value indicating the tree to be analysed. E.g. \code{1}
refers to the first dendrometer data column in \code{df}.}

\item{detection_method}{Either \code{"manual"} for threshold-based jump
detection or \code{"auto"} for automatic detection using
\code{changepoint::cpt.mean()} with \code{penalty = "Manual"}.}

\item{manual_threshold}{Numeric threshold considered as artefact when
\code{detection_method = "manual"}.}

\item{auto_method_penalty}{Numeric manual penalty value used in
\code{changepoint::cpt.mean()} when \code{detection_method = "auto"}.
Larger values generally lead to fewer detected jumps.}

\item{adjustment_method}{Either \code{"window_median"} (recommended) or
\code{"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.}

\item{adjust_window}{Integer window size used for robust jump-size estimation
when \code{adjustment_method = "window_median"}.}

\item{plot_window}{Integer number of points shown before and after each jump in
the interactive plot.}

\item{auto_every_second}{Logical. If \code{TRUE}, keeps every second detected
changepoint in automatic mode to mimic the legacy behavior.}

\item{set_jump_point_na}{Logical. If \code{TRUE}, sets the exact jump point to
\code{NA} after correction.}
}
\value{
A dataframe containing jump-free dendrometer data.
}
\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.
}
