Struct ndarray::ArrayBase [−] [src]

pub struct ArrayBase<S, D> where S: Data {
    // some fields omitted
}

An N-dimensional array.

The array is a general container of elements. It cannot grow or shrink, but can be sliced into subsets of its data. The array supports arithmetic operations by applying them elementwise.

The ArrayBase<S, D> is parameterized by: - S for the data container - D for the number of dimensions

Type aliases Array, OwnedArray, ArrayView, and ArrayViewMut refer to ArrayBase with different types for the data storage.

Array and OwnedArray

OwnedArray owns the underlying array elements directly (just like a Vec), while Array is a an array with reference counted data. Array can act both as an owner or as a view in that regard. Sharing requires that it uses copy-on-write for mutable operations. Calling a method for mutating elements on Array, for example view_mut() or get_mut(), will break sharing and require a clone of the data (if it is not uniquely held).

Note that all ArrayBase variants can change their view (slicing) of the data freely, even when their data can’t be mutated.

Indexing and Dimension

Array indexes are represented by the types Ix and Ixs (signed).

The dimensionality of the array determines the number of axes, for example a 2D array has two axes. These are listed in “big endian” order, so that the greatest dimension is listed first, the lowest dimension with the most rapidly varying index is the last.

In a 2D array the index of each element is (row, column) as seen in this 3 × 3 example:

[[ (0, 0), (0, 1), (0, 2)],  // row 0
 [ (1, 0), (1, 1), (1, 2)],  // row 1
 [ (2, 0), (2, 1), (2, 2)]]  // row 2
//    \       \       \
//   column 0  \     column 2
//            column 1

The number of axes for an array is fixed by the D parameter: Ix for a 1D array, (Ix, Ix) for a 2D array etc. The D type is also used for element indices in .get() and array[index]. The dimension type Vec<Ix> allows a dynamic number of axes.

Slicing

You can use slicing to create a view of a subset of the data in the array. Slicing methods include .slice(), .islice(), .slice_mut().

The slicing argument can be passed using the macro s![], which will be used in all examples. (The explicit form is a reference to a fixed size array of Si; see its docs for more information.)

// import the s![] macro
#[macro_use(s)]
extern crate ndarray;

use ndarray::arr3;

fn main() {

// 2 submatrices of 2 rows with 3 elements per row, means a shape of `[2, 2, 3]`.

let a = arr3(&[[[ 1,  2,  3],     // -- 2 rows  \_
                [ 4,  5,  6]],    // --         /
               [[ 7,  8,  9],     //            \_ 2 submatrices
                [10, 11, 12]]]);  //            /
//  3 columns ..../.../.../

assert_eq!(a.shape(), &[2, 2, 3]);

// Let’s create a slice with
//
// - Both of the submatrices of the greatest dimension: `..`
// - Only the first row in each submatrix: `0..1`
// - Every element in each row: `..`

let b = a.slice(s![.., 0..1, ..]);
// without the macro, the explicit argument is `&[S, Si(0, Some(1), 1), S]`

let c = arr3(&[[[ 1,  2,  3]],
               [[ 7,  8,  9]]]);
assert_eq!(b, c);
assert_eq!(b.shape(), &[2, 1, 3]);

// Let’s create a slice with
//
// - Both submatrices of the greatest dimension: `..`
// - The last row in each submatrix: `-1..`
// - Row elements in reverse order: `..;-1`
let d = a.slice(s![.., -1.., ..;-1]);
let e = arr3(&[[[ 6,  5,  4]],
               [[12, 11, 10]]]);
assert_eq!(d, e);
}

Subviews

Subview methods allow you to restrict the array view while removing one axis from the array. Subview methods include .subview(), .isubview(), .subview_mut().

Subview takes two arguments: axis and index.

use ndarray::{arr3, aview2};

// 2 submatrices of 2 rows with 3 elements per row, means a shape of `[2, 2, 3]`.

let a = arr3(&[[[ 1,  2,  3],    // \ axis 0, submatrix 0
                [ 4,  5,  6]],   // /
               [[ 7,  8,  9],    // \ axis 0, submatrix 1
                [10, 11, 12]]]); // /
        //        \
        //         axis 2, column 0

assert_eq!(a.shape(), &[2, 2, 3]);

// Let’s take a subview along the greatest dimension (axis 0),
// taking submatrix 0, then submatrix 1

let sub_0 = a.subview(0, 0);
let sub_1 = a.subview(0, 1);

assert_eq!(sub_0, aview2(&[[ 1,  2,  3],
                           [ 4,  5,  6]]));
assert_eq!(sub_1, aview2(&[[ 7,  8,  9],
                           [10, 11, 12]]));
assert_eq!(sub_0.shape(), &[2, 3]);

// This is the subview picking only axis 2, column 0
let sub_col = a.subview(2, 0);

assert_eq!(sub_col, aview2(&[[ 1,  4],
                             [ 7, 10]]));

.isubview() modifies the view in the same way as subview(), but since it is in place, it cannot remove the collapsed axis. It becomes an axis of length 1.

.outer_iter() is an iterator of every subview along the zeroth (outer) axis, while .axis_iter() is an iterator of every subview along a specific axis.

Arithmetic Operations

Arrays support all arithmetic operations the same way: they apply elementwise.

Since the trait implementations are hard to overview, here is a summary.

Let A be an array or view of any kind. Let B be a mutable array (that is, either OwnedArray, Array, or ArrayViewMut) The following combinations of operands are supported for an arbitrary binary operator denoted by @.

The trait Scalar marks types that can be used in arithmetic with arrays directly. For a scalar K the following combinations of operands are supported (scalar can be on either side).

Broadcasting

Arrays support limited broadcasting, where arithmetic operations with array operands of different sizes can be carried out by repeating the elements of the smaller dimension array. See .broadcast() for a more detailed description.

use ndarray::arr2;

let a = arr2(&[[1., 1.],
               [1., 2.]]);
let b = arr2(&[[0., 1.]]);

let c = arr2(&[[1., 2.],
               [1., 3.]]);
// We can add because the shapes are compatible even if not equal.
assert!(
    c == a + b
);

Methods

impl<S> ArrayBase<S, Ix> where S: DataOwned
[src]

