tourr (version 1.1.0)

geodesic_path: Generate geodesic path.

Description

Wrap basis generation method with a function that computes the geodesic interpolation from the previous frame to the next frame, and provides convenient access to all the information about the path.

Usage

geodesic_path(current, target, frozen = NULL, ...)

Value

interpolate

A function with single parameter in [0, 1] that returns an interpolated frame between the current and future frames. 0 gives the current plane, 1 gives the new target frame in plane of current frame.

dist

The distance, in radians, between the current and target frames.

Fa

The current frame.

Fz

The new target frame.

tau

The principle angles between the current and target frames.

Ga

The current plane.

Gz

The target plane.

Arguments

current

starting projection

target

ending projection

frozen

matrix giving frozen variables, as described in freeze

Details

Frozen variables allow us to keep certain values of the projection fixed and generate a geodesic across the subspace generated by those

Examples

a <- basis_random(4, 2)
b <- basis_random(4, 2)
path <- geodesic_path(a, b)

path$dist
all.equal(a, path$interpolate(0))
# Not true generally - a rotated into plane of b
all.equal(b, path$interpolate(1))