Fast inverse square root

Fast inverse square root, sometimes referred to as Template:Mono or by the hexadecimal constant Template:Mono, is an algorithm that estimates $\frac{1}{\sqrt{x}}$ , the reciprocal (or multiplicative inverse) of the square root of a 32-bit floating-point number $x$ in IEEE 754 floating-point format. The algorithm is best known for its implementation in 1999 in Quake III Arena, a first-person shooter video game heavily based on 3D graphics. With subsequent hardware advancements, especially the x86 SSE instruction rsqrtss, this algorithm is not generally the best choice for modern computers,^[1] though it remains an interesting historical example.^[2]

The algorithm accepts a 32-bit floating-point number as the input and stores a halved value for later use. Then, treating the bits representing the floating-point number as a 32-bit integer, a logical shift right by one bit is performed and the result subtracted from the number Template:Mono, which is a floating-point representation of an approximation of $\sqrt{2^{127}}$ .^[3] This results in the first approximation of the inverse square root of the input. Treating the bits again as a floating-point number, it runs one iteration of Newton's method, yielding a more precise approximation.

History

William Kahan and K.C. Ng at Berkeley wrote an unpublished paper in May 1986 describing how to calculate the square root using bit-fiddling techniques followed by Newton iterations.^[4] In the late 1980s, Cleve Moler at Ardent Computer learned about this technique^[5] and passed it along to his coworker Greg Walsh. Greg Walsh devised the now-famous constant and fast inverse square root algorithm. Gary Tarolli was consulting for Kubota, the company funding Ardent at the time, and likely brought the algorithm to 3dfx Interactive circa 1994.^[6]^[7]

Jim Blinn demonstrated a simple approximation of the inverse square root in a 1997 column for IEEE Computer Graphics and Applications.Template:Sfn Reverse engineering of other contemporary 3D video games uncovered a variation of the algorithm in Activision's 1997 Interstate '76.^[8]

Quake III Arena, a first-person shooter video game, was released in 1999 by id Software and used the algorithm. Brian Hook may have brought the algorithm from 3dfx to id Software.^[6] A discussion of the code appeared on the Chinese developer forum CSDN in 2000,^[9] and Usenet and the gamedev.net forum spread the code widely in 2002 and 2003.Template:Sfn Speculation arose as to who wrote the algorithm and how the constant was derived; some guessed John Carmack.^[7] Quake IIITemplate:'s full source code was released at QuakeCon 2005, but provided no answers. The authorship question was resolved in 2006 when Greg Walsh, the original author, contacted Beyond3D after their speculation gained popularity on Slashdot.^[6]

In 2007 the algorithm was implemented in some dedicated hardware vertex shaders using field-programmable gate arrays (FPGA).^[10]Template:Sfn

Motivation

The inverse square root of a floating point number is used in digital signal processing to normalize a vector, scaling it to length 1 to produce a unit vector.Template:Sfn For example, computer graphics programs use inverse square roots to compute angles of incidence and reflection for lighting and shading. 3D graphics programs must perform millions of these calculations every second to simulate lighting. When the code was developed in the early 1990s, most floating point processing power lagged the speed of integer processing.^[7] This was troublesome for 3D graphics programs before the advent of specialized hardware to handle transform and lighting. Computation of square roots usually depends upon many division operations, which for floating point numbers are computationally expensive. The fast inverse square generates a good approximation with only one division step.

The length of the vector is determined by calculating its Euclidean norm: the square root of the sum of squares of the vector components. When each component of the vector is divided by that length, the new vector will be a unit vector pointing in the same direction. In a 3D graphics program, all vectors are in three-dimensional space, so $𝒗$ would be a vector $(v_{1}, v_{2}, v_{3})$ . Then,

‖ 𝒗 ‖ = \sqrt{v_{1}^{2} + v_{2}^{2} + v_{3}^{2}}

