README.md

sapx

Add a scalar constant to each element in a one-dimensional single-precision floating-point ndarray.

Usage

var sapx = require( '@stdlib/blas/ext/base/ndarray/sapx' );

sapx( arrays )

Adds a scalar constant to each element in a one-dimensional single-precision floating-point ndarray.

var Float32Array = require( '@stdlib/array/float32' );
var ndarray = require( '@stdlib/ndarray/ctor' );
var scalar2ndarray = require( '@stdlib/ndarray/from-scalar' );
var ndarray2array = require( '@stdlib/ndarray/to-array' );

var xbuf = new Float32Array( [ 1.0, 2.0, 3.0, 4.0 ] );
var x = new ndarray( 'float32', xbuf, [ 4 ], [ 1 ], 0, 'row-major' );

var alpha = scalar2ndarray( 5.0, {
    'dtype': 'float32'
});

var out = sapx( [ x, alpha ] );
// returns <ndarray>[ 6.0, 7.0, 8.0, 9.0 ]

var bool = ( out === x );
// returns true

var arr = ndarray2array( out );
// returns [ 6.0, 7.0, 8.0, 9.0 ]

The function has the following parameters:

• arrays: array-like object containing a one-dimensional input ndarray and a zero-dimensional ndarray containing a scalar constant.

var Float32Array = require( '@stdlib/array/float32' );
var ndarray = require( '@stdlib/ndarray/ctor' );
var scalar2ndarray = require( '@stdlib/ndarray/from-scalar' );

// Initial array:
var xbuf = new Float32Array( [ 1.0, 2.0, 3.0, 4.0, 5.0 ] );

// Create an ndarray view:
var x = new ndarray( 'float32', xbuf, [ 3 ], [ 1 ], 2, 'row-major' );
var alpha = scalar2ndarray( 5.0, {
    'dtype': 'float32'
});
var out = sapx( [ x, alpha ] );
// returns <ndarray>[ 8.0, 9.0, 10.0 ]

Examples

var discreteUniform = require( '@stdlib/random/array/discrete-uniform' );
var ndarray = require( '@stdlib/ndarray/ctor' );
var scalar2ndarray = require( '@stdlib/ndarray/from-scalar' );
var ndarray2array = require( '@stdlib/ndarray/to-array' );
var sapx = require( '@stdlib/blas/ext/base/ndarray/sapx' );

var xbuf = discreteUniform( 10, 0, 100, {
    'dtype': 'float32'
});
var x = new ndarray( 'float32', xbuf, [ 10 ], [ 1 ], 0, 'row-major' );
console.log( ndarray2array( x ) );

var alpha = scalar2ndarray( 5.0, {
    'dtype': 'float32'
});

sapx( [ x, alpha ] );
console.log( ndarray2array( x ) );