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

### Import

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

### Synopsis

  float archr_core_asech_1f32(const float i1);  (1)  double archr_core_asech_1f64(const double i1);  (2)  void archr_core_asech_f32(float *o0, const float *i1, size_t sz);  (3)  void archr_core_asech_f64(double *o0, const double *i1, size_t sz);  (4)
  float asech(const float i1);  (1)  double asech(const double i1);  (2)  void asech(const float *i1, size_t sz, float *o0);  (3)  void asech(const double *i1, size_t sz, double *o0);  (4) template void asech(const Range& i1, Range& o0);  (5)
 subroutine archr_core_asech_1f32(real(4) :: r, real(4), parameter :: i1)  (1) subroutine archr_core_asech_1f64(real(8) :: r, real(8), parameter :: i1)  (2) subroutine archr_core_asech_f32(real(4), dimension(*), parameter :: i1, integer(4) :: sz, real(4), dimension(*) :: o0)  (3) subroutine archr_core_asech_f64(real(8), dimension(*), parameter :: i1, integer(4) :: sz, real(8), dimension(*) :: o0)  (4)
 def asech(i1): return o0  (1)
 function o0 = archr_core_asech(i1)  (1)

### Description

Computes the Inverse Hyperbolic Secant:

• 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/asech.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_asech_f32(o1, i1, sz);
for (i = 0; i < sz; ++i) {
printf("%4lu: asech(%f) = %f\n", i, (double)i1[i], (double)o1[i]);
}
}


### Possible Output

   0: asech(-3.466457) = -nan
1: asech(0.007624) = 5.569626
2: asech(2.723485) = -nan
3: asech(8.514454) = -nan
4: asech(-6.434300) = -nan
5: asech(-3.718313) = -nan
6: asech(-7.909604) = -nan
7: asech(-4.880131) = -nan
8: asech(-8.887694) = -nan
9: asech(-2.049582) = -nan


#include <ctime>
#include <cstdio>
#include <cstdlib>
#include <cstdint>
#include <cstddef>
#include <vector>
#include <algorithm>
#include <iomanip>
#include <iostream>
#include <archr/core/asech.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::asech(i1.data(), sz, o1.data());
for (i = 0; i < sz; ++i) {
std::cout << std::setw(4) << i << ": " << "asech" << "(" << i1[i] << ")" << " = " << o1[i] << std::endl;
}
}


### Possible Output

   0: asech(-3.46646) = -nan
1: asech(0.0076237) = 5.56963
2: asech(2.72348) = -nan
3: asech(8.51445) = -nan
4: asech(-6.4343) = -nan
5: asech(-3.71831) = -nan
6: asech(-7.9096) = -nan
7: asech(-4.88013) = -nan
8: asech(-8.88769) = -nan
9: asech(-2.04958) = -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_asech_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 :               NaN
5 :   0.985257924
6 :               NaN
7 :               NaN
8 :               NaN
9 :               NaN
10 :               NaN