is the Euclidean norm of the vector, and the normalized (unit) vector is

\begin{matrix} \hat{𝒗} & = \frac{1}{‖ 𝒗 ‖} 𝒗 \\ = \frac{1}{\sqrt{v_{1}^{2} + v_{2}^{2} + v_{3}^{2}}} 𝒗, \end{matrix}

where the fraction term is the inverse square root of $v_{1}^{2} + v_{2}^{2} + v_{3}^{2}$ .

At the time, floating-point division was generally expensive compared to multiplication; the fast inverse square root algorithm bypassed the division step, giving it its performance advantage.

Overview of the code

The following C code is the fast inverse square root implementation from Quake III Arena, stripped of C preprocessor directives, but including the exact original comment text:^[11]

float Q_rsqrt( float number )
{
	long i;
	float x2, y;
	const float threehalfs = 1.5F;

	x2 = number * 0.5F;
	y  = number;
	i  = * ( long * ) &y;                       // evil floating point bit level hacking
	i  = 0x5f3759df - ( i >> 1 );               // what the fuck?
	y  = * ( float * ) &i;
	y  = y * ( threehalfs - ( x2 * y * y ) );   // 1st iteration
//	y  = y * ( threehalfs - ( x2 * y * y ) );   // 2nd iteration, this can be removed

	return y;
}

At the time, the general method to compute the inverse square root was to calculate an approximation for $\frac{1}{\sqrt{x}}$ , then revise that approximation via another method until it came within an acceptable error range of the actual result. Common software methods in the early 1990s drew approximations from a lookup table.Template:Sfn The key of the fast inverse square root was to directly compute an approximation by utilizing the structure of floating-point numbers, proving faster than table lookups. The algorithm was approximately four times faster than computing the square root with another method and calculating the reciprocal via floating-point division.Template:Sfn The algorithm was designed with the IEEE 754-1985 32-bit floating-point specification in mind, but investigation from Chris Lomont showed that it could be implemented in other floating-point specifications.Template:Sfn

The advantages in speed offered by the fast inverse square root trick came from treating the 32-bit floating-point word^{[note 1]} as an integer, then subtracting it from a "magic" constant, Template:Mono.^[7]Template:Sfn Template:Sfn Template:Sfn This integer subtraction and bit shift results in a bit pattern which, when re-defined as a floating-point number, is a rough approximation for the inverse square root of the number. One iteration of Newton's method is performed to gain some accuracy, and the code is finished. The algorithm generates reasonably accurate results using a unique first approximation for Newton's method; however, it is much slower and less accurate than using the SSE instruction rsqrtss on x86 processors also released in 1999.Template:R

Worked example

As an example, the number $x = 0.15625$ can be used to calculate $\frac{1}{\sqrt{x}} \approx 2.52982$ . The first steps of the algorithm are illustrated below:

0011_1110_0010_0000_0000_0000_0000_0000  Bit pattern of both x and i
0001_1111_0001_0000_0000_0000_0000_0000  Shift right one position: (i >> 1)
0101_1111_0011_0111_0101_1001_1101_1111  The magic number 0x5F3759DF
0100_0000_0010_0111_0101_1001_1101_1111  The result of 0x5F3759DF - (i >> 1)

Interpreting as IEEE 32-bit representation:

0_01111100_01000000000000000000000  1.25 × 2⁻³
0_00111110_00100000000000000000000  1.125 × 2⁻⁶⁵
0_10111110_01101110101100111011111  1.432430... × 2⁶³
0_10000000_01001110101100111011111  1.307430... × 2¹

Reinterpreting this last bit pattern as a floating point number gives the approximation $y = 2.61486$ , which has an error of about 3.4%. After one iteration of Newton's method, the final result is $y = 2.52549$ , an error of only 0.17%.

Avoiding undefined behavior

