vc_osculating_circle: Sample osculating circles of a spatial curve

View source: R/osculating_geometry.R

vc_osculating_circleR Documentation

Sample osculating circles of a spatial curve

Description

Sample osculating circles of a spatial curve

Usage

vc_osculating_circle(
  curve,
  t,
  velocity = NULL,
  acceleration = NULL,
  h = NULL,
  h2 = NULL,
  n = 72L
)

Arguments

curve

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

t

Nonempty finite real vector of parameter values in the desired order.

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.

n

Number of circle segments, at least three.

Details

A circle at a resolved point has radius 1/curvature and center point plus radius times the principal normal. The sampled ring starts and ends at the curve point and initially follows the tangent. A ring is unavailable for unresolved curvature or speed, or when its geometry cannot be represented. The frame diagnostics are retained. The construction needs only the first two derivatives.

Value

List with type osculating_circle, t and circles in parameter order. Each circle stores the frame, curvature, radius, center, status and a three-column ring matrix when the circle is available.

Examples

curve <- function(t)c(cos(t),sin(t),t/2)
vc_osculating_circle(curve,c(0,pi/2))$circles[[1]]$radius

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