compute-logspace

Generates a logarithmically spaced numeric array.

Downloads in past

Stats

StarsIssuesVersionUpdatedCreatedSize
compute-logspace
711.0.09 years ago9 years agoMinified + gzip package size for compute-logspace in KB

Readme

logspace
!NPM versionnpm-imagenpm-url !Build Statustravis-imagetravis-url !Coverage Statuscoveralls-imagecoveralls-url !Dependenciesdependencies-imagedependencies-url
Generates a logarithmically spaced numeric array.

Installation

$ npm install compute-logspace

For use in the browser, use browserify.

Usage

To use the module,
var logspace = require( 'compute-logspace' );

logspace( a, b, length )

Generates a logarithmically spaced numeric array between 10^a and 10^b. If a length is not provided, the default output array length is 10.
var arr = logspace( 0, 2, 6 );
// returns [ 1, ~2.5, ~6.31, ~15.85, ~39.81, 100 ]

Notes

The output array includes the values 10^a and 10^b. Beware of floating point errors, including for the first and last array elements.
This function is inspired by MATLAB's logspace and NumPy's logspace.

Examples

var logspace = require( 'compute-logspace' ),
	out;

// Default behavior:
out = logspace( 0, 3 );
console.log( out.join( '\n' ) );

// Specify length:
out = logspace( 0, 3, 100 );
console.log( out.join( '\n' ) );

// Create an array with decremented values:
out = logspace( 3, 0, 10 );
console.log( out.join( '\n' ) );

To run the example code from the top-level application directory,
$ node ./examples/index.js

Tests

Unit

Unit tests use the Mocha test framework with Chai assertions. To run the tests, execute the following command in the top-level application directory:
$ make test

All new feature development should have corresponding unit tests to validate correct functionality.

Test Coverage

This repository uses Istanbul as its code coverage tool. To generate a test coverage report, execute the following command in the top-level application directory:
$ make test-cov

Istanbul creates a ./reports/coverage directory. To access an HTML version of the report,
$ make view-cov

License

MIT license.

Copyright

Copyright © 2014. Athan Reines.