NdArray

Copie o conteúdo desta matriz para a matriz de destino.

A shape() da matriz de destino deve ser igual à forma desta matriz, ou uma exceção é lançada. Após a cópia, o conteúdo de ambas as matrizes pode ser alterado de forma independente, sem afetar um ao outro.

Retorna uma sequência de todos os elementos em uma determinada dimensão.

Logicamente, a matriz N-dimensional pode ser achatada em um único vetor, onde os escalares do (n - 1) elemento precede aqueles do (n) elemento, para um total de valores de size() .

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

A sequência retornada pode então ser iterada para visitar cada elemento, chamando forEach(Consumer) ou forEachIndexed(BiConsumer) .

// Iterate matrix for initializing each of its vectors
    matrixOfFloats.elements(0).forEach(v -> {
      v.set(vector(1.0f, 2.0f, 3.0f));
    );

    // Iterate a vector for reading each of its scalar
    vectorOfFloats.scalars().forEachIdx((coords, s) -> {
      System.out.println("Value " + s.getFloat() + " found at " + coords);
    });
 }

Verifica a igualdade entre matrizes n-dimensionais.

Uma matriz é igual a outro objeto se este objeto for outro NdArray da mesma forma, tipo e os elementos forem iguais e na mesma ordem. Por exemplo:

IntNdArray array = NdArrays.ofInts(Shape.of(2, 2))
    .set(NdArrays.vectorOf(1, 2), 0)
    .set(NdArrays.vectorOf(3, 4), 1);

 assertEquals(array, StdArrays.ndCopyOf(new int[][] { {1, 2, {3, 4} }));  // true
 assertEquals(array, StdArrays.ndCopyOf(new Integer[][] { {1, 2}, {3, 4} }));  // true, as Integers are equal to ints
 assertNotEquals(array, NdArrays.vectorOf(1, 2, 3, 4));  // false, different shapes
 assertNotEquals(array, StdArrays.ndCopyOf(new int[][] { {3, 4}, {1, 2} }));  // false, different order
 assertNotEquals(array, StdArrays.ndCopyOf(new long[][] { {1L, 2L}, {3L, 4L} }));  // false, different types
 }

Observe que o cálculo necessário para verificar a igualdade entre duas matrizes pode ser caro em alguns casos e, portanto, é recomendado não usar esse método em um caminho crítico onde o desempenho é importante.

Retorna o elemento N-dimensional desta matriz nas coordenadas fornecidas.

Elementos de qualquer uma das dimensões desta matriz podem ser recuperados. Por exemplo, se o número de coordenadas é igual ao número de dimensões deste array, então um array de classificação 0 (escalar) é retornado, cujo valor pode então ser obtido chamando `array.getObject ()`.

Quaisquer alterações aplicadas aos elementos retornados afetam os dados desta matriz também, pois não há nenhuma cópia envolvida.

Observe que invocar este método é uma forma equivalente e mais eficiente de array.get(x, y, z) este array em um escalar único, ou seja, array.get(x, y, z) é igual a array.slice(at(x), at(y), at(z))

Retorna o valor do escalar encontrado nas coordenadas fornecidas.

Para acessar o elemento escalar, o número de coordenadas fornecidas deve ser igual ao número de dimensões desta matriz (ou seja, sua classificação). Por exemplo:

FloatNdArray matrix = NdArrays.ofFloats(shape(2, 2));  // matrix rank = 2
  matrix.getObject(0, 1);  // succeeds, returns 0.0f
  matrix.getObject(0);  // throws IllegalRankException

  FloatNdArray scalar = matrix.get(0, 1);  // scalar rank = 0
  scalar.getObject();  // succeeds, returns 0.0f
 

Leia o conteúdo deste array N-dimensional no buffer de destino.

O tamanho do buffer deve ser igual ou maior ao size() desta matriz, ou uma exceção é lançada. Após a cópia, o conteúdo do buffer e do array podem ser alterados de forma independente, sem afetar um ao outro.

Retorna uma sequência de todos os escalares nesta matriz.

Isso é equivalente a chamar elements(shape().numDimensions() - 1)

Atribui o valor do elemento N-dimensional encontrado nas coordenadas fornecidas.

O número de coordenadas fornecidas pode estar em qualquer lugar entre 0 e classificação - 1. Por exemplo:

FloatNdArray matrix = NdArrays.ofFloats(shape(2, 2));  // matrix rank = 2
  matrix.set(vector(10.0f, 20.0f), 0);  // success
  matrix.set(scalar(10.0f), 1, 0); // success
 

Atribui o valor do escalar encontrado nas coordenadas fornecidas.

Para acessar o elemento escalar, o número de coordenadas fornecidas deve ser igual ao número de dimensões desta matriz (ou seja, sua classificação). Por exemplo:

FloatNdArray matrix = NdArrays.ofFloats(shape(2, 2));  // matrix rank = 2
  matrix.setObject(10.0f, 0, 1);  // succeeds
  matrix.setObject(10.0f, 0);  // throws IllegalRankException

  FloatNdArray scalar = matrix.get(0, 1);  // scalar rank = 0
  scalar.setObject(10.0f);  // succeeds
 

Cria uma visualização multidimensional (ou fatia) dessa matriz mapeando uma ou mais dimensões para os seletores de índice fornecidos.

As fatias permitem atravessar uma matriz N-dimensional em qualquer um de seus eixos e / ou filtrar apenas os elementos de interesse. Por exemplo, para uma determinada matriz nos eixos [x, y] , é possível iterar os elementos em y=0 para todos os x .

Quaisquer alterações aplicadas à fatia retornada afetam os dados dessa matriz também, pois não há nenhuma cópia envolvida.

Exemplo de uso:

FloatNdArray matrix3d = NdArrays.ofFloats(shape(3, 2, 4));  // with [x, y, z] axes

    // Iterates elements on the x axis by preserving only the 3rd value on the z axis,
    // (i.e. [x, y, 2])
    matrix3d.slice(all(), all(), at(2)).elements(0).forEach(m -> {
      assertEquals(shape(2), m); // y=2, z=0 (scalar)
    );

    // Creates a slice that contains only the last element of the y axis and elements with an
    // odd `z` coordinate.
    FloatNdArray slice = matrix3d.slice(all(), at(1), odd());
    assertEquals(shape(3, 2), slice.shape());  // x=3, y=0 (scalar), z=2 (odd coordinates)

    // Iterates backward the elements on the x axis
    matrix3d.slice(flip()).elements(0).forEach(m -> {
      assertEquals(shape(2, 4), m);  // y=2, z=4
    });
 }

Grave o conteúdo desta matriz N-dimensional do buffer de origem.

O tamanho do buffer deve ser igual ou maior ao size() desta matriz, ou uma exceção é lançada. Após a cópia, o conteúdo do buffer e do array podem ser alterados de forma independente, sem afetar um ao outro.