The Dr. Turner release 🚀
-
Complex matrix multiplication now uses BLAS
cgemm/zgemmwhen enabled (and matrix layout allows), by @ethanhs. -
Use
matrixmultiplyas fallback for complex matrix multiplication when BLAS is not available or the matrix layout requires it by @bluss -
Add
into/to_slice_memory_ordermethods for views, lifetime-preserving versions of existing similar methods by @jturner314 -
kronfunction for Kronecker product by @ethanhs. -
split_complexmethod for splitting complex arrays into separate real and imag view parts by @jturner314 and @ethanhs. -
New method
try_into_owned_nocopyby @jturner314 -
New producer and iterable
axis_windowsby @VasanthakumarV and @jturner314. -
New method
Zip::par_foldby @adamreichold -
New constructor
from_diag_elemby @jturner314 -
Parallel::with_min_lenmethod for parallel iterators by @adamreichold -
Allocation-preserving map function
.mapv_into_any()added by [@benkay86]
-
Improve performance of
.sum_axis()for some cases by @jturner314
-
Fix error in calling dgemv (matrix-vector multiplication) with BLAS and broadcasted arrays, by @jturner314.
-
Support approx 0.5 partially alongside the already existing approx 0.4 support. New feature flag is
approx-0_5, by @jturner314 -
Slice and reference-to-array conversions to CowArray added for by @jturner314.
-
Allow trailing comma in stack and concatenate macros by @jturner314
-
Zipnow has amust_usemarker to help users by @adamreichold
-
Fixing the crates.io badge on github by @atouchet
-
Use intra-doc links in docs by @LeSeulArtichaut
-
Clippy fixes by @adamreichold
-
Minor fixes in links and punctuation in docs by @jimblandy
-
Minor fixes in docs by @chohner
-
Update tests to quickcheck 1.0 by @bluss
-
New methods
.last/_mut()for arrays and array views by @jturner314
-
Fix
as_slice_memory_order_mut()so that it never changes strides (the memory layout) of the array when called.This was a bug that impacted
ArcArray(and for example notArrayorArrayView/Mut), and multiple methods onArcArraythat useas_slice_memory_order_mut(for examplemap_mut). Fix by @jturner314.
-
Array1 now implements
From<Box<[T]>>by @jturner314 -
ArcArray now implements
From<Array<...>>by @jturner314 -
CowArray now implements RawDataSubst by @jturner314
-
Mention unsharing in
.as_mut_ptrdocs by @jturner314 -
Clarify and fix minor errors in push/append method docs by @bluss f21c668a
-
Fix several warnings in doc example code by @bluss
-
New methods for growing/appending to owned
Arrays. These methods allow building an array efficiently chunk by chunk. By @bluss..push_row(),.push_column().push(axis, array),.append(axis, array)
stack,concatenateand.select()now support allClone-able elements as a result. -
New reshaping method
.to_shape(...), called with new shape and optional ordering parameter, this is the first improvement for reshaping in terms of added features and increased consistency, with more to come. By @bluss. -
Arraynow implements a by-value iterator, by @bluss. -
New methods
.move_into()and.move_into_uninit()which allow assigning into an array by moving values from an array into another, by @bluss. -
New method
.remove_index()for owned arrays by @bluss -
New constructor
build_uninitwhich makes it easier to initialize uninitialized arrays in a way that's generic over all owned array kinds. By @bluss.
-
Preserve the allocation of the input array in some more cases for arithmetic ops by @SparrowLii
-
Improve broadcasting performance for &array + &array arithmetic ops by @SparrowLii
-
Fix an error in construction of empty array with negative strides, by @jturner314.
-
Fix minor performance bug with loop order selection in Zip by @bluss
-
Add dimension getters to
ShapeandStrideShapeby @stokhos
-
Rustdoc now uses the ndarray logo that @jturner314 created previously
-
Minor doc changes by @stokhos, @cassiersg and @jturner314
-
A little refactoring to reduce generics bloat in a few places by @bluss.
-
Arrays and views now have additional PartialEq impls so that it's possible to compare arrays with references to arrays and vice versa by @bluss
-
Fix panic in creation of
.windows()producer from negative stride array by @bluss
-
Update BLAS documentation further by @bluss
-
Support inserting new axes while slicing by @jturner314. This is an example:
let view = arr.slice(s![.., -1, 2..;-1, NewAxis]);
-
Support two-sided broadcasting in arithmetic operations with arrays by @SparrowLii
This now allows, for example, addition of a 3 x 1 with a 1 x 3 array; the operands are in this case broadcast to 3 x 3 which is the shape of the result.
Note that this means that a new trait bound is required in some places when mixing dimensionality types of arrays in arithmetic operations.
-
Support for compiling ndarray as
no_std(using core and alloc) by @xd009642 and @bluss -
New methods
.cell_view()andArrayViewMut::into_cell_viewthat enable new ways of working with array elements as if they were in Cells - setting elements through shared views and broadcast views, by @bluss. -
New methods
slice_each_axis/_mut/_inplacethat make it easier to slice a dynamic number of axes in some situations, by @jturner314 -
New method
a.assign_to(b)with the inverse argument order compared to the existingb.assign(a)and some extra features like assigning into uninitialized arrays, By @bluss. -
New methods
.std()and.var()for standard deviation and variance by @kdubovikov
-
Ndarray can now correctly determine that arrays can be contiguous, even if they have negative strides, by @SparrowLii
-
Improvements to
map_inplaceby @jturner314 -
.into_dimensionalityperformance was improved for theIxDyntoIxDyncase by @bluss -
Improved performance for scalar + &array and &array + scalar operations by @jturner314
-
New constructors
Array::from_iterandArray::from_vecby @bluss. No new functionality, just that these constructors are available without trait imports. -
NdProducer::raw_dimis now a documented method by @jturner314 -
AxisDescriptionis now a struct with field names, not a tuple struct by @jturner314. Its accessor methods are now deprecated. -
Methods for array comparison
abs_diff_eqandrelative_eqare now exposed as inherent methods too (no trait import needed), still under the approx feature flag by @bluss -
Changes to the slicing-related types and macro by @jturner314 and @bluss:
- Remove the
Dimension::SliceArgassociated type, and add a newSliceArgtrait for this purpose. - Change the return type of the
s![]macro to an ownedSliceInforather than a reference. - Replace the
SliceOrIndexenum withSliceInfoElem, which has an additionalNewAxisvariant and does not have astep_bymethod. - Change the type parameters of
SliceInfoin order to support theNewAxisfunctionality and remove some trickyunsafecode. - Mark the
SliceInfo::newmethod asunsafe. The new implementations ofTryFromcan be used as a safe alternative. - Remove the
AsRef<SliceInfo<[SliceOrIndex], D>> for SliceInfo<T, D>implementation. Add the similarFrom<&'a SliceInfo<T, Din, Dout>> for SliceInfo<&'a [SliceInfoElem], Din, Dout>conversion as an alternative. - Change the expr
;step case in thes![]macro to error at compile time if an unsupported type for expr is used, instead of panicking at runtime.
rust-ndarray#570
rust-ndarray#940
rust-ndarray#943
rust-ndarray#945 - Remove the
-
Removed already deprecated methods by @bluss:
- Remove deprecated
.all_close()- use approx feature and methods like.abs_diff_eqinstead - Mark
.scalar_sum()as deprecated - use.sum()instead - Remove deprecated
DataClone- useData + RawDataCloneinstead - Remove deprecated
ArrayView::into_slice- useto_slice()instead.
- Remove deprecated
-
Remove already deprecated methods: rows, cols (for row and column count; the new names are nrows and ncols) by @bluss
-
Renamed
Zipmethods by @bluss and @SparrowLii:apply->for_eachapply_collect->map_collectapply_collect_into->map_collect_into- (
par_prefixed methods renamed accordingly)
-
Deprecate
Array::uninitializedand revamped its replacement by @blussPlease use new new
Array::uninitwhich is based onMaybeUninit(renamed fromArray::maybe_uninit, the old name is also deprecated). -
Renamed methods (old names are now deprecated) by @bluss and @jturner314
genrows/_mut->rows/_mutgencolumns/_mut->columns/_mutstack_new_axis->stack(the new name already existed)visit->for_each
-
Updated
matrixmultiplydependency to 0.3.0 by @bluss and adding new feature flagmatrixmultiply-threadingto enable its threading -
Updated
num-complexdependency to 0.4.0 by @bluss
-
Fix
Zip::indexedfor the 0-dimensional case by @jturner314 -
Fix bug in layout computation that broke parallel collect to f-order array in some circumstances by @bluss
-
Fix an unwanted panic in shape overflow checking by @bluss
-
Mark the
SliceInfo::newmethod asunsafedue to the requirement thatindices.as_ref()always return the same value when called multiple times, by @bluss and @jturner314
-
It was changed how we integrate with BLAS and
blas-src. Users of BLAS need B943 to read the README for the updated instructions. Ndarray itself no longer has public dependency onblas-src. Changes by @bluss. -
Various improvements to tests and CI by @jturner314
-
The
sort-axis.rsexample file's implementation of sort was bugfixed and now has tests, by @dam5h and @bluss -
We now link to the #rust-sci room on matrix in the readme by @jturner314
-
Internal cleanup with builder-like methods for creating arrays by @bluss
-
Implementation fix of
.swap(i, j)by @bluss -
Minimum supported Rust version (MSRV) is Rust 1.49.
-
Minor improvements to docs by @insideoutclub
-
Zip::apply_collectandZip::par_apply_collectnow support all elements (not justCopyelements) by @bluss rust-ndarray#814
rust-ndarray#817 -
New function
stackby @andrei-papou
rust-ndarray#844
rust-ndarray#850
-
Handle inhomogeneous shape inputs better in Zip, in practice: guess better whether to prefer c- or f-order for the inner loop by @bluss rust-ndarray#809
-
Improve code sharing in some commonly used code by @bluss rust-ndarray#819
-
The old function
stackhas been renamed toconcatenate. A new functionstackwith numpy-like semantics have taken its place. Old usages ofstackshould change to useconcatenate.concatenateproduces an array with the same number of axes as the inputs.
stackproduces an array that has one more axis than the inputs.This change was unfortunately done without a deprecation period, due to the long period between releases.
-
Enum ErrorKind is now properly non-exhaustive and has lost its old placeholder invalid variant. By @Zuse64 rust-ndarray#848
-
Remove deprecated items:
- RcArray (deprecated alias for ArcArray)
- Removed
subview_inplaceusecollapse_axis - Removed
subview_mutuseindex_axis_mut - Removed
into_subviewuseindex_axis_move - Removed
subviewuseindex_axis - Removed
slice_inplaceuseslice_collapse
-
Undeprecated
remove_axisbecause its replacement is hard to find out on your own. -
Update public external dependencies to new versions by @Eijebong and @bluss
- num-complex 0.3
- approx 0.4 (optional)
- blas-src 0.6.1 and openblas-src 0.9.0 (optional)
-
Minor doc fixes by @acj rust-ndarray#834
-
Minor doc fixes by @xd009642 rust-ndarray#847
-
The minimum required rust version is Rust 1.42.
-
Release management by @bluss
- New amazing slicing methods
multi_slice_*by @jturner314 rust-ndarray#717 - New method
.cast()for raw views by @bluss rust-ndarray#734 - New aliases
ArcArray1,ArcArray2by @d-dorazio rust-ndarray#741 - New array constructor
from_shape_simple_fnby @bluss rust-ndarray#728 Dimension::Largernow requiresRemoveAxisby @TheLortex rust-ndarray#792- New methods for collecting Zip into an array by @bluss rust-ndarray#797
- New
Array::maybe_uninitand.assume_init()by @bluss rust-ndarray#803
- Remove itertools as dependency by @bluss rust-ndarray#730
- Improve
zip_mut_with(and thus arithmetic ops) for f-order arrays by @nilgoyette rust-ndarray#754 - Implement
foldforIndicesIterby @jturner314 rust-ndarray#733 - New Quick Start readme by @lifuyang rust-ndarray#785
- Remove alignment restriction on raw views by @jturner314 rust-ndarray#738
- Fix documentation in ndarray for numpy users by @jturner314
- Improve blas version documentation by @jturner314
- Doc improvements by @mockersf rust-ndarray#751
- Doc and lint related improvements by @viniciusd rust-ndarray#750
- Minor fixes related to best practices for unsafe code by @bluss rust-ndarray#799 rust-ndarray#802
- Release management by @bluss
ndarray-parallelis merged intondarray. Use therayonfeature-flag to get access to parallel iterators and other parallelized methods. (#563 by @bluss)- Add
logspaceandgeomspaceconstructors (#617 by @JP-Ellis) - Implement approx traits for
ArrayBase. They can be enabled using theapproxfeature-flag. (#581 by @jturner314) - Add
meanmethod (#580 by @LukeMathWalker) - Add
Zip::allto check if all elements satisfy a predicate (#615 by @mneumann) - Add
RawArrayViewandRawArrayViewMuttypes andRawData,RawDataMut, andRawDataClonetraits (#496 by @jturner314) - Add
CowArray,Cloneonwritearray (#632 by @jturner314 and @andrei-papou) - Add
as_standard_layouttoArrayBase: it takes an array by reference and returns aCoWArrayin standard layout (#616 by @jturner314 and @andrei-papou) - Add
Array2::from_diagmethod to create 2D arrays from a diagonal (#673 by @rth) - Add
foldmethod toZip(#684 by @jturner314) - Add
split_atmethod toAxisChunksIter/Mut(#691 by @jturner314) - Implement parallel iteration for
AxisChunksIter/Mut(#639 by @nitsky) - Add
into_scalarmethod toArrayView0andArrayViewMut0(#700 by @LukeMathWalker) - Add
accumulate_axis_inplacemethod toArrayBase(#611 by @jturner314 and @bluss) - Add the
array!,azip!, ands!macros tondarray::prelude(#517 by @jturner314)
- Improve performance for matrix multiplications when using the pure-Rust backend thanks to
matrix-multiply:v0.2(leverage SIMD instructions on x86-64 with runtime feature detection) (#556 by @bluss) - Improve performance of
foldfor iterators (#574 by @jturner314) - Improve performance of
nth_backfor iterators (#686 by @jturner314) - Improve performance of iterators for 1-d arrays (#614 by @andrei-papou)
- Improve formatting for large arrays (#606 by @andrei-papou and @LukeMathWalker, #633 and #707 by @jturner314, and #713 by @bluss)
- Arithmetic operations between arrays with different element types are now allowed when there is a scalar equivalent (#588 by @jturner314)
.map_axis/_mutwon't panic on 0-lengthaxis(#579 by @andrei-papou)- Various documentation improvements (by @jturner314, @JP-Ellis, @LukeMathWalker, @bluss)
- The
into_slicemethod on ArrayView is deprecated and renamed toto_slice(#646 by @max-sixty) RcArrayis deprecated in favour ofArcArray(#560 by @bluss)into_sliceis renamed toto_slice.into_sliceis now deprecated (#646 by @max-sixty)from_vecis deprecated in favour of using theFromto convert aVecinto anArray(#648 by @max-sixty)mean_axisreturnsOption<A>instead ofA, to avoid panicking when invoked on a 0-length axis (#580 by @LukeMathWalker)- Remove
rustc-serializefeature-flag.serdeis the recommended feature-flag for serialization (#557 by @bluss) rows/colsare renamed tonrows/ncols.rows/colsare now deprecated (#701 by @bluss)- The usage of the
azip!macro has changed to be more similar toforloops (#626 by @jturner314) - For
var_axisandstd_axis, the constraints onddofand the trait bounds onAhave been made more strict (#515 by @jturner314) - For
mean_axis, the constraints onAhave changed (#518 by @jturner314) DataCloneis deprecated in favor of usingData + RawDataClone(#496 by @jturner314)- The
Dimension::Patternassociated type now has more trait bounds (#634 by @termoshtt) Axis::index()now takesselfinstead of&self(#642 by @max-sixty)- The bounds on the implementation of
HashforDimhave changed (#642 by @max-sixty)
- Prevent overflow when computing strides in
do_slice(#575 by @jturner314) - Fix issue with BLAS matrix-vector multiplication for array with only 1 non-trivial dimension (#585 by @sebasv)
- Fix offset computation to avoid UB/panic when slicing in some edge cases (#636 by @jturner314)
- Fix issues with axis iterators (#669 by @jturner314)
- Fix handling of empty input to
s!macro (#714 by @bluss and #715 by @jturner314)
- Various improvements to
ndarray's CI pipeline (clippy,cargo fmt, etc. by @max-sixty and @termoshtt) - Bump minimum required Rust version to 1.37.
- Add
std_axismethod for computing standard deviation by @LukeMathWalker. - Add
productmethod for computing product of elements in an array by @sebasv. - Add
firstandfirst_mutmethods for getting the first element of an array. - Add
into_scalarmethod for converting anArray0into its element. - Add
insert_axis_inplaceandindex_axis_inplacemethods for inserting and removing axes in dynamic-dimensional (IxDyn) arrays without taking ownership. - Add
stride_ofmethod for getting the stride of an axis. - Add public
ndimandzerosmethods toDimensiontrait. - Rename
scalar_sumtosum,subviewtoindex_axis,subview_muttoindex_axis_mut,subview_inplacetocollapse_axis,into_subviewtoindex_axis_move, andslice_inplacetoslice_collapse(deprecating the old names, except forscalar_sumwhich will be in 0.13). - Deprecate
remove_axisand fix soundness hole when removing a zero-length axis. - Implement
CloneforLanesIter. - Implement
Debug,Copy, andCloneforFoldWhile. - Relax constraints on
sum_axis,mean_axis, andinto_owned. - Add number of dimensions (and whether it's const or dynamic) to array
Debugformat. - Allow merging axes with
merge_axeswhen either axis length is ≤ 1. - Clarify and check more precise safety requirements for constructing arrays. This fixes undefined behavior in some edge cases. (See #543.)
- Fix
is_standard_layoutin some edge cases. (See #543.) - Fix chunk sizes in
axis_chunks_iterandaxis_chunks_iter_mutwhen the stride is zero or the array element type is zero-sized by @bluss. - Improve documentation by @jturner314, @bluss, and @paulkernfeld.
- Improve element iterators with implementations of
Iterator::rfold. - Miscellaneous internal implementation improvements by @jturner314 and @bluss.
- Add
var_axismethod for computing variance by @LukeMathWalker. - Add
map_mutandmap_axis_mutmethods (mutable variants ofmapandmap_axis) by @LukeMathWalker. - Add support for 128-bit integer scalars (
i128andu128). - Add support for slicing with inclusive ranges (
start..=endand..=end). - Relax constraint on closure from
FntoFnMutformapv,mapv_into,map_inplaceandmapv_inplace. - Implement
TrustedIteratorforIterMut. - Bump
num-traitsandnum-complexto version0.2. - Bump
blas-srcto version0.2. - Bump minimum required Rust version to 1.27.
- Additional contributors to this release: @ExpHP, @jturner314, @alexbool, @messense, @danmack, @nbro
- New documentation; @jturner314 has written a large “ndarray for NumPy users” document, which we include in rustdoc. Read it here a useful quick guide for any user, and in particular if you are familiar with numpy.
- Add
ArcArray.RcArrayhas becomeArcArray; it is now using thread safe reference counting just likeArc; this means that shared ownership arrays are nowSend/Syncif the corresponding element type is `Send- Sync`.
- Add array method
.permute_axes()by @jturner314 - Add array constructor
Array::onesby @ehsanmok - Add the method
.reborrow()toArrayView/Mut, which can be used to shorten the lifetime of an array view; in a reference-like type this normally happens implicitly but for technical reasons the views have an invariant lifetime parameter. - Fix an issue with type inference, the dimensionality of an array should not infer correctly in more cases when using slicing. By @jturner314.
- Dimension types (
Ix1, Ix2, .., IxDyn) now implementHashby @jturner314 - Blas integration can now use gemv for matrix-vector multiplication also when the matrix is f-order by @maciejkula
- Encapsulated
unsafecode blocks in thes![]macro are now exempted from theunsafe_codelint by @jturner314
-
Allow combined slicing and subviews in a single operation by @jturner314 and @bluss
- Add support for individual indices (to indicate subviews) to the
s![]macro, and change the return type to&SliceInfo<[SliceOrIndex; n], Do>. - Change the argument type of the slicing methods to correspond to the new
s![]macro. - Replace the
Sitype withSliceOrIndex. - Add a new
Slicetype that is similar to the oldSitype.
- Add support for individual indices (to indicate subviews) to the
-
Add support for more index types (e.g.
usize) to thes![]macro by @jturner314 -
Rename
.islice()to.slice_inplace()by @jturner314 -
Rename
.isubview()to.subview_inplace()by @jturner314 -
Add
.slice_move(),.slice_axis(),.slice_axis_mut(), and.slice_axis_inplace()methods by @jturner314 -
Add
Dimension::NDIMassociated constant by @jturner314 -
Change trait bounds for arithmetic ops between an array (by value) and a reference to an array or array view (“array1 (op) &array2”); before, an
ArrayViewMutwas supported on the left hand side, now, the left hand side must not be a view. (#380) by @jturner314 -
Remove deprecated methods (
.whole_chunks(),.whole_chunks_mut(),.sum(), and.mean(); replaced by.exact_chunks(),.exact_chunks_mut(),.sum_axis(), and.mean_axis(), respectively) by @bluss -
Updated to the latest blas (optional) dependencies. See instructions in the README.
-
Minimum required Rust version is 1.22.
-
0.10.13
- Add an extension trait for longer-life indexing methods for array views
(
IndexLonger) by @termoshtt and @bluss - The
a.dot(b)method now supports a vector times matrix multiplication by @jturner314 - More general
.into_owned()method by @jturner314
- Add an extension trait for longer-life indexing methods for array views
(
-
0.10.12
- Implement serde serialization for
IxDyn, so that arrays and array views using it are serializable as well.
- Implement serde serialization for
-
0.10.11
- Add method
.uswap(a, b)for unchecked swap by @jturner314 - Bump private dependencies (itertools 0.7)
- Add method
-
0.10.10
- Fix crash with zero size arrays in the fallback matrix multiplication code (#365) by @jturner314
-
0.10.9
- Fix crash in
Array::from_shape_fnwhen creating an f-order array with zero elements (#361) by @jturner314
- Fix crash in
-
0.10.8
- Add method
.insert_axis()to arrays and array views by @jturner314
- Add method
-
0.10.7
- Add method
.is_empty()to arrays and array views by @iamed2 - Support optional trailing commas in the
array![]macro by Alex Burka - Added an example of permuting/sorting along an axis to the sources
- Add method
-
0.10.6
- Tweak the implementation for (bounds checked) indexing of arrays ([] operator). The new code will have the optimizer elide the bounds checks in more situations.
-
0.10.5
- Add method
.into_dimensionality::<D>()for dimensionality conversion (FromIxDynto fixed size and back). - New names
.sum_axisand.mean_axisfor sum and mean functions. Old names deprecated to make room for scalar-returning methods, making a proper convention. - Fix deserialization using ron (#345) by @Libbum
- Add method
-
0.10.4
- Fix unused mut warnings in
azip!()macro - Fix bug #340 by @lloydmeta; uses blas gemm for more memory layouts of column matrices. Only relevant if using blas.
- Fix unused mut warnings in
-
0.10.3
- Fix docs.rs doc build
-
0.10.2
- Support trailing commas in the
s![]macro - Some documentation improvements for the introduction, for
azip!()and other places. - Added two more examples in the source
- Support trailing commas in the
-
0.10.1
- Add method
.into_dyn()to convert to a dynamic dimensionality array or array view. By @bobogei81123 - Edit docs for the fact that type alias pages now show methods.
See the doc pages for
ArrayandArrayViewand the other aliases. - Edit docs for
Zip
- Add method
-
0.10.0
- Upgrade to Serde 1.0. Crate feature name is
serde-1. - Require Rust 1.18. The
pub(crate)feature is that important.
- Upgrade to Serde 1.0. Crate feature name is
-
0.9.1
- Fix
Array::from_shape_fnto give correct indices for f-order shapes - Fix
Array::from_shape_fnto panic correctly on shape size overflow
- Fix
-
0.9.0 Release Announcement
- Add
Zip::indexed - New methods
genrows/_mut, gencolumns/_mut, lanes/_mutthat return iterable producers (producer meansZipcompatible). - New method
.windows()by @Robbepop, returns an iterable producer - New function
general_mat_vec_mul(with fast default and blas acceleration) Zip::applyandfold_whilenow takeselfas the first argumentindices/_ofnow return iterable producers (not iterator)- No allocation for short
IxDyn. - Remove
Ix, Ixsfrom the prelude - Remove deprecated
Axis::axismethod (use.index()) - Rename
.whole_chunksto.exact_chunks. - Remove
.inner 6B28 _iterin favour of the new.genrows()method. - Iterators and similar structs are now scoped under
ndarray::iter IntoNdProducernow has theItemassociated type- Owned array storage types are now encapsulated in newtypes
FoldWhilegot the methodis_done.- Arrays now implement formatting trait
Binaryif elements do - Internal changes.
NdProducergeneralized.Dimensiongets theSmallertype parameter. Internal traits have the private marker now. #(alternate) in formatting does nothing now.- Require Rust 1.15
- Add
-
0.8.4
- Use
Zipin.all_close()(performance improvement) - Use
#[inline]on a function used for higher dimensional checked indexing (performance improvement for arrays of ndim >= 3) .subview()has a more elaborate panic message
- Use
-
0.8.3
- Fix a bug in
Zip/NdProducerif an array of at least 3 dimensions was contig but not c- nor f-contig. WholeChunksIter/Mutnow implSend/Syncas appropriate- Misc cleanup and using dimension-reducing versions of inner_iter
internally. Remove a special case in
zip_mut_withthat only made it slower (1D not-contig arrays).
- Fix a bug in
-
0.8.2
- Add more documentation and an example for dynamic dimensions: see
IxDyn.IxDynwill have a representation change next incompatible version. Use it as a type alias for best forward compatibility. - Add iterable and producer
.whole_chunks_mut(size). - Fix a bug in
whole_chunks: it didn't check the dimensionality of the requested chunk size properly (anIxDyn-only bug). - Improve performance of
zip_mut_with(and thus all binary operators) for block slices of row major arrays. AxisChunksItercreation sped up and it implementsClone.- Dimension mismatch in
Ziphas a better panic message.
- Add more documentation and an example for dynamic dimensions: see
-
0.8.1
-
Add
Zipand macroazip!()which implement lock step function application across elements from one up to six arrays (or in general producers)- Apart from array views, axis iterators and the whole chunks iterable are also producers
-
Add constructor
Array::uninitialized -
Add iterable and producer
.whole_chunks(size) -
Implement a prettier
DebugforSi. -
Fix
Array::defaultso that it panics as documented if the size of the array would wrap around integer type limits. -
Output more verbose panics for errors when slicing arrays (only in debug mode).
-
-
0.8.0
- Update serde dependency to 0.9
- Remove deprecated type alias
OwnedArray(useArray) - Remove deprecated
.assign_scalar()(usefill)
-
0.7.3
- Add macro
array![]for creating one-, two-, or three-dimensional arrays (with ownership semantics likevec![]) Arraynow implementsClone::clone_from()specifically, so that its allocation is (possibly) reused.- Add
.to_vec()for one-dimensional arrays - Add
RcArray::into_owned(self) -> Array. - Add crate categories
- Add macro
-
0.7.2
- Add array methods
.remove_axis(),.merge_axes()and.invert_axis() - Rename
Axis’ accessoraxistoindex, old name is deprecated.
- Add array methods
-
0.7.1
- Fix two bugs in
Array::clone(); it did not support zero-size elements like(), and for some negatively strided arrays it did not update the first element offset correctly. - Add
.axes()which is an iterator over the axes of an array, yielding its index, length and stride. - Add method
.max_stride_axis().
- Fix two bugs in
-
0.6.10
- Fix two bugs in
Array::clone(); it did not support zero-size elements like(), and for some negatively strided arrays it did not update the first element offset correctly.
- Fix two bugs in
-
0.7.0
- Big overhaul of dimensions: Add type
Dimwith aliasesIx1, Ix2, Ix3, ...etc for specific dimensionalities. Instead ofIxfor dimension useIx1, instead of(Ix, Ix)useIx2, and so on. - The dimension type
Dimsupports indexing and arithmetic. SeeDimensiontrait for new methods and inherited traits. - Constructors and methods that take tuples for array sizes, like
Array::zeros,Array::from_shape_vec,.into_shape()and so on will continue to work with tuples. - The array method
.raw_dim()returns the shape descriptionDas it is..dim()continues to return the dimension as a tuple. - Renamed iterators for consistency (each iterator is named for the
method that creates it, for example
.iter()returnsIter). - The index iterator is now created with free functions
indicesorindices_of. - Expanded the
ndarray::preludemodule with the dimensionality-specific type aliases, and some other items LinalgScalarand related features no longer need to useAnyfor static type dispatch.- Serialization with
serdenow supports binary encoders like bincode and others. .assign_scalar()was deprecated and replaced by.fill(), which takes an element by value.- Require Rust 1.13
- Big overhaul of dimensions: Add type
-
0.6.9
- Implement
ExactSizeIteratorfor the indexed iterators
- Implement
-
0.6.8
- Fix a bug in a partially consumed elements iterator's
.fold(). (Note that users are recommended to not use the elements iterator, but the higher level functions which are the maps, folds and other methods of the array types themselves.)
- Fix a bug in a partially consumed elements iterator's
-
0.6.7
- Improve performance of a lot of basic operations for arrays where
the innermost dimension is not contiguous (
.fold(), .map(), .to_owned(), arithmetic operations with scalars). - Require Rust 1.11
- Improve performance of a lot of basic operations for arrays where
the innermost dimension is not contiguous (
-
0.6.6
- Add dimensionality specific type aliases:
Array0, Array1, Array2, ...and so on (there are many), alsoIx0, Ix1, Ix2, .... - Add constructor
Array::from_shape_fn(D, |D| -> A). - Improve performance of
Array::default, and.fold()for noncontiguous array iterators.
- Add dimensionality specific type aliases:
-
0.6.5
- Add method
.into_raw_vec()to turn anArrayinto the its underlying element storage vector, in whatever element order it is using.
- Add method
-
0.6.4
- Add method
.map_axis()which is used to flatten an array along one axis by mapping it to a scalar.
- Add method
-
0.6.3
- Work around compilation issues in nightly (issue #217)
- Add
Defaultimplementations for owned arrays
-
0.6.2
- Add serialization support for serde 0.8, under the crate feature name
serde
- Add serialization support for serde 0.8, under the crate feature name
-
0.6.1
- Add
unsafearray view constructorsArrayView::from_shape_ptrfor read-only and read-write array views. These make it easier to create views from raw pointers.
- Add
-
0.6.0
- Rename
OwnedArraytoArray. The old name is deprecated. - Remove deprecated constructor methods. Use zeros, from_elem, from_shape_vec or from_shape_vec_unchecked instead.
- Remove deprecated in place arithmetic methods like iadd et.c. Use += et.c. instead.
- Remove deprecated method mat_mul, use dot instead.
- Require Rust 1.9
- Rename
-
0.5.2
- Use num-traits, num-complex instead of num.
-
0.5.1
- Fix theoretical well-formedness issue with Data trait
-
0.5.0
- Require Rust 1.8 and enable +=, -=, and the other assign operators.
All
iadd, iadd_scalarand similar methods are now deprecated. - ndarray now has a prelude:
use ndarray::prelude::*;. - Constructors from_elem, zeros, from_shape_vec now all support passing a custom memory layout. A lot of specific constructors were deprecated.
- Add method
.select(Axis, &[Ix]) -> OwnedArray, to create an array from a non-contiguous pick of subviews along an axis. - Rename
.mat_mul()to just.dot()and add a functiongeneral_mat_mulfor matrix multiplication with scaling into an existing array. - Change .fold() to use arbitrary order.
- See below for more details
- Require Rust 1.8 and enable +=, -=, and the other assign operators.
All
-
0.5.0-alpha.2
- Fix a namespace bug in the stack![] macro.
- Add method .select() that can pick an arbitrary set of rows (for example) into a new array.
-
0.4.9
- Fix a namespace bug in the stack![] macro.
- Add deprecation messages to .iadd() and similar methods (use += instead).
-
0.5.0-alpha.1
- Add .swap(i, j) for swapping two elements
- Add a prelude module
use ndarray::prelude::*; - Add ndarray::linalg::general_mat_mul which computes C ← α A B + β C, i.e matrix multiplication into an existing array, with optional scaling.
- Add .fold_axis(Axis, folder)
- Implement .into_shape() for f-order arrays
-
0.5.0-alpha.0
- Requires Rust 1.8. Compound assignment operators are now enabled by default.
- Rename
.mat_mul()to.dot(). The same method name now handles dot product and matrix multiplication. - Remove deprecated items: raw_data, raw_data_mut, allclose, zeros, Array. Docs for 0.4. lists the replacements.
- Remove deprecated crate features: rblas, assign_ops
- A few consuming arithmetic ops with ArrayViewMut were removed (this was missed in the last version).
- Change .fold() to use arbitrary order. Its specification and implementation has changed, to pick the most appropriate element traversal order depending on memory layout.
-
0.4.8
- Fix an error in
.dot()when using BLAS and arrays with negative stride.
- Fix an error in
-
0.4.7
- Add dependency matrixmultiply to handle matrix multiplication for floating point elements. It supports matrices of general stride and is a great improvement for performance. See PR #175.
-
0.4.6
- Fix bug with crate feature blas; it would not compute matrix multiplication correctly for arrays with negative or zero stride.
- Update blas-sys version (optional dependency).
-
0.4.5
- Add
.all_close()which replaces the now deprecated.allclose(). The new method has a stricter protocol: it panics if the array shapes are not compatible. We don't want errors to pass silently. - Add a new illustration to the doc for
.axis_iter(). - Rename
OuterIter, OuterIterMuttoAxisIter, AxisIterMut. The old name is now deprecated.
- Add
-
0.4.4
- Add mapping methods
.mapv(), .mapv_into(), .map_inplace(),.mapv_inplace(), .visit(). Themapvversions have the transformation function receive the element by value (hence v). - Add method
.scaled_add()(a.k.a axpy) and constructorfrom_vec_dim_f. - Add 2d array methods
.rows(), .cols(). - Deprecate method
.fold()because it dictates a specific visit order.
- Add mapping methods
-
0.4.3
- Add array method
.t()as a shorthand to create a transposed view. - Fix
mat_mulso that it accepts arguments of different array kind - Fix a bug in
mat_mulwhen using BLAS and multiplying with a column matrix (#154)
- Add array method
-
0.4.2
- Add new BLAS integration used by matrix multiplication
(selected with crate feature
blas). Uses pluggable backend. - Deprecate module
ndarray::blasand crate featurerblas. This module was moved to the cratendarray-rblas. - Add array methods
as_slice_memory_order, as_slice_memory_order_mut, as_ptr, as_mut_ptr. - Deprecate
raw_data, raw_data_mut. - Add
Send + SynctoNdFloat. - Arrays now show shape & stride in their debug formatter.
- Fix a bug where
from_vec_dim_stridedid not accept arrays with unitary axes. - Performance improvements for contiguous arrays in non-c order when using
methods
to_owned, map, scalar_sum, assign_scalar, and arithmetic operations between array and scalar. - Some methods now return arrays in the same memory order of the input
if the input is contiguous:
to_owned, map, mat_mul(matrix multiplication only if both inputs are the same memory order), and arithmetic operations that allocate a new result. - Slight performance improvements in
dot, mat_muldue to more efficient glue code for calling BLAS. - Performance improvements in
.assign_scalar.
- Add new BLAS integration used by matrix multiplication
(selected with crate feature
-
0.4.1
- Mark iterators
Send + Syncwhen possible.
- Mark iterators
-
0.4.0 Release Announcement
- New array splitting via
.split_at(Axis, Ix)and.axis_chunks_iter() - Added traits
NdFloat,AsArrayandFrom for ArrayViewwhich improve generic programming. - Array constructors panic when attempting to create an array whose element
count overflows
usize. (Would be a debug assertion for overflow before.) - Performance improvements for
.map(). - Added
stackand macrostack![axis, arrays..]to concatenate arrays. - Added constructor
OwnedArray::range(start, end, step). - The type alias
Arraywas renamed toRcArray(and the old name deprecated). - Binary operators are not defined when consuming a mutable array view as the left hand side argument anymore.
- Remove methods and items deprecated since 0.3 or earlier; deprecated methods have notes about replacements in 0.3 docs.
- See below for full changelog through alphas.
- New array splitting via
-
0.4.0-alpha.8
- In debug mode, indexing an array out of bounds now has a detailed message about index and shape. (In release mode it does not.)
- Enable assign_ops feature automatically when it is supported (Rust 1.8 beta or later).
- Add trait
NdFloatwhich makes it easy to be generic overf32, f64. - Add
Fromimplementations that convert slices or references to arrays into array views. This replacesfrom_slicefrom a previous alpha. - Add
AsArraytrait, which is simply based on thoseFromimplementations. - Improve
.map()so that it can autovectorize. - Use
Axisargument inRemoveAxistoo. - Require
DataOwnedin the raw data methods. - Merged error types into a single
ShapeError, which uses no allocated data.
-
0.4.0-alpha.7
- Fix too strict lifetime bound in arithmetic operations like
&a @ &b. - Rename trait Scalar to ScalarOperand (and improve its docs).
- Implement <<= and >>= for arrays.
- Fix too strict lifetime bound in arithmetic operations like
-
0.4.0-alpha.6
- All axis arguments must now be wrapped in newtype
Axis. - Add method
.split_at(Axis, Ix)to read-only and read-write array views. - Add constructors
ArrayView{,Mut}::from_sliceand array view methods are now visible in the docs.
- All axis arguments must now be wrapped in newtype
-
0.4.0-alpha.5
- Use new trait
LinalgScalarfor operations where we want type-based specialization. This shrinks the set of types that allow dot product, matrix multiply, mean. - Use BLAS acceleration transparently in
.dot()(this is the first step). - Only OwnedArray and RcArray and not ArrayViewMut can now be used as consumed left hand operand for arithmetic operators. See arithmetic operations docs!
- Remove deprecated module
linalg(it was already mostly empty) - Deprecate free function
zerosin favour of static methodzeros.
- Use new trait
-
0.4.0-alpha.4
- Rename
ArraytoRcArray. Old name is deprecated. - Add methods
OuterIter::split_at,OuterIterMut::split_at - Change
arr0, arr1, arr2, arr3to returnOwnedArray. Addrcarr1, rcarr2, rcarr3that returnRcArray.
- Rename
-
0.4.0-alpha.3
- Improve arithmetic operations where the RHS is a broadcast 0-dimensional array.
- Add read-only and read-write array views to the
rblasintegration. Added methodsAsBlas::{blas_view_checked, blas_view_mut_checked, bv, bvm}. - Use hash_slice in
Hashimpl for arrays.
-
0.4.0-alpha.2
- Add
ArrayBase::reversed_axeswhich transposes an array.
- Add
-
0.4.0-alpha.1
-
Add checked and unchecked constructor methods for creating arrays from a vector and explicit dimension and stride, or with fortran (column major) memory order (marked
f):ArrayBase::from_vec_dim,from_vec_dim_stride,from_vec_dim_stride_unchecked,from_vec_dim_unchecked_f,from_elem_f,zeros_f- View constructors
ArrayView::from_slice_dim_stride,ArrayViewMut::from_slice_dim_stride. - Rename old
ArrayBase::from_vec_dimtofrom_vec_dim_unchecked.
-
Check better for wraparound when computing the number of elements in a shape; this adds error cases that panic in
from_elem,zerosetc, however the new check will only ever panic in cases that would trigger debug assertions for overflow in the previous versions!. -
Add an array chunks iterator
.axis_chunks_iter()and mutable version; it allows traversing the array in for example chunks of n rows at a time. -
Remove methods and items deprecated since 0.3 or earlier; deprecated methods have notes about replacements in 0.3 docs.
-
-
0.3.1
- Add
.row_mut(),.column_mut() - Add
.axis_iter(),.axis_iter_mut()
- Add
-
0.3.0
- Second round of API & consistency update is done
- 0.3.0 highlight: Index type
Ixchanged tousize. - 0.3.0 highlight: Operator overloading for scalar and array arithmetic.
- 0.3.0 highlight: Indexing with
a[[i, j, k]]syntax. - Add
ArrayBase::eye(n) - See below for more info
-
0.3.0-alpha.4
- Shrink array view structs by removing their redundant slice field (see #45).
Changed the definition of the view
typealiases. .mat_mul()and.mat_mul_col()now returnOwnedArray. Use.into_shared()if you need anArray.- impl ExactSizeIterator where possible for iterators.
- impl DoubleEndedIterator for
.outer_iter()(and _mut).
- Shrink array view structs by removing their redundant slice field (see #45).
Changed the definition of the view
-
0.3.0-alpha.3
.subview()changed to return an array view, also addedinto_subview().- Add
.outer_iter()and.outer_iter_mut()for iteration along the greatest axis of the array. Views also implementinto_outer_iter()for “lifetime preserving” iterators.
-
0.3.0-alpha.2
- Improve the strided last dimension case in
zip_mut_withslightly (affects all binary operations). - Add
.row(i), .column(i)for 2D arrays. - Deprecate
.row_iter(), .col_iter(). - Add method
.dot()for computing the dot product between two 1D arrays.
- Improve the strided last dimension case in
-
0.3.0-alpha.1
- Index type
Ixchanged tousize(#9). Gives better iterator codegen and 64-bit size arrays. - Support scalar operands with arithmetic operators.
- Change
.slice()and.diag()to return array views, add.into_diag(). - Add ability to use fixed size arrays for array indexing, enabling syntax
like
a[[i, j]]for indexing. - Add
.ndim()
- Index type
-
0.2.0
- First chapter of API and performance evolution is done \o/
- 0.2.0 highlight: Vectorized (efficient) arithmetic operations
- 0.2.0 highlight: Easier slicing using
s![] - 0.2.0 highlight: Nicer API using views
- 0.2.0 highlight: Bridging to BLAS functions.
- See below for more info
-
0.2.0-alpha.9
- Support strided matrices in
rblasbridge, and fix a bug with non square matrices. - Deprecated all of module
linalg.
- Support strided matrices in
-
0.2.0-alpha.8
- Note: PACKAGE NAME CHANGED TO
ndarray. Having package != crate ran into many quirks of various tools. Changing the package name is easier for everyone involved! - Optimized
scalar_sum()so that it will vectorize for the floating point element case too.
- Note: PACKAGE NAME CHANGED TO
-
0.2.0-alpha.7
-
Optimized arithmetic operations!
- For c-contiguous arrays or arrays with c-contiguous lowest dimension they optimize very well, and can vectorize!
-
Add
.inner_iter(),.inner_iter_mut() -
Add
.fold(),.zip_mut_with() -
Add
.scalar_sum() -
Add example
examples/life.rs
-
-
0.2.0-alpha.6
- Add
#[deprecated]attributes (enabled with new enough nightly) - Add
ArrayBase::linspace, deprecate constructorrange.
- Add
-
0.2.0-alpha.5
- Add
s![...], a slice argument macro. - Add
aview_mut1(),zeros() - Add
.diag_mut()and deprecate.diag_iter_mut(),.sub_iter_mut() - Add
.uget(),.uget_mut()for unchecked indexing and deprecate the old names. - Improve
ArrayBase::from_elem - Removed
SliceRange, replaced byFromimpls forSi.
- Add
-
0.2.0-alpha.4
- Slicing methods like
.slice()now take a fixed size array ofSias the slice description. This allows more type checking to verify that the number of axes is correct. - Add experimental
rblasintegration. - Add
into_shape()which allows reshaping any array or view kind.
- Slicing methods like
-
0.2.0-alpha.3
- Add and edit a lot of documentation
-
0.2.0-alpha.2
- Improve performance for iterators when the array data is in the default memory layout. The iterator then wraps the default slice iterator and loops will autovectorize.
- Remove method
.indexed()on iterators. ChangedIndexedand addedÌndexedMut.< 3271 /li> - Added
.as_slice(), .as_mut_slice() - Support rustc-serialize
-
0.2.0-alpha
-
Alpha release!
-
Introduce
ArrayBase,OwnedArray,ArrayView,ArrayViewMut -
All arithmetic operations should accept any array type
-
Arraycontinues to refer to the default reference counted copy on write array -
Add
.view(),.view_mut(),.to_owned(),.into_shared() -
Add
.slice_mut(),.subview_mut() -
Some operations now return
OwnedArray:.map().sum().mean()
-
Add
get,get_mutto replace the now deprecatedat,at_mut. -
Fix bug in assign_scalar
-
-
0.1.1
- Add Array::default
- Fix bug in raw_data_mut
-
0.1.0
- First release on crates.io
- Starting point for evolution to come