LongNdArray

Belirli bir boyuttaki tüm öğelerin sırasını döndürür.

Mantıksal olarak, N boyutlu dizi, toplam size() değerleri için (n - 1) 'inci elemanın skalerlerinin (n) 'inci elemanın skalerlerinden önce geldiği tek bir vektörde düzleştirilebilir.

Örneğin, [x, y] eksenlerinde bir nxm matrisi verildiğinde, öğeler aşağıdaki sırayla yinelenir:

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

Döndürülen dizi daha sonra forEach(Consumer) veya forEachIndexed(BiConsumer) çağrılarak her bir öğeyi ziyaret etmek için yinelenebilir.

// 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);
    });
 }

Verilen koordinatlarda bu dizinin N boyutlu öğesini döndürür.

Bu dizinin herhangi bir boyutunun elemanları alınabilir. Örneğin, koordinat sayısı bu dizinin boyut sayısına eşitse, bu durumda sıra-0 (skaler) bir dizi döndürülür ve bu değer daha sonra 'array.getObject()' çağrılarak elde edilebilir.

Döndürülen öğelere uygulanan herhangi bir değişiklik, herhangi bir kopya olmadığından bu dizinin verilerini de etkiler.

Bu yöntemi çağırmanın, bu diziyi tek bir skalere göre dilimlemenin eşdeğer ve daha etkili bir yolu olduğunu unutmayın; yani array.get(x, y, z) array.slice(at(x), at(y), at(z)) değerine eşittir. array.slice(at(x), at(y), at(z))

Verilen koordinatlarda bulunan skalerin uzun değerini döndürür.

Skaler öğeye erişmek için sağlanan koordinatların sayısı bu dizinin boyut sayısına (yani sırasına) eşit olmalıdır. Örneğin:

LongNdArray matrix = NdArrays.ofLongs(shape(2, 2));  // matrix rank = 2
  matrix.getLong(0, 1);  // succeeds, returns 0L
  matrix.getLong(0);  // throws IllegalRankException

  LongNdArray scalar = matrix.get(0, 1);  // scalar rank = 0
  scalar.getLong();  // succeeds, returns 0L
 

Verilen koordinatlarda bulunan skalerin değerini döndürür.

Skaler öğeye erişmek için sağlanan koordinatların sayısı bu dizinin boyut sayısına (yani sırasına) eşit olmalıdır. Örneğin:

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
 

Bu dizideki tüm skalerlerin sırasını döndürür.

Bu elements(shape().numDimensions() - 1) çağrısına eşdeğerdir.

Verilen koordinatlarda bulunan skalerin uzun değerini atar.

Skaler öğeye erişmek için sağlanan koordinatların sayısı bu dizinin boyut sayısına (yani sırasına) eşit olmalıdır. Örneğin:

LongNdArray matrix = NdArrays.ofLongs(shape(2, 2));  // matrix rank = 2
  matrix.setLong(10L, 0, 1);  // succeeds
  matrix.setLong(10L, 0);  // throws IllegalRankException

  LongNdArray scalar = matrix.get(0, 1);  // scalar rank = 0
  scalar.setLong(10L);  // succeeds
 

Bir veya daha fazla boyutu verilen dizin seçicilerle eşleyerek bu dizinin çok boyutlu bir görünümünü (veya dilimini) oluşturur.

Dilimler, N boyutlu bir diziyi herhangi bir eksende hareket ettirmeye ve/veya yalnızca ilgilenilen öğeleri filtrelemeye olanak tanır. Örneğin, [x, y] eksenlerindeki belirli bir matris için, tüm x değerleri için öğeleri y=0 yinelemek mümkündür.

Döndürülen dilime uygulanan herhangi bir değişiklik, herhangi bir kopya olmadığından bu dizinin verilerini de etkiler.

Kullanım örneği:

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
    });
 }