feat: add math/base/special/kernel-sinf

---
type: pre_commit_static_analysis_report
description: Results of running static analysis checks when committing changes.
report:
  - task: lint_filenames
    status: passed
  - task: lint_editorconfig
    status: passed
  - task: lint_markdown
    status: passed
  - task: lint_package_json
    status: na
  - task: lint_repl_help
    status: passed
  - task: lint_javascript_src
    status: passed
  - task: lint_javascript_cli
    status: na
  - task: lint_javascript_examples
    status: passed
  - task: lint_javascript_tests
    status: passed
  - task: lint_javascript_benchmarks
    status: passed
  - task: lint_python
    status: na
  - task: lint_r
    status: na
  - task: lint_c_src
    status: passed
  - task: lint_c_examples
    status: passed
  - task: lint_c_benchmarks
    status: passed
  - task: lint_c_tests_fixtures
    status: na
  - task: lint_shell
    status: na
  - task: lint_typescript_declarations
    status: passed
  - task: lint_typescript_tests
    status: passed
  - task: lint_license_headers
    status: passed
---

Author: anandkaranubc

lib/node_modules/@stdlib/math/base/special/kernel-sinf/README.md

@@ -8,7 +8,7 @@ Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
 You may obtain a copy of the License at
 
-    http://www.apache.org/licenses/LICENSE-2.0
+   http://www.apache.org/licenses/LICENSE-2.0
 
 Unless required by applicable law or agreed to in writing, software
 distributed under the License is distributed on an "AS IS" BASIS,
@@ -35,52 +35,23 @@ var kernelSinf = require( '@stdlib/math/base/special/kernel-sinf' );
 Computes the [sine][sine] of a single-precision floating-point number on `[-π/4, π/4]`.
 
 ```javascript
-var v = kernelSinf( 0.0, 0.0 );
+var v = kernelSinf( 0.0 );
 // returns ~0.0
 
-v = kernelSinf( 3.14159/6.0, 0.0 );
+v = kernelSinf( 3.141592653589793/6.0 );
 // returns ~0.5
 
-v = kernelSinf( 0.619, 9.279e-10 );
-// returns ~0.58
+v = kernelSinf( 0.619 );
+// returns ~0.580
 
-v = kernelSinf( NaN, 0.0 );
-// returns NaN
-
-v = kernelSinf( 3.0, NaN );
-// returns NaN
-
-v = kernelSinf( NaN, NaN );
+v = kernelSinf( NaN );
 // returns NaN
 ```
 
 </section>
 
 <!-- /.usage -->
 
-<section class="notes">
-
-## Notes
-
--   For increased accuracy, the number for which the [sine][sine] should be evaluated can be supplied as a [single-double number][single-arithmetic] (i.e., a non-evaluated sum of two [single-precision floating-point numbers][ieee754] `x` and `y`).
-
--   As components of a [single-double number][single-arithmetic], the two [single-precision floating-point numbers][ieee754] `x` and `y` must satisfy
-
-    <!-- <equation class="equation" label="eq:single_double_inequality" align="center" raw="|y| \leq \frac{1}{2} \operatorname{ulp}(x)" alt="Inequality for the two components of a single-double number."> -->
-
-    <div class="equation" align="center" data-raw-text="|y| \leq \frac{1}{2} \operatorname{ulp}(x)" data-equation="eq:single_double_inequality">
-        <img src="https://cdn.jsdelivr.net/gh/stdlib-js/stdlib@819807799dc2df7eb037d5901624fa3169bce774/lib/node_modules/@stdlib/math/base/special/kernel-sin/docs/img/equation_double_double_inequality.svg" alt="Inequality for the two components of a single-double number.">
-        <br>
-    </div>
-
-    <!-- </equation> -->
-
-    where `ulp` stands for [units in the last place][ulp].
-
-</section>
-
-<!-- /.notes -->
-
 <section class="examples">
 
 ## Examples