Constructor methods for one-dimensional arrays.

Create a one-dimensional array from a vector (no allocation needed).

Create a one-dimensional array from an iterable.

Create a one-dimensional array from inclusive interval [start, end] with n elements. F must be a floating point type.

Deprecated

: use ArrayBase::linspace() instead

Create a one-dimensional array from interval [start, end)

impl<S, A> ArrayBase<S, (Ix, Ix)> where S: DataOwned<Elem=A>
[src]

Constructor methods for two-dimensional arrays.

Create an identity matrix of size n (square 2D array).

impl<S, A, D> ArrayBase<S, D> where S: DataOwned<Elem=A>, D: Dimension
[src]

Constructor methods for arrays.

Create an array with copies of elem, dimension dim.

use ndarray::Array;
use ndarray::arr3;

let a = Array::from_elem((2, 2, 2), 1.);

assert!(
    a == arr3(&[[[1., 1.],
                 [1., 1.]],
                [[1., 1.],
                 [1., 1.]]])
);

Create an array with zeros, dimension dim.

Create an array with default values, dimension dim.

Create an array from a vector (with no allocation needed).

Unsafe because dimension is unchecked, and must be correct.

impl<A, S, D> ArrayBase<S, D> where S: Data<Elem=A>, D: Dimension
[src]

Return the total number of elements in the Array.

Return the shape of the array.

Return the shape of the array as a slice.

Return the strides of the array

Return the number of dimensions (axes) in the array

Return a read-only view of the array

Return a read-write view of the array

Return an uniquely owned copy of the array

Return a shared ownership (copy on write) array.

Turn the array into a shared ownership (copy on write) array, without any copying.

Return an iterator of references to the elements of the array.

Iterator element type is &A.

Return an iterator of references to the elements of the array.

Iterator element type is (D, &A).

Return an iterator of mutable references to the elements of the array.

Iterator element type is &mut A.

Return an iterator of indexes and mutable references to the elements of the array.

Iterator element type is (D, &mut A).

Return a sliced array.

See Slicing for full documentation. See also D::SliceArg.

Panics if an index is out of bounds or stride is zero.
(Panics if D is Vec and indexes does not match the number of array axes.)

Slice the array’s view in place.

See also D::SliceArg.

Panics if an index is out of bounds or stride is zero.
(Panics if D is Vec and indexes does not match the number of array axes.)

Deprecated

: use .slice() instead

Deprecated: Use .slice() instead.

Return a sliced read-write view of the array.

See also D::SliceArg.

Panics if an index is out of bounds or stride is zero.
(Panics if D is Vec and indexes does not match the number of array axes.)

Deprecated

: use .slice_mut() instead

Deprecated: use .slice_mut()

Return a reference to the element at index, or return None if the index is out of bounds.

Arrays also support indexing syntax: array[index].

use ndarray::arr2;

let a = arr2(&[[1., 2.],
               [3., 4.]]);

assert!(
    a.get((0, 1)) == Some(&2.) &&
    a.get((0, 2)) == None &&
    a[(0, 1)] == 2. &&
    a[[0, 1]] == 2.
);

Deprecated

: use .get() instead

Deprecated: use .get(i)

Return a mutable reference to the element at index, or return None if the index is out of bounds.

Deprecated

: use .get_mut() instead

Deprecated: use .get_mut(i)

Perform unchecked array indexing.

Return a reference to the element at index.

Note: only unchecked for non-debug builds of ndarray.

Deprecated

: use .uget() instead

Deprecated: use .uget()

Perform unchecked array indexing.

Return a mutable reference to the element at index.

Note: Only unchecked for non-debug builds of ndarray.
Note: The array must be uniquely held when mutating it.

Deprecated

: use .uget_mut() instead

Deprecated: use .uget_mut()

Swap axes ax and bx.

This does not move any data, it just adjusts the array’s dimensions and strides.

Panics if the axes are out of bounds.

use ndarray::arr2;

let mut a = arr2(&[[1., 2., 3.]]);
a.swap_axes(0, 1);
assert!(
    a == arr2(&[[1.], [2.], [3.]])
);

Along axis, select the subview index and return a view with that axis removed.

See Subviews for full documentation.

Panics if axis or index is out of bounds.

use ndarray::{arr1, arr2};

let a = arr2(&[[1., 2.],    // -- axis 0, row 0
               [3., 4.],    // -- axis 0, row 1
               [5., 6.]]);  // -- axis 0, row 2
//               \   \
//                \   axis 1, column 1
//                 axis 1, column 0
assert!(
    a.subview(0, 1) == arr1(&[3., 4.]) &&
    a.subview(1, 1) == arr1(&[2., 4., 6.])
);

Collapse dimension axis into length one, and select the subview of index along that axis.

Panics if index is past the length of the axis.

Along axis, select the subview index and return self with that axis removed.

See .subview() and Subviews for full documentation.

Along axis, select the subview index and return a read-write view with the axis removed.

Panics if axis or index is out of bounds.

use ndarray::{arr2, aview2};

let mut a = arr2(&[[1., 2.],
                   [3., 4.]]);

a.subview_mut(1, 1).iadd_scalar(&10.);

assert!(
    a == aview2(&[[1., 12.],
                  [3., 14.]])
);

Deprecated

: use .subview_mut() instead

Deprecated: use .subview_mut()

Return an iterator that traverses over all dimensions but the innermost, and yields each inner row.

For example, in a 2 × 2 × 3 array, the iterator element is a row of 3 elements (and there are 2 × 2 = 4 rows in total).

Iterator element is ArrayView<A, Ix> (1D array view).

use ndarray::arr3;
let a = arr3(&[[[ 0,  1,  2],    // -- row 0, 0
                [ 3,  4,  5]],   // -- row 0, 1
               [[ 6,  7,  8],    // -- row 1, 0
                [ 9, 10, 11]]]); // -- row 1, 1
// `inner_iter` yields the four inner rows of the 3D array.
let mut row_sums = a.inner_iter().map(|v| v.scalar_sum());
assert_eq!(row_sums.collect::<Vec<_>>(), vec![3, 12, 21, 30]);

Return an iterator that traverses over all dimensions but the innermost, and yields each inner row.

