NdArraySequence

interface pública NdArraySequence

Subclasses indiretas conhecidas FastElementSequence <T, U estende NdArray <T>>, SingleElementSequence <T, U estende NdArray <T>>, SlicingElementSequence <T, U estende NdArray <T>> FastElementSequence <T, U estende NdArray <T>> Uma sequência reciclando a mesma instância NdArray ao iterar seus elementos SingleElementSequence <T, U estende NdArray <T>> Uma sequência de um único elemento SlicingElementSequence <T, U estende NdArray <T>> Uma sequência criando uma nova instância NdArray (fatia) para cada elemento de uma iteração

Uma sequência de elementos de uma matriz N-dimensional.

Um NdArraySequence é usado para percorrer um NdArray em uma determinada dimensão e visitar cada um de seus elementos. Por exemplo, dada uma matriz nxm nos eixos [x, y] , os elementos são iterados na seguinte ordem:

x ₀ y ₀ , x ₀ y ₁ , ..., x ₀ y _m-1 , x ₁ y ₀ , x ₁ y ₁ , ..., x _n-1 y _m-1

Métodos Públicos

NdArraySequence abstrato <T>	asfatias () Retorna cada elemento como uma nova fatia.
vazio abstrato	forEachIndexed (BiConsumer<long[], T> consumidor) Visite cada elemento desta iteração e suas respectivas coordenadas.

Métodos herdados

Da interface java.lang.Iterable

vazio abstrato	forEach (Consumidor<? super T> arg0)
Iterador abstrato<T>	iterador ()
divisor abstrato<T>	divisor ()

Métodos Públicos

resumo público NdArraySequence <T> asSlices ()

Retorna cada elemento como uma nova fatia.

Ao contrário das coleções Java convencionais, os elementos de um NdArraySequence são transitórios, ou seja, novas instâncias NdArray são alocadas para cada iteração. Para melhorar o desempenho, a mesma instância pode ser reciclada para visualizar todos os elementos desta sequência, usando um DataBufferWindow .

Porém, em alguns casos, pode ser preferível desabilitar tais otimizações para garantir que cada elemento retornado seja uma nova fatia da matriz original. Por exemplo, se um ou mais elementos visitados devem estar além do escopo da iteração da sequência, asSlices() garante que todos os elementos retornados pela sequência sejam instâncias únicas.

final List<IntNdArray> vectors = new ArrayList<>();
     IntNdArray matrix = NdArrays.ofInts(Shape.of(6, 6));
     ndArray.elements(0).forEach(e -> vectors::add);  // Not safe, as `e` might always be the same recycled instance
     ndArray.elements(0).asSlices().forEach(e -> vectors::add);  // Safe, each `e` is a distinct NdArray instance
 

Devoluções

• uma sequência que retorna cada elemento iterado como uma nova fatia

Veja também

• DataBufferWindow

público abstrato void forEachIndexed (BiConsumer<long[], T> consumidor)

Visite cada elemento desta iteração e suas respectivas coordenadas.

Importante: o método consumidor não deve manter referência às coordenadas, pois elas podem ser mutáveis ​​e reutilizadas durante a iteração para melhorar o desempenho.

Parâmetros

consumidor	método a ser invocado para cada elemento