According to the C standard, reinterpreting a floating point value as an integer by casting then dereferencing the pointer to it is not valid (undefined behavior). Another way would be to place the floating point value in a union containing an additional 32-bit unsigned integer member, and accesses to that integer provides a bit level view of the contents of the floating point value.

# include <stdint.h> // uint32_t

float Q_rsqrt(float number)
{
  union {
    float    f;
    uint32_t i;
  } conv = { .f = number };
  conv.i  = 0x5f3759df - (conv.i >> 1);
  conv.f *= 1.5F - (number * 0.5F * conv.f * conv.f);
  return conv.f;
}

For C++, however, type punning through a union is also undefined behavior. In modern C++, the recommended method for implementing this function's casts is through C++20's std::bit_cast. This also allows the function to work in constexpr context:

import std;

constexpr std::float32_t Q_rsqrt(std::float32_t number) noexcept
{
  const auto y = std::bit_cast<std::float32_t>(
    0x5f3759df - (std::bit_cast<std::uint32_t>(number) >> 1));
  return y * (1.5f32 - (number * 0.5f32 * y * y));
}

Algorithm

The algorithm computes $\frac{1}{\sqrt{x}}$ by performing the following steps:

Alias the argument $x$ to an integer as a way to compute an approximation of the binary logarithm $\log_{2} (x)$
Use this approximation to compute an approximation of $\log_{2} (\frac{1}{\sqrt{x}}) = - \frac{1}{2} \log_{2} (x)$
Alias back to a float, as a way to compute an approximation of the base-2 exponential
Refine the approximation using a single iteration of Newton's method.

Floating-point representation

Template:Main

Since this algorithm relies heavily on the bit-level representation of single-precision floating-point numbers, a short overview of this representation is provided here. To encode a non-zero real number $x$ as a single precision float, the first step is to write $x$ as a normalized binary number:Template:Sfn

\begin{matrix} x & = \pm 1 . b_{1} b_{2} b_{3} \dots \times 2^{e_{x}} \end{matrix}

where the exponent $e_{x}$ is an integer, and $1 . b_{1} b_{2} b_{3} \dots$ is the binary representation of the significand. Since the single bit before the point in the significand is always 1, it does not need be stored. The equation can be rewritten as:

\begin{matrix} x & = (- 1)^{S_{x}} \cdot 2^{e_{x}} (1 + m_{x}) \end{matrix}

where $m_{x}$ means $0 . b_{1} b_{2} b_{3} \dots$ , so $m_{x} \in [0, 1)$ . From this form, three unsigned integers are computed:Template:Sfn

$S_{x}$ , the "sign bit", is $0$ if $x$ is positive and $1$ negative or zero (1 bit)
$E_{x} = e_{x} + B$ is the "biased exponent", where $B = 127$ is the "exponent bias"^{[note 2]} (8 bits)
$M_{x} = m_{x} \times L$ , where $L = 2^{23}$ ^{[note 3]} (23 bits)

Thus: $e_{x} = E_{x} - B$ and $m_{x} = \frac{M_{x}}{L}$ .

These fields are then packed, left to right, into a 32-bit container.Template:Sfn

As an example, consider again the number $x = 0.15625 = 0.0010 1_{2}$ . Normalizing $x$ yields:

x = (- 1)^{0} \cdot 2^{- 3} (1 + 0.25) = + 2^{- 3} (1 + 0.25)

and thus, the three unsigned integer fields are:

$S = 0$
$E = - 3 + 127 = 124 = 0111 110 0_{2}$
$M = 0.25 \times 2^{23} = 2 097 152 = 0010 0000 0000 0000 0000 000 0_{2}$

these fields are packed as shown in the figure below:

The number is represented in binary as:

I_{x} = S_{x} \cdot 2^{31} + E_{x} L + M_{x}

Also, since this algorithm works on real numbers, $\sqrt{x}$ is only defined for $x \geq 0$ . The code thus assumes $x \geq 0$ and $S_{x} = 0$ .