Iterator element is ArrayViewMut<A, Ix> (1D read-write array view).

Return an iterator that traverses over the outermost dimension and yields each subview.

For example, in a 2 × 2 × 3 array, the iterator element is a 2 × 3 subview (and there are 2 in total).

Iterator element is ArrayView<A, D::Smaller> (read-only array view).

use ndarray::arr3;
let a = arr3(&[[[ 0,  1,  2],    // \ axis 0, submatrix 0
                [ 3,  4,  5]],   // /
               [[ 6,  7,  8],    // \ axis 0, submatrix 1
                [ 9, 10, 11]]]); // /
// `outer_iter` yields the two submatrices along axis 0.
let mut iter = a.outer_iter();
assert_eq!(iter.next().unwrap(), a.subview(0, 0));
assert_eq!(iter.next().unwrap(), a.subview(0, 1));

Return an iterator that traverses over the outermost dimension and yields each subview.

Iterator element is ArrayViewMut<A, D::Smaller> (read-write array view).

Return an iterator that traverses over axis and yields each subview along it.

For example, in a 2 × 2 × 3 array, with axis equal to 1, the iterator element is a 2 × 3 subview (and there are 2 in total).

Iterator element is ArrayView<A, D::Smaller> (read-only array view).

See Subviews for full documentation.

Panics if axis is out of bounds.

Return an iterator that traverses over axis and yields each mutable subview along it.

Iterator element is ArrayViewMut<A, D::Smaller> (read-write array view).

Panics if axis is out of bounds.

Return an view of the diagonal elements of the array.

The diagonal is simply the sequence indexed by (0, 0, .., 0), (1, 1, ..., 1) etc as long as all axes have elements.

Return a read-write view over the diagonal elements of the array.

Return the diagonal as a one-dimensional array.

Deprecated

: use .diag() instead

Deprecated: use .diag()

Deprecated

: use .diag_mut() instead

Deprecated: use .diag_mut()

Return true if the array data is laid out in contiguous “C order” in memory (where the last index is the most rapidly varying).

Return false otherwise, i.e the array is possibly not contiguous in memory, it has custom strides, etc.

Return the array’s data as a slice, if it is contiguous and the element order corresponds to the memory order. Return None otherwise.

Return the array’s data as a slice, if it is contiguous and the element order corresponds to the memory order. Return None otherwise.

Transform the array into shape; any shape with the same number of elements is accepted.

May clone all elements if needed to arrange elements in standard layout (and break sharing).

Panics if shapes are incompatible.

use ndarray::{arr1, arr2};

assert!(
    arr1(&[1., 2., 3., 4.]).reshape((2, 2))
    == arr2(&[[1., 2.],
              [3., 4.]])
);

Transform the array into shape; any shape with the same number of elements is accepted, but the source array or view must be contiguous, otherwise we cannot rearrange the dimension.

Errors if the shapes don't have the same number of elements.
Errors if the input array is not c-contiguous (this will be slightly improved in the future).

use ndarray::{aview1, aview2};

assert!(
    aview1(&[1., 2., 3., 4.]).into_shape((2, 2)).unwrap()
    == aview2(&[[1., 2.],
                [3., 4.]])
);

Act like a larger size and/or shape array by broadcasting into a larger shape, if possible.

Return None if shapes can not be broadcast together.

Background

  • Two axes are compatible if they are equal, or one of them is 1.
  • In this instance, only the axes of the smaller side (self) can be 1.

Compare axes beginning with the last axis of each shape.

For example (1, 2, 4) can be broadcast into (7, 6, 2, 4) because its axes are either equal or 1 (or missing); while (2, 2) can not be broadcast into (2, 4).

The implementation creates a view with strides set to zero for the axes that are to be repeated.

The broadcasting documentation for Numpy has more information.

use ndarray::{aview1, aview2};

assert!(
    aview1(&[1., 0.]).broadcast((10, 2)).unwrap()
    == aview2(&[[1., 0.]; 10])
);

Deprecated

: use .broadcast() instead

Deprecated: Use .broadcast() instead.

Return a slice of the array’s backing data in memory order.

Note: Data memory order may not correspond to the index order of the array. Neither is the raw data slice is restricted to just the Array’s view.
Note: the slice may be empty.

Return a mutable slice of the array’s backing data in memory order.

Note: Data memory order may not correspond to the index order of the array. Neither is the raw data slice is restricted to just the Array’s view.
Note: the slice may be empty.

Note: The data is uniquely held and nonaliased while it is mutably borrowed.

Perform an elementwise assigment to self from rhs.

If their shapes disagree, rhs is broadcast to the shape of self.

Panics if broadcasting isn’t possible.

Perform an elementwise assigment to self from scalar x.

Traverse two arrays in unspecified order, in lock step, calling the closure f on each element pair.

If their shapes disagree, rhs is broadcast to the shape of self.

Panics if broadcasting isn’t possible.

Traverse the array elements in order and apply a fold, returning the resulting value.

Apply f elementwise and return a new array with the results.

Return an array with the same shape as self.

use ndarray::arr2;

let a = arr2(&[[ 0., 1.],
               [-1., 2.]]);
assert!(
    a.map(|x| *x >= 1.0)
    == arr2(&[[false, true],
              [false, true]])
);

impl<A, S, D> ArrayBase<S, D> where S: Data<Elem=A>, D: Dimension
[src]

Return sum along axis.

use ndarray::{aview0, aview1, arr2};

let a = arr2(&[[1., 2.],
               [3., 4.]]);
assert!(
    a.sum(0) == aview1(&[4., 6.]) &&
    a.sum(1) == aview1(&[3., 7.]) &&

    a.sum(0).sum(0) == aview0(&10.)
);

Panics if axis is out of bounds.

Return the sum of all elements in the array.

use ndarray::arr2;

let a = arr2(&[[1., 2.],
               [3., 4.]]);
assert_eq!(a.scalar_sum(), 10.);

Return mean along axis.

use ndarray::{aview1, arr2};

let a = arr2(&[[1., 2.],
               [3., 4.]]);
assert!(
    a.mean(0) == aview1(&[2.0, 3.0]) &&
    a.mean(1) == aview1(&[1.5, 3.5])
);

