Rust f32::atanh

Percentage Accurate: 99.8% → 99.8%
Time: 4.5s
Alternatives: 5
Speedup: 1.0×

Specification

?
\[\begin{array}{l} \\ \tanh^{-1} x \end{array} \]
(FPCore (x) :precision binary32 (atanh x))
float code(float x) {
	return atanhf(x);
}
function code(x)
	return atanh(x)
end
function tmp = code(x)
	tmp = atanh(x);
end
\begin{array}{l}

\\
\tanh^{-1} x
\end{array}

Sampling outcomes in binary32 precision:

Local Percentage Accuracy vs ?

The average percentage accuracy by input value. Horizontal axis shows value of an input variable; the variable is choosen in the title. Vertical axis is accuracy; higher is better. Red represent the original program, while blue represents Herbie's suggestion. These can be toggled with buttons below the plot. The line is an average while dots represent individual samples.

Accuracy vs Speed?

Herbie found 5 alternatives:

AlternativeAccuracySpeedup
The accuracy (vertical axis) and speed (horizontal axis) of each alternatives. Up and to the right is better. The red square shows the initial program, and each blue circle shows an alternative.The line shows the best available speed-accuracy tradeoffs.

Initial Program: 99.8% accurate, 1.0× speedup?

\[\begin{array}{l} \\ 0.5 \cdot \mathsf{log1p}\left(\frac{2 \cdot x}{1 - x}\right) \end{array} \]
(FPCore (x) :precision binary32 (* 0.5 (log1p (/ (* 2.0 x) (- 1.0 x)))))
float code(float x) {
	return 0.5f * log1pf(((2.0f * x) / (1.0f - x)));
}
function code(x)
	return Float32(Float32(0.5) * log1p(Float32(Float32(Float32(2.0) * x) / Float32(Float32(1.0) - x))))
end
\begin{array}{l}

\\
0.5 \cdot \mathsf{log1p}\left(\frac{2 \cdot x}{1 - x}\right)
\end{array}

Alternative 1: 99.8% accurate, 1.0× speedup?

\[\begin{array}{l} \\ 0.5 \cdot \mathsf{log1p}\left(\frac{x + x}{1 - x}\right) \end{array} \]
(FPCore (x) :precision binary32 (* 0.5 (log1p (/ (+ x x) (- 1.0 x)))))
float code(float x) {
	return 0.5f * log1pf(((x + x) / (1.0f - x)));
}
function code(x)
	return Float32(Float32(0.5) * log1p(Float32(Float32(x + x) / Float32(Float32(1.0) - x))))
end
\begin{array}{l}

\\
0.5 \cdot \mathsf{log1p}\left(\frac{x + x}{1 - x}\right)
\end{array}
Derivation
  1. Initial program 99.9%

    \[0.5 \cdot \mathsf{log1p}\left(\frac{2 \cdot x}{1 - x}\right) \]
  2. Add Preprocessing
  3. Step-by-step derivation
    1. lift-*.f32N/A

      \[\leadsto \frac{1}{2} \cdot \mathsf{log1p}\left(\frac{\color{blue}{2 \cdot x}}{1 - x}\right) \]
    2. count-2-revN/A

      \[\leadsto \frac{1}{2} \cdot \mathsf{log1p}\left(\frac{\color{blue}{x + x}}{1 - x}\right) \]
    3. lower-+.f3299.9

      \[\leadsto 0.5 \cdot \mathsf{log1p}\left(\frac{\color{blue}{x + x}}{1 - x}\right) \]
  4. Applied rewrites99.9%

    \[\leadsto 0.5 \cdot \mathsf{log1p}\left(\frac{\color{blue}{x + x}}{1 - x}\right) \]
  5. Add Preprocessing

Alternative 2: 99.2% accurate, 3.2× speedup?

\[\begin{array}{l} \\ \mathsf{fma}\left(\left(x \cdot x\right) \cdot x, \mathsf{fma}\left(\mathsf{fma}\left(0.14285714285714285, x \cdot x, 0.2\right), x \cdot x, 0.3333333333333333\right), x\right) \end{array} \]
(FPCore (x)
 :precision binary32
 (fma
  (* (* x x) x)
  (fma (fma 0.14285714285714285 (* x x) 0.2) (* x x) 0.3333333333333333)
  x))
