• Stars
    star
    162
  • Rank 232,284 (Top 5 %)
  • Language
    C++
  • License
    MIT License
  • Created about 8 years ago
  • Updated over 7 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Floating Point Hacks

Floating Point Hacks

Completely useless, but fun nevertheless.

Equations for a "fast" method.


Table of Contents


This repository contains a set of procedures to compute numerical methods in the vein of the fast inverse root method. In particular, we will generate code that

  1. Computes rational powers () to an arbitrary precision.
  2. Computes irrational powers () to within 10% relative error.
  3. Computes to within 10% relative error.
  4. Computes to within 10% relative error.
  5. Computes the geometric mean of an std::array quickly to within 10% error.

Additionally, we will do so using mostly just integer arithmetic.

Usage

You can use everything in floathacks by including hacks.h

#include <floathacks/hacks.h>
using namespace floathacks; // Comment this out if you don't want your top-level namespace to be polluted

For Contributors

This document is compiled from READOTHER.md by readme2tex. Make sure that you pip install readme2tex. You can run

python -m readme2tex --output README.md --branch svgs

to recompile these docs.

Pow

To generate an estimation for , where is any floating point number, you can run

float approximate_root = fpow<FLOAT(0.12345)>::estimate(x);

Since estimates of pow can be refined into better iterates (as long as c is "rational enough"), you can also compute a more exact result via

float root = pow<FLOAT(0.12345), n>(x);

where n is the number of newton iterations to perform. The code generated by this template will unroll itself, so it's relatively efficient.

However, the optimized code does not let you use it as a constexpr or where the exponent is not constant. In those cases, you can use consts::fpow(x, c) and consts::pow(x, c, iterations = 2) instead:

float root = consts::pow(x, 0.12345, n);

Note that the compiler isn't able to deduce the optimal constants in these cases, so you'll incur additional penalties computing the constants of the method.

Exp

You can also compute an approximation of with

float guess = fexp(x);

Unfortunately, since there are no refinement methods available for exponentials, we can't do much with this result if it's too coarse for your needs. In addition, due to overflow, this method breaks down when x approaches 90.

Log

Similarly, you can also compute an approximation of with

float guess = flog(x);

Again, as is with the case of fexp, there are no refinement methods available for logarithms either.

All of the f*** methods above have bounded relative errors of at most 10%. The refined pow method can be made to give arbitrary precision by increasing the number of refinement iterations. Each refinement iteration takes time proportional to the number of digits in the floating point representation of the exponent. Note that since floats are finite, this is bounded above by 32 (and more tightly, 23).

Geometric Mean

You can compute the geometric mean () of a std::array<float, n> with

float guess = fgmean<3>({ 1, 2, 3 });

This can be refined, but you typically do not care about the absolute precision of a mean-like statistic. To refine this, you can run Newton's method on . As far as I am aware, this is also an original method.

Justification

Prelude

The key ingredient of these types of methods is the pair of transformations and .

  • takes a IEEE 754 single precision floating point number and outputs its "machine" representation. In essence, it acts like

      unsigned long f2l(float x) {
        union {float fl; unsigned long lg;} lens = { x };
        return lens.lg;
      }
    
  • takes an unsigned long representing a float and returns a IEEE 754 single precision floating point number. It acts like

      float l2f(unsigned long z) {
        union {float fl; unsigned long lg;} lens = { z };
        return lens.fl;
      }
    

So for example, the fast inverse root method:

  union {float fl; unsigned long lg;} lens = { x };
  lens.lg = 0x5f3759df - lens.lg / 2;
  float y = lens.fl;

can be equivalently expressed as

In a similar vein, a fast inverse cube-root method is presented at the start of this page.

We will justify this in the next section.

Arbitrary Powers

We can approximate any using just integer arithmetic on the machine representation of . To do so, compute

where . In general, any value of bias, as long as it is reasonably small, will work. At bias = 0, the method computes a value whose error is completely positive. Therefore, by increasing the bias, we can shift some of the error down into the negative plane and halve the error.

As seen in the fast-inverse-root method, a bias of -0x5c416 tend to work well for pretty much every case that I've tried, as long as we tack on at least one Newton refinement stage at the end. It works well without refinement as well, but an even bias of -0x5c000 works even better.

Why does this work? See these slides for the derivation. In particular, the fast inverse square-root is a subclass of this method.

Exp

We can approximate up to using a similar set of bit tricks. I'll first give its equation, and then give its derivations. As far as I am aware, these are original. However, since there are no refinement methods for the computation of , there is practically no reason to ever resort to this approximation unless you're okay with 10% error.

Here, is the machine epsilon for single precision, and it is computed by .

To give a derivation of this equation, we'll need to borrow a few mathematical tools from analysis. In particular, while l2f and f2l have many discontinuities ( of them to be exact), it is mostly smooth. This carries over to its "rate-of-change" as well, so we will just pretend that it has mostly smooth derivatives everywhere.