The number, given to calculate the square root, could be rewritten as:

I_{x} = E_{x} L + M_{x}

x = (- 1)^{0} \cdot 2^{e_{x}} (1 + m_{x}) = + 2^{e_{x}} (1 + m_{x})

Aliasing to an integer as an approximate logarithm

If $\frac{1}{\sqrt{x}}$ were to be calculated without a computer or a calculator, a table of logarithms would be useful, together with the identity $\log_{b} (\frac{1}{\sqrt{x}}) = \log_{b} (x^{- \frac{1}{2}}) = - \frac{1}{2} \log_{b} (x)$ , which is valid for every base $b$ . The fast inverse square root is based on this identity, and on the fact that aliasing a float32 to an integer gives a rough approximation of its logarithm. Here is how:

If $x$ is a positive normal number:

x = 2^{e_{x}} (1 + m_{x})

then

\log_{2} (x) = e_{x} + \log_{2} (1 + m_{x})

and since $m_{x} \in [0, 1)$ , the logarithm on the right-hand side can be approximated byTemplate:Sfn

\log_{2} (1 + m_{x}) \approx m_{x} + σ

where $σ$ is a free parameter used to tune the approximation. For example, $σ = 0$ yields exact results at both ends of the interval, while $σ = \frac{1}{2} - \frac{1 + \ln (\ln (2))}{2 \ln (2)} \approx 0.0430357$ yields the optimal approximation (the best in the sense of the uniform norm of the error). However, this value is not used by the algorithm as it does not take subsequent steps into account.

Thus there is the approximation

\log_{2} (x) \approx e_{x} + m_{x} + σ .

Interpreting the floating-point bit-pattern of $x$ as an integer $I_{x}$ yields^{[note 4]}

\begin{matrix} I_{x} & = E_{x} L + M_{x} \\ = L (e_{x} + B + m_{x}) \\ = L (e_{x} + m_{x} + σ + B - σ) \\ \approx L \log_{2} (x) + L (B - σ) . \end{matrix}

It then appears that $I_{x}$ is a scaled and shifted piecewise-linear approximation of $\log_{2} (x)$ , as illustrated in the figure on the right. In other words, $\log_{2} (x)$ is approximated by

\log_{2} (x) \approx \frac{I_{x}}{L} - (B - σ) .

First approximation of the result

The calculation of $y = \frac{1}{\sqrt{x}}$ is based on the identity

\log_{2} (y) = - \frac{1}{2} \log_{2} (x)

Using the approximation of the logarithm above, applied to both $x$ and $y$ , the above equation gives:

\frac{I_{y}}{L} - (B - σ) \approx - \frac{1}{2} (\frac{I_{x}}{L} - (B - σ))

Thus, an approximation of $I_{y}$ is:

I_{y} \approx \frac{3}{2} L (B - σ) - \frac{1}{2} I_{x}

which is written in the code as

i  = 0x5f3759df - ( i >> 1 );

The first term above is the magic number

\frac{3}{2} L (B - σ) = 𝟶 𝚡 𝟻 𝙵 𝟹 𝟽 𝟻 𝟿 𝙳 𝙵

from which it can be inferred that $σ \approx 0.0450466$ . The second term, $\frac{1}{2} I_{x}$ , is calculated by shifting the bits of $I_{x}$ one position to the right.Template:Sfn

Newton's method

