vc_green: Compare the two integrals in Green's circulation theorem

View source: R/green.R

vc_greenR Documentation

Compare the two integrals in Green's circulation theorem

Description

Compare the two integrals in Green's circulation theorem

Usage

vc_green(
  field,
  lower,
  upper,
  interval,
  lower_derivative = NULL,
  upper_derivative = NULL,
  rotation = NULL,
  orientation = c("counterclockwise", "clockwise"),
  boundary_method = c("simpson", "trapezoid", "adaptive"),
  n_boundary = 16L,
  method = c("simpson", "trapezoid"),
  n_outer = 8L,
  n_inner = 8L,
  abs_tol = 1e-08,
  rel_tol = 1e-08
)

Arguments

field

Function of one Cartesian vector c(x,y) returning c(P,Q).

lower, upper

Scalar functions defining the lower and upper y graphs.

interval

Two finite, strictly increasing x endpoints.

lower_derivative, upper_derivative

Optional derivatives of the y graphs.

rotation

Optional scalar function of c(x,y) giving dQ/dx - dP/dy. Defaults to numerical partial derivatives from vc_jacobian().

orientation

Boundary traversal. Clockwise negates the boundary circulation and the oriented interior integral.

boundary_method

Rule for vc_line_integral().

n_boundary

Initial fixed-rule cell count per boundary edge.

method

Simpson or trapezoid rule.

n_outer, n_inner

Initial cell counts, refined at both levels.

abs_tol, rel_tol

Nonnegative diagnostic tolerances, one positive.

Details

The region is a single strip between two graphs. Counterclockwise traversal follows the lower graph to the right, the right edge upward, the upper graph to the left and the left edge downward. Collapsed vertical edges contribute zero. The caller supplies a suitable simple piecewise smooth boundary and a C1 field on a neighborhood of the region. Finite sampled boundary checks cannot establish those hypotheses. Central stencils may leave the domain. Numerical agreement and error indicators are diagnostic only. Regions with holes need decomposition.

Value

List with circulation, signed interior integral, signed difference (circulation minus interior), comparison tolerance, both quadrature results, a summed error indicator, and separate derivative diagnostics.

Examples

vc_green(function(p)c(-p[2],p[1]),function(x)0,function(x)1,c(0,1),
  lower_derivative=function(x)0,upper_derivative=function(x)0,
  rotation=function(p)2,n_boundary=4,n_outer=2,n_inner=2)$circulation

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