feat: add C implementation for stats/base/dists/f/pdf

lib/node_modules/@stdlib/array/base/falses/docs/types/test.ts

@@ -29,9 +29,9 @@ import falses = require( './index' );
 // The compiler throws an error if the function is provided an argument which is not a number...
 {
 	falses( 'abc' ); // $ExpectError
-	falses( true ); // $ExpectError
 	falses( false ); // $ExpectError
-	falses( null ); // $ExpectError
+	falses( false ); // $ExpectError
+	falses( false ); // $ExpectError
 	falses( [] ); // $ExpectError
 	falses( {} ); // $ExpectError
 	falses( ( x: number ): number => x ); // $ExpectError

lib/node_modules/@stdlib/array/base/trues/docs/types/test.ts

@@ -31,7 +31,7 @@ import trues = require( './index' );
 	trues( 'abc' ); // $ExpectError
 	trues( true ); // $ExpectError
 	trues( false ); // $ExpectError
-	trues( null ); // $ExpectError
+	trues( true ); // $ExpectError
 	trues( [] ); // $ExpectError
 	trues( {} ); // $ExpectError
 	trues( ( x: number ): number => x ); // $ExpectError

lib/node_modules/@stdlib/array/nulls/benchmark/benchmark.js

@@ -41,7 +41,7 @@ bench( pkg, function benchmark( b ) {
 	}
 	b.toc();
 	if ( !isCollection( arr ) ) {
-		b.fail( 'should return an array' );
+		b.fail( 'should return a typed array' );
 	}
 	b.pass( 'benchmark finished' );
 	b.end();

lib/node_modules/@stdlib/assert/has-dataview-support/test/test.js

@@ -71,9 +71,9 @@ tape( 'if `DataView` is supported, detection result is `true`', function test( t
 		}
 		out = {};
 		out.buffer = buf;
-		out._buffer = []; // eslint-disable-line no-underscore-dangle
+		out._buffer = new Array( byteLength ); // eslint-disable-line no-underscore-dangle
 		for ( i = 0; i < byteLength; i++ ) {
-			out._buffer.push( 0 ); // eslint-disable-line no-underscore-dangle
+			out._buffer[ i ] = 0; // eslint-disable-line no-underscore-dangle
 		}
 		out.byteLength = byteLength;
 		out.byteOffset = byteOffset;

lib/node_modules/@stdlib/blas/base/dgemm/README.md

@@ -55,12 +55,12 @@ The function has the following parameters:
 -   **K**: number of columns in the matrix `op(A)` and number of rows in the matrix `op(B)`.
 -   **α**: scalar constant.
 -   **A**: first input matrix stored in linear memory as a [`Float64Array`][mdn-float64array].
--   **lda**: stride between successive contiguous vectors of the matrix `A` (a.k.a., leading dimension of `A`).
+-   **lda**: stride of the first dimension of `A` (leading dimension of `A`).
 -   **B**: second input matrix stored in linear memory as a [`Float64Array`][mdn-float64array].
--   **ldb**: stride between successive contiguous vectors of the matrix `B` (a.k.a., leading dimension of `B`).
+-   **ldb**: stride of the first dimension of `B` (leading dimension of `B`).
 -   **β**: scalar constant.
 -   **C**: third input matrix stored in linear memory as a [`Float64Array`][mdn-float64array].
--   **ldc**: stride between successive contiguous vectors of the matrix `C` (a.k.a., leading dimension of `C`).
+-   **ldc**: stride of the first dimension of `C` (leading dimension of `C`).
 
 The stride parameters determine how elements in the input arrays are accessed at runtime. For example, to perform matrix multiplication of two subarrays
 

lib/node_modules/@stdlib/blas/base/dgemm/docs/repl.txt

@@ -43,15 +43,15 @@
         First matrix.
 
     lda: integer
-        Stride between successive contiguous vectors of the matrix `A` (a.k.a.,
-        leading dimension of the matrix `A`).
+        Stride of the first dimension of `A` (a.k.a., leading dimension of the
+        matrix `A`).
 
     B: Float64Array
         Second matrix.
 
     ldb: integer
-        Stride between successive contiguous vectors of the matrix `B` (a.k.a.,
-        leading dimension of the matrix `B`).
+        Stride of the first dimension of `B` (a.k.a., leading dimension of the
+        matrix `B`).
 
     β: number
         Scalar constant.
@@ -60,8 +60,8 @@
         Third matrix.
 
     ldc: integer
-        Stride between successive contiguous vectors of the matrix `C` (a.k.a.,
-        leading dimension of the matrix `C`).
+        Stride of the first dimension of `C` (a.k.a., leading dimension of the
+        matrix `C`).
 
     Returns
     -------

lib/node_modules/@stdlib/blas/base/dgemm/docs/types/index.d.ts

@@ -37,12 +37,12 @@ interface Routine {
 	* @param K - number of columns in the matrix `op(A)` and number of rows in the matrix `op(B)`
 	* @param alpha - scalar constant
 	* @param A - first matrix
-	* @param LDA - stride between successive contiguous vectors of the matrix `A` (a.k.a., leading dimension of the matrix `A`)
+	* @param LDA - stride of the first dimension of `A` (a.k.a., leading dimension of the matrix `A`)
 	* @param B - second matrix
-	* @param LDB - stride between successive contiguous vectors of the matrix `B` (a.k.a., leading dimension of the matrix `B`)
+	* @param LDB - stride of the first dimension of `B` (a.k.a., leading dimension of the matrix `B`)
 	* @param beta - scalar constant
 	* @param C - third matrix
-	* @param LDC - stride between successive contiguous vectors of the matrix `C` (a.k.a., leading dimension of the matrix `C`)
+	* @param LDC - stride of the first dimension of `C` (a.k.a., leading dimension of the matrix `C`)
 	* @returns `C`
 	*
 	* @example

lib/node_modules/@stdlib/blas/base/dgemm/lib/dgemm.js

@@ -42,12 +42,12 @@ var base = require( './base.js' );
 * @param {NonNegativeInteger} K - number of columns in the matrix `op(A)` and number of rows in the matrix `op(B)`
 * @param {number} alpha - scalar constant
 * @param {Float64Array} A - first matrix
-* @param {PositiveInteger} LDA - stride between successive contiguous vectors of the matrix `A` (a.k.a., leading dimension of the matrix `A`)
+* @param {PositiveInteger} LDA - stride of the first dimension of `A` (a.k.a., leading dimension of the matrix `A`)
 * @param {Float64Array} B - second matrix
-* @param {PositiveInteger} LDB - stride between successive contiguous vectors of the matrix `B` (a.k.a., leading dimension of the matrix `B`)
+* @param {PositiveInteger} LDB - stride of the first dimension of `B` (a.k.a., leading dimension of the matrix `B`)
 * @param {number} beta - scalar constant
 * @param {Float64Array} C - third matrix
-* @param {PositiveInteger} LDC - stride between successive contiguous vectors of the matrix `C` (a.k.a., leading dimension of the matrix `C`)
+* @param {PositiveInteger} LDC - stride of the first dimension of `C` (a.k.a., leading dimension of the matrix `C`)
 * @throws {TypeError} first argument must be a valid order
 * @throws {TypeError} second argument must be a valid transpose operation
 * @throws {TypeError} third argument must be a valid transpose operation

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

@@ -83,7 +83,6 @@ import matrixTriangleResolveEnum = require( '@stdlib/blas/base/matrix-triangle-r
 import matrixTriangleResolveStr = require( '@stdlib/blas/base/matrix-triangle-resolve-str' );
 import matrixTriangleStr2Enum = require( '@stdlib/blas/base/matrix-triangle-str2enum' );
 import matrixTriangles = require( '@stdlib/blas/base/matrix-triangles' );
-import ndarray = require( '@stdlib/blas/base/ndarray' );
 import operationSideEnum2Str = require( '@stdlib/blas/base/operation-side-enum2str' );
 import operationSideResolveEnum = require( '@stdlib/blas/base/operation-side-resolve-enum' );
 import operationSideResolveStr = require( '@stdlib/blas/base/operation-side-resolve-str' );
@@ -1706,11 +1705,6 @@ interface Namespace {
 	*/
 	matrixTriangles: typeof matrixTriangles;
 
-	/**
-	* Base ndarray BLAS functions.
-	*/
-	ndarray: typeof ndarray;
-
 	/**
 	* Returns the BLAS operation side string associated with a BLAS operation side enumeration constant.
 	*

lib/node_modules/@stdlib/blas/base/ndarray/README.md

@@ -47,7 +47,6 @@ The namespace exposes the following APIs:
 
 -   <span class="signature">[`dasum( arrays )`][@stdlib/blas/base/ndarray/dasum]</span><span class="delimiter">: </span><span class="description">calculate the sum of absolute values for all elements in a one-dimensional double-precision floating-point ndarray.</span>
 -   <span class="signature">[`ddot( arrays )`][@stdlib/blas/base/ndarray/ddot]</span><span class="delimiter">: </span><span class="description">calculate the dot product of two one-dimensional double-precision floating-point ndarrays.</span>
--   <span class="signature">[`gasum( arrays )`][@stdlib/blas/base/ndarray/gasum]</span><span class="delimiter">: </span><span class="description">calculate the sum of absolute values for all elements in a one-dimensional ndarray.</span>
 -   <span class="signature">[`gdot( arrays )`][@stdlib/blas/base/ndarray/gdot]</span><span class="delimiter">: </span><span class="description">calculate the dot product of two one-dimensional ndarrays.</span>
 -   <span class="signature">[`sasum( arrays )`][@stdlib/blas/base/ndarray/sasum]</span><span class="delimiter">: </span><span class="description">calculate the sum of absolute values for all elements in a one-dimensional single-precision floating-point ndarray.</span>
 -   <span class="signature">[`sdot( arrays )`][@stdlib/blas/base/ndarray/sdot]</span><span class="delimiter">: </span><span class="description">calculate the dot product of two one-dimensional single-precision floating-point ndarrays.</span>
@@ -97,8 +96,6 @@ console.log( objectKeys( ns ) );
 
 [@stdlib/blas/base/ndarray/ddot]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/blas/base/ndarray/ddot
 
-[@stdlib/blas/base/ndarray/gasum]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/blas/base/ndarray/gasum
-
 [@stdlib/blas/base/ndarray/gdot]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/blas/base/ndarray/gdot
 
 [@stdlib/blas/base/ndarray/sasum]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/blas/base/ndarray/sasum

lib/node_modules/@stdlib/blas/base/ndarray/docs/types/index.d.ts

@@ -20,131 +20,16 @@
 
 /* eslint-disable max-lines */
 
-import dasum = require( '@stdlib/blas/base/ndarray/dasum' );
 import ddot = require( '@stdlib/blas/base/ndarray/ddot' );
-import gasum = require( '@stdlib/blas/base/ndarray/gasum' );
-import gdot = require( '@stdlib/blas/base/ndarray/gdot' );
-import sasum = require( '@stdlib/blas/base/ndarray/sasum' );
-import sdot = require( '@stdlib/blas/base/ndarray/sdot' );
 
 /**
 * Interface describing the `ndarray` namespace.
 */
 interface Namespace {
 	/**
-	* Computes the sum of absolute values for all elements in a one-dimensional double-precision floating-point ndarray.
-	*
-	* @param arrays - array-like object containing a one-dimensional input ndarray
-	* @returns sum
-	*
-	* @example
-	* var Float64Array = require( '@stdlib/array/float64' );
-	* var ndarray = require( '@stdlib/ndarray/base/ctor' );
-	*
-	* var xbuf = new Float64Array( [ 1.0, -2.0, 3.0, -4.0, 5.0 ] );
-	* var x = new ndarray( 'float64', xbuf, [ 5 ], [ 1 ], 0, 'row-major' );
-	*
-	* var y = ns.dasum( [ x ] );
-	* // returns 15.0
-	*/
-	dasum: typeof dasum;
-
-	/**
-	* Computes the dot product of two one-dimensional double-precision floating-point ndarrays.
-	*
-	* @param arrays - array-like object containing two one-dimensional input ndarrays
-	* @returns dot product
-	*
-	* @example
-	* var Float64Array = require( '@stdlib/array/float64' );
-	* var ndarray = require( '@stdlib/ndarray/base/ctor' );
-	*
-	* var xbuf = new Float64Array( [ 4.0, 2.0, -3.0, 5.0, -1.0 ] );
-	* var x = new ndarray( 'float64', xbuf, [ 5 ], [ 1 ], 0, 'row-major' );
-	*
-	* var ybuf = new Float64Array( [ 2.0, 6.0, -1.0, -4.0, 8.0 ] );
-	* var y = new ndarray( 'float64', ybuf, [ 5 ], [ 1 ], 0, 'row-major' );
-	*
-	* var z = ns.ddot( [ x, y ] );
-	* // returns -5.0
+	* TODO
 	*/
 	ddot: typeof ddot;
-
-	/**
-	* Computes the sum of absolute values for all elements in a one-dimensional ndarray.
-	*
-	* @param arrays - array-like object containing a one-dimensional input ndarray
-	* @returns sum
-	*
-	* @example
-	* var ndarray = require( '@stdlib/ndarray/base/ctor' );
-	*
-	* var xbuf = [ 1.0, -2.0, 3.0, -4.0, 5.0 ];
-	* var x = new ndarray( 'generic', xbuf, [ 5 ], [ 1 ], 0, 'row-major' );
-	*
-	* var y = ns.gasum( [ x ] );
-	* // returns 15.0
-	*/
-	gasum: typeof gasum;
-
-	/**
-	* Computes the dot product of two one-dimensional ndarrays.
-	*
-	* @param arrays - array-like object containing two one-dimensional input ndarrays
-	* @returns dot product
-	*
-	* @example
-	* var ndarray = require( '@stdlib/ndarray/base/ctor' );
-	*
-	* var xbuf = [ 4.0, 2.0, -3.0, 5.0, -1.0 ];
-	* var x = new ndarray( 'generic', xbuf, [ 5 ], [ 1 ], 0, 'row-major' );
-	*
-	* var ybuf = [ 2.0, 6.0, -1.0, -4.0, 8.0 ];
-	* var y = new ndarray( 'generic', ybuf, [ 5 ], [ 1 ], 0, 'row-major' );
-	*
-	* var z = ns.gdot( [ x, y ] );
-	* // returns -5.0
-	*/
-	gdot: typeof gdot;
-
-	/**
-	* Computes the sum of absolute values for all elements in a one-dimensional single-precision floating-point ndarray.
-	*
-	* @param arrays - array-like object containing a one-dimensional input ndarray
-	* @returns sum
-	*
-	* @example
-	* var Float32Array = require( '@stdlib/array/float32' );
-	* var ndarray = require( '@stdlib/ndarray/base/ctor' );
-	*
-	* var xbuf = new Float32Array( [ 1.0, -2.0, 3.0, -4.0, 5.0 ] );
-	* var x = new ndarray( 'float32', xbuf, [ 5 ], [ 1 ], 0, 'row-major' );
-	*
-	* var y = ns.sasum( [ x ] );
-	* // returns 15.0
-	*/
-	sasum: typeof sasum;
-
-	/**
-	* Computes the dot product of two one-dimensional single-precision floating-point ndarrays.
-	*
-	* @param arrays - array-like object containing two one-dimensional input ndarrays
-	* @returns dot product
-	*
-	* @example
-	* var Float32Array = require( '@stdlib/array/float32' );
-	* var ndarray = require( '@stdlib/ndarray/base/ctor' );
-	*
-	* var xbuf = new Float32Array( [ 4.0, 2.0, -3.0, 5.0, -1.0 ] );
-	* var x = new ndarray( 'float32', xbuf, [ 5 ], [ 1 ], 0, 'row-major' );
-	*
-	* var ybuf = new Float32Array( [ 2.0, 6.0, -1.0, -4.0, 8.0 ] );
-	* var y = new ndarray( 'float32', ybuf, [ 5 ], [ 1 ], 0, 'row-major' );
-	*
-	* var z = ns.sdot( [ x, y ] );
-	* // returns -5.0
-	*/
-	sdot: typeof sdot;
 }
 
 /**

lib/node_modules/@stdlib/blas/base/ndarray/gdot/docs/types/index.d.ts

@@ -20,7 +20,7 @@
 
 /// <reference types="@stdlib/types"/>
 
-import { typedndarray } from '@stdlib/types/ndarray';
+import { ndarray } from '@stdlib/types/ndarray';
 
 /**
 * Computes the dot product of two one-dimensional ndarrays.
@@ -40,7 +40,7 @@ import { typedndarray } from '@stdlib/types/ndarray';
 * var z = gdot( [ x, y ] );
 * // returns -5.0
 */
-declare function gdot<T extends typedndarray<number> = typedndarray<number>>( arrays: [ T, T ] ): number;
+declare function gdot<T extends ndarray = ndarray>( arrays: [ T, T ] ): number;
 
 
 // EXPORTS //

lib/node_modules/@stdlib/blas/base/ndarray/lib/index.js

@@ -16,7 +16,7 @@
 * limitations under the License.
 */
 
 'use strict';
 
 /*
 * When adding modules to the namespace, ensure that they are added in alphabetical order according to module name.
@@ -54,15 +54,6 @@
 */
 setReadOnly( ns, 'ddot', require( '@stdlib/blas/base/ndarray/ddot' ) );
 
-/**
-* @name gasum
-* @memberof ns
-* @readonly
-* @type {Function}
-* @see {@link module:@stdlib/blas/base/ndarray/gasum}
-*/
-setReadOnly( ns, 'gasum', require( '@stdlib/blas/base/ndarray/gasum' ) );
-
 /**
 * @name gdot
 * @memberof ns

lib/node_modules/@stdlib/blas/ext/README.md

@@ -46,12 +46,10 @@ The namespace contains the following:
 <div class="namespace-toc">
 
 -   <span class="signature">[`base`][@stdlib/blas/ext/base]</span><span class="delimiter">: </span><span class="description">base (i.e., lower-level) extensions to basic linear algebra subprograms (BLAS).</span>
--   <span class="signature">[`circshift( x, k[, options] )`][@stdlib/blas/ext/circshift]</span><span class="delimiter">: </span><span class="description">circularly shift the elements of an input ndarray by a specified number of positions along one or more ndarray dimensions.</span>
 -   <span class="signature">[`cusum( x[, initial][, options] )`][@stdlib/blas/ext/cusum]</span><span class="delimiter">: </span><span class="description">compute the cumulative sum along one or more ndarray dimensions.</span>
 -   <span class="signature">[`findIndex( x[, options], clbk[, thisArg] )`][@stdlib/blas/ext/find-index]</span><span class="delimiter">: </span><span class="description">return the index of the first element along an ndarray dimension which passes a test implemented by a predicate function.</span>
 -   <span class="signature">[`findLastIndex( x[, options], clbk[, thisArg] )`][@stdlib/blas/ext/find-last-index]</span><span class="delimiter">: </span><span class="description">return the index of the last element along an ndarray dimension which passes a test implemented by a predicate function.</span>
 -   <span class="signature">[`indexOf( x, searchElement[, fromIndex][, options] )`][@stdlib/blas/ext/index-of]</span><span class="delimiter">: </span><span class="description">return the first index of a specified search element along an ndarray dimension.</span>
--   <span class="signature">[`join( x[, options] )`][@stdlib/blas/ext/join]</span><span class="delimiter">: </span><span class="description">return an ndarray created by joining elements using a separator along one or more ndarray dimensions.</span>
 -   <span class="signature">[`lastIndexOf( x, searchElement[, fromIndex][, options] )`][@stdlib/blas/ext/last-index-of]</span><span class="delimiter">: </span><span class="description">return the last index of a specified search element along an ndarray dimension.</span>
 -   <span class="signature">[`linspace( shape, start, stop[, endpoint][, options] )`][@stdlib/blas/ext/linspace]</span><span class="delimiter">: </span><span class="description">return a new ndarray filled with linearly spaced values over a specified interval along one or more ndarray dimensions.</span>
 -   <span class="signature">[`sorthp( x[, sortOrder][, options] )`][@stdlib/blas/ext/sorthp]</span><span class="delimiter">: </span><span class="description">sort an input ndarray along one or more ndarray dimensions using heapsort.</span>
@@ -101,8 +99,6 @@ console.log( objectKeys( ns ) );
 
 [@stdlib/blas/ext/base]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/blas/ext/base
 
-[@stdlib/blas/ext/circshift]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/blas/ext/circshift
-
 [@stdlib/blas/ext/cusum]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/blas/ext/cusum
 
 [@stdlib/blas/ext/find-index]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/blas/ext/find-index
@@ -111,8 +107,6 @@ console.log( objectKeys( ns ) );
 
 [@stdlib/blas/ext/index-of]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/blas/ext/index-of
 
-[@stdlib/blas/ext/join]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/blas/ext/join
-
 [@stdlib/blas/ext/last-index-of]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/blas/ext/last-index-of
 
 [@stdlib/blas/ext/linspace]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/blas/ext/linspace