Template:Main Template:Multiple image The number $y = \frac{1}{\sqrt{x}}$ is a solution of the equation $\frac{1}{y^{2}} - x = 0$ . The approximation yielded by the earlier steps can be refined by using a root-finding method, a method that finds the zero of a function. The algorithm uses Newton's method: if there is an approximation, $y_{n}$ for $y$ , then a better approximation $y_{n + 1}$ can be calculated by taking $y_{n} - \frac{f (y_{n})}{f^{'} (y_{n})}$ , where $f^{'} (y_{n})$ is the derivative of $f (y)$ at $y_{n}$ .Template:Sfn Applied to the equation $\frac{1}{y^{2}} - x = 0$ , Newton's method gives

\begin{matrix} f (y) & = \frac{1}{y^{2}} - x \\ f^{'} (y) & = - \frac{2}{y^{3}} \\ y_{n + 1} & = y_{n} - \frac{f (y_{n})}{f^{'} (y_{n})} \\ = y_{n} + \frac{y_{n}^{3}}{2} (\frac{1}{y_{n}^{2}} - x) \\ = y_{n} (\frac{3}{2} - \frac{x}{2} y_{n}^{2}), \end{matrix}

which is written in the code as y = y * ( threehalfs - ( x2 * y * y ) );.

By repeating this step, using the output of the function ( $y_{n + 1}$ ) as the input of the next iteration, the algorithm causes $y$ to converge to the inverse square root.Template:Sfn For the purposes of the Quake III engine, only one iteration was used. A second iteration remained in the code but was commented out.Template:Sfn

Accuracy

