Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -47,11 +47,11 @@ Returns the k-means distance metric string associated with a k-means distance me
```javascript
var str2enum = require( '@stdlib/ml/base/kmeans/metric-str2enum' );

var v = str2enum( 'sqeuclidean' );
var v = str2enum( 'squared-euclidean' );
// returns <number>

var s = enum2str( v );
// returns 'sqeuclidean'
// returns 'squared-euclidean'
```

If unable to resolve a k-means distance metric string, the function returns `null`.
Expand Down Expand Up @@ -85,8 +85,8 @@ var v = enum2str( -999999999 );
var str2enum = require( '@stdlib/ml/base/kmeans/metric-str2enum' );
var enum2str = require( '@stdlib/ml/base/kmeans/metric-enum2str' );

var str = enum2str( str2enum( 'sqeuclidean' ) );
// returns 'sqeuclidean'
var str = enum2str( str2enum( 'squared-euclidean' ) );
// returns 'squared-euclidean'

str = enum2str( str2enum( 'cosine' ) );
// returns 'cosine'
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ bench( pkg, function benchmark( b ) {
var i;

values = [
str2enum( 'sqeuclidean' ),
str2enum( 'squared-euclidean' ),
str2enum( 'cosine' ),
str2enum( 'cityblock' ),
str2enum( 'correlation' )
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -15,8 +15,9 @@

Examples
--------
> var out = {{alias}}( {{alias:@stdlib/ml/base/kmeans/metric-str2enum}}( 'sqeuclidean' ) )
'sqeuclidean'
> var out = {{alias}}( {{alias:@stdlib/ml/base/kmeans/metric-str2enum}}(
... 'squared-euclidean' ) )
'squared-euclidean'

See Also
--------
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -27,11 +27,11 @@
* @example
* var str2enum = require( '@stdlib/ml/base/kmeans/metric-str2enum' );
*
* var v = str2enum( 'sqeuclidean' );
* var v = str2enum( 'squared-euclidean' );
* // returns <number>
*
* var s = enum2str( v );
* // returns 'sqeuclidean'
* // returns 'squared-euclidean'
*/
declare function enum2str( value: number ): string | null;

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,6 @@ var str = enum2str( str2enum( 'cosine' ) );
console.log( str );
// => 'cosine'

str = enum2str( str2enum( 'sqeuclidean' ) );
str = enum2str( str2enum( 'squared-euclidean' ) );
console.log( str );
// => 'sqeuclidean'
// => 'squared-euclidean'
Original file line number Diff line number Diff line change
Expand Up @@ -27,11 +27,11 @@
* var str2enum = require( '@stdlib/ml/base/kmeans/metric-str2enum' );
* var enum2str = require( '@stdlib/ml/base/kmeans/metric-enum2str' );
*
* var v = str2enum( 'sqeuclidean' );
* var v = str2enum( 'squared-euclidean' );
* // returns <number>
*
* var s = enum2str( v );
* // returns 'sqeuclidean'
* // returns 'squared-euclidean'
*/

// MODULES //
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -43,11 +43,11 @@ var hash = objectInverse( enumeration(), {
* @example
* var str2enum = require( '@stdlib/ml/base/kmeans/metric-str2enum' );
*
* var v = str2enum( 'sqeuclidean' );
* var v = str2enum( 'squared-euclidean' );
* // returns <number>
*
* var s = enum2str( v );
* // returns 'sqeuclidean'
* // returns 'squared-euclidean'
*/
function enum2str( value ) {
var v = hash[ value ];
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ var enum2str = require( './../lib' );
// VARIABLES //

var VALUES = [
'sqeuclidean',
'squared-euclidean',
'cosine',
'cityblock',
'correlation'
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ Returns the enumeration constant associated with a supported k-means distance me
```javascript
var str2enum = require( '@stdlib/ml/base/kmeans/metric-str2enum' );

var v = resolve( 'sqeuclidean' );
var v = resolve( 'squared-euclidean' );
// returns <number>

v = resolve( str2enum( 'cosine' ) );
Expand All @@ -71,7 +71,7 @@ var v = resolve( 'beep' );

## Notes

- Downstream consumers of this function should **not** rely on specific integer values (e.g., `SQEUCLIDEAN == 0`). Instead, the function should be used in an opaque manner.
- Downstream consumers of this function should **not** rely on specific integer values (e.g., `SQUARED_EUCLIDEAN == 0`). Instead, the function should be used in an opaque manner.

</section>

Expand All @@ -88,7 +88,7 @@ var v = resolve( 'beep' );
```javascript
var resolve = require( '@stdlib/ml/base/kmeans/metric-resolve-enum' );

var v = resolve( 'sqeuclidean' );
var v = resolve( 'squared-euclidean' );
// returns <number>

v = resolve( 'cosine' );
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ bench( format( '%s::string', pkg ), function benchmark( b ) {
var i;

values = [
'sqeuclidean',
'squared-euclidean',
'cosine',
'correlation',
'cityblock'
Expand All @@ -63,7 +63,7 @@ bench( format( '%s::integer', pkg ), function benchmark( b ) {
var i;

values = [
str2enum( 'sqeuclidean' ),
str2enum( 'squared-euclidean' ),
str2enum( 'cosine' ),
str2enum( 'correlation' ),
str2enum( 'cityblock' )
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,8 +4,8 @@
distance metric value.

Downstream consumers of this function should *not* rely on specific integer
values (e.g., `SQEUCLIDEAN == 0`). Instead, the function should be used in
an opaque manner.
values (e.g., `SQUARED_EUCLIDEAN == 0`). Instead, the function should be
used in an opaque manner.

Parameters
----------
Expand All @@ -19,9 +19,10 @@

Examples
--------
> var out = {{alias}}( 'sqeuclidean' )
> var out = {{alias}}( 'squared-euclidean' )
<number>
> out = {{alias}}( {{alias:@stdlib/ml/base/kmeans/metric-str2enum}}( 'sqeuclidean' ) )
> out = {{alias}}( {{alias:@stdlib/ml/base/kmeans/metric-str2enum}}(
... 'squared-euclidean' ) )
<number>

See Also
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -23,16 +23,16 @@
*
* ## Notes
*
* - Downstream consumers of this function should **not** rely on specific integer values (e.g., `SQEUCLIDEAN == 0`). Instead, the function should be used in an opaque manner.
* - Downstream consumers of this function should **not** rely on specific integer values (e.g., `SQUARED_EUCLIDEAN == 0`). Instead, the function should be used in an opaque manner.
*
* @param value - distance metric value
* @returns enumeration constant
*
* @example
* var v = resolve( 'sqeuclidean' );
* var v = resolve( 'squared-euclidean' );
* // returns <number>
*/
declare function resolve( value: any ): number | null;

Check warning on line 35 in lib/node_modules/@stdlib/ml/base/kmeans/metric-resolve-enum/docs/types/index.d.ts

View workflow job for this annotation

GitHub Actions / Lint Changed Files

Unexpected any. Specify a different type


// EXPORTS //
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -24,5 +24,5 @@ import resolve = require( './index' );
// The function returns a number or null...
{
resolve( 0 ); // $ExpectType number | null
resolve( 'sqeuclidean' ); // $ExpectType number | null
resolve( 'squared-euclidean' ); // $ExpectType number | null
}
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@

var resolve = require( './../lib' );

var v = resolve( 'sqeuclidean' );
var v = resolve( 'squared-euclidean' );
console.log( v );
// => <number>

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@
* @example
* var resolve = require( '@stdlib/ml/base/kmeans/metric-resolve-enum' );
*
* var v = resolve( 'sqeuclidean' );
* var v = resolve( 'squared-euclidean' );
* // returns <number>
*/

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -31,13 +31,13 @@ var str2enum = require( '@stdlib/ml/base/kmeans/metric-str2enum' );
*
* ## Notes
*
* - Downstream consumers of this function should **not** rely on specific integer values (e.g., `SQEUCLIDEAN == 0`). Instead, the function should be used in an opaque manner.
* - Downstream consumers of this function should **not** rely on specific integer values (e.g., `SQUARED_EUCLIDEAN == 0`). Instead, the function should be used in an opaque manner.
*
* @param {*} value - distance metric value
* @returns {(integer|null)} enumeration constant or null
*
* @example
* var v = resolve( 'sqeuclidean' );
* var v = resolve( 'squared-euclidean' );
* // returns <number>
*/
function resolve( value ) {
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ var resolve = require( './../lib' );
// VARIABLES //

var VALUES = [
'sqeuclidean',
'squared-euclidean',
'cosine',
'correlation',
'cityblock'
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -88,8 +88,8 @@ var resolve = require( '@stdlib/ml/base/kmeans/metric-resolve-str' );
var v = resolve( str2enum( 'cosine' ) );
// returns 'cosine'

v = resolve( str2enum( 'sqeuclidean' ) );
// returns 'sqeuclidean'
v = resolve( str2enum( 'squared-euclidean' ) );
// returns 'squared-euclidean'
```

</section>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ bench( format( '%s::string', pkg ), function benchmark( b ) {
var i;

values = [
'sqeuclidean',
'squared-euclidean',
'cosine',
'correlation',
'cityblock'
Expand All @@ -63,7 +63,7 @@ bench( format( '%s::integer', pkg ), function benchmark( b ) {
var i;

values = [
str2enum( 'sqeuclidean' ),
str2enum( 'squared-euclidean' ),
str2enum( 'cosine' ),
str2enum( 'correlation' ),
str2enum( 'cityblock' )
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,6 @@ var v = resolve( str2enum( 'cosine' ) );
console.log( v );
// => 'cosine'

v = resolve( str2enum( 'sqeuclidean' ) );
v = resolve( str2enum( 'squared-euclidean' ) );
console.log( v );
// => 'sqeuclidean'
// => 'squared-euclidean'
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ var resolve = require( './../lib' );
// VARIABLES //

var VALUES = [
'sqeuclidean',
'squared-euclidean',
'cosine',
'correlation',
'cityblock'
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -66,7 +66,7 @@ var v = str2enum( 'beep' );

## Notes

- Downstream consumers of this function should **not** rely on specific integer values (e.g., `SQEUCLIDEAN == 0`). Instead, the function should be used in an opaque manner.
- Downstream consumers of this function should **not** rely on specific integer values (e.g., `SQUARED_EUCLIDEAN == 0`). Instead, the function should be used in an opaque manner.

</section>

Expand All @@ -86,7 +86,7 @@ var str2enum = require( '@stdlib/ml/base/kmeans/metric-str2enum' );
var v = str2enum( 'cosine' );
// returns <number>

v = str2enum( 'sqeuclidean' );
v = str2enum( 'squared-euclidean' );
// returns <number>
```

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ bench( pkg, function benchmark( b ) {
var i;

values = [
'sqeuclidean',
'squared-euclidean',
'cosine',
'cityblock',
'correlation'
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,8 +4,8 @@
string.

Downstream consumers of this function should *not* rely on specific integer
values (e.g., `SQEUCLIDEAN == 0`). Instead, the function should be used in
an opaque manner.
values (e.g., `SQUARED_EUCLIDEAN == 0`). Instead, the function should be
used in an opaque manner.

Parameters
----------
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@
*
* ## Notes
*
* - Downstream consumers of this function should **not** rely on specific integer values (e.g., `SQEUCLIDEAN == 0`). Instead, the function should be used in an opaque manner.
* - Downstream consumers of this function should **not** rely on specific integer values (e.g., `SQUARED_EUCLIDEAN == 0`). Instead, the function should be used in an opaque manner.
*
* @param metric - distance metric string
* @returns enumeration constant
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,6 @@ var v = str2enum( 'cosine' );
console.log( v );
// => <number>

v = str2enum( 'sqeuclidean' );
v = str2enum( 'squared-euclidean' );
console.log( v );
// => <number>
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ var ENUM = enumeration();
*
* ## Notes
*
* - Downstream consumers of this function should **not** rely on specific integer values (e.g., `SQEUCLIDEAN == 0`). Instead, the function should be used in an opaque manner.
* - Downstream consumers of this function should **not** rely on specific integer values (e.g., `SQUARED_EUCLIDEAN == 0`). Instead, the function should be used in an opaque manner.
*
* @param {string} metric - distance metric string
* @returns {(integer|null)} integer value or null
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ var str2enum = require( './../lib' );

var VALUES = [
'cosine',
'sqeuclidean',
'squared-euclidean',
'cityblock',
'correlation'
];
Expand Down
Loading