ct_camtrap_animal_distance: Estimate distance from camera trap to animal

In ct: Camera Trap Data Management and Multi-Method Ecological Analysis

Estimate distance from camera trap to animal

Description

Calculates the radial distance between a camera trap and an animal detected in an image using geometric principles and reference markers.

Usage

ct_camtrap_animal_distance(fov, forward_distance, ref_halfwidth, animal_offset)

Arguments

fov	Numeric. The camera's horizontal field of view in degrees. Common values range from 30^\circ to 60^\circ depending on camera model.
forward_distance	Numeric. The forward distance (in meters) from the camera to the animal along the central axis, estimated using reference markers visible in the image.
ref_halfwidth	Numeric. The measured half-width of the camera's field of view in the image at distance forward_distance, in any unit (e.g., cm, pixels). This is typically measured with a ruler on the photo or using image analysis software.
animal_offset	Numeric. The measured horizontal offset of the animal from the central vertical line in the image, in the same units as ref_halfwidth.

Value

Numeric. The estimated radial distance (in meters) from the camera to the animal.

Examples

distance <- ct_camtrap_animal_distance(
  fov = 35,
  forward_distance = 7.5,
  ref_halfwidth = 12,
  animal_offset = 3
)

ct documentation built on Oct. 22, 2026, 1:07 a.m.