Python convenience functions that I wish were in the math module
# maff Python convenience functions that I wish were in the math module, as well as some that I agree probably shouldn’t be.
## Quick usage
import maff print(maff.ease(0.1))
The first time you import maff, it will also pollute the math module with its own functions, so you can call them via math on any module that imports math.
import maff, math print(math.ease(0.1))
## To install
Download maff.py and put it in your source directory. To install from command line:
curl https://raw.githubusercontent.com/cosmologicon/maff/master/maff.py > my-source-directory/maff.py
## Usage note
As the name hopefully implies, this is a bit of a frivolous module and not recommended for serious use. I plan to use it for game jams.
maff.tau: the circle constant equal to 2pi.
maff.phi and maff.Phi: golden ratio and reciprocal golden ratio.
## Functions taken from GLSL
maff.sign(x): sign of x.
maff.clamp(x, a, b): clamps x to range [a, b].
maff.mix(x, y, a): mix the values x and y with mixing factor a.
maff.step(edge, x): Heaviside step function of x with given edge.
maff.smoothstep(edge0, edge1, x): step function with Hermite interpolation between edge0 and edge1.
maff.length(v): length of vector v. Can be any iterable.
maff.distance(v0, v1): distance between vectors v0 and v1
maff.dot(v0, v1): dot product
maff.norm(v) or maff.normalize(v): normalize vector to length 1. Does not fail on zero vector.
maff.norm(v, a) or maff.normalize(v, a): normalize vector to length a.
## Fade functions
maff.ease(x): Hermite interpolation of x in range (0, 1). Equal to maff.smoothstep(0, 1, x).
maff.fade(x, x0, dx): fade from 0 to 1 starting at x = x0 for a fade interval of dx.
maff.smoothfade(x, x0, dx): like fade with Hermite interpolation.
maff.dfade(x, x0, x1, dx): double-fade from 0 to 1 starting at x0, then back from 1 to 0 ending at x1, with a fade interval of dx on both ends.
maff.dsmoothfade(x, x0, x1, dx): double-fade with Hermite interpolation.
## Approach functions
maff.approach(x, y, dx): increase or decrease x by amount dx in the direction of y. If the distance between x and y is less than dx, then return y instead. x and y can be vectors.
maff.softapproach(x, y, dlogx): increase or decrease x by an amount determined by dlogx. dlogx is a unitless parameter between 0 and infinity. If dlogx is 0, then x will be returned. For sufficiently large dlogx, then y will be returned. Calling this repeatedly and updating the value of x will give exponential decay toward y, with a timescale factor of 1 / dlogx.
maff.softapproach(x, y, dlogx, dxmax=inf, dymin=0.1): After calculating the approach distance dx, it’s compared with dxmax. If it exceeds dxmax then it’s capped at dxmax. If the resulting is a distance less than dymin away from y, then y is returned. This is because with exponential decay it’s impossible to ever exactly reach y.
## Other functions
maff.CS(theta): 2-tuple of cos(theta), sin(theta).
maff.CS(theta, r): 2-tuple of r cos(theta), r sin(theta).
maff.CSround(ntheta): Produces ntheta 2-tuples of cos(theta), sin(theta) distributed around the unit circle.
maff.CSround(ntheta, r=1, jtheta0=0): specify radius and offset.
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.