vc_frenet_frame: Evaluate the Frenet frame of a spatial curve

View source: R/frenet_frame.R

vc_frenet_frameR Documentation

Evaluate the Frenet frame of a spatial curve

Description

Evaluate the Frenet frame of a spatial curve

Usage

vc_frenet_frame(
  curve,
  t,
  velocity = NULL,
  acceleration = NULL,
  h = NULL,
  h2 = NULL
)

Arguments

curve

Function of one scalar parameter returning a finite real three-vector in Cartesian x,y,z order.

t

One finite real parameter value.

velocity, acceleration

Optional functions giving the first and second derivatives in Cartesian order. Each supplied function must return a finite real three-vector. The caller supplies its mathematical validity.

h, h2

Optional positive initial central steps for velocity and acceleration, respectively. Defaults use the Jacobian and Hessian scales.

Details

The frame follows increasing parameter t. It uses B in the direction of the cross product of velocity and acceleration and N in the direction of B crossed with T. Zero supplied velocity gives zero_speed. A zero or numerically unresolved normal component leaves only the tangent available (unresolved_curvature). Numerical velocity can give unresolved_speed. Resolution uses the last refinement change and a roundoff indicator for each numerical derivative, plus machine precision for the cross product. These indicators and the stored sensitivity diagnostics are heuristic. Central stencils may leave the curve's domain or cross a nonsmooth point. Supply derivatives at such points when the required derivatives exist. Use lapply() to evaluate the frame at several parameters.

Value

List with type frenet_frame, t, point, velocity, acceleration, unit tangent, principal normal, binormal, status, derivative sources and numerical diagnostics. Each unavailable direction is a three-vector of NA.

Examples

helix <- function(t)c(cos(t),sin(t),t/2)
vc_frenet_frame(helix,0,velocity=function(t)c(-sin(t),cos(t),.5),
  acceleration=function(t)c(-cos(t),-sin(t),0))

vectorialcalculus documentation built on Nov. 17, 2026, 1:09 a.m.