feat: lib added

Author: Neerajpathak07

lib/node_modules/@stdlib/math/base/special/atan2f/lib/index.js

@@ -0,0 +1,61 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2018 The Stdlib Authors.
+*
+* 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
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+'use strict';
+
+/**
+* Compute the angle in the plane (in radians) between the positive x-axis and the ray from `(0,0)` to the point `(x,y)`.
+*
+* @module @stdlib/math/base/special/atan2f
+*
+* @example
+* var atan2 = require( '@stdlib/math/base/special/atan2f' );
+*
+* var v = atan2f( 2.0, 2.0 ); // => atanf(1.0)
+* // returns ~0.785
+*
+* v = atan2f( 6.0, 2.0 ); // => atanf(3.0)
+* // returns ~1.249
+*
+* v = atan2f( -1.0, -1.0 ); // => atanf(1.0) - π
+* // returns ~-2.356
+*
+* v = atan2f( 3.0, 0.0 ); // => π/2
+* // returns ~1.571
+*
+* v = atan2f( -2.0, 0.0 ); // => -π/2
+* // returns ~-1.571
+*
+* v = atan2f( 0.0, 0.0 );
+* // returns 0.0
+*
+* v = atan2f( 3.0, NaN );
+* // returns NaN
+*
+* v = atan2f( NaN, 2.0 );
+* // returns NaN
+*/
+
+// MODULES //
+
+var atan2f = require( './main.js' );
+
+
+// EXPORTS //
+
+module.exports = atan2f;

lib/node_modules/@stdlib/math/base/special/atan2f/lib/main.js

@@ -0,0 +1,156 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2024 The Stdlib Authors.
+*
+* 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
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*
+*
+* ## Notice
+*
+* The original code, copyright and license are from [Go]{@link https://golang.org/src/math/atan2f.go}. The implementation follows the original, but has been modified for JavaScript.
+*
+* ```text
+* Copyright (c) 2009 The Go Authors. All rights reserved.
+*
+* Redistribution and use in source and binary forms, with or withoutf
+* modification, are permitted provided that the following conditions are
+* met:
+*
+*    * Redistributions of source code must retain the above copyright
+* notice, this list of conditions and the following disclaimer.
+*    * Redistributions in binary form must reproduce the above
+* copyright notice, this list of conditions and the following disclaimer
+* in the documentation and/or other materials provided with the
+* distribution.
+*    * Neither the name of Google Inc. nor the names of its
+* contributors may be used to endorse or promote products derived from
+* this software without specific prior written permission.
+*
+* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+* A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+* OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+* ```
+*/
+
+'use strict';
+
+// MODULES //
+
+var isinfinite = require( '@stdlib/math/base/assert/is-infinite' );
+var copysign = require( '@stdlib/math/base/special/copysign' );
+var signbit = require( '@stdlib/number/float64/base/signbit' );
+var float64ToFloat32 = require( '@stdlib/number/float64/base/to-float32' );
+var isnanf = require( '@stdlib/math/base/assert/is-nanf' );
+var atan2 = require( '@stdlib/math/base/special/atan2' );
+var PINF = require( '@stdlib/constants/float64/pinf' );
+var PI = require( '@stdlib/constants/float64/pi' );
+var PI02F = require( '@stdlib/constants/float32/half-pi' );
+var PI04F = require( '@stdlib/constants/float32/fourth-pi' );
+
+
+// MAIN //
+
+/**
+* Computes the angle in the plane (in radians) between the positive x-axis and the ray from `(0,0)` to the point `(x,y)`.
+*
+* @param {number} y - `y` coordinate
+* @param {number} x - `x` coordinate
+* @returns {number} angle (in radians)
+*
+* @example
+* var v = atan2f( 2.0, 2.0 ); // => atanf(1.0)
+* // returns ~0.785
+*
+* @example
+* var v = atan2f( 6.0, 2.0 ); // => atanf(3.0)
+* // returns ~1.249
+*
+* @example
+* var v = atan2f( -1.0, -1.0 ); // => atanf(1.0) - π
+* // returns ~-2.356
+*
+* @example
+* var v = atan2f( 3.0, 0.0 ); // => π/2
+* // returns ~1.571
+*
+* @example
+* var v = atan2f( -2.0, 0.0 ); // => -π/2
+* // returns ~-1.571
+*
+* @example
+* var v = atan2f( 0.0, 0.0 );
+* // returns 0.0
+*
+* @example
+* var v = atan2f( 3.0, NaN );
+* // returns NaN
+*
+* @example
+* var v = atan2f( NaN, 2.0 );
+* // returns NaN
+*/
+function atan2f( y, x ) {
+	var q;
+	if ( isnanf( x ) || isnanf( y ) ) {
+		return NaN;
+	}
+	x = float64ToFloat32( x );
+	if ( isinfinite( x ) ) {
+		if ( x === PINF ) {
+			y = float64ToFloat32( y );
+			if ( isinfinite( y ) ) {
+				return copysign( PI04F, y );
+			}
+			return copysign( 0.0, y );
+		}
+		// Case: x is -Infinity
+		if ( isinfinite( y ) ) {
+			return copysign( 3.0*PI04F, y );
+		}
+		return copysign( PI, y );
+	}
+	if ( isinfinite( y ) ) {
+		return copysign( PI02F, y );
+	}
+	if ( y === 0.0 ) {
+		if ( x >= 0.0 && !signbit( x ) ) {
+			return copysign( 0.0, y );
+		}
+		return copysign( PI, y );
+	}
+	if ( x === 0.0 ) {
+		return copysign( PI02F, y );
+	}
+	q = atan2( y / x );
+	if ( x < 0.0 ) {
+		if ( q <= 0.0 ) {
+			return q + PI;
+		}
+		return q - PI;
+	}
+	return q;
+}
+
+
+// EXPORTS //
+
+module.exports = atan2f;

lib/node_modules/@stdlib/math/base/special/atan2f/lib/native.js

@@ -0,0 +1,61 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2024 The Stdlib Authors.
+*
+* 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
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+'use strict';
+
+/**
+* Compute the angle in the plane (in radians) between the positive x-axis and the ray from `(0,0)` to the point `(x,y)`.
+*
+* @module @stdlib/math/base/special/atan2f
+*
+* @example
+* var atan2 = require( '@stdlib/math/base/special/atan2f' );
+*
+* var v = atan2f( 2.0, 2.0 ); // => atanf(1.0)
+* // returns ~0.785
+*
+* v = atan2f( 6.0, 2.0 ); // => atanf(3.0)
+* // returns ~1.249
+*
+* v = atan2f( -1.0, -1.0 ); // => atanf(1.0) - π
+* // returns ~-2.356
+*
+* v = atan2f( 3.0, 0.0 ); // => π/2
+* // returns ~1.571
+*
+* v = atan2f( -2.0, 0.0 ); // => -π/2
+* // returns ~-1.571
+*
+* v = atan2f( 0.0, 0.0 );
+* // returns 0.0
+*
+* v = atan2f( 3.0, NaN );
+* // returns NaN
+*
+* v = atan2f( NaN, 2.0 );
+* // returns NaN
+*/
+
+// MODULES //
+
+var atan2f = require( './main.js' );
+
+
+// EXPORTS //
+
+module.exports = atan2f;