binary3d

Apply a binary callback to elements in two three-dimensional nested input arrays and assign results to elements in a three-dimensional nested output array.

Usage

var binary3d = require( '@stdlib/array/base/binary3d' );

binary3d( arrays, shape, fcn )

Applies a binary callback to elements in two three-dimensional nested input arrays and assigns results to elements in a three-dimensional nested output array.

var add = require( '@stdlib/math/base/ops/add' );
var zeros3d = require( '@stdlib/array/base/zeros3d' );

var x = [ [ [ 1.0, 2.0 ], [ 3.0, 4.0 ] ] ];
var z = zeros3d( [ 1, 2, 2 ] );

var shape = [ 1, 2, 2 ];

binary3d( [ x, x, z ], shape, add );
// z => [ [ [ 2.0, 4.0 ], [ 6.0, 8.0 ] ] ]

The function accepts the following arguments:

arrays: array-like object containing two input nested arrays and one output nested array.
shape: array shape.
fcn: binary function to apply.

Notes

The function assumes that the input and output arrays have the same shape.

Examples

var discreteUniform = require( '@stdlib/random/base/discrete-uniform' ).factory;
var filled3dBy = require( '@stdlib/array/base/filled3d-by' );
var zeros3d = require( '@stdlib/array/base/zeros3d' );
var add = require( '@stdlib/math/base/ops/add' );
var binary3d = require( '@stdlib/array/base/binary3d' );

var shape = [ 2, 3, 3 ];

var x = filled3dBy( shape, discreteUniform( -100, 100 ) );
console.log( x );

var y = filled3dBy( shape, discreteUniform( -100, 100 ) );
console.log( y );

var z = zeros3d( shape );
console.log( z );

binary3d( [ x, y, z ], shape, add );
console.log( z );