docs: update description and examples

Author: kgryte

lib/node_modules/@stdlib/math/base/tools/evalpoly/README.md

@@ -20,7 +20,7 @@ limitations under the License.
 
 # evalpoly
 
-> Evaluate a [polynomial][polynomial].
+> Evaluate a [polynomial][polynomial] using double-precision floating-point arithmetic.
 
 <section class="intro">
 
@@ -66,7 +66,7 @@ The coefficients should be ordered in **ascending** degree, thus matching summat
 
 #### evalpoly.factory( c )
 
-Uses code generation to in-line coefficients and return a `function` for evaluating a [polynomial][polynomial].
+Uses code generation to in-line coefficients and return a function for evaluating a [polynomial][polynomial] using double-precision floating-point arithmetic.
 
 ```javascript
 var polyval = evalpoly.factory( [ 3.0, 2.0, 1.0 ] );
@@ -100,38 +100,25 @@ v = polyval( 5.0 ); // => 3*5^0 + 2*5^1 + 1*5^2
 <!-- eslint no-undef: "error" -->
 
 ```javascript
-var randu = require( '@stdlib/random/base/randu' );
-var round = require( '@stdlib/math/base/special/round' );
-var Float64Array = require( '@stdlib/array/float64' );
+var discreteUniform = require( '@stdlib/random/array/discrete-uniform' );
+var uniform = require( '@stdlib/random/base/uniform' );
 var evalpoly = require( '@stdlib/math/base/tools/evalpoly' );
 
-var polyval;
-var coef;
-var sign;
+// Create an array of random coefficients:
+var coef = discreteUniform( 10, -100, 100 );
+
+// Evaluate the polynomial at random values:
 var v;
 var i;
-
-// Create an array of random coefficients...
-coef = new Float64Array( 10 );
-for ( i = 0; i < coef.length; i++ ) {
-    if ( randu() < 0.5 ) {
-        sign = -1.0;
-    } else {
-        sign = 1.0;
-    }
-    coef[ i ] = sign * round( randu()*100.0 );
-}
-
-// Evaluate the polynomial at random values...
 for ( i = 0; i < 100; i++ ) {
-    v = randu() * 100.0;
+    v = uniform( 0.0, 100.0 );
     console.log( 'f(%d) = %d', v, evalpoly( coef, v ) );
 }
 
