agd

auto eve::agd = functor<agd_t>

inlineconstexpr

Header file

#include <eve/module/math.hpp>

Callable Signatures

namespace eve
{
   // Regular overload
   constexpr auto agd(floating_value auto x)                          noexcept; // 1
 
   // Semantic option
   constexpr auto agd[raw](floating_value auto x)                     noexcept; // 2
   constexpr auto agd[fast] (floating_value auto x)                   noexcept; // 2
 
   // Lanes masking
   constexpr auto agd[conditional_expr auto c](floating_value auto x) noexcept; // 3
   constexpr auto agd[logical_value auto m](floating_value auto x)    noexcept; // 3
}

Parameters

• x: floating value.
• c: Conditional expression masking the operation.
• m: Logical value masking the operation.

Return value

1. Returns the elementwise inverse gudermannian of the input for x angle in the superior half circle. In particular:
   • If the element is \(\pm0\), \(0\) is returned.
   • If the element is \(\pm\pi/2\), \(\infty\) is returned.
   • If the element is not in \([-\pi/2, \pi/2] \), NaN is returned.
2. The raw and fast options use internally less accuate but faster implementations.
3. The operation is performed conditionally.

External references

• Wolfram MathWorld: Inverse Gudermannian
• Wikipedia: Gudermannian function
• DLMF: gudermannian functions

Example

// revision 1
#include <eve/module/math.hpp>
#include <iostream>
 
int main()
{
  eve::wide wf = {1.0f, 0.0f, eve::pio_2(eve::as<float>()), eve::pio_4(eve::as<float>())};
 
  std::cout << "<- wf                     = " << wf << "\n";
 
  std::cout << "-> agd(wf)                = " << eve::agd(wf) << "\n";
  std::cout << "-> agd[ignore_last(2)](wf)= " << eve::agd[eve::ignore_last(2)](wf) << "\n";
  std::cout << "-> agd[wf != -2.0f](wf)   = " << eve::agd[wf != -2.0f](wf) << "\n";
}