geodesic_path: Generate geodesic path.

In tourr: Tour Methods for Multivariate Data Visualisation

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, ...)

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

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.

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))

tourr documentation built on May 29, 2024, 11:22 a.m.