Parametric curve

The parametric-curve library provides an implementation of parametric curves. Parametric curves are n-dimensional curves described by parametric equations, one per each dimension. For example:

``` x = a cos (t)
y = a sin (t)
z = bt```

In this example, t is the parameter, and a and b are constants.

Usage

(require-extension parametric-curve)

Documentation

Procedures

parametric-curve? :: OBJECT -> BOOL procedure

Returns #t if the given object is a parametric curve, #f otherwise.

simple-curve :: N * K * FS * TMIN * TMAX -> PCURVE procedure

Basic parametric curve constructor.

N
number of interpolation points (N >= 3)
K
continuity class of the interpolating spline for this curve (1 or 2, for first or second derivative)
FS
a list of one-argument procedures that are evaluated to obtain points on the curve. The length of FS determines the dimensionality of the curve
TMIN
minimum value for the curve parameter
TMIN
maximum value for the curve parameter
sample-curve :: PCURVE -> (T -> POINT) procedure

Constructs a procedure to sample the curve at the given parameter value.

sample-curve* :: PCURVE -> (T LIST -> POINT LIST) procedure

Constructs a procedure to sample the curve at the given parameter values.

linear-curve :: N * COEFFS * TMIN * TMAX -> PCURVE procedure

Constructor for a linear curve of the form c1 * x + c2.

N
number of interpolation points (N >= 3)
COEFFS
supplies c1 and c2 for the different dimensions
TMIN
minimum value for the curve parameter
TMAX
maximum value for the curve parameter
line-segment:: N * COEFFS -> PCURVE procedure

Creates a line segment whose starting point is zero, and its end points is defined by COEFFS. N is the number of interpolating points.

map-curve :: FS * PCURVE -> PCURVE procedure

Maps the given functions to the parametric curve.

iterate-curve :: PCURVE * N -> POINT LIST procedure

Samples a parametric curve at N regular intervals in the range xmin..xmax inclusive.

range-curve :: PCURVE * N * (X1,XN) LIST -> POINT LIST procedure

Samples a parametric curve at regular intervals in the given ranges.

arc-length :: PCURVE * DX -> NUMBER procedure

Computers the arc length of the curve given step DX.

Examples

Version history

1.13
Added matchable as a test dependency [reported by mario]
1.7
1.4
1.0
Initial release

```Copyright 2012-2015 Ivan Raikov

This program is free software: you can redistribute it and/or modify