float code(float x) {
	return fmaf(((x * x) * x), fmaf(fmaf(0.14285714285714285f, (x * x), 0.2f), (x * x), 0.3333333333333333f), x);
}
function code(x)
	return fma(Float32(Float32(x * x) * x), fma(fma(Float32(0.14285714285714285), Float32(x * x), Float32(0.2)), Float32(x * x), Float32(0.3333333333333333)), x)
end
\begin{array}{l}

\\
\mathsf{fma}\left(\left(x \cdot x\right) \cdot x, \mathsf{fma}\left(\mathsf{fma}\left(0.14285714285714285, x \cdot x, 0.2\right), x \cdot x, 0.3333333333333333\right), x\right)
\end{array}
Derivation
  1. Initial program 99.9%

    \[0.5 \cdot \mathsf{log1p}\left(\frac{2 \cdot x}{1 - x}\right) \]
  2. Add Preprocessing
  3. Taylor expanded in x around 0

    \[\leadsto \color{blue}{x \cdot \left(1 + {x}^{2} \cdot \left(\frac{1}{3} + {x}^{2} \cdot \left(\frac{1}{5} + \frac{1}{7} \cdot {x}^{2}\right)\right)\right)} \]
  4. Step-by-step derivation
    1. +-commutativeN/A

      \[\leadsto x \cdot \color{blue}{\left({x}^{2} \cdot \left(\frac{1}{3} + {x}^{2} \cdot \left(\frac{1}{5} + \frac{1}{7} \cdot {x}^{2}\right)\right) + 1\right)} \]
    2. distribute-lft-inN/A

      \[\leadsto \color{blue}{x \cdot \left({x}^{2} \cdot \left(\frac{1}{3} + {x}^{2} \cdot \left(\frac{1}{5} + \frac{1}{7} \cdot {x}^{2}\right)\right)\right) + x \cdot 1} \]
    3. associate-*r*N/A

      \[\leadsto \color{blue}{\left(x \cdot {x}^{2}\right) \cdot \left(\frac{1}{3} + {x}^{2} \cdot \left(\frac{1}{5} + \frac{1}{7} \cdot {x}^{2}\right)\right)} + x \cdot 1 \]
    4. unpow2N/A

      \[\leadsto \left(x \cdot \color{blue}{\left(x \cdot x\right)}\right) \cdot \left(\frac{1}{3} + {x}^{2} \cdot \left(\frac{1}{5} + \frac{1}{7} \cdot {x}^{2}\right)\right) + x \cdot 1 \]
    5. cube-multN/A

      \[\leadsto \color{blue}{{x}^{3}} \cdot \left(\frac{1}{3} + {x}^{2} \cdot \left(\frac{1}{5} + \frac{1}{7} \cdot {x}^{2}\right)\right) + x \cdot 1 \]
    6. *-rgt-identityN/A

      \[\leadsto {x}^{3} \cdot \left(\frac{1}{3} + {x}^{2} \cdot \left(\frac{1}{5} + \frac{1}{7} \cdot {x}^{2}\right)\right) + \color{blue}{x} \]
    7. lower-fma.f32N/A

      \[\leadsto \color{blue}{\mathsf{fma}\left({x}^{3}, \frac{1}{3} + {x}^{2} \cdot \left(\frac{1}{5} + \frac{1}{7} \cdot {x}^{2}\right), x\right)} \]
  5. Applied rewrites99.7%

    \[\leadsto \color{blue}{\mathsf{fma}\left({x}^{3}, \mathsf{fma}\left(\mathsf{fma}\left(0.14285714285714285, x \cdot x, 0.2\right), x \cdot x, 0.3333333333333333\right), x\right)} \]
  6. Step-by-step derivation
    1. Applied rewrites99.7%

      \[\leadsto \mathsf{fma}\left(\left(x \cdot x\right) \cdot x, \mathsf{fma}\left(\color{blue}{\mathsf{fma}\left(0.14285714285714285, x \cdot x, 0.2\right)}, x \cdot x, 0.3333333333333333\right), x\right) \]
    2. Add Preprocessing

    Alternative 3: 98.9% accurate, 4.5× speedup?

    \[\begin{array}{l} \\ \mathsf{fma}\left(\left(x \cdot x\right) \cdot x, \mathsf{fma}\left(0.2, x \cdot x, 0.3333333333333333\right), x\right) \end{array} \]
    (FPCore (x)
     :precision binary32
     (fma (* (* x x) x) (fma 0.2 (* x x) 0.3333333333333333) x))
    float code(float x) {
    	return fmaf(((x * x) * x), fmaf(0.2f, (x * x), 0.3333333333333333f), x);
    }
    
    function code(x)
    	return fma(Float32(Float32(x * x) * x), fma(Float32(0.2), Float32(x * x), Float32(0.3333333333333333)), x)
    end
    
    \begin{array}{l}
    
    \\
    \mathsf{fma}\left(\left(x \cdot x\right) \cdot x, \mathsf{fma}\left(0.2, x \cdot x, 0.3333333333333333\right), x\right)
    \end{array}
    
    Derivation
    1. Initial program 99.9%

      \[0.5 \cdot \mathsf{log1p}\left(\frac{2 \cdot x}{1 - x}\right) \]
    2. Add Preprocessing
    3. Taylor expanded in x around 0

      \[\leadsto \color{blue}{x \cdot \left(1 + {x}^{2} \cdot \left(\frac{1}{3} + {x}^{2} \cdot \left(\frac{1}{5} + \frac{1}{7} \cdot {x}^{2}\right)\right)\right)} \]
    4. Step-by-step derivation
      1. +-commutativeN/A

        \[\leadsto x \cdot \color{blue}{\left({x}^{2} \cdot \left(\frac{1}{3} + {x}^{2} \cdot \left(\frac{1}{5} + \frac{1}{7} \cdot {x}^{2}\right)\right) + 1\right)} \]
      2. distribute-lft-inN/A

        \[\leadsto \color{blue}{x \cdot \left({x}^{2} \cdot \left(\frac{1}{3} + {x}^{2} \cdot \left(\frac{1}{5} + \frac{1}{7} \cdot {x}^{2}\right)\right)\right) + x \cdot 1} \]
      3. associate-*r*N/A

        \[\leadsto \color{blue}{\left(x \cdot {x}^{2}\right) \cdot \left(\frac{1}{3} + {x}^{2} \cdot \left(\frac{1}{5} + \frac{1}{7} \cdot {x}^{2}\right)\right)} + x \cdot 1 \]
      4. unpow2N/A

        \[\leadsto \left(x \cdot \color{blue}{\left(x \cdot x\right)}\right) \cdot \left(\frac{1}{3} + {x}^{2} \cdot \left(\frac{1}{5} + \frac{1}{7} \cdot {x}^{2}\right)\right) + x \cdot 1 \]
      5. cube-multN/A

        \[\leadsto \color{blue}{{x}^{3}} \cdot \left(\frac{1}{3} + {x}^{2} \cdot \left(\frac{1}{5} + \frac{1}{7} \cdot {x}^{2}\right)\right) + x \cdot 1 \]
      6. *-rgt-identityN/A

        \[\leadsto {x}^{3} \cdot \left(\frac{1}{3} + {x}^{2} \cdot \left(\frac{1}{5} + \frac{1}{7} \cdot {x}^{2}\right)\right) + \color{blue}{x} \]
      7. lower-fma.f32N/A

        \[\leadsto \color{blue}{\mathsf{fma}\left({x}^{3}, \frac{1}{3} + {x}^{2} \cdot \left(\frac{1}{5} + \frac{1}{7} \cdot {x}^{2}\right), x\right)} \]
    5. Applied rewrites99.7%

      \[\leadsto \color{blue}{\mathsf{fma}\left({x}^{3}, \mathsf{fma}\left(\mathsf{fma}\left(0.14285714285714285, x \cdot x, 0.2\right), x \cdot x, 0.3333333333333333\right), x\right)} \]
    6. Step-by-step derivation
      1. Applied rewrites99.7%

        \[\leadsto \mathsf{fma}\left(\left(x \cdot x\right) \cdot x, \mathsf{fma}\left(\color{blue}{\mathsf{fma}\left(0.14285714285714285, x \cdot x, 0.2\right)}, x \cdot x, 0.3333333333333333\right), x\right) \]
      2. Taylor expanded in x around 0

        \[\leadsto \mathsf{fma}\left(\left(x \cdot x\right) \cdot x, \mathsf{fma}\left(\frac{1}{5}, \color{blue}{x} \cdot x, \frac{1}{3}\right), x\right) \]
      3. Step-by-step derivation
        1. Applied rewrites99.5%

          \[\leadsto \mathsf{fma}\left(\left(x \cdot x\right) \cdot x, \mathsf{fma}\left(0.2, \color{blue}{x} \cdot x, 0.3333333333333333\right), x\right) \]
        2. Add Preprocessing

        Alternative 4: 98.4% accurate, 7.4× speedup?

        \[\begin{array}{l} \\ \mathsf{fma}\left(\left(x \cdot x\right) \cdot x, 0.3333333333333333, x\right) \end{array} \]
        (FPCore (x) :precision binary32 (fma (* (* x x) x) 0.3333333333333333 x))
        float code(float x) {
        	return fmaf(((x * x) * x), 0.3333333333333333f, x);
        }
        
        function code(x)
        	return fma(Float32(Float32(x * x) * x), Float32(0.3333333333333333), x)
        end
        
        \begin{array}{l}
        
        \\
        \mathsf{fma}\left(\left(x \cdot x\right) \cdot x, 0.3333333333333333, x\right)
        \end{array}
        
        Derivation
        1. Initial program 99.9%

          \[0.5 \cdot \mathsf{log1p}\left(\frac{2 \cdot x}{1 - x}\right) \]
        2. Add Preprocessing
        3. Taylor expanded in x around 0

          \[\leadsto \color{blue}{x \cdot \left(1 + \frac{1}{3} \cdot {x}^{2}\right)} \]
        4. Step-by-step derivation
          1. +-commutativeN/A

            \[\leadsto x \cdot \color{blue}{\left(\frac{1}{3} \cdot {x}^{2} + 1\right)} \]
          2. distribute-lft-inN/A

            \[\leadsto \color{blue}{x \cdot \left(\frac{1}{3} \cdot {x}^{2}\right) + x \cdot 1} \]
          3. *-commutativeN/A

            \[\leadsto x \cdot \color{blue}{\left({x}^{2} \cdot \frac{1}{3}\right)} + x \cdot 1 \]
          4. associate-*r*N/A

            \[\leadsto \color{blue}{\left(x \cdot {x}^{2}\right) \cdot \frac{1}{3}} + x \cdot 1 \]
          5. unpow2N/A

            \[\leadsto \left(x \cdot \color{blue}{\left(x \cdot x\right)}\right) \cdot \frac{1}{3} + x \cdot 1 \]
          6. cube-multN/A

            \[\leadsto \color{blue}{{x}^{3}} \cdot \frac{1}{3} + x \cdot 1 \]
          7. *-rgt-identityN/A

            \[\leadsto {x}^{3} \cdot \frac{1}{3} + \color{blue}{x} \]
          8. lower-fma.f32N/A

            \[\leadsto \color{blue}{\mathsf{fma}\left({x}^{3}, \frac{1}{3}, x\right)} \]
          9. lower-pow.f3299.2

            \[\leadsto \mathsf{fma}\left(\color{blue}{{x}^{3}}, 0.3333333333333333, x\right) \]
        5. Applied rewrites99.2%

          \[\leadsto \color{blue}{\mathsf{fma}\left({x}^{3}, 0.3333333333333333, x\right)} \]
        6. Step-by-step derivation
          1. Applied rewrites99.2%

            \[\leadsto \mathsf{fma}\left(\left(x \cdot x\right) \cdot x, 0.3333333333333333, x\right) \]
          2. Add Preprocessing

          Alternative 5: 96.8% accurate, 11.4× speedup?

          \[\begin{array}{l} \\ 0.5 \cdot \left(2 \cdot x\right) \end{array} \]
          (FPCore (x) :precision binary32 (* 0.5 (* 2.0 x)))
          float code(float x) {
          	return 0.5f * (2.0f * x);
          }
          
          module fmin_fmax_functions
              implicit none
              private
              public fmax
              public fmin
          
              interface fmax
                  module procedure fmax88
                  module procedure fmax44
                  module procedure fmax84
                  module procedure fmax48
              end interface
              interface fmin
                  module procedure fmin88
                  module procedure fmin44
                  module procedure fmin84
                  module procedure fmin48
              end interface
          contains
              real(8) function fmax88(x, y) result (res)
                  real(8), intent (in) :: x
                  real(8), intent (in) :: y
                  res = merge(y, merge(x, max(x, y), y /= y), x /= x)
              end function
              real(4) function fmax44(x, y) result (res)
                  real(4), intent (in) :: x
                  real(4), intent (in) :: y
                  res = merge(y, merge(x, max(x, y), y /= y), x /= x)
              end function
              real(8) function fmax84(x, y) result(res)
                  real(8), intent (in) :: x
                  real(4), intent (in) :: y
                  res = merge(dble(y), merge(x, max(x, dble(y)), y /= y), x /= x)
              end function
              real(8) function fmax48(x, y) result(res)
                  real(4), intent (in) :: x
                  real(8), intent (in) :: y
                  res = merge(y, merge(dble(x), max(dble(x), y), y /= y), x /= x)
              end function
              real(8) function fmin88(x, y) result (res)
                  real(8), intent (in) :: x
                  real(8), intent (in) :: y
                  res = merge(y, merge(x, min(x, y), y /= y), x /= x)
              end function
              real(4) function fmin44(x, y) result (res)
                  real(4), intent (in) :: x
                  real(4), intent (in) :: y
                  res = merge(y, merge(x, min(x, y), y /= y), x /= x)
              end function
              real(8) function fmin84(x, y) result(res)
                  real(8), intent (in) :: x
                  real(4), intent (in) :: y
                  res = merge(dble(y), merge(x, min(x, dble(y)), y /= y), x /= x)
              end function
              real(8) function fmin48(x, y) result(res)
                  real(4), intent (in) :: x
                  real(8), intent (in) :: y
                  res = merge(y, merge(dble(x), min(dble(x), y), y /= y), x /= x)
              end function
          end module
          
          real(4) function code(x)
          use fmin_fmax_functions
              real(4), intent (in) :: x
              code = 0.5e0 * (2.0e0 * x)
          end function
          
          function code(x)
          	return Float32(Float32(0.5) * Float32(Float32(2.0) * x))
          end
          
          function tmp = code(x)
          	tmp = single(0.5) * (single(2.0) * x);
          end
          
          \begin{array}{l}
          
          \\
          0.5 \cdot \left(2 \cdot x\right)
          \end{array}
          
          Derivation
          1. Initial program 99.9%

            \[0.5 \cdot \mathsf{log1p}\left(\frac{2 \cdot x}{1 - x}\right) \]
          2. Add Preprocessing
          3. Taylor expanded in x around 0

            \[\leadsto \frac{1}{2} \cdot \color{blue}{\left(2 \cdot x\right)} \]
          4. Step-by-step derivation
            1. lower-*.f3297.6

              \[\leadsto 0.5 \cdot \color{blue}{\left(2 \cdot x\right)} \]
          5. Applied rewrites97.6%

            \[\leadsto 0.5 \cdot \color{blue}{\left(2 \cdot x\right)} \]
          6. Add Preprocessing

          Reproduce

          ?
          herbie shell --seed 2024360 
          (FPCore (x)
            :name "Rust f32::atanh"
            :precision binary32
            (* 0.5 (log1p (/ (* 2.0 x) (- 1.0 x)))))