MATHLIB User Guide
MATHLIB_sin.cpp
Go to the documentation of this file.
1 /******************************************************************************
2  * Copyright (C) 2023 Texas Instruments Incorporated - https://www.ti.com/
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions
6  * are met:
7  *
8  * Redistributions of source code must retain the above copyright
9  * notice, this list of conditions and the following disclaimer.
10  *
11  * Redistributions in binary form must reproduce the above copyright
12  * notice, this list of conditions and the following disclaimer in the
13  * documentation and/or other materials provided with the
14  * distribution.
15  *
16  * Neither the name of Texas Instruments Incorporated nor the names of
17  * its contributors may be used to endorse or promote products derived
18  * from this software without specific prior written permission.
19  *
20  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
21  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
22  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
23  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
24  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
25  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
26  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
27  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
28  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
29  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
30  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
31  *
32  ******************************************************************************/
33 
34 #define ELEMENT_COUNT(x) c7x::element_count_of<x>::value
35 
36 /******************************************************************************/
37 /* */
38 /* Includes */
39 /* */
40 /******************************************************************************/
41 
42 #include "MATHLIB_types.h"
43 #include "MATHLIB_utility.h"
44 #include <cstddef>
45 
46 /******************************************************************************/
47 /* */
48 /* MATHLIB_sin */
49 /* */
50 /******************************************************************************/
51 
52 // this method performs sine computation of input vector
53 template <typename T> MATHLIB_STATUS MATHLIB_sin(size_t length, T *pSrc, T *pDst);
54 
55 template <> MATHLIB_STATUS MATHLIB_sin<float>(size_t length, float *pSrc, float *pDst)
56 {
57 
58  // variables
59  MATHLIB_STATUS status = MATHLIB_SUCCESS; // return function status
60  size_t numBlocks = 0; // compute loop's iteration count
61  size_t remNumBlocks = 0; // when numBlocks is not a multiple of SIMD width
62 
63  // derive c7x vector type from template typename
64  typedef typename c7x::make_full_vector<float>::type vec;
65 
66  // Compile-time decision: float_vec => int_vec and double_vec=> long_vec
67  typedef
68  typename std::conditional<ELEMENT_COUNT(c7x::float_vec) == ELEMENT_COUNT(vec), c7x::int_vec, c7x::long_vec>::type
69  vec_type;
70 
71  __SE_TEMPLATE_v1 se0Params = __gen_SE_TEMPLATE_v1();
72  __SA_TEMPLATE_v1 sa0Params = __gen_SA_TEMPLATE_v1();
73 
74  status = MATHLIB_checkParams(length, pSrc, pDst);
75 
76  if (status == MATHLIB_SUCCESS) {
77 
78  MATHLIB_SE0SA01DSequentialInit(&se0Params, &sa0Params, length, pSrc, pDst);
79 
80  // calculate compute loop's iteration counter
81  numBlocks = length / c7x::element_count_of<vec>::value;
82  remNumBlocks = length % c7x::element_count_of<vec>::value;
83  if (remNumBlocks) {
84  numBlocks++;
85  }
86 
87  // open SE0, SE1, and SA0 for reading and writing operands
88  MATHLIB_SE0SA0Open(&se0Params, &sa0Params, pSrc);
89 
90  /**********************************************************************/
91  /* Create and assign values for constants employed on cos computation */
92  /**********************************************************************/
93 
94  vec InvPI, One, MAX, Zero, s1, s2, s3, s4, C1, C2, X, Y, Z, F, G, R, negativeOne, Sign;
95  vec_type N, int_one;
96 
97  InvPI = (vec) 0.318309886183791;
98  One = (vec) 1.0;
99  MAX = (vec) 1048576.0;
100  Zero = (vec) 0.0;
101  s1 = (vec) -1.666665668e-1;
102  s2 = (vec) 8.333025139e-3;
103  s3 = (vec) -1.980741872e-4;
104  s4 = (vec) 2.601903036e-6;
105  C1 = (vec) 3.140625;
106  C2 = (vec) 9.67653589793e-4;
107  negativeOne = (vec) -1;
108 
109  int_one = (vec_type) 1;
110 
111  Sign = One;
112 
113  // compute loop to perform vector sin
114  for (size_t i = 0; i < numBlocks; i++) {
115  vec a = c7x::strm_eng<0, vec>::get_adv();
116  Y = a;
117 
118  // if (__abs(Y) > (vec)MAX) {
119  // Y = Zero;
120  // }
121  __vpred cmp_gt = __cmp_lt_pred((vec) MAX, __abs(Y));
122  Y = __select(cmp_gt, Zero, Y);
123 
124  // X = Y * (1/PI)
125  X = Y * InvPI;
126 
127  N = __float_to_int(X);
128  Z = c7x::convert<vec>(N);
129 
130  /**********************************************************************/
131  /* Sign checking for quadrant 3 or 4 */
132  /**********************************************************************/
133 
134  // if ((N % 2) != 0) {
135  // Sign = -Sign;
136  // }
137  vec_type andN = N & int_one;
138  vec convert_andN = c7x::convert<vec>(andN);
139  __vpred cmp_mod = __cmp_le_pred(convert_andN, Zero);
140  vec Sign_vec = __select(cmp_mod, Sign, negativeOne);
141 
142  F = (Y - (Z * C1)) - (Z * C2);
143  G = F * F;
144 
145  R = ((((((s4 * G) + s3) * G) + s2) * G) + s1) * G;
146 
147  vec output = ((F + (F * R)) * Sign_vec);
148  __vpred tmp = c7x::strm_agen<0, vec>::get_vpred();
149  vec *VB1 = c7x::strm_agen<0, vec>::get_adv(pDst);
150 
151  __vstore_pred(tmp, VB1, output);
152  }
153 
155  }
156 
157  return status;
158 }
159 
160 template <> MATHLIB_STATUS MATHLIB_sin<double>(size_t length, double *pSrc, double *pDst)
161 {
162 
163  // variables
164  MATHLIB_STATUS status = MATHLIB_SUCCESS; // return function status
165  size_t numBlocks = 0; // compute loop's iteration count
166  size_t remNumBlocks = 0; // when numBlocks is not a multiple of SIMD width
167 
168  // derive c7x vector type from template typename
169  typedef typename c7x::make_full_vector<c7x::double_vec>::type vec;
170  typedef typename c7x::make_full_vector<c7x::int_vec>::type vec_type;
171 
172  __SE_TEMPLATE_v1 se0Params = __gen_SE_TEMPLATE_v1();
173  __SA_TEMPLATE_v1 sa0Params = __gen_SA_TEMPLATE_v1();
174 
175  status = MATHLIB_checkParams(length, pSrc, pDst);
176 
177  if (status == MATHLIB_SUCCESS) {
178 
179  MATHLIB_SE0SA01DSequentialInit(&se0Params, &sa0Params, length, pSrc, pDst);
180 
181  // calculate compute loop's iteration counter
182  numBlocks = length / c7x::element_count_of<vec>::value;
183  remNumBlocks = length % c7x::element_count_of<vec>::value;
184  if (remNumBlocks) {
185  numBlocks++;
186  }
187 
188  // open SE0 and SA0 for reading and writing operands
189  MATHLIB_SE0SA0Open(&se0Params, &sa0Params, pSrc);
190 
191  /**********************************************************************/
192  /* Create and assign values for constants employed on cos computation */
193  /**********************************************************************/
194  vec InvPI, C1, C2, r8, r7, r6, r5, r4, r3, r2, r1, MAX, Zero, Sign, negativeOne;
195 
196  InvPI = (vec) 0.31830988618379067154;
197  C1 = (vec) 3.1416015625;
198  C2 = (vec) -8.908910206761537356617e-6;
199  r8 = (vec) 2.7204790957888846175e-15;
200  r7 = (vec) -7.6429178068910467734e-13;
201  r6 = (vec) 1.6058936490371589114e-10;
202  r5 = (vec) -2.5052106798274584544e-8;
203  r4 = (vec) 2.7557319210152756119e-6;
204  r3 = (vec) -1.9841269841201840457e-4;
205  r2 = (vec) 8.3333333333331650314e-3;
206  r1 = (vec) -1.6666666666666665052e-1;
207  MAX = (vec) 1.073741824e+09;
208  Zero = (vec) 0.0;
209  Sign = (vec) 1.0;
210 
211  negativeOne = (vec) -1.0;
212 
213  vec_type int_one = (vec_type) 1;
214 
215  vec X, Z, F1, F2, G, R;
216  vec_type N;
217 
218  // compute loop to perform vector sin
219  for (size_t i = 0; i < numBlocks; i++) {
220  vec a = c7x::strm_eng<0, vec>::get_adv();
221 
222  F1 = a;
223 
224  __vpred cmp_gt = __cmp_lt_pred((vec) MAX, __abs(F1));
225  F1 = __select(cmp_gt, Zero, F1);
226 
227  X = F1 * InvPI;
228  N = __double_to_int(X);
229  Z = __low_int_to_double(N);
230 
231  vec_type andN = N & int_one;
232  vec convert_andN = __low_int_to_double(andN);
233 
234  __vpred cmp_mod = __cmp_le_pred(convert_andN, Zero);
235  vec Sign_vec = __select(cmp_mod, Sign, negativeOne);
236 
237  F1 = (F1 - (Z * C1)) - (Z * C2);
238  F2 = F1 * F1;
239  G = F2 * F2;
240 
241  R = ((((((G * r8) + r6) * G) + r4) * G) + r2) * G;
242  X = ((((((G * r7) + r5) * G) + r3) * G) + r1) * F2;
243  R = R + X;
244  G = ((F1 + (F1 * R)) * Sign_vec);
245 
246  __vpred tmp = c7x::strm_agen<0, vec>::get_vpred();
247  vec *VB1 = c7x::strm_agen<0, vec>::get_adv(pDst);
248  __vstore_pred(tmp, VB1, G);
249  }
250 
252  }
253 
254  return status;
255 }
256 
257 /******************************************************************************/
258 /* */
259 /* C-interface wrapper functions */
260 /* */
261 /******************************************************************************/
262 
263 extern "C" {
264 
265 // single-precision wrapper
266 MATHLIB_STATUS MATHLIB_sin_sp(size_t length, float *pSrc, float *pDst)
267 {
268  MATHLIB_STATUS status = MATHLIB_sin<float>(length, pSrc, pDst);
269  return status;
270 }
271 
272 
273 // double-precision wrapper
274 MATHLIB_STATUS MATHLIB_sin_dp(size_t length, double *pSrc, double *pDst)
275 {
276  MATHLIB_STATUS status = MATHLIB_sin<double>(length, pSrc, pDst);
277  return status;
278 }
279 
280 
281 } // extern "C"
MATHLIB_STATUS MATHLIB_sin< float >(size_t length, float *pSrc, float *pDst)
Definition: MATHLIB_sin.cpp:55
MATHLIB_STATUS MATHLIB_sin(size_t length, T *pSrc, T *pDst)
#define ELEMENT_COUNT(x)
Definition: MATHLIB_sin.cpp:34
MATHLIB_STATUS MATHLIB_sin< double >(size_t length, double *pSrc, double *pDst)
static void MATHLIB_SE0SA0Close()
This method performs SE0 and SA0 close.
static void MATHLIB_SE0SA01DSequentialInit(__SE_TEMPLATE_v1 *se0Params, __SA_TEMPLATE_v1 *sa0Params, size_t length, T *pSrc, T *pDst)
static MATHLIB_STATUS MATHLIB_checkParams(size_t length, T *pSrc, T *pDst)
This method performs parameter checks for MATHLIB function.
static void MATHLIB_SE0SA0Open(__SE_TEMPLATE_v1 *se0Params, __SA_TEMPLATE_v1 *sa0Params, T *pSrc)
This method performs SE0 and SA0 open.
MATHLIB_STATUS MATHLIB_sin_sp(size_t length, float *pSrc, float *pDst)
This function is the C interface for MATHLIB_sin. Function accepts float pointers.
MATHLIB_STATUS MATHLIB_sin_dp(size_t length, double *pSrc, double *pDst)
This function is the C interface for MATHLIB_sin. Function accepts double pointers.
MATHLIB_STATUS_NAME
The enumeration of all status codes.
@ MATHLIB_SUCCESS