find_center_y: Find the center_y value

In EmmaLiTsai/recoverKBTDR: Recovering Records From Kooyman-Billups Time Depth Recorders (KBTDRs)

Find the center_y value

Description

Center_y is the height of the pivot-point of the KBTDR transducer arm above depth = 0 in centimeters. While most center_y values are close to 11cm, these functions provide ESTIMATES of center_y. These calculations need to be confirmed visually to ensure that it does not introduce any abnormal skew across the record. However, any variation in this height is < 1mm at the scale of the KBTDR.

Usage

find_center_y(
  beg_dive = c(x1, y1),
  depth_dive = c(x2, y2),
  rate,
  psi_calibration = NULL,
  max_depth = NULL,
  df = NULL
)

Arguments

beg_dive	numeric vector of the x & y coordinates of the beginning of the dive.
depth_dive	numeric vector of the x & y coordinates of a point at depth along the same dive.
rate	rate of film movement, estimated by local timing dots.
psi_calibration	data frame of psi calibration curve, produced after center_scan.
max_depth	maximum depth, if no psi calibration curve is present.
df	tidy trace data frame, if no psi calibration curve is present.

Value

numeric value of an estimated center_y value to use for arc removal.

Examples

## Not run: 
# if psi calibration curve is present:
find_center_y(beg_dive, depth_dive, rate, psi_calibration)
find_center_y(beg_dive = c(1142.945, 0), depth_dive = c(1140.55, 9.3),
rate = 0.16, psi_calibration)

# if only maximum depth is known:
find_center_y(beg_dive, depth_dive, rate, max_depth, trace)
find_center_y(beg_dive = c(65.258, y1 = -0.056), d
epth_dive = c(63.442, 5.341),
rate = 0.21, max_depth = 484, trace = trace)

## End(Not run)

EmmaLiTsai/recoverKBTDR documentation built on Aug. 29, 2024, 10:38 a.m.