Differentiating the l2f and f2l functions.

Consider the function

where the equality is a consequence of the chain-rule, assuming that f2l is differentiable at the particular value of . Now, this raises an interesting question: What does it mean to take a derivative of ?

Well, it's not all that mysterious. The derivative of f2l is just the rate at which a number's IEEE 754 machine representation changes as we make small perturbations to a number. Unfortunately, while it might be easy to compute this derivative as a numerical approximation, we still don't have an approximate form for algebraic manipulation.

While might be difficult to construct, we can fair much better with its sibling, . Now, the derivative is the rate that a float will change given that we make small perturbations to its machine representation. However, since its machine representations are all bit-vectors, it doesn't make sense to take a derivative here since we can't make these perturbations arbitrarily small. The smallest change we can make is to either add or subtract one. However, if we just accept our fate, then we can define the "derivative" as the finite difference

where

Here, equality holds when is a perfect power of (including fractions of the form ).

Therefore,

From here, we also have

A Tale of Two Functions

Given , antidifferentiating both sides gives

Similarly, since satisfies , we have

This makes sense, since we'd like these two functions to be inverses of each other.

Exp, redux.

Consider

which suggests that .

Since we would like , we can impose the boundary condition

which gives . However, while this method gives bounded relative error, in its unbiased form this is pretty off the mark for general purposes (it approximates some other ). Instead, we can add in an unbiased form:

where, empirically, gives a good approximation. Notice that the we've chosen is close to , which is what we need to transform to . In particular, for all , the , , and relative error is always below 10%.

Log

In a similar spirit, we can use the approximation

to derive

Imposing a boundary condition at gives , so we should expect

However, this actually computes some other logarithm , and we'll have to, again, unbias this term

where the term came from the fact that the base computation approximates the 2-logarithm. Empirically, I've found that a bias of works well. In particular, for all , the , , and relative error is always below 10%.

Geometric Mean

There's a straightforward derivation of the geometric mean. Consider the approximations of and , we can refine them as

Therefore, a bit of algebra will show that

which reduces to the equation for the geometric mean.

Notice that we just add a series of integers, followed by an integer divide, which is pretty efficient.


For more information on how the constant () is derived for the cube-root, visit http://www.bullshitmath.lol/.

Equations rendered with readme2tex.

More Repositories

1

readme2tex

Renders TeXy Math for Github Readmes
Python
906
star
2

LuaInLua

A self-hosting compiler for the Lua language.
Lua
194
star
3

see.lua

A Lua 5.x/LuaJIT introspection library for humans
Lua
85
star
4

pyXLSX

A python class library that can read Office 2007 Excel Files
Python
43
star
5

RegexEnumerator

Combinatorial tricks to enumerate regular expressions in closed-form.
Python
33
star
6

BullshitMath.lol

You can't do that! Can you?
HTML
22
star
7

Rocket-for-Lua

A Sqlite ORM modeler (implements Django's model paradigm in Lua) for all data related projects.
Lua
18
star
8

pyChroma

Chroma-Hash in python as implemented by http://mattt.me/2009/07/chroma-hash-a-belated-introduction
JavaScript
9
star
9

Yuck

A Compiler Tutorial for a contemporary dynamic language.
Java
6
star
10

Xi

The Xi Language
C
5
star
11

NotepadThing

JavaScript
3
star
12

luadis

Lua Disassembler and decompiler
Lua
3
star
13

notetag

blargh
Python
3
star
14

pybird

A simple and fast python twitter library that doesn't need all of the hassels of python-twitter
Python
2
star
15

compiling-with-cps

Compiling with CPS
OCaml
2
star
16

mu

A small experimental language
C++
2
star
17

laughing-octo-bot

I have no fucking idea
C
2
star
18

AMX2D

AMX2D For CS2D - Advanced bootstrapping of all CS2D functionalities. Created out of boredom
Lua
1
star
19

Urban-RealEstate

Geo Project
Python
1
star
20

MatrixParser

cool reduction of CFG parsing into matrix multiplication
Python
1
star
21

monomer-dimer-tilings

Convoluted solution for the monomer-dimer tiling problem.
Python
1
star
22

LuaPrettify

Cleans up and formats your Lua Code (In Python)
Python
1
star
23

LetsBuildACompiler

A set of tools developed for let's build a compiler in python series
Python
1
star
24

rpn_jit

Experimenting with primitive JIT mechanisms.
C++
1
star
25

Simple-Parser

A simple LL(1) topdown parser generator implemented in the D programming language. (Sorry, no lexers yet)
D
1
star
26

Open2DServer

Open source implementation of CS2D 0.1.0.4 beta protocol (outdated)
Python
1
star