From 1e3f0da519c60253cd810d87c51600c6f02daad9 Mon Sep 17 00:00:00 2001 From: stdlib-bot <82920195+stdlib-bot@users.noreply.github.com> Date: Tue, 26 Mar 2024 02:01:23 +0000 Subject: [PATCH] Update artifacts --- math/base/special/atan2/coverage.ndjson | 1 + math/base/special/atan2/index.html | 146 ++++++ math/base/special/atan2/index.js.html | 268 +++++++++++ math/base/special/atan2/main.js.html | 604 ++++++++++++++++++++++++ math/base/special/atan2/native.js.html | 253 ++++++++++ 5 files changed, 1272 insertions(+) create mode 100644 math/base/special/atan2/coverage.ndjson create mode 100644 math/base/special/atan2/index.html create mode 100644 math/base/special/atan2/index.js.html create mode 100644 math/base/special/atan2/main.js.html create mode 100644 math/base/special/atan2/native.js.html diff --git a/math/base/special/atan2/coverage.ndjson b/math/base/special/atan2/coverage.ndjson new file mode 100644 index 000000000..2a942e5ec --- /dev/null +++ b/math/base/special/atan2/coverage.ndjson @@ -0,0 +1 @@ +[290,290,100,27,27,100,2,2,100,290,290,100,"1cf574bb29355855c8d86594c0133b4812ac78b3","2024-03-25 21:59:22 -0400"] diff --git a/math/base/special/atan2/index.html b/math/base/special/atan2/index.html new file mode 100644 index 000000000..e3d6f2e92 --- /dev/null +++ b/math/base/special/atan2/index.html @@ -0,0 +1,146 @@ + + + + +
++ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +File | ++ | Statements | ++ | Branches | ++ | Functions | ++ | Lines | ++ |
---|---|---|---|---|---|---|---|---|---|
index.js | +
+
+ |
+ 100% | +61/61 | +100% | +1/1 | +100% | +0/0 | +100% | +61/61 | +
main.js | +
+
+ |
+ 100% | +173/173 | +100% | +24/24 | +100% | +1/1 | +100% | +173/173 | +
native.js | +
+
+ |
+ 100% | +56/56 | +100% | +2/2 | +100% | +1/1 | +100% | +56/56 | +
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 +27 +28 +29 +30 +31 +32 +33 +34 +35 +36 +37 +38 +39 +40 +41 +42 +43 +44 +45 +46 +47 +48 +49 +50 +51 +52 +53 +54 +55 +56 +57 +58 +59 +60 +61 +62 | 1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x + | /** +* @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/atan2 +* +* @example +* var atan2 = require( '@stdlib/math/base/special/atan2' ); +* +* var v = atan2( 2.0, 2.0 ); // => atan(1.0) +* // returns ~0.785 +* +* v = atan2( 6.0, 2.0 ); // => atan(3.0) +* // returns ~1.249 +* +* v = atan2( -1.0, -1.0 ); // => atan(1.0) - π +* // returns ~-2.356 +* +* v = atan2( 3.0, 0.0 ); // => π/2 +* // returns ~1.571 +* +* v = atan2( -2.0, 0.0 ); // => -π/2 +* // returns ~-1.571 +* +* v = atan2( 0.0, 0.0 ); +* // returns 0.0 +* +* v = atan2( 3.0, NaN ); +* // returns NaN +* +* v = atan2( NaN, 2.0 ); +* // returns NaN +*/ + +// MODULES // + +var atan2 = require( './main.js' ); + + +// EXPORTS // + +module.exports = atan2; + |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 +27 +28 +29 +30 +31 +32 +33 +34 +35 +36 +37 +38 +39 +40 +41 +42 +43 +44 +45 +46 +47 +48 +49 +50 +51 +52 +53 +54 +55 +56 +57 +58 +59 +60 +61 +62 +63 +64 +65 +66 +67 +68 +69 +70 +71 +72 +73 +74 +75 +76 +77 +78 +79 +80 +81 +82 +83 +84 +85 +86 +87 +88 +89 +90 +91 +92 +93 +94 +95 +96 +97 +98 +99 +100 +101 +102 +103 +104 +105 +106 +107 +108 +109 +110 +111 +112 +113 +114 +115 +116 +117 +118 +119 +120 +121 +122 +123 +124 +125 +126 +127 +128 +129 +130 +131 +132 +133 +134 +135 +136 +137 +138 +139 +140 +141 +142 +143 +144 +145 +146 +147 +148 +149 +150 +151 +152 +153 +154 +155 +156 +157 +158 +159 +160 +161 +162 +163 +164 +165 +166 +167 +168 +169 +170 +171 +172 +173 +174 | 1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +7050x +7050x +7050x +2x +2x +7050x +13x +5x +2x +2x +3x +3x +8x +13x +2x +2x +6x +6x +7050x +6x +6x +7050x +20x +10x +10x +10x +10x +7050x +6x +6x +7003x +7050x +2002x +1001x +1001x +1001x +1001x +5001x +7050x +1x +1x +1x +1x +1x + | /** +* @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. +* +* +* ## Notice +* +* The original code, copyright and license are from [Go]{@link https://golang.org/src/math/atan2.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 without +* 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 isnan = require( '@stdlib/math/base/assert/is-nan' ); +var atan = require( '@stdlib/math/base/special/atan' ); +var PINF = require( '@stdlib/constants/float64/pinf' ); +var PI = require( '@stdlib/constants/float64/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)`. +* +* ## Special Cases +* +* ```tex +* \begin{align*} +* \operatorname{atan2}(y,\mathrm{NaN}) &= \mathrm{NaN}\\ +* \operatorname{atan2}(\mathrm{NaN},x) &= \mathrm{NaN}\\ +* \operatorname{atan2}( +0,x \ge 0 ) &= +0 \\ +* \operatorname{atan2}( -0, x \ge 0 ) &= -0 \\ +* \operatorname{atan2}( +0,x \le -0 ) &= +\Pi \\ +* \operatorname{atan2}( -0, x \le -0 ) &= -\Pi \\ +* \operatorname{atan2}(+\infty, +\infty) &= +\tfrac{\Pi}{4} \\ +* \operatorname{atan2}(-\infty, +\infty) &= -\tfrac{\Pi}{4} \\ +* \operatorname{atan2}(+\infty, -\infty) &= +\tfrac{3\Pi}{4} \\ +* \operatorname{atan2}(-\infty, -\infty) &= -\tfrac{3\Pi}{4} \\ +* \operatorname{atan2}(y, +\infty) &= 0.0 \\ +* \operatorname{atan2}(y>0, -\infty) &= +\Pi \\ +* \operatorname{atan2}(y<0, -\infty) &= -\Pi \\ +* \operatorname{atan2}(+\infty, x ) &= +\tfrac{\Pi}{2} \\ +* \operatorname{atan2}(-\infty, x ) &= -\tfrac{\Pi}{2} \\ +* \end{align*} +* ``` +* +* @param {number} y - `y` coordinate +* @param {number} x - `x` coordinate +* @returns {number} angle (in radians) +* +* @example +* var v = atan2( 2.0, 2.0 ); // => atan(1.0) +* // returns ~0.785 +* +* @example +* var v = atan2( 6.0, 2.0 ); // => atan(3.0) +* // returns ~1.249 +* +* @example +* var v = atan2( -1.0, -1.0 ); // => atan(1.0) - π +* // returns ~-2.356 +* +* @example +* var v = atan2( 3.0, 0.0 ); // => π/2 +* // returns ~1.571 +* +* @example +* var v = atan2( -2.0, 0.0 ); // => -π/2 +* // returns ~-1.571 +* +* @example +* var v = atan2( 0.0, 0.0 ); +* // returns 0.0 +* +* @example +* var v = atan2( 3.0, NaN ); +* // returns NaN +* +* @example +* var v = atan2( NaN, 2.0 ); +* // returns NaN +*/ +function atan2( y, x ) { + var q; + if ( isnan( x ) || isnan( y ) ) { + return NaN; + } + if ( isinfinite( x ) ) { + if ( x === PINF ) { + if ( isinfinite( y ) ) { + return copysign( PI / 4.0, y ); + } + return copysign( 0.0, y ); + } + // Case: x is -Infinity + if ( isinfinite( y ) ) { + return copysign( 3.0*PI/4.0, y ); + } + return copysign( PI, y ); + } + if ( isinfinite( y ) ) { + return copysign( PI / 2.0, 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( PI / 2.0, y ); + } + q = atan( y / x ); + if ( x < 0.0 ) { + if ( q <= 0.0 ) { + return q + PI; + } + return q - PI; + } + return q; +} + + +// EXPORTS // + +module.exports = atan2; + |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 +27 +28 +29 +30 +31 +32 +33 +34 +35 +36 +37 +38 +39 +40 +41 +42 +43 +44 +45 +46 +47 +48 +49 +50 +51 +52 +53 +54 +55 +56 +57 | 1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +7050x +7050x +7050x +1x +1x +1x +1x +1x + | /** +* @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'; + +// MODULES // + +var addon = require( './../src/addon.node' ); + +/** +* Computes the angle in the plane (in radians) between the positive x-axis and the ray from `(0,0)` to the point `(x,y)`. +* +* @private +* @param {number} y - `y` coordinate +* @param {number} x - `x` coordinate +* @returns {number} angle (in radians) +* +* @example +* var v = atan2( 2.0, 2.0 ); // => atan(1.0) +* // returns ~0.785 +* +* @example +* v = atan2( 6.0, 2.0 ); // => atan(3.0) +* // returns ~1.249 +* +* @example +* v = atan2( 3.0, 0.0 ); // => π/2 +* // returns ~1.571 +* +* @example +* v = atan2( 3.0, NaN ); +* // returns NaN +*/ +function atan2( y, x ) { + return addon( y, x ); +} + + +// EXPORTS // + +module.exports = atan2; + |