As noted above, the approximation is very accurate. The single graph on the right plots the error of the function (that is, the error of the approximation after it has been improved by running one iteration of Newton's method), for inputs starting at 0.01, where the standard library gives 10.0 as a result, and InvSqrt() gives 9.982522, making the relative difference 0.0017478, or 0.175% of the true value, 10. The absolute error only drops from then on, and the relative error stays within the same bounds across all orders of magnitude.

Subsequent improvements

Magic number

It is not known precisely how the exact value for the magic number was determined. Chris Lomont developed a function to minimize approximation error by choosing the magic number $R$ over a range. He first computed the optimal constant for the linear approximation step as Template:Mono, close to Template:Mono, but this new constant gave slightly less accuracy after one iteration of Newton's method.Template:Sfn Lomont then searched for a constant optimal even after one and two Newton iterations and found Template:Mono, which is more accurate than the original at every iteration stage.Template:Sfn He concluded by asking whether the exact value of the original constant was chosen through derivation or trial and error.Template:Sfn Lomont said that the magic number for 64-bit IEEE754 size type double is Template:Mono, but it was later shown by Matthew Robertson to be exactly Template:Mono.^[12]

Jan Kadlec reduced the relative error by a further factor of 2.7 by adjusting the constants in the single Newton's method iteration as well,^[13] arriving after an exhaustive search at

conv.i = 0x5F1FFFF9 - ( conv.i >> 1 );
conv.f *= 0.703952253f * ( 2.38924456f - x * conv.f * conv.f );
return conv.f;

A complete mathematical analysis for determining the magic number is now available for single-precision floating-point numbers.Template:Sfn^[14]

Zero finding

Intermediate to the use of one vs. two iterations of Newton's method in terms of speed and accuracy is a single iteration of Halley's method. In this case, Halley's method is equivalent to applying Newton's method with the starting formula $f (y) = \frac{1}{y^{1 / 2}} - x y^{3 / 2} = 0$ . The update step is then

y_{n + 1} = y_{n} - \frac{f (y_{n})}{f^{'} (y_{n})} = y_{n} (\frac{3 + x y_{n}^{2}}{1 + 3 x y_{n}^{2}}),

where the implementation should calculate $x y_{n}^{2}$ only once, via a temporary variable.

Obsolescence

Subsequent additions by hardware manufacturers have made this algorithm redundant for the most part. For example, on x86, Intel introduced the SSE instruction rsqrtss in 1999. In a 2009 benchmark on the Intel Core 2, this instruction took 0.85ns per float compared to 3.54ns for the fast inverse square root algorithm, and had less error.^[1]

Some low-cost embedded systems do not have specialized square root instructions. However, manufacturers of these systems usually provide trigonometric and other math libraries, based on algorithms such as CORDIC.

Notes

Template:Reflist

References

Template:Reflist

Bibliography

Template:Refbegin

Template:Refend

External links

0x5f3759df, further investigations into accuracy and generalizability of the algorithm by Christian Plesner Hansen
Origin of Quake3's Fast InvSqrt()
Quake III Arena source code (archived in Software Heritage)
Implementation of InvSqrt in DESMOS
"Fast Inverse Square Root — A Quake III Algorithm" (YouTube)

Template:Quake Template:Id Software

Template:Good article

↑ ^1.0 ^1.1 Cite error: Invalid <ref> tag; no text was provided for refs named ruskin
↑ Cite error: Invalid <ref> tag; no text was provided for refs named z88dk
↑ Cite error: Invalid <ref> tag; no text was provided for refs named mrob
↑ Cite error: Invalid <ref> tag; no text was provided for refs named fdlibm
↑ Cite error: Invalid <ref> tag; no text was provided for refs named MolerResp
↑ ^6.0 ^6.1 ^6.2 Cite error: Invalid <ref> tag; no text was provided for refs named Beyond3Dp2
↑ ^7.0 ^7.1 ^7.2 ^7.3 Cite error: Invalid <ref> tag; no text was provided for refs named Beyond3D
↑ Template:Cite web
↑ Cite error: Invalid <ref> tag; no text was provided for refs named csdn
↑ Template:Cite book
↑ Cite error: Invalid <ref> tag; no text was provided for refs named quakesrc
↑ Cite error: Invalid <ref> tag; no text was provided for refs named robertson
↑ Template:Cite web
↑ Template:Cite journal

Cite error: <ref> tags exist for a group named "note", but no corresponding <references group="note"/> tag was found

[ruskin-1] 1.0 ^1.1 Cite error: Invalid <ref> tag; no text was provided for refs named ruskin

[z88dk-2] Cite error: Invalid <ref> tag; no text was provided for refs named z88dk

[mrob-3] Cite error: Invalid <ref> tag; no text was provided for refs named mrob

[fdlibm-4] Cite error: Invalid <ref> tag; no text was provided for refs named fdlibm

[MolerResp-5] Cite error: Invalid <ref> tag; no text was provided for refs named MolerResp

[Beyond3Dp2-6] 6.0 ^6.1 ^6.2 Cite error: Invalid <ref> tag; no text was provided for refs named Beyond3Dp2

[Beyond3D-7] 7.0 ^7.1 ^7.2 ^7.3 Cite error: Invalid <ref> tag; no text was provided for refs named Beyond3D

[interstate76-8] Template:Cite web

[csdn-9] Cite error: Invalid <ref> tag; no text was provided for refs named csdn

[10] Template:Cite book

[quakesrc-11] Cite error: Invalid <ref> tag; no text was provided for refs named quakesrc

[robertson-16] Cite error: Invalid <ref> tag; no text was provided for refs named robertson

[17] Template:Cite web

[:0-18] Template:Cite journal

[1]

[2]

[3]

[4]

[5]

[6]

[7]

[8]

[9]

[10]

[11]

[note 1]

[note 2]

[note 3]

[note 4]

[12]

[13]

[14]

Fast inverse square root

Contents

History

Motivation

Overview of the code

Worked example

Avoiding undefined behavior

Algorithm

Floating-point representation

Aliasing to an integer as an approximate logarithm

First approximation of the result

Newton's method

Accuracy

Subsequent improvements

Magic number

Zero finding

Obsolescence

See also

Notes

References

Bibliography

Further reading

External links

Navigation menu

Fast inverse square root

History

Motivation

Overview of the code

Worked example

Avoiding undefined behavior

Algorithm

Floating-point representation

Aliasing to an integer as an approximate logarithm

First approximation of the result

Newton's method

Accuracy

Subsequent improvements

Magic number

Zero finding

Obsolescence

See also

Notes

References

Bibliography

Further reading

External links

Navigation menu

Search