fastmath.vector — generateme/fastmath 1.0.0

Mathematical vector operations.

Types

• Fixed size (custom types):
  • Vec2 - 2d vector, creator vec2
  • Vec3 - 3d vector, creator vec3
  • Vec4 - 4d vector, creator vec4
  • ArrayVec - fixed size vector as double array, n-dimensional, creator [[arrayvec]]
• Variable size:
  • Clojure's PersistentVector, creator [].

VectorProto defines most of the functions.

Vectors implements also:

• Sequable
• Sequencial
• IFn
• Counted
• equals and toString from Object

That means that vectors can be destructured, treated as sequence or called as a function. See vec2 for examples.

aligned? clj

(aligned? v1 v2)

Are vectors aligned (have the same direction)?

angle-between clj

(angle-between v1 v2)

Angle between two vectors

See also relative-angle-between.

array->vec2 clj

(array->vec2 a)

Doubles array to Vec2

array->vec3 clj

(array->vec3 a)

Doubles array to Vec3

array->vec4 clj

(array->vec4 a)

Doubles array to Vec4

array-vec clj

(array-vec xs)

Make ArrayVec type based on provided sequence xs.

average-vectors clj

(average-vectors vs)

(average-vectors init vs)

Average / centroid of vectors. Input: initial vector (optional), list of vectors

dist clj

(dist v1 v2)

Euclidean distance between vectors

dist-abs clj

(dist-abs v1 v2)

Manhattan distance between vectors

dist-canberra clj

(dist-canberra v1 v2)

Canberra distance

dist-cheb clj

(dist-cheb v1 v2)

Chebyshev distance between 2d vectors

dist-cos clj

(dist-cos v1 v2)

Cosine distance

dist-discrete clj

(dist-discrete v1 v2)

Discrete distance between 2d vectors

dist-emd clj

(dist-emd v1 v2)

Earth Mover's Distance

dist-sq clj

(dist-sq v1 v2)

Squared Euclidean distance between vectors

distances clj

ediv clj

(ediv v1 v2)

Element-wise division of two vectors.

faceforward clj

(faceforward n v)

Flip normal n to match the same direction as v.

generate-vec2 clj

(generate-vec2 f)

(generate-vec2 f1 f2)

Generate Vec2 with fn(s)

generate-vec3 clj

(generate-vec3 f)

(generate-vec3 f1 f2 f3)

Generate Vec3 with fn(s)

generate-vec4 clj

(generate-vec4 f)

(generate-vec4 f1 f2 f3 f4)

Generate Vec4 with fn(s)

limit clj

(limit v len)

Limit length of the vector by given value

normalize clj

(normalize v)

Normalize vector (set length = 1.0)

relative-angle-between clj

(relative-angle-between v1 v2)

Angle between two vectors relative to each other.

See also angle-between.

set-mag clj

(set-mag v len)

Set length of the vector

TOLERANCE clj

Tolerance used in [[is-near-zero?]]. Values less than this value are treated as zero.

vec2 clj

(vec2 x y)

Make 2d vector

vec3 clj

(vec3 v z)

(vec3 x y z)

Make Vec2 vector

vec4 clj

(vec4 v w)

(vec4 v z w)

(vec4 x y z w)

Make Vec4 vector

VectorProto clj protocol

Vector operations

to-vec clj

(to-vec v)

Convert to Clojure primitive vector Vec.

dot clj

(dot v1 v2)

Dot product of two vectors.

permute clj

(permute v idxs)

Permute vector elements with given indices.

applyf clj

(applyf v f)

Apply function to all vector values (like map but returns the same type).

add clj

(add v1)

(add v1 v2)

Sum of two vectors.

approx clj

(approx v)

(approx v d)

Round to 2 (or d) decimal places

cross clj

(cross v1 v2)

Cross product

reciprocal clj

(reciprocal v)

Reciprocal of elements.

sum clj

(sum v1)

Sum of elements

emn clj

(emn v1 v2)

Element-wise min from two vectors.

is-near-zero? clj

(is-near-zero? v1)

Is vector almost zero? (all absolute values of elements are less than TOLERANCE)

heading clj

(heading v1)

Angle between vector and unit vector [1,0,...]

axis-rotate clj

(axis-rotate v1 angle axis)

(axis-rotate v1 angle axis pivot)

Rotate around axis, 3d only

magsq clj

(magsq v1)

Length of the vector squared.

to-polar clj

(to-polar v1)

To polar coordinates (2d, 3d only), first element is length, the rest angle.

transform clj

(transform v1 o vx vy)

(transform v1 o vx vy vz)

Transform vector; map point to coordinate system defined by origin, vx and vy (as bases), 2d and 3d only.

mag clj

(mag v1)

length of the vector.

from-polar clj

(from-polar v1)

From polar coordinates (2d, 3d only)

sub clj

(sub v1)

(sub v1 v2)

Subtraction of two vectors.

mindim clj

(mindim v)

Index of minimum value.

is-zero? clj

(is-zero? v1)

Is vector zero?

econstrain clj

(econstrain v val1 val2)

Element-wise constrain

base-from clj

(base-from v)

List of perpendicular vectors (basis)

emult clj

(emult v1 v)

Element-wise vector multiplication (Hadamard product).

maxdim clj

(maxdim v)

Index of maximum value.

emx clj

(emx v1 v2)

Element-wise max from two vectors.

interpolate clj

(interpolate v1 v2 t)

(interpolate v1 v2 t f)

Interpolate vectors, optionally set interpolation fn

perpendicular clj

(perpendicular v1)

(perpendicular v1 v2)

Perpendicular vector (only 2d).

div clj

(div v1 v)

Divide vector by number v

mn clj

(mn v1)

Minimum value of vector elements

abs clj

(abs v1)

Absolute value of vector elements

einterpolate clj

(einterpolate v1 v2 v)

(einterpolate v1 v2 v f)

Interpolate vectors element-wise, optionally set interpolation fn

mx clj

(mx v1)

Maximum value of vector elements

mult clj

(mult v1 v)

Multiply vector by number v.

rotate clj

(rotate v1 angle)

(rotate v1 anglex angley anglez)

Rotate vector