ndarray

Multidimensional arrays.

Usage

var ns = require( '@stdlib/ndarray' );

ns

ndarray namespace.

var o = ns;
// returns {...}

The namespace exports the following functions to create multidimensional arrays:

• array( [buffer,] [options] ): create a multidimensional array.
• ndarray( dtype, buffer, shape, strides, offset, order[, options] ): multidimensional array constructor.

The namespace contains the following sub-namespaces:

• base: base ndarray.
• iter: multidimensional array iterators.

In addition, the namespace contains the following multidimensional array utility functions:

• anyBy( x[, options], predicate[, thisArg] ): test whether at least one element along one or more ndarray dimensions passes a test implemented by a predicate function.
• any( x[, options] ): test whether at least one element along one or more ndarray dimensions is truthy.
• at( x[, ...indices] ): return an ndarray element.
• broadcastArray( x, shape ): broadcast an ndarray to a specified shape.
• broadcastArrays( ...arrays ): broadcast ndarrays to a common shape.
• broadcastScalar( value, shape[, options] ): broadcast a scalar value to an ndarray of a specified shape.
• castingModes(): list of ndarray casting modes.
• concat( arrays[, options] ): concatenate a list of ndarrays along a specified ndarray dimension.
• concat1d( ...arrays ): return a one-dimensional ndarray formed by concatenating provided input arguments.
• copy( x[, options] ): copy an input ndarray to a new ndarray having the same shape and data type.
• countFalsy( x[, options] ): count the number of falsy elements along one or more ndarray dimensions.
• countIf( x[, options], predicate[, thisArg] ): count the number of truthy elements along one or more ndarray dimensions.
• countTruthy( x[, options] ): count the number of truthy elements along one or more ndarray dimensions.
• dataBuffer( x ): return the underlying data buffer of a provided ndarray.
• defaults(): default ndarray settings.
• dispatch( fcns, types, data, nargs, nin, nout ): create an ndarray function interface which performs multiple dispatch.
• DataType( value[, options] ): data type constructor.
• dtype( x ): return the data type of a provided ndarray.
• dtypes( [kind] ): list of ndarray data types.
• emptyLike( x[, options] ): create an uninitialized ndarray having the same shape and data type as a provided ndarray.
• empty( shape[, options] ): create an uninitialized ndarray having a specified shape and data type.
• every( x[, options] ): test whether every element along one or more ndarray dimensions is truthy.
• FancyArray( dtype, buffer, shape, strides, offset, order[, options] ): fancy multidimensional array constructor.
• fillBy( x, fcn[, thisArg] ): fill an input ndarray according to a callback function.
• fillSlice( x, value, ...s[, options] ): fill an input ndarray view with a specified value.
• fill( x, value ): fill an input ndarray with a specified value.
• filterMap( x[, options], fcn[, thisArg] ): filter and map elements in an input ndarray to elements in a new output ndarray according to a callback function.
• filter( x[, options], predicate[, thisArg] ): return a shallow copy of an ndarray containing only those elements which pass a test implemented by a predicate function.
• findLast( x[, options], predicate[, thisArg] ): return a new ndarray containing the last elements which pass a test implemented by a predicate function along one or more ndarray dimensions.
• find( x[, options], predicate[, thisArg] ): return a new ndarray containing the first elements which pass a test implemented by a predicate function along one or more ndarray dimensions.
• flag( x, name ): return a specified flag for a provided ndarray.
• flags( x ): return the flags of a provided ndarray.
• flattenBy( x[, options], fcn[, thisArg] ): flatten an ndarray according to a callback function.
• flattenFromBy( x, dim[, options], fcn[, thisArg] ): flatten an ndarray according to a callback function starting from a specified dimension.
• flattenFrom( x, dim[, options] ): return a copy of an input ndarray where all dimensions of the input ndarray are flattened starting from a specified dimension.
• flatten( x[, options] ): return a flattened copy of an input ndarray.
• fliplr( x ): return a read-only view of an input ndarray in which the order of elements along the last dimension is reversed.
• flipud( x ): return a read-only view of an input ndarray in which the order of elements along the second-to-last dimension is reversed.
• forEach( x, fcn[, thisArg] ): invoke a callback function once for each ndarray element.
• scalar2ndarrayLike( x, value[, options] ): convert a scalar value to a zero-dimensional ndarray having the same data-type as a provided ndarray.
• scalar2ndarray( value[, options] ): convert a scalar value to a zero-dimensional ndarray.
• includes( x, searchElement[, options] ): test whether an ndarray contains a specified value along one or more dimensions.
• ind2sub( shape, idx[, options] ): convert a linear index to an array of subscripts.
• indexModes(): list of ndarray index modes.
• ndindex( x[, options] ): ndarray index constructor.
• inputCastingPolicies(): list of input ndarray casting policies.
• map( x[, options], fcn[, thisArg] ): apply a callback function to elements in an input ndarray and assign results to elements in a new output ndarray.
• maybeBroadcastArray( x, shape ): broadcast an ndarray to a specified shape if and only if the specified shape differs from the provided ndarray's shape.
• maybeBroadcastArrays( arrays ): broadcast ndarrays to a common shape.
• minDataType( value ): determine the minimum ndarray data type of the closest "kind" necessary for storing a provided scalar value.
• mostlySafeCasts( [dtype] ): return a list of ndarray data types to which a provided ndarray data type can be safely cast and, for floating-point data types, can be downcast.
• ndarraylike2ndarray( x[, options] ): convert an ndarray-like object to an ndarray.
• ndims( x ): return the number of ndarray dimensions.
• nextDataType( [dtype] ): return the next larger ndarray data type of the same kind.
• numelDimension( x, dim ): return the size (i.e., number of elements) of a specified dimension for a provided ndarray.
• numel( x ): return the number of elements in an ndarray.
• offset( x ): return the index offset specifying the underlying buffer index of the first iterated ndarray element.
• order( x ): return the layout order of a provided ndarray.
• orders(): list of ndarray orders.
• outputDataTypePolicies(): list of output ndarray data type policies.
• pop( x[, options] ): return an array containing a read-only truncated view of an input ndarray and a read-only view of the last element(s) along a specified dimension.
• prependSingletonDimensions( x, n ): return a read-only view of an input ndarray with a specified number of prepended singleton dimensions.
• promotionRules( [dtype1, dtype2] ): return the ndarray data type with the smallest size and closest "kind" to which ndarray data types can be safely cast.
• push( x, ...values ): return a one-dimensional ndarray formed by appending provided scalar values to a one-dimensional input ndarray.
• reject( x[, options], predicate[, thisArg] ): return a shallow copy of an ndarray containing only those elements which fail a test implemented by a predicate function.
• reverseDimension( x, dim ): return a read-only view of an input ndarray in which the order of elements along a specified dimension is reversed.
• reverse( x ): return a read-only view of an input ndarray in which the order of elements along each dimension is reversed.
• safeCasts( [dtype] ): return a list of ndarray data types to which a provided ndarray data type can be safely cast.
• sameKindCasts( [dtype] ): return a list of ndarray data types to which a provided ndarray data type can be safely cast or cast within the same "kind".
• shape( x ): return the shape of a provided ndarray.
• shift( x[, options] ): return an array containing a read-only truncated view of an input ndarray and a read-only view of the first element(s) along a specified dimension.
• sliceAssign( x, y, ...s[, options] ): assign element values from a broadcasted input ndarray to corresponding elements in an output ndarray view.
• sliceDimensionFrom( x, dim, start[, options] ): return a read-only shifted view of an input ndarray along a specified dimension.
• sliceDimensionTo( x, dim, stop[, options] ): return a read-only truncated view of an input ndarray along a specified dimension.
• sliceDimension( x, dim, slice[, options] ): return a read-only view of an input ndarray when sliced along a specified dimension.
• sliceFrom( x, ...start[, options] ): return a read-only shifted view of an input ndarray.
• sliceTo( x, ...stop[, options] ): return a read-only truncated view of an input ndarray.
• slice( x, ...s[, options] ): return a read-only view of an input ndarray.
• someBy( x, n[, options], predicate[, thisArg] ): test whether at least n elements along one or more ndarray dimensions pass a test implemented by a predicate function.
• some( x, n[, options] ): test whether at least n elements along one or more ndarray dimensions are truthy.
• spreadDimensions( ndims, x, dims ): return a read-only view of an input ndarray where the dimensions of the input ndarray are expanded to a specified dimensionality by spreading dimensions to specified dimension indices and inserting dimensions of size one for the remaining dimensions.
• stride( x, dim ): return the stride along a specified dimension for a provided ndarray.
• strides( x ): return the strides of a provided ndarray.
• sub2ind( shape, ...subscripts[, options] ): convert subscripts to a linear index.
• ndarray2array( x ): convert an ndarray to a generic array.
• ndarray2fancy( x[, options] ): convert an ndarray to an object supporting fancy indexing.
• ndarray2json( x ): serialize an ndarray as a JSON object.
• toReversedDimension( x[, options] ): return a new ndarray where the order of elements of an input ndarray along a specified dimension is reversed.
• toReversed( x ): return a new ndarray where the order of elements of an input ndarray is reversed along each dimension.
• unshift( x, ...values ): return a one-dimensional ndarray formed by prepending provided scalar values to a one-dimensional input ndarray.
• vector: vector constructors and associated utilities.
• ndarrayWith( x, indices, value ): return a new ndarray with the element at a specified index replaced by a provided value.
• zerosLike( x[, options] ): create a zero-filled ndarray having the same shape and data type as a provided ndarray.
• zeros( shape[, options] ): create a zero-filled ndarray having a specified shape and data type.

Examples

var objectKeys = require( '@stdlib/utils/keys' );
var ns = require( '@stdlib/ndarray' );

console.log( objectKeys( ns ) );