feat: add support for accessor arrays and refactor stats/base/stdevyc

Author: Hecker165

lib/node_modules/@stdlib/stats/base/stdevyc/docs/types/index.d.ts

@@ -21,11 +21,11 @@
 /// <reference types="@stdlib/types"/>
 
 import { NumericArray, Collection, AccessorArrayLike } from '@stdlib/types/array';
- 
- /**
- * Input array.
- */
- type InputArray = NumericArray | Collection<number> | AccessorArrayLike<number>;
+
+/**
+* Input array.
+*/
+type InputArray = NumericArray | Collection<number> | AccessorArrayLike<number>;
 /**
 * Interface describing `stdevyc`.
 */

lib/node_modules/@stdlib/stats/base/stdevyc/lib/accessors.js

@@ -23,6 +23,7 @@
 var isnan = require( '@stdlib/math/base/assert/is-nan' );
 var sqrt = require( '@stdlib/math/base/special/sqrt' );
 
+
 // MAIN //
 
 /**
@@ -43,16 +44,16 @@ var sqrt = require( '@stdlib/math/base/special/sqrt' );
 *
 * var x = toAccessorArray( [ 2.0, 1.0, 2.0, -2.0, -2.0, 2.0, 3.0, 4.0 ] );
 *
-* var v = stdevyc( 4, arraylike2object( x ), 2, 1 );
+* var v = stdevyc( 4, 1, arraylike2object( x ), 2, 1 );
 * // returns <computed standard deviation>
 */
-function stdevyc( N, x, strideX, offsetX ) {
+function stdevyc( N, correction, x, strideX, offsetX ) {
+    var delta;
+    var count;
     var xbuf;
-    var get;
     var mean;
+    var get;
     var M2;
-    var delta;
-    var count;
     var ix;
     var v;
     var i;
@@ -63,7 +64,7 @@ function stdevyc( N, x, strideX, offsetX ) {
     // Cache a reference to the element accessor:
     get = x.accessors[ 0 ];
 
-    if ( N < 2 ) {
+    if ( N <= correction ) {  // Prevent division by zero
         return NaN;
     }
 
@@ -85,9 +86,10 @@ function stdevyc( N, x, strideX, offsetX ) {
         ix += strideX;
     }
 
-    return sqrt( M2 / ( count - 1 ) );
+    return sqrt( M2 / ( count - correction ) );
 }
 
+
 // EXPORTS //
 
 module.exports = stdevyc;