pub struct Dim<I>where
I: ?Sized,{
index: I,
}
Expand description
Dimension description.
Dim
describes the number of axes and the length of each axis
in an array. It is also used as an index type.
See also the Dimension
trait for its methods and
operations.
§Examples
To create an array with a particular dimension, you’d just pass
a tuple (in this example (3, 2) is used), which is converted to
Dim
by the array constructor.
use ndarray::Array2;
use ndarray::Dim;
let mut array = Array2::zeros((3, 2));
array[[0, 0]] = 1.;
assert_eq!(array.raw_dim(), Dim([3, 2]));
Fields§
§index: I
Implementations§
Trait Implementations§
Source§impl<'a, I> AddAssign<&'a Dim<I>> for Dim<I>
impl<'a, I> AddAssign<&'a Dim<I>> for Dim<I>
Source§fn add_assign(&mut self, rhs: &Dim<I>)
fn add_assign(&mut self, rhs: &Dim<I>)
Performs the
+=
operation. Read moreSource§impl AddAssign<usize> for Dim<[usize; 1]>
impl AddAssign<usize> for Dim<[usize; 1]>
Source§fn add_assign(&mut self, rhs: usize)
fn add_assign(&mut self, rhs: usize)
Performs the
+=
operation. Read moreSource§impl<I> AddAssign for Dim<I>
impl<I> AddAssign for Dim<I>
Source§fn add_assign(&mut self, rhs: Dim<I>)
fn add_assign(&mut self, rhs: Dim<I>)
Performs the
+=
operation. Read moreSource§impl Dimension for Dim<[usize; 0]>
impl Dimension for Dim<[usize; 0]>
Source§const NDIM: Option<usize> = _
const NDIM: Option<usize> = _
For fixed-size dimension representations (e.g.
Ix2
), this should be
Some(ndim)
, and for variable-size dimension representations (e.g.
IxDyn
), this should be None
.Source§fn into_pattern(self) -> <Dim<[usize; 0]> as Dimension>::Pattern
fn into_pattern(self) -> <Dim<[usize; 0]> as Dimension>::Pattern
Convert the dimension into a pattern matching friendly value.
Source§fn zeros(ndim: usize) -> Dim<[usize; 0]>
fn zeros(ndim: usize) -> Dim<[usize; 0]>
Creates a dimension of all zeros with the specified ndim. Read more
Source§fn size_checked(&self) -> Option<usize>
fn size_checked(&self) -> Option<usize>
Compute the size while checking for overflow.
Source§fn as_array_view(&self) -> ArrayBase<ViewRepr<&usize>, Dim<[usize; 1]>>
fn as_array_view(&self) -> ArrayBase<ViewRepr<&usize>, Dim<[usize; 1]>>
Borrow as a read-only array view.
Source§impl Dimension for Dim<[usize; 1]>
impl Dimension for Dim<[usize; 1]>
Source§const NDIM: Option<usize> = _
const NDIM: Option<usize> = _
For fixed-size dimension representations (e.g.
Ix2
), this should be
Some(ndim)
, and for variable-size dimension representations (e.g.
IxDyn
), this should be None
.Source§fn into_pattern(self) -> <Dim<[usize; 1]> as Dimension>::Pattern
fn into_pattern(self) -> <Dim<[usize; 1]> as Dimension>::Pattern
Convert the dimension into a pattern matching friendly value.
Source§fn zeros(ndim: usize) -> Dim<[usize; 1]>
fn zeros(ndim: usize) -> Dim<[usize; 1]>
Creates a dimension of all zeros with the specified ndim. Read more
Source§fn size_checked(&self) -> Option<usize>
fn size_checked(&self) -> Option<usize>
Compute the size while checking for overflow.
Source§fn as_array_view(&self) -> ArrayBase<ViewRepr<&usize>, Dim<[usize; 1]>>
fn as_array_view(&self) -> ArrayBase<ViewRepr<&usize>, Dim<[usize; 1]>>
Borrow as a read-only array view.
Source§impl Dimension for Dim<[usize; 2]>
impl Dimension for Dim<[usize; 2]>
Source§const NDIM: Option<usize> = _
const NDIM: Option<usize> = _
For fixed-size dimension representations (e.g.
Ix2
), this should be
Some(ndim)
, and for variable-size dimension representations (e.g.
IxDyn
), this should be None
.Source§type Pattern = (usize, usize)
type Pattern = (usize, usize)
Pattern matching friendly form of the dimension value. Read more
Source§fn into_pattern(self) -> <Dim<[usize; 2]> as Dimension>::Pattern
fn into_pattern(self) -> <Dim<[usize; 2]> as Dimension>::Pattern
Convert the dimension into a pattern matching friendly value.
Source§fn zeros(ndim: usize) -> Dim<[usize; 2]>
fn zeros(ndim: usize) -> Dim<[usize; 2]>
Creates a dimension of all zeros with the specified ndim. Read more
Source§fn size_checked(&self) -> Option<usize>
fn size_checked(&self) -> Option<usize>
Compute the size while checking for overflow.
Source§fn as_array_view(&self) -> ArrayBase<ViewRepr<&usize>, Dim<[usize; 1]>>
fn as_array_view(&self) -> ArrayBase<ViewRepr<&usize>, Dim<[usize; 1]>>
Borrow as a read-only array view.
Source§impl Dimension for Dim<[usize; 3]>
impl Dimension for Dim<[usize; 3]>
Source§const NDIM: Option<usize> = _
const NDIM: Option<usize> = _
For fixed-size dimension representations (e.g.
Ix2
), this should be
Some(ndim)
, and for variable-size dimension representations (e.g.
IxDyn
), this should be None
.Source§type Pattern = (usize, usize, usize)
type Pattern = (usize, usize, usize)
Pattern matching friendly form of the dimension value. Read more
Source§fn into_pattern(self) -> <Dim<[usize; 3]> as Dimension>::Pattern
fn into_pattern(self) -> <Dim<[usize; 3]> as Dimension>::Pattern
Convert the dimension into a pattern matching friendly value.
Source§fn zeros(ndim: usize) -> Dim<[usize; 3]>
fn zeros(ndim: usize) -> Dim<[usize; 3]>
Creates a dimension of all zeros with the specified ndim. Read more
Source§fn size_checked(&self) -> Option<usize>
fn size_checked(&self) -> Option<usize>
Compute the size while checking for overflow.
Source§fn as_array_view(&self) -> ArrayBase<ViewRepr<&usize>, Dim<[usize; 1]>>
fn as_array_view(&self) -> ArrayBase<ViewRepr<&usize>, Dim<[usize; 1]>>
Borrow as a read-only array view.
Source§impl Dimension for Dim<[usize; 4]>
impl Dimension for Dim<[usize; 4]>
Source§const NDIM: Option<usize> = _
const NDIM: Option<usize> = _
For fixed-size dimension representations (e.g.
Ix2
), this should be
Some(ndim)
, and for variable-size dimension representations (e.g.
IxDyn
), this should be None
.Source§type Pattern = (usize, usize, usize, usize)
type Pattern = (usize, usize, usize, usize)
Pattern matching friendly form of the dimension value. Read more
Source§fn into_pattern(self) -> <Dim<[usize; 4]> as Dimension>::Pattern
fn into_pattern(self) -> <Dim<[usize; 4]> as Dimension>::Pattern
Convert the dimension into a pattern matching friendly value.
Source§fn zeros(ndim: usize) -> Dim<[usize; 4]>
fn zeros(ndim: usize) -> Dim<[usize; 4]>
Creates a dimension of all zeros with the specified ndim. Read more
Source§fn size_checked(&self) -> Option<usize>
fn size_checked(&self) -> Option<usize>
Compute the size while checking for overflow.
Source§fn as_array_view(&self) -> ArrayBase<ViewRepr<&usize>, Dim<[usize; 1]>>
fn as_array_view(&self) -> ArrayBase<ViewRepr<&usize>, Dim<[usize; 1]>>
Borrow as a read-only array view.
Source§impl Dimension for Dim<[usize; 5]>
impl Dimension for Dim<[usize; 5]>
Source§const NDIM: Option<usize> = _
const NDIM: Option<usize> = _
For fixed-size dimension representations (e.g.
Ix2
), this should be
Some(ndim)
, and for variable-size dimension representations (e.g.
IxDyn
), this should be None
.Source§type Pattern = (usize, usize, usize, usize, usize)
type Pattern = (usize, usize, usize, usize, usize)
Pattern matching friendly form of the dimension value. Read more
Source§fn into_pattern(self) -> <Dim<[usize; 5]> as Dimension>::Pattern
fn into_pattern(self) -> <Dim<[usize; 5]> as Dimension>::Pattern
Convert the dimension into a pattern matching friendly value.
Source§fn zeros(ndim: usize) -> Dim<[usize; 5]>
fn zeros(ndim: usize) -> Dim<[usize; 5]>
Creates a dimension of all zeros with the specified ndim. Read more
Source§fn size_checked(&self) -> Option<usize>
fn size_checked(&self) -> Option<usize>
Compute the size while checking for overflow.
Source§fn as_array_view(&self) -> ArrayBase<ViewRepr<&usize>, Dim<[usize; 1]>>
fn as_array_view(&self) -> ArrayBase<ViewRepr<&usize>, Dim<[usize; 1]>>
Borrow as a read-only array view.
Source§impl Dimension for Dim<[usize; 6]>
impl Dimension for Dim<[usize; 6]>
Source§const NDIM: Option<usize> = _
const NDIM: Option<usize> = _
For fixed-size dimension representations (e.g.
Ix2
), this should be
Some(ndim)
, and for variable-size dimension representations (e.g.
IxDyn
), this should be None
.Source§type Pattern = (usize, usize, usize, usize, usize, usize)
type Pattern = (usize, usize, usize, usize, usize, usize)
Pattern matching friendly form of the dimension value. Read more
Source§fn into_pattern(self) -> <Dim<[usize; 6]> as Dimension>::Pattern
fn into_pattern(self) -> <Dim<[usize; 6]> as Dimension>::Pattern
Convert the dimension into a pattern matching friendly value.
Source§fn zeros(ndim: usize) -> Dim<[usize; 6]>
fn zeros(ndim: usize) -> Dim<[usize; 6]>
Creates a dimension of all zeros with the specified ndim. Read more
Source§fn size_checked(&self) -> Option<usize>
fn size_checked(&self) -> Option<usize>
Compute the size while checking for overflow.
Source§fn as_array_view(&self) -> ArrayBase<ViewRepr<&usize>, Dim<[usize; 1]>>
fn as_array_view(&self) -> ArrayBase<ViewRepr<&usize>, Dim<[usize; 1]>>
Borrow as a read-only array view.
Source§impl Dimension for Dim<IxDynImpl>
impl Dimension for Dim<IxDynImpl>
IxDyn is a “dynamic” index, pretty hard to use when indexing, and memory wasteful, but it allows an arbitrary and dynamic number of axes.
Source§const NDIM: Option<usize> = None
const NDIM: Option<usize> = None
For fixed-size dimension representations (e.g.
Ix2
), this should be
Some(ndim)
, and for variable-size dimension representations (e.g.
IxDyn
), this should be None
.Source§type Pattern = Dim<IxDynImpl>
type Pattern = Dim<IxDynImpl>
Pattern matching friendly form of the dimension value. Read more
Source§fn into_pattern(self) -> <Dim<IxDynImpl> as Dimension>::Pattern
fn into_pattern(self) -> <Dim<IxDynImpl> as Dimension>::Pattern
Convert the dimension into a pattern matching friendly value.
Source§fn zeros(ndim: usize) -> Dim<IxDynImpl>
fn zeros(ndim: usize) -> Dim<IxDynImpl>
Creates a dimension of all zeros with the specified ndim. Read more
Source§fn into_dyn(self) -> Dim<IxDynImpl>
fn into_dyn(self) -> Dim<IxDynImpl>
Convert the dimensional into a dynamic dimensional (IxDyn).
Source§fn size_checked(&self) -> Option<usize>
fn size_checked(&self) -> Option<usize>
Compute the size while checking for overflow.
Source§impl<'a, I> MulAssign<&'a Dim<I>> for Dim<I>
impl<'a, I> MulAssign<&'a Dim<I>> for Dim<I>
Source§fn mul_assign(&mut self, rhs: &Dim<I>)
fn mul_assign(&mut self, rhs: &Dim<I>)
Performs the
*=
operation. Read moreSource§impl<I> MulAssign<usize> for Dim<I>
impl<I> MulAssign<usize> for Dim<I>
Source§fn mul_assign(&mut self, rhs: usize)
fn mul_assign(&mut self, rhs: usize)
Performs the
*=
operation. Read moreSource§impl<I> MulAssign for Dim<I>
impl<I> MulAssign for Dim<I>
Source§fn mul_assign(&mut self, rhs: Dim<I>)
fn mul_assign(&mut self, rhs: Dim<I>)
Performs the
*=
operation. Read moreSource§impl<'a, I> SubAssign<&'a Dim<I>> for Dim<I>
impl<'a, I> SubAssign<&'a Dim<I>> for Dim<I>
Source§fn sub_assign(&mut self, rhs: &Dim<I>)
fn sub_assign(&mut self, rhs: &Dim<I>)
Performs the
-=
operation. Read moreSource§impl SubAssign<usize> for Dim<[usize; 1]>
impl SubAssign<usize> for Dim<[usize; 1]>
Source§fn sub_assign(&mut self, rhs: usize)
fn sub_assign(&mut self, rhs: usize)
Performs the
-=
operation. Read moreSource§impl<I> SubAssign for Dim<I>
impl<I> SubAssign for Dim<I>
Source§fn sub_assign(&mut self, rhs: Dim<I>)
fn sub_assign(&mut self, rhs: Dim<I>)
Performs the
-=
operation. Read moreimpl<I> Copy for Dim<I>
impl<I> Eq for Dim<I>
impl NdIndex<Dim<[usize; 0]>> for [usize; 0]
impl NdIndex<Dim<[usize; 0]>> for ()
impl NdIndex<Dim<[usize; 1]>> for [usize; 1]
impl NdIndex<Dim<[usize; 1]>> for usize
impl NdIndex<Dim<[usize; 2]>> for [usize; 2]
impl NdIndex<Dim<[usize; 2]>> for (usize, usize)
impl NdIndex<Dim<[usize; 3]>> for [usize; 3]
impl NdIndex<Dim<[usize; 3]>> for (usize, usize, usize)
impl NdIndex<Dim<[usize; 4]>> for [usize; 4]
impl NdIndex<Dim<[usize; 4]>> for (usize, usize, usize, usize)
impl NdIndex<Dim<[usize; 5]>> for [usize; 5]
impl NdIndex<Dim<[usize; 5]>> for (usize, usize, usize, usize, usize)
impl NdIndex<Dim<[usize; 6]>> for [usize; 6]
impl<'a> NdIndex<Dim<IxDynImpl>> for &'a [usize]
impl<'a> NdIndex<Dim<IxDynImpl>> for &'a Dim<IxDynImpl>
impl NdIndex<Dim<IxDynImpl>> for [usize; 0]
impl NdIndex<Dim<IxDynImpl>> for [usize; 1]
impl NdIndex<Dim<IxDynImpl>> for [usize; 2]
impl NdIndex<Dim<IxDynImpl>> for [usize; 3]
impl NdIndex<Dim<IxDynImpl>> for [usize; 4]
impl NdIndex<Dim<IxDynImpl>> for [usize; 5]
impl NdIndex<Dim<IxDynImpl>> for [usize; 6]
impl NdIndex<Dim<IxDynImpl>> for Dim<[usize; 0]>
impl NdIndex<Dim<IxDynImpl>> for Dim<[usize; 1]>
impl NdIndex<Dim<IxDynImpl>> for Dim<[usize; 2]>
impl NdIndex<Dim<IxDynImpl>> for Dim<[usize; 3]>
impl NdIndex<Dim<IxDynImpl>> for Dim<[usize; 4]>
impl NdIndex<Dim<IxDynImpl>> for Dim<[usize; 5]>
impl NdIndex<Dim<IxDynImpl>> for Dim<[usize; 6]>
impl NdIndex<Dim<IxDynImpl>> for usize
impl<I> StructuralPartialEq for Dim<I>where
I: ?Sized,
Auto Trait Implementations§
impl<I> Freeze for Dim<I>
impl<I> RefUnwindSafe for Dim<I>where
I: RefUnwindSafe + ?Sized,
impl<I> Send for Dim<I>
impl<I> Sync for Dim<I>
impl<I> Unpin for Dim<I>
impl<I> UnwindSafe for Dim<I>where
I: UnwindSafe + ?Sized,
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
Source§unsafe fn clone_to_uninit(&self, dst: *mut T)
unsafe fn clone_to_uninit(&self, dst: *mut T)
🔬This is a nightly-only experimental API. (
clone_to_uninit
)Source§impl<D> IntoDimension for Dwhere
D: Dimension,
impl<D> IntoDimension for Dwhere
D: Dimension,
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
Converts
self
into a Left
variant of Either<Self, Self>
if into_left
is true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
Converts
self
into a Left
variant of Either<Self, Self>
if into_left(&self)
returns true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read more