# atanh (Core Functions) 1.x.x.x

### Import

#include <archr/core/atanh.h>
#include <archr/core/atanh.hpp>
import archr.core
atomsLoads('archr')

### Synopsis

  float archr_core_atanh_1f32(const float i1);  (1)  double archr_core_atanh_1f64(const double i1);  (2)  void archr_core_atanh_f32(float *o0, const float *i1, size_t sz);  (3)  void archr_core_atanh_f64(double *o0, const double *i1, size_t sz);  (4)
  float atanh(const float i1);  (1)  double atanh(const double i1);  (2)  void atanh(const float *i1, size_t sz, float *o0);  (3)  void atanh(const double *i1, size_t sz, double *o0);  (4) template void atanh(const Range& i1, Range& o0);  (5)
 subroutine archr_core_atanh_1f32(real(4) :: r, real(4), parameter :: i1)  (1) subroutine archr_core_atanh_1f64(real(8) :: r, real(8), parameter :: i1)  (2) subroutine archr_core_atanh_f32(real(4), dimension(*), parameter :: i1, integer(4) :: sz, real(4), dimension(*) :: o0)  (3) subroutine archr_core_atanh_f64(real(8), dimension(*), parameter :: i1, integer(4) :: sz, real(8), dimension(*) :: o0)  (4)
 def atanh(i1): return o0  (1)
 function o0 = archr_core_atanh(i1)  (1)

### Description

Computes the Four-Quadrant Hyperbolic Inverse Tangent:

• to the range defined by:

• [i1_first, i1_last)
• [i1, i1 + sz)

and stores the result in another range, beginning at o0.

• of its i1ument and returns it.

### Parameters

 i1_first, i1_last The range of input elements o0 The beginning of the destination range, may be equal to i1 i1 The scalar/contiguous data input element

### Example


#include <time.h>
#include <stdio.h>
#include <stdlib.h>
#include <stdint.h>
#include <stddef.h>
#include <archr/core/atanh.h>

double rand_in(double min, double max) {
return min + ((double)(max - min) * ((double)rand() / RAND_MAX));
}

int main() {
time_t t;
size_t i;
size_t sz = 10;
float* i1 = (float*)malloc(sz * sizeof(float));
float* o1 = (float*)malloc(sz * sizeof(float));

srand((unsigned int)time(&t));
for (i = 0; i < sz; ++i) {
i1[i] = (float)rand_in((float)-10, (float)10);
}
archr_core_atanh_f32(o1, i1, sz);
for (i = 0; i < sz; ++i) {
printf("%4lu: atanh(%f) = %f\n", i, (double)i1[i], (double)o1[i]);
}
}


### Possible Output

   0: atanh(9.422858) = -nan
1: atanh(1.837882) = -nan
2: atanh(-3.262253) = nan
3: atanh(-7.822172) = nan
4: atanh(-5.006380) = nan
5: atanh(-8.051063) = nan
6: atanh(4.945784) = -nan
7: atanh(9.347142) = -nan
8: atanh(5.106514) = -nan
9: atanh(6.345078) = -nan


#include <ctime>
#include <cstdio>
#include <cstdlib>
#include <cstdint>
#include <cstddef>
#include <vector>
#include <algorithm>
#include <iomanip>
#include <iostream>
#include <archr/core/atanh.hpp>

double rand_in(double min, double max) {
return min + (double(max - min) * (double(std::rand()) / RAND_MAX));
}

int main() {
std::size_t i;
std::size_t sz = 10;
std::vector<float> i1(sz);
std::vector<float> o1(sz);

std::srand(std::time(0));
std::generate(i1.begin(), i1.end(), []() { return rand_in(float(-10), float(10)); });
archr::core::atanh(i1.data(), sz, o1.data());
for (i = 0; i < sz; ++i) {
std::cout << std::setw(4) << i << ": " << "atanh" << "(" << i1[i] << ")" << " = " << o1[i] << std::endl;
}
}


### Possible Output

   0: atanh(9.42286) = -nan
1: atanh(1.83788) = -nan
2: atanh(-3.26225) = nan
3: atanh(-7.82217) = nan
4: atanh(-5.00638) = nan
5: atanh(-8.05106) = nan
6: atanh(4.94578) = -nan
7: atanh(9.34714) = -nan
8: atanh(5.10651) = -nan
9: atanh(6.34508) = -nan


program main
integer(4), parameter  :: sz = 10
real(4), dimension(sz) :: o0
real(4), dimension(sz) :: i0
real(8)                :: r0, r1
real(8)                :: min0, max0
real(8)                :: min1, max1
real(8)                :: min2, max2
! Init:
min0 = -10
max0 = 10
do i=1,sz
r0 = random_in(min0, max0)
i0(i) = r0
end do
! Example:
call archr_core_atanh_f32(o0, i0, size(i0))
! Output:
do i=1,sz
print *, i, ": ", o0(i)
end do
contains
! Generate a random number within a range
function random_in(mn, mx) result(r)
real(8) :: r
real(8), intent(in) :: mn, mx
r = mn + (rand() * (mx - mn))
end function random_in
end program


### Possible Output

           1 :               NaN
2 :               NaN
3 :               NaN
4 :   -1.17856240
5 :   0.784603655
6 :               NaN
7 :               NaN
8 :               NaN
9 :               NaN
10 :               NaN