@@ -89,15 +60,13 @@ v = kernelSinf( NaN, NaN );
 
 ```javascript
 var linspace = require( '@stdlib/array/base/linspace' );
-var PI = require( '@stdlib/constants/float32/pi' );
+var logEachMap = require( '@stdlib/console/log-each-map' );
+var PI = require( '@stdlib/constants/float64/pi' );
 var kernelSinf = require( '@stdlib/math/base/special/kernel-sinf' );
 
 var x = linspace( -PI/4.0, PI/4.0, 100 );
 
-var i;
-for ( i = 0; i < x.length; i++ ) {
-    console.log( 'sine(%d) = %d', x[ i ], kernelSinf( x[ i ], 0.0 ) );
-}
+logEachMap( 'kernelSinf(%0.4f) = %0.4f', x, kernelSinf );
 ```
 
 </section>
@@ -130,25 +99,24 @@ for ( i = 0; i < x.length; i++ ) {
 #include "stdlib/math/base/special/kernel_sinf.h"
 ```
 
-#### stdlib_base_kernel_sinf( x, y )
+#### stdlib_base_kernel_sinf( x )
 
 Computes the [sine][sine] of a single-precision floating-point number on `[-π/4, π/4]`.
 
 ```c
-float out = stdlib_base_kernel_sinf( 0.0f, 0.0f );
+float v = stdlib_base_kernel_sinf( 0.0 );
 // returns ~0.0f
 
-out = stdlib_base_kernel_sinf( 0.619f, 9.279e-10f );
-// returns ~0.58f
+v = stdlib_base_kernel_sinf( 3.141592653589793/6.0 );
+// returns ~0.5f
 ```
 
 The function accepts the following arguments:
 
--   **x**: `[in] float` input value (in radians, assumed to be bounded by `~pi/4` in magnitude).
--   **y**: `[in] float` tail of `x`.
+-   **x**: `[in] double` input value (in radians, assumed to be bounded by `~pi/4` in magnitude).
 
 ```c
-float stdlib_base_kernel_sinf( const float x, const float y );
+float stdlib_base_kernel_sinf( const double x );
 ```
 
 </section>
@@ -159,10 +127,6 @@ float stdlib_base_kernel_sinf( const float x, const float y );
 
 <section class="notes">
 
-### Notes
-
--   For increased accuracy, the number for which the [sine][sine] should be evaluated can be supplied as a [single-double number][single-arithmetic] (i.e., a non-evaluated sum of two [single-precision floating-point numbers][ieee754] `x` and `y`).
-
 </section>
 
 <!-- /.notes -->
@@ -178,13 +142,13 @@ float stdlib_base_kernel_sinf( const float x, const float y );
 #include <stdio.h>
 
 int main( void ) {
-    const float x[] = { -0.7853982f, -0.6108652f, -0.4363323f, -0.2617994f, -0.08726646f, 0.08726646f, 0.2617994f, 0.4363323f, 0.6108652f, 0.7853982f };
+    const double x[] = { -0.7853981633974483, -0.6108652381980153, -0.4363323129985824, -0.26179938779914946, -0.08726646259971649, 0.08726646259971649, 0.26179938779914935, 0.43633231299858233, 0.6108652381980153, 0.7853981633974483 };
 
     float out;
     int i;
     for ( i = 0; i < 10; i++ ) {
-        out = stdlib_base_kernel_sinf( x[ i ], 0.0f );
-        printf ( "x: %f, y: %f, out: %f\n", x[ i ], 0.0f, out );
+        out = stdlib_base_kernel_sinf( x[ i ] );
+        printf ( "x[ i ]: %lf, out: %f\n", x[ i ], out );
     }
 }
 ```
@@ -201,15 +165,6 @@ int main( void ) {
 
 <section class="related">
 
-* * *
-
-## See Also
-
--   <span class="package-name">[`@stdlib/math/base/special/kernel-cosf`][@stdlib/math/base/special/kernel-cosf]</span><span class="delimiter">: </span><span class="description">compute the cosine of a single-precision floating-point number on \[-π/4, π/4].</span>
--   <span class="package-name">[`@stdlib/math/base/special/kernel-tanf`][@stdlib/math/base/special/kernel-tanf]</span><span class="delimiter">: </span><span class="description">compute the tangent of a single-precision floating-point number on \[-π/4, π/4].</span>
--   <span class="package-name">[`@stdlib/math/base/special/sinf`][@stdlib/math/base/special/sinf]</span><span class="delimiter">: </span><span class="description">compute the sine of a number.</span>
--   <span class="package-name">[`@stdlib/math/base/special/kernel-sin`][@stdlib/math/base/special/kernel-sin]</span><span class="delimiter">: </span><span class="description">compute the sine of a double-precision floating-point number on \[-π/4, π/4].</span>
-
 </section>
 
 <!-- /.related -->
@@ -220,20 +175,8 @@ int main( void ) {
 
 [sine]: https://en.wikipedia.org/wiki/Sine
 
-[single-arithmetic]: https://en.wikipedia.org/wiki/Single-precision_floating-point_format
-
-[ieee754]: https://en.wikipedia.org/wiki/IEEE_floating_point
-
-[ulp]: https://en.wikipedia.org/wiki/Unit_in_the_last_place
-
 <!-- <related-links> -->
 
-[@stdlib/math/base/special/kernel-cos]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/math/base/special/kernel-cos
-
-[@stdlib/math/base/special/kernel-tan]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/math/base/special/kernel-tan
-
-[@stdlib/math/base/special/sin]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/math/base/special/sin
-
 <!-- </related-links> -->
 
 </section>

lib/node_modules/@stdlib/math/base/special/kernel-sinf/benchmark/benchmark.js

@@ -21,9 +21,9 @@
 // MODULES //
 
 var bench = require( '@stdlib/bench' );
-var randu = require( '@stdlib/random/base/randu' );
+var uniform = require( '@stdlib/random/array/uniform' );
 var isnanf = require( '@stdlib/math/base/assert/is-nanf' );
-var PI = require( '@stdlib/constants/float32/pi' );
+var PI = require( '@stdlib/constants/float64/pi' );
 var pkg = require( './../package.json' ).name;
 var kernelSinf = require( './../lib' );
 
@@ -35,10 +35,11 @@ bench( pkg, function benchmark( b ) {
 	var y;
 	var i;
 
+	x = uniform( 100, -PI/4.0, PI/4.0 );
+
 	b.tic();
 	for ( i = 0; i < b.iterations; i++ ) {
-		x = ( randu() * PI/2.0 ) - ( PI/4.0 );
-		y = kernelSinf( x, 0.0 );
+		y = kernelSinf( x[ i%x.length ] );
 		if ( isnanf( y ) ) {
 			b.fail( 'should not return NaN' );
 		}

lib/node_modules/@stdlib/math/base/special/kernel-sinf/benchmark/benchmark.native.js

@@ -22,18 +22,18 @@
 
 var resolve = require( 'path' ).resolve;
 var bench = require( '@stdlib/bench' );
-var randu = require( '@stdlib/random/base/randu' );
+var uniform = require( '@stdlib/random/array/uniform' );
 var isnanf = require( '@stdlib/math/base/assert/is-nanf' );
-var PI = require( '@stdlib/constants/float32/pi' );
+var PI = require( '@stdlib/constants/float64/pi' );
 var tryRequire = require( '@stdlib/utils/try-require' );
 var pkg = require( './../package.json' ).name;
 
 
 // VARIABLES //
 
-var kernelSin = tryRequire( resolve( __dirname, './../lib/native.js' ) );
+var kernelSinf = tryRequire( resolve( __dirname, './../lib/native.js' ) );
 var opts = {
-	'skip': ( kernelSin instanceof Error )
+	'skip': ( kernelSinf instanceof Error )
 };
 
 
@@ -44,10 +44,11 @@ bench( pkg+'::native', opts, function benchmark( b ) {
 	var y;
 	var i;
 
+	x = uniform( 100, -PI/4.0, PI/4.0 );
+
 	b.tic();
 	for ( i = 0; i < b.iterations; i++ ) {
-		x = ( randu() * PI/2.0 ) - ( PI/4.0 );
-		y = kernelSin( x, 0.0 );
+		y = kernelSinf( x[ i%x.length ] );
 		if ( isnanf( y ) ) {
 			b.fail( 'should not return NaN' );
 		}

lib/node_modules/@stdlib/math/base/special/kernel-sinf/benchmark/c/native/Makefile

@@ -88,15 +88,15 @@ c_targets := benchmark.out
 # RULES #
 
 #/
-# Compiles source files.
+# Compiles C source files.
 #
-# @param {string} [C_COMPILER] - C compiler (e.g., `gcc`)
-# @param {string} [CFLAGS] - C compiler options
-# @param {(string|void)} [fPIC] - compiler flag determining whether to generate position independent code (e.g., `-fPIC`)
-# @param {string} [INCLUDE] - list of includes (e.g., `-I /foo/bar -I /beep/boop/include`)
-# @param {string} [SOURCE_FILES] - list of source files
+# @param {string} SOURCE_FILES - list of C source files
+# @param {string} [INCLUDE] - list of includes (e.g., `-I /foo/bar -I /beep/boop`)
+# @param {string} [LIBRARIES] - list of libraries (e.g., `-lpthread -lblas`)
 # @param {string} [LIBPATH] - list of library paths (e.g., `-L /foo/bar -L /beep/boop`)
-# @param {string} [LIBRARIES] - list of libraries (e.g., `-lopenblas -lpthread`)
+# @param {string} [C_COMPILER] - C compiler
+# @param {string} [CFLAGS] - C compiler flags
+# @param {(string|void)} [fPIC] - compiler flag indicating whether to generate position independent code
 #
 # @example
 # make
@@ -112,13 +112,13 @@ all: $(c_targets)
 # Compiles C source files.
 #
 # @private
-# @param {string} CC - C compiler (e.g., `gcc`)
-# @param {string} CFLAGS - C compiler options
-# @param {(string|void)} fPIC - compiler flag determining whether to generate position independent code (e.g., `-fPIC`)
-# @param {string} INCLUDE - list of includes (e.g., `-I /foo/bar`)
-# @param {string} SOURCE_FILES - list of source files
-# @param {string} LIBPATH - list of library paths (e.g., `-L /foo/bar`)
-# @param {string} LIBRARIES - list of libraries (e.g., `-lopenblas`)
+# @param {string} SOURCE_FILES - list of C source files
+# @param {(string|void)} INCLUDE - list of includes (e.g., `-I /foo/bar -I /beep/boop`)
+# @param {(string|void)} LIBRARIES - list of libraries (e.g., `-lpthread -lblas`)
+# @param {(string|void)} LIBPATH - list of library paths (e.g., `-L /foo/bar -L /beep/boop`)
+# @param {string} CC - C compiler
+# @param {string} CFLAGS - C compiler flags
+# @param {(string|void)} fPIC - compiler flag indicating whether to generate position independent code
 #/
 $(c_targets): %.out: %.c
 	$(QUIET) $(CC) $(CFLAGS) $(fPIC) $(INCLUDE) -o $@ $(SOURCE_FILES) $< $(LIBPATH) -lm $(LIBRARIES)

lib/node_modules/@stdlib/math/base/special/kernel-sinf/benchmark/c/native/benchmark.c

@@ -23,7 +23,7 @@
 #include <time.h>
 #include <sys/time.h>
 
-#define NAME "kernel_sin"
+#define NAME "kernel_sinf"
 #define ITERATIONS 1000000
 #define REPEATS 3
 
@@ -91,15 +91,18 @@ static double rand_double( void ) {
 */
 static double benchmark( void ) {
 	double elapsed;
-	double x;
-	double z;
+	double x[ 100 ];
 	double t;
+	float z;
 	int i;
 
+	for ( i = 0; i < 100; i++ ) {
+		x[ i ] = ( ( rand_double()*2.0 ) - 1.0 ) * 0.7853981633974483;
+	}
+
 	t = tic();
 	for ( i = 0; i < ITERATIONS; i++ ) {
-		x = ( ( rand_double() * 2.0 ) - 1.0 ) * 0.7853981633974483;
-		z = stdlib_base_kernel_sinf( x, 0.0 );
+		z = stdlib_base_kernel_sinf( x[ i%100 ] );
 		if ( z != z ) {
 			printf( "should not return NaN\n" );
 			break;