vc_surface_area: Approximate the lateral area generated by revolving a graph

View source: R/applications.R

vc_surface_areaR Documentation

Approximate the lateral area generated by revolving a graph

Description

Approximate the lateral area generated by revolving a graph

Usage

vc_surface_area(
  f,
  interval,
  axis_at = 0,
  df = NULL,
  h = NULL,
  breaks = NULL,
  end_caps = FALSE,
  method = c("adaptive", "trapezoid", "simpson"),
  n = 32L,
  abs_tol = 1e-08,
  rel_tol = 1e-08,
  subdivisions = 100L
)

Arguments

f

Deterministic function accepting a real scalar and returning one finite real scalar. Vectorization is not required.

interval

Two finite real bounds, allowing reversed or equal bounds.

axis_at

Finite position of the parallel rotation axis in the dependent coordinate: y=axis_at for y=f(x), or x=axis_at for x=f(y).

df

Optional scalar derivative function, assumed mathematically correct. NULL reuses vc_derivative() with central differences.

h

Optional positive finite numerical derivative step.

breaks

Optional finite strictly increasing interior integration split points, for example known intersections. These are not found automatically.

end_caps

Logical; add two circular end disks with endpoint radii abs(f(t)-axis_at). This assumes the filled region between this graph and its axis. It is not the cap rule for a two-graph annular region.

method

Quadrature rule: trapezoid, Simpson, or adaptive QUADPACK through stats::integrate(). Improper infinite bounds are not supported.

n

Initial number of equal cells for fixed rules; positive integer, even and at least two for Simpson. Ignored by the adaptive rule.

abs_tol, rel_tol

Nonnegative finite absolute and relative diagnostic tolerances; at least one must be positive. Adaptive integration also applies the tolerance restrictions of stats::integrate().

subdivisions

Positive integer maximum adaptive subinterval count; ignored by fixed rules.

Details

Integrates ⁠2*pi*abs(f(t)-axis_at)*sqrt(1+f'(t)^2)⁠. This is the surface generated by one graph, not automatically the entire boundary of a washer/shell solid between two graphs. Parameterization must cover the surface without multiplicity for geometric-area interpretation. Caps are excluded by default. Equal bounds give zero lateral and cap areas without evaluating endpoints; coincident end disks are not counted twice.

Value

A surface_area list with the same diagnostics as vc_arc_length() and axis_at, lateral_area, cap_area, end_caps. Estimate is lateral area plus requested caps; integral diagnostics describe only the lateral part.

Examples

identity |> vc_surface_area(c(0,1),df=function(x)1) # pi*sqrt(2)

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