-// Generate an `evalpoly` function...
-polyval = evalpoly.factory( coef );
+// Generate an `evalpoly` function:
+var polyval = evalpoly.factory( coef );
 for ( i = 0; i < 100; i++ ) {
-    v = (randu()*100.0) - 50.0;
+    v = uniform( -50.0, 50.0 );
     console.log( 'f(%d) = %d', v, polyval( v ) );
 }
 ```

lib/node_modules/@stdlib/math/base/tools/evalpoly/docs/repl.txt

@@ -1,6 +1,6 @@
 
 {{alias}}( c, x )
-    Evaluates a polynomial.
+    Evaluates a polynomial using double-precision floating-point arithmetic.
 
     Parameters
     ----------
@@ -25,7 +25,8 @@
 
 
 {{alias}}.factory( c )
-    Returns a function for evaluating a polynomial.
+    Returns a function for evaluating a polynomial using double-precision
+    floating-point arithmetic.
 
     Parameters
     ----------

lib/node_modules/@stdlib/math/base/tools/evalpoly/docs/types/index.d.ts

@@ -18,8 +18,12 @@
 
 // TypeScript Version: 4.1
 
+/// <reference types="@stdlib/types"/>
+
+import { Collection } from '@stdlib/types/array';
+
 /**
-* Evaluates a polynomial.
+* Evaluates a polynomial using double-precision floating-point arithmetic.
 *
 * @param x - value at which to evaluate a polynomial
 * @returns evaluated polynomial
@@ -31,7 +35,7 @@ type EvaluationFunction = ( x: number ) => number;
 */
 interface EvalPoly {
 	/**
-	* Evaluates a polynomial.
+	* Evaluates a polynomial using double-precision floating-point arithmetic.
 	*
 	* ## Notes
 	*
@@ -48,10 +52,10 @@ interface EvalPoly {
 	* var v = evalpoly( [3.0,2.0,1.0], 10.0 ); // 3*10^0 + 2*10^1 + 1*10^2
 	* // returns 123.0
 	*/
-	( c: Array<number>, x: number ): number;
+	( c: Collection<number>, x: number ): number;
 
 	/**
-	* Generates a function for evaluating a polynomial.
+	* Generates a function for evaluating a polynomial using double-precision floating-point arithmetic.
 	*
 	* ## Notes
 	*
@@ -72,11 +76,11 @@ interface EvalPoly {
 	* v = polyval( 5.0 ); // => 3*5^0 + 2*5^1 + 1*5^2
 	* // returns 38.0
 	*/
-	factory( c: Array<number> ): EvaluationFunction;
+	factory( c: Collection<number> ): EvaluationFunction;
 }
 
 /**
-* Evaluates a polynomial.
+* Evaluates a polynomial using double-precision floating-point arithmetic.
 *
 * ## Notes
 *

lib/node_modules/@stdlib/math/base/tools/evalpoly/examples/index.js

@@ -18,46 +18,10 @@
 
 'use strict';
 
-var randu = require( '@stdlib/random/base/randu' );
-var round = require( '@stdlib/math/base/special/round' );
-var Float64Array = require( '@stdlib/array/float64' );
+var discreteUniform = require( '@stdlib/random/array/discrete-uniform' );
+var uniform = require( '@stdlib/random/base/uniform' );
 var evalpoly = require( './../lib' );
 
-var polyval;
-var coef;
-var sign;
-var eqn;
-var v;
-var i;
-
-// Create an array of random coefficients...
-coef = new Float64Array( 10 );
-for ( i = 0; i < coef.length; i++ ) {
-	if ( randu() < 0.5 ) {
-		sign = -1.0;
-	} else {
-		sign = 1.0;
-	}
-	coef[ i ] = sign * round( randu()*100.0 );
-}
-eqn = toStr( coef );
-console.log( 'f(x) = %s', eqn );
-
-// Evaluate the polynomial at random values...
-for ( i = 0; i < 100; i++ ) {
-	v = randu() * 100.0;
-	console.log( 'f(%d) = %d', v, evalpoly( coef, v ) );
-}
-
-// Generate an `evalpoly` function...
-polyval = evalpoly.factory( coef );
-
-console.log( '\nf(x) = %s', eqn );
-for ( i = 0; i < 100; i++ ) {
-	v = (randu()*100.0) - 50.0;
-	console.log( 'f(%d) = %d', v, polyval( v ) );
-}
-
 function toStr( coef ) {
 	var str;
 	var c;
@@ -78,3 +42,26 @@ function toStr( coef ) {
 	}
 	return str;
 }
+
+// Create an array of random coefficients:
+var coef = discreteUniform( 10, -100, 100 );
+
+// Generate a polynomial equation:
+var eqn = toStr( coef );
+console.log( 'f(x) = %s', eqn );
+
+// Evaluate the polynomial at random values:
+var v;
+var i;
+for ( i = 0; i < 100; i++ ) {
+	v = uniform( 0.0, 100.0 );
+	console.log( 'f(%d) = %d', v, evalpoly( coef, v ) );
+}
+
+// Generate an `evalpoly` function:
+var polyval = evalpoly.factory( coef );
+console.log( '\nf(x) = %s', eqn );
+for ( i = 0; i < 100; i++ ) {
+	v = uniform( -50.0, 50.0 );
+	console.log( 'f(%d) = %d', v, polyval( v ) );
+}

lib/node_modules/@stdlib/math/base/tools/evalpoly/lib/factory.js

@@ -27,7 +27,7 @@ var evalpoly = require( './main.js' );
 // MAIN //
 
 /**
-* Generates a function for evaluating a polynomial.
+* Generates a function for evaluating a polynomial using double-precision floating-point arithmetic.
 *
 * ## Notes
 *

lib/node_modules/@stdlib/math/base/tools/evalpoly/lib/index.js

@@ -19,7 +19,7 @@
 'use strict';
 
 /**
-* Evaluate a polynomial.
+* Evaluate a polynomial using double-precision floating-point arithmetic.
 *
 * @module @stdlib/math/base/tools/evalpoly
 *

lib/node_modules/@stdlib/math/base/tools/evalpoly/lib/main.js

@@ -21,7 +21,7 @@
 // MAIN //
 
 /**
-* Evaluates a polynomial.
+* Evaluates a polynomial using double-precision floating-point arithmetic.
 *
 * ## Notes
 *

lib/node_modules/@stdlib/math/base/tools/evalpoly/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stdlib/math/base/tools/evalpoly",
   "version": "0.0.0",
-  "description": "Evaluate a polynomial.",
+  "description": "Evaluate a polynomial using double-precision floating-point arithmetic.",
   "license": "Apache-2.0",
   "author": {
     "name": "The Stdlib Authors",