betainc

auto eve::betainc = functor<betainc_t>

inlineconstexpr

Defined in header

#include <eve/module/special.hpp>

Callable Signatures

namespace eve
{
   // Regular overload
   constexpr auto betainc(floating_value auto s,
                          floating_value auto x, floating_value auto y)          noexcept; // 1
 
   // semantic modifyers
   constexpr auto betainc[raw](/*any previous overload*/)                        noexcept; // 2
   constexpr auto betainc[fast](/*any previous overload*/)                       noexcept; // 2
 
   // Lanes masking
   constexpr auto betainc[conditional_expr auto c](/*any previous overload*/)    noexcept; // 3
   constexpr auto betainc[logical_value auto m](*any previous overload*/)        noexcept; // 3
}

Parameters

• s : real floating argument. \( s \in [0, 1]\)
• x, y: strictly positive real floating arguments.

Return value

1. The value of the incomplete betainc function is returned.
2. speedier computations at accuracy price,
3. The operation is performed conditionnaly.

External references

• DLMF: Incomplete Beta Function
• Wolfram MathWorld: Beta Incomplete Function
• Wikipedia: Beta Function

Example

// revision 1
#include <eve/module/special.hpp>
#include <iostream>
 
int main()
{
  eve::wide pf = { 0.0f, 0.1f, 0.5f, 2.0f};
  eve::wide qf = { 1.0f, 1.0f, 3.0f, 5.0f};
  eve::wide rf = { 4.0f, 2.0f, 1.0f, 0.2f};
 
  std::cout << "<- pf                                  = " << pf << '\n';
  std::cout << "<- qf                                  = " << qf << '\n';
  std::cout << "<- rf                                  = " << rf << '\n';
 
  std::cout << "-> betainc(pf, qf, rf)                 = " << eve::betainc(pf, qf, rf) << '\n';
  std::cout << "-> betainc[ignore_last(2)](pf, qf, rf) = " << eve::betainc[eve::ignore_last(2)](pf, qf, rf) << '\n';
  std::cout << "-> betainc[rf != 0.2f](pf, qf, rf)     = " << eve::betainc[rf != 0.2](pf, qf, rf) << '\n';
}