Panics if axis is out of bounds.

Return true if the arrays' elementwise differences are all within the given absolute tolerance.
Return false otherwise, or if the shapes disagree.

impl<A, S> ArrayBase<S, Ix> where S: Data<Elem=A>
[src]

Compute the dot product of one-dimensional arrays.

The dot product is a sum of the elementwise products (no conjugation of complex operands, and thus not their inner product).

Panics if the arrays are not of the same length.

impl<A, S> ArrayBase<S, (Ix, Ix)> where S: Data<Elem=A>
[src]

Return an array view of row index.

Panics if index is out of bounds.

Return a mutable array view of row index.

Panics if index is out of bounds.

Return an array view of column index.

Panics if index is out of bounds.

Return a mutable array view of column index.

Panics if index is out of bounds.

Deprecated

: use .row() instead

Deprecated: Use .row() instead.

Deprecated

: use .column() instead

Deprecated: Use .column() instead.

Perform matrix multiplication of rectangular arrays self and rhs.

The array shapes must agree in the way that if self is M × N, then rhs is N × K.

Return a result array with shape M × K.

Panics if shapes are incompatible.

use ndarray::arr2;

let a = arr2(&[[1., 2.],
               [0., 1.]]);
let b = arr2(&[[1., 2.],
               [2., 3.]]);

assert!(
    a.mat_mul(&b) == arr2(&[[5., 8.],
                            [2., 3.]])
);

Perform the matrix multiplication of the rectangular array self and column vector rhs.

The array shapes must agree in the way that if self is M × N, then rhs is N.

Return a result array with shape M.

Panics if shapes are incompatible.

impl<A, S, D> ArrayBase<S, D> where S: DataMut<Elem=A>, D: Dimension
[src]

In-place arithmetic operations.

Perform elementwise addition between self and rhs, in place.

If their shapes disagree, rhs is broadcast to the shape of self.

Panics if broadcasting isn’t possible.

Perform elementwise addition between self and the scalar x, in place.

Perform elementwise subtraction between self and rhs, in place.

If their shapes disagree, rhs is broadcast to the shape of self.

Panics if broadcasting isn’t possible.

Perform elementwise subtraction between self and the scalar x, in place.

Perform elementwise multiplication between self and rhs, in place.

If their shapes disagree, rhs is broadcast to the shape of self.

Panics if broadcasting isn’t possible.

Perform elementwise multiplication between self and the scalar x, in place.

Perform elementwise division between self and rhs, in place.

If their shapes disagree, rhs is broadcast to the shape of self.

Panics if broadcasting isn’t possible.

Perform elementwise division between self and the scalar x, in place.

Perform elementwise remainder between self and rhs, in place.

If their shapes disagree, rhs is broadcast to the shape of self.

Panics if broadcasting isn’t possible.

Perform elementwise remainder between self and the scalar x, in place.

Perform elementwise bit and between self and rhs, in place.

If their shapes disagree, rhs is broadcast to the shape of self.

Panics if broadcasting isn’t possible.

Perform elementwise bit and between self and the scalar x, in place.

Perform elementwise bit or between self and rhs, in place.

If their shapes disagree, rhs is broadcast to the shape of self.

Panics if broadcasting isn’t possible.

Perform elementwise bit or between self and the scalar x, in place.

Perform elementwise bit xor between self and rhs, in place.

If their shapes disagree, rhs is broadcast to the shape of self.

Panics if broadcasting isn’t possible.

Perform elementwise bit xor between self and the scalar x, in place.

Perform elementwise left shift between self and rhs, in place.

If their shapes disagree, rhs is broadcast to the shape of self.

Panics if broadcasting isn’t possible.

Perform elementwise left shift between self and the scalar x, in place.

Perform elementwise right shift between self and rhs, in place.

If their shapes disagree, rhs is broadcast to the shape of self.

Panics if broadcasting isn’t possible.

Perform elementwise right shift between self and the scalar x, in place.

Perform an elementwise negation of self, in place.

Perform an elementwise unary not of self, in place.

Trait Implementations

impl<S, D, I> Index<I> for ArrayBase<S, D> where D: Dimension, I: NdIndex<Dim=D>, S: Data
[src]

Access the element at index.

Panics if index is out of bounds.

The returned type after indexing

The method for the indexing (Foo[Bar]) operation

impl<S, D, I> IndexMut<I> for ArrayBase<S, D> where D: Dimension, I: NdIndex<Dim=D>, S: DataMut
[src]

Access the element at index mutably.

Panics if index is out of bounds.

The method for the indexing (Foo[Bar]) operation

impl<S, S2, D> PartialEq<ArrayBase<S2, D>> for ArrayBase<S, D> where D: Dimension, S: Data, S2: Data<Elem=S::Elem>, S::Elem: PartialEq
[src]

Return true if the array shapes and all elements of self and rhs are equal. Return false otherwise.

This method tests for !=.

impl<S, D> Eq for ArrayBase<S, D> where D: Dimension, S: Data, S::Elem: Eq
[src]

impl<A, S> FromIterator<A> for ArrayBase<S, Ix> where S: DataOwned<Elem=A>
[src]

Creates a value from an iterator. Read more

impl<'a, S, D> IntoIterator for &'a ArrayBase<S, D> where D: Dimension, S: Data
[src]

The type of the elements being iterated over.

Which kind of iterator are we turning this into?

Creates an iterator from a value. Read more

impl<'a, S, D> IntoIterator for &'a mut ArrayBase<S, D> where D: Dimension, S: DataMut
[src]

The type of the elements being iterated over.

Which kind of iterator are we turning this into?

Creates an iterator from a value. Read more

impl<'a, S, D> Hash for ArrayBase<S, D> where D: Dimension, S: Data, S::Elem: Hash
[src]

Feeds this value into the state given, updating the hasher as necessary.

Feeds a slice of this type into the state provided.

impl<S, D> Sync for ArrayBase<S, D> where S: Sync + Data, D: Sync
[src]

ArrayBase is Sync when the storage type is.

impl<S, D> Send for ArrayBase<S, D> where S: Send + Data, D: Send
[src]

ArrayBase is Send when the storage type is.

impl<'a, A: Display, S, D: Dimension> Display for ArrayBase<S, D> where S: Data<Elem=A>
[src]

Format the array using Display and apply the formatting parameters used to each element.

The array is shown in multiline style, unless the alternate form is used, {:#}.

Formats the value using the given formatter.

impl<'a, A: Debug, S, D: Dimension> Debug for ArrayBase<S, D> where S: Data<Elem=A>
[src]

Format the array using Debug and apply the formatting parameters used to each element.

The array is shown in multiline style, unless the alternate form is used, {:#?}.

Formats the value using the given formatter.

impl<'a, A: LowerExp, S, D: Dimension> LowerExp for ArrayBase<S, D> where S: Data<Elem=A>
[src]

Format the array using LowerExp and apply the formatting parameters used to each element.

The array is shown in multiline style, unless the alternate form is used, {:#e}.

Formats the value using the given formatter.

impl<'a, A: UpperExp, S, D: Dimension> UpperExp for ArrayBase<S, D> where S: Data<Elem=A>
[src]

Format the array using UpperExp and apply the formatting parameters used to each element.

The array is shown in multiline style, unless the alternate form is used, {:#E}.

Formats the value using the given formatter.

impl<'a, A: LowerHex, S, D: Dimension> LowerHex for ArrayBase<S, D> where S: Data<Elem=A>
[src]

Format the array using LowerHex and apply the formatting parameters used to each element.

The array is shown in multiline style, unless the alternate form is used, {:#x}.

Formats the value using the given formatter.

impl<A, S, S2, D, E> Add<ArrayBase<S2, E>> for ArrayBase<S, D> where A: Clone + Add<A, Output=A>, S: DataMut<Elem=A>, S2: Data<Elem=A>, D: Dimension, E: Dimension
[src]

Perform elementwise addition between self and rhs, and return the result (based on self).

If their shapes disagree, rhs is broadcast to the shape of self.

Panics if broadcasting isn’t possible.

The resulting type after applying the + operator

The method for the + operator

impl<'a, A, S, S2, D, E> Add<&'a ArrayBase<S2, E>> for ArrayBase<S, D> where A: Clone + Add<A, Output=A>, S: DataMut<Elem=A>, S2: Data<Elem=A>, D: Dimension, E: Dimension
[src]

Perform elementwise addition between self and reference rhs, and return the result (based on self).

If their shapes disagree, rhs is broadcast to the shape of self.

Panics if broadcasting isn’t possible.

The resulting type after applying the + operator

The method for the + operator

impl<'a, A, S, S2, D, E> Add<&'a ArrayBase<S2, E>> for &'a ArrayBase<S, D> where A: Clone + Add<A, Output=A>, S: Data<Elem=A>, S2: Data<Elem=A>, D: Dimension, E: Dimension
[src]

Perform elementwise addition between references self and rhs, and return the result as a new OwnedArray.

If their shapes disagree, rhs is broadcast to the shape of self.

Panics if broadcasting isn’t possible.

The resulting type after applying the + operator

The method for the + operator

impl<A, S, D, B> Add<B> for ArrayBase<S, D> where A: Clone + Add<B, Output=A>, S: DataMut<Elem=A>, D: Dimension, B: Clone + Scalar
[src]

Perform elementwise addition between self and the scalar x, and return the result (based on self).

The resulting type after applying the + operator

The method for the + operator

impl<'a, A, S, D, B> Add<B> for &'a ArrayBase<S, D> where A: Clone + Add<B, Output=A>, S: Data<Elem=A>, D: Dimension, B: Clone + Scalar
[src]

Perform elementwise addition between the reference self and the scalar x, and return the result as a new OwnedArray.

The resulting type after applying the + operator

The method for the + operator

impl<A, S, S2, D, E> Sub<ArrayBase<S2, E>> for ArrayBase<S, D> where A: Clone + Sub<A, Output=A>, S: DataMut<Elem=A>, S2: Data<Elem=A>, D: Dimension, E: Dimension
[src]

Perform elementwise subtraction between self and rhs, and return the result (based on self).

If their shapes disagree, rhs is broadcast to the shape of self.

Panics if broadcasting isn’t possible.

The resulting type after applying the - operator

The method for the - operator

impl<'a, A, S, S2, D, E> Sub<&'a ArrayBase<S2, E>> for ArrayBase<S, D> where A: Clone + Sub<A, Output=A>, S: DataMut<Elem=A>, S2: Data<Elem=A>, D: Dimension, E: Dimension
[src]

Perform elementwise subtraction between self and reference rhs, and return the result (based on self).

If their shapes disagree, rhs is broadcast to the shape of self.

Panics if broadcasting isn’t possible.

The resulting type after applying the - operator

The method for the - operator

impl<'a, A, S, S2, D, E> Sub<&'a ArrayBase<S2, E>> for &'a ArrayBase<S, D> where A: Clone + Sub<A, Output=A>, S: Data<Elem=A>, S2: Data<Elem=A>, D: Dimension, E: Dimension
[src]

Perform elementwise subtraction between references self and rhs, and return the result as a new OwnedArray.

If their shapes disagree, rhs is broadcast to the shape of self.

Panics if broadcasting isn’t possible.

The resulting type after applying the - operator

The method for the - operator

impl<A, S, D, B> Sub<B> for ArrayBase<S, D> where A: Clone + Sub<B, Output=A>, S: DataMut<Elem=A>, D: Dimension, B: Clone + Scalar
[src]

Perform elementwise subtraction between self and the scalar x, and return the result (based on self).

The resulting type after applying the - operator

The method for the - operator

impl<'a, A, S, D, B> Sub<B> for &'a ArrayBase<S, D> where A: Clone + Sub<B, Output=A>, S: Data<Elem=A>, D: Dimension, B: Clone + Scalar
[src]

Perform elementwise subtraction between the reference self and the scalar x, and return the result as a new OwnedArray.

The resulting type after applying the - operator

The method for the - operator

impl<A, S, S2, D, E> Mul<ArrayBase<S2, E>> for ArrayBase<S, D> where A: Clone + Mul<A, Output=A>, S: DataMut<Elem=A>, S2: Data<Elem=A>, D: Dimension, E: Dimension
[src]

Perform elementwise multiplication between self and rhs, and return the result (based on self).

If their shapes disagree, rhs is broadcast to the shape of self.

Panics if broadcasting isn’t possible.

The resulting type after applying the * operator

The method for the * operator

impl<'a, A, S, S2, D, E> Mul<&'a ArrayBase<S2, E>> for ArrayBase<S, D> where A: Clone + Mul<A, Output=A>, S: DataMut<Elem=A>, S2: Data<Elem=A>, D: Dimension, E: Dimension
[src]

Perform elementwise multiplication between self and reference rhs, and return the result (based on self).

If their shapes disagree, rhs is broadcast to the shape of self.

Panics if broadcasting isn’t possible.

The resulting type after applying the * operator

The method for the * operator

impl<'a, A, S, S2, D, E> Mul<&'a ArrayBase<S2, E>> for &'a ArrayBase<S, D> where A: Clone + Mul<A, Output=A>, S: Data<Elem=A>, S2: Data<Elem=A>, D: Dimension, E: Dimension
[src]

Perform elementwise multiplication between references self and rhs, and return the result as a new OwnedArray.

If their shapes disagree, rhs is broadcast to the shape of self.

Panics if broadcasting isn’t possible.

The resulting type after applying the * operator

The method for the * operator

impl<A, S, D, B> Mul<B> for ArrayBase<S, D> where A: Clone + Mul<B, Output=A>, S: DataMut<Elem=A>, D: Dimension, B: Clone + Scalar
[src]

Perform elementwise multiplication between self and the scalar x, and return the result (based on self).

The resulting type after applying the * operator

The method for the * operator

impl<'a, A, S, D, B> Mul<B> for &'a ArrayBase<S, D> where A: Clone + Mul<B, Output=A>, S: Data<Elem=A>, D: Dimension, B: Clone + Scalar
[src]

Perform elementwise multiplication between the reference self and the scalar x, and return the result as a new OwnedArray.

The resulting type after applying the * operator

The method for the * operator

impl<A, S, S2, D, E> Div<ArrayBase<S2, E>> for ArrayBase<S, D> where A: Clone + Div<A, Output=A>, S: DataMut<Elem=A>, S2: Data<Elem=A>, D: Dimension, E: Dimension
[src]

Perform elementwise division between self and rhs, and return the result (based on self).

If their shapes disagree, rhs is broadcast to the shape of self.

Panics if broadcasting isn’t possible.

The resulting type after applying the / operator

The method for the / operator

impl<'a, A, S, S2, D, E> Div<&'a ArrayBase<S2, E>> for ArrayBase<S, D> where A: Clone + Div<A, Output=A>, S: DataMut<Elem=A>, S2: Data<Elem=A>, D: Dimension, E: Dimension
[src]

Perform elementwise division between self and reference rhs, and return the result (based on self).

If their shapes disagree, rhs is broadcast to the shape of self.

Panics if broadcasting isn’t possible.

The resulting type after applying the / operator

The method for the / operator

impl<'a, A, S, S2, D, E> Div<&'a ArrayBase<S2, E>> for &'a ArrayBase<S, D> where A: Clone + Div<A, Output=A>, S: Data<Elem=A>, S2: Data<Elem=A>, D: Dimension, E: Dimension
[src]

Perform elementwise division between references self and rhs, and return the result as a new OwnedArray.

If their shapes disagree, rhs is broadcast to the shape of self.

Panics if broadcasting isn’t possible.

The resulting type after applying the / operator

The method for the / operator

impl<A, S, D, B> Div<B> for ArrayBase<S, D> where A: Clone + Div<B, Output=A>, S: DataMut<Elem=A>, D: Dimension, B: Clone + Scalar
[src]

Perform elementwise division between self and the scalar x, and return the result (based on self).

The resulting type after applying the / operator

The method for the / operator

impl<'a, A, S, D, B> Div<B> for &'a ArrayBase<S, D> where A: Clone + Div<B, Output=A>, S: Data<Elem=A>, D: Dimension, B: Clone + Scalar
[src]

Perform elementwise division between the reference self and the scalar x, and return the result as a new OwnedArray.

The resulting type after applying the / operator

The method for the / operator

impl<A, S, S2, D, E> Rem<ArrayBase<S2, E>> for ArrayBase<S, D> where A: Clone + Rem<A, Output=A>, S: DataMut<Elem=A>, S2: Data<Elem=A>, D: Dimension, E: Dimension
[src]

Perform elementwise remainder between self and rhs, and return the result (based on self).

If their shapes disagree, rhs is broadcast to the shape of self.

Panics if broadcasting isn’t possible.

The resulting type after applying the % operator

The method for the % operator

impl<'a, A, S, S2, D, E> Rem<&'a ArrayBase<S2, E>> for ArrayBase<S, D> where A: Clone + Rem<A, Output=A>, S: DataMut<Elem=A>, S2: Data<Elem=A>, D: Dimension, E: Dimension
[src]

Perform elementwise remainder between self and reference rhs, and return the result (based on self).

If their shapes disagree, rhs is broadcast to the shape of self.

Panics if broadcasting isn’t possible.

The resulting type after applying the % operator

The method for the % operator

impl<'a, A, S, S2, D, E> Rem<&'a ArrayBase<S2, E>> for &'a ArrayBase<S, D> where A: Clone + Rem<A, Output=A>, S: Data<Elem=A>, S2: Data<Elem=A>, D: Dimension, E: Dimension
[src]

Perform elementwise remainder between references self and rhs, and return the result as a new OwnedArray.

If their shapes disagree, rhs is broadcast to the shape of self.

Panics if broadcasting isn’t possible.

The resulting type after applying the % operator

The method for the % operator

impl<A, S, D, B> Rem<B> for ArrayBase<S, D> where A: Clone + Rem<B, Output=A>, S: DataMut<Elem=A>, D: Dimension, B: Clone + Scalar
[src]

Perform elementwise remainder between self and the scalar x, and return the result (based on self).

The resulting type after applying the % operator

The method for the % operator

impl<'a, A, S, D, B> Rem<B> for &'a ArrayBase<S, D> where A: Clone + Rem<B, Output=A>, S: Data<Elem=A>, D: Dimension, B: Clone + Scalar
[src]

Perform elementwise remainder between the reference self and the scalar x, and return the result as a new OwnedArray.

The resulting type after applying the % operator

The method for the % operator

impl<A, S, S2, D, E> BitAnd<ArrayBase<S2, E>> for ArrayBase<S, D> where A: Clone + BitAnd<A, Output=A>, S: DataMut<Elem=A>, S2: Data<Elem=A>, D: Dimension, E: Dimension
[src]

Perform elementwise bit and between self and rhs, and return the result (based on self).

If their shapes disagree, rhs is broadcast to the shape of self.

Panics if broadcasting isn’t possible.

The resulting type after applying the & operator

The method for the & operator

impl<'a, A, S, S2, D, E> BitAnd<&'a ArrayBase<S2, E>> for ArrayBase<S, D> where A: Clone + BitAnd<A, Output=A>, S: DataMut<Elem=A>, S2: Data<Elem=A>, D: Dimension, E: Dimension
[src]

Perform elementwise bit and between self and reference rhs, and return the result (based on self).

If their shapes disagree, rhs is broadcast to the shape of self.

Panics if broadcasting isn’t possible.

The resulting type after applying the & operator

The method for the & operator

impl<'a, A, S, S2, D, E> BitAnd<&'a ArrayBase<S2, E>> for &'a ArrayBase<S, D> where A: Clone + BitAnd<A, Output=A>, S: Data<Elem=A>, S2: Data<Elem=A>, D: Dimension, E: Dimension
[src]

Perform elementwise bit and between references self and rhs, and return the result as a new OwnedArray.

If their shapes disagree, rhs is broadcast to the shape of self.

Panics if broadcasting isn’t possible.

The resulting type after applying the & operator

The method for the & operator

impl<A, S, D, B> BitAnd<B> for ArrayBase<S, D> where A: Clone + BitAnd<B, Output=A>, S: DataMut<Elem=A>, D: Dimension, B: Clone + Scalar
[src]

Perform elementwise bit and between self and the scalar x, and return the result (based on self).

The resulting type after applying the & operator

The method for the & operator

impl<'a, A, S, D, B> BitAnd<B> for &'a ArrayBase<S, D> where A: Clone + BitAnd<B, Output=A>, S: Data<Elem=A>, D: Dimension, B: Clone + Scalar
[src]

Perform elementwise bit and between the reference self and the scalar x, and return the result as a new OwnedArray.

The resulting type after applying the & operator

The method for the & operator

impl<A, S, S2, D, E> BitOr<ArrayBase<S2, E>> for ArrayBase<S, D> where A: Clone + BitOr<A, Output=A>, S: DataMut<Elem=A>, S2: Data<Elem=A>, D: Dimension, E: Dimension
[src]

Perform elementwise bit or between self and rhs, and return the result (based on self).

If their shapes disagree, rhs is broadcast to the shape of self.

Panics if broadcasting isn’t possible.

The resulting type after applying the | operator

The method for the | operator

impl<'a, A, S, S2, D, E> BitOr<&'a ArrayBase<S2, E>> for ArrayBase<S, D> where A: Clone + BitOr<A, Output=A>, S: DataMut<Elem=A>, S2: Data<Elem=A>, D: Dimension, E: Dimension
[src]

Perform elementwise bit or between self and reference rhs, and return the result (based on self).

If their shapes disagree, rhs is broadcast to the shape of self.

Panics if broadcasting isn’t possible.

The resulting type after applying the | operator

The method for the | operator

impl<'a, A, S, S2, D, E> BitOr<&'a ArrayBase<S2, E>> for &'a ArrayBase<S, D> where A: Clone + BitOr<A, Output=A>, S: Data<Elem=A>, S2: Data<Elem=A>, D: Dimension, E: Dimension
[src]

Perform elementwise bit or between references self and rhs, and return the result as a new OwnedArray.

If their shapes disagree, rhs is broadcast to the shape of self.

Panics if broadcasting isn’t possible.

The resulting type after applying the | operator

The method for the | operator

impl<A, S, D, B> BitOr<B> for ArrayBase<S, D> where A: Clone + BitOr<B, Output=A>, S: DataMut<Elem=A>, D: Dimension, B: Clone + Scalar
[src]

Perform elementwise bit or between self and the scalar x, and return the result (based on self).

The resulting type after applying the | operator

The method for the | operator

impl<'a, A, S, D, B> BitOr<B> for &'a ArrayBase<S, D> where A: Clone + BitOr<B, Output=A>, S: Data<Elem=A>, D: Dimension, B: Clone + Scalar
[src]

Perform elementwise bit or between the reference self and the scalar x, and return the result as a new OwnedArray.

The resulting type after applying the | operator

The method for the | operator

impl<A, S, S2, D, E> BitXor<ArrayBase<S2, E>> for ArrayBase<S, D> where A: Clone + BitXor<A, Output=A>, S: DataMut<Elem=A>, S2: Data<Elem=A>, D: Dimension, E: Dimension
[src]

Perform elementwise bit xor between self and rhs, and return the result (based on self).

If their shapes disagree, rhs is broadcast to the shape of self.

Panics if broadcasting isn’t possible.

The resulting type after applying the ^ operator

The method for the ^ operator

impl<'a, A, S, S2, D, E> BitXor<&'a ArrayBase<S2, E>> for ArrayBase<S, D> where A: Clone + BitXor<A, Output=A>, S: DataMut<Elem=A>, S2: Data<Elem=A>, D: Dimension, E: Dimension
[src]

Perform elementwise bit xor between self and reference rhs, and return the result (based on self).

If their shapes disagree, rhs is broadcast to the shape of self.

Panics if broadcasting isn’t possible.

The resulting type after applying the ^ operator

The method for the ^ operator

impl<'a, A, S, S2, D, E> BitXor<&'a ArrayBase<S2, E>> for &'a ArrayBase<S, D> where A: Clone + BitXor<A, Output=A>, S: Data<Elem=A>, S2: Data<Elem=A>, D: Dimension, E: Dimension
[src]

Perform elementwise bit xor between references self and rhs, and return the result as a new OwnedArray.

If their shapes disagree, rhs is broadcast to the shape of self.

Panics if broadcasting isn’t possible.

The resulting type after applying the ^ operator

The method for the ^ operator

impl<A, S, D, B> BitXor<B> for ArrayBase<S, D> where A: Clone + BitXor<B, Output=A>, S: DataMut<Elem=A>, D: Dimension, B: Clone + Scalar
[src]

Perform elementwise bit xor between self and the scalar x, and return the result (based on self).

The resulting type after applying the ^ operator

The method for the ^ operator

impl<'a, A, S, D, B> BitXor<B> for &'a ArrayBase<S, D> where A: Clone + BitXor<B, Output=A>, S: Data<Elem=A>, D: Dimension, B: Clone + Scalar
[src]

Perform elementwise bit xor between the reference self and the scalar x, and return the result as a new OwnedArray.

The resulting type after applying the ^ operator

The method for the ^ operator

impl<A, S, S2, D, E> Shl<ArrayBase<S2, E>> for ArrayBase<S, D> where A: Clone + Shl<A, Output=A>, S: DataMut<Elem=A>, S2: Data<Elem=A>, D: Dimension, E: Dimension
[src]

Perform elementwise left shift between self and rhs, and return the result (based on self).

If their shapes disagree, rhs is broadcast to the shape of self.

Panics if broadcasting isn’t possible.

The resulting type after applying the << operator

The method for the << operator

impl<'a, A, S, S2, D, E> Shl<&'a ArrayBase<S2, E>> for ArrayBase<S, D> where A: Clone + Shl<A, Output=A>, S: DataMut<Elem=A>, S2: Data<Elem=A>, D: Dimension, E: Dimension
[src]

Perform elementwise left shift between self and reference rhs, and return the result (based on self).

If their shapes disagree, rhs is broadcast to the shape of self.

Panics if broadcasting isn’t possible.

The resulting type after applying the << operator

The method for the << operator

impl<'a, A, S, S2, D, E> Shl<&'a ArrayBase<S2, E>> for &'a ArrayBase<S, D> where A: Clone + Shl<A, Output=A>, S: Data<Elem=A>, S2: Data<Elem=A>, D: Dimension, E: Dimension
[src]

Perform elementwise left shift between references self and rhs, and return the result as a new OwnedArray.

If their shapes disagree, rhs is broadcast to the shape of self.

Panics if broadcasting isn’t possible.

The resulting type after applying the << operator

The method for the << operator

impl<A, S, D, B> Shl<B> for ArrayBase<S, D> where A: Clone + Shl<B, Output=A>, S: DataMut<Elem=A>, D: Dimension, B: Clone + Scalar
[src]

Perform elementwise left shift between self and the scalar x, and return the result (based on self).

The resulting type after applying the << operator

The method for the << operator

impl<'a, A, S, D, B> Shl<B> for &'a ArrayBase<S, D> where A: Clone + Shl<B, Output=A>, S: Data<Elem=A>, D: Dimension, B: Clone + Scalar
[src]

Perform elementwise left shift between the reference self and the scalar x, and return the result as a new OwnedArray.

The resulting type after applying the << operator

The method for the << operator

impl<A, S, S2, D, E> Shr<ArrayBase<S2, E>> for ArrayBase<S, D> where A: Clone + Shr<A, Output=A>, S: DataMut<Elem=A>, S2: Data<Elem=A>, D: Dimension, E: Dimension
[src]

Perform elementwise right shift between self and rhs, and return the result (based on self).

If their shapes disagree, rhs is broadcast to the shape of self.

Panics if broadcasting isn’t possible.

The resulting type after applying the >> operator

The method for the >> operator

impl<'a, A, S, S2, D, E> Shr<&'a ArrayBase<S2, E>> for ArrayBase<S, D> where A: Clone + Shr<A, Output=A>, S: DataMut<Elem=A>, S2: Data<Elem=A>, D: Dimension, E: Dimension
[src]

Perform elementwise right shift between self and reference rhs, and return the result (based on self).

If their shapes disagree, rhs is broadcast to the shape of self.

Panics if broadcasting isn’t possible.

The resulting type after applying the >> operator

The method for the >> operator

impl<'a, A, S, S2, D, E> Shr<&'a ArrayBase<S2, E>> for &'a ArrayBase<S, D> where A: Clone + Shr<A, Output=A>, S: Data<Elem=A>, S2: Data<Elem=A>, D: Dimension, E: Dimension
[src]

Perform elementwise right shift between references self and rhs, and return the result as a new OwnedArray.

If their shapes disagree, rhs is broadcast to the shape of self.

Panics if broadcasting isn’t possible.

The resulting type after applying the >> operator

The method for the >> operator

impl<A, S, D, B> Shr<B> for ArrayBase<S, D> where A: Clone + Shr<B, Output=A>, S: DataMut<Elem=A>, D: Dimension, B: Clone + Scalar
[src]

Perform elementwise right shift between self and the scalar x, and return the result (based on self).

The resulting type after applying the >> operator

The method for the >> operator

impl<'a, A, S, D, B> Shr<B> for &'a ArrayBase<S, D> where A: Clone + Shr<B, Output=A>, S: Data<Elem=A>, D: Dimension, B: Clone + Scalar
[src]

Perform elementwise right shift between the reference self and the scalar x, and return the result as a new OwnedArray.

The resulting type after applying the >> operator

The method for the >> operator

impl<A, S, D> Neg for ArrayBase<S, D> where A: Clone + Neg<Output=A>, S: DataMut<Elem=A>, D: Dimension
[src]

The resulting type after applying the - operator

Perform an elementwise negation of self and return the result.

impl<A, S, D> Not for ArrayBase<S, D> where A: Clone + Not<Output=A>, S: DataMut<Elem=A>, D: Dimension
[src]

The resulting type after applying the ! operator

Perform an elementwise unary not of self and return the result.

impl<S: DataClone, D: Clone> Clone for ArrayBase<S, D>
[src]

Returns a copy of the value. Read more

Performs copy-assignment from source. Read more

impl<S: DataClone + Copy, D: Copy> Copy for ArrayBase<S, D>
[src]