NdArray

Bu dizinin içeriğini hedef diziye kopyalayın.

Hedef dizinin shape() bu dizinin şekline eşit olmalıdır, aksi takdirde bir istisna atılır. Kopyalamanın ardından her iki dizinin içeriği birbirini etkilemeden bağımsız olarak değiştirilebilir.

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

N boyutlu diziler arasındaki eşitliği kontrol eder.

Bir dizi, başka bir nesneye eşitse, bu nesne aynı şekil, türde başka bir NdArray ise ve öğeler eşit ve aynı sıradaysa. Örneğin:

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
 }

İki dizi arasındaki eşitliği doğrulamak için gereken hesaplamanın bazı durumlarda pahalı olabileceğini ve bu nedenle performansın önemli olduğu kritik bir yolda bu yöntemin kullanılmaması önerildiğini unutmayın.

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 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 N boyutlu dizinin içeriğini hedef ara belleğe okuyun.

Tamponun boyutu bu dizinin size size() eşit veya daha büyük olmalıdır, aksi takdirde bir istisna atılır. Kopyalamanın ardından ara belleğin ve dizinin içeriği, birbirini etkilemeden bağımsız olarak değiştirilebilir.

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 N boyutlu öğenin değerini atar.

Sağlanan koordinatların sayısı 0 ile sıra - 1 arasında herhangi bir yerde olabilir. Örneğin:

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
 

Verilen koordinatlarda bulunan skalerin 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:

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
 

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

Bu N boyutlu dizinin içeriğini kaynak arabelleğinden yazın.

Tamponun boyutu bu dizinin size size() eşit veya daha büyük olmalıdır, aksi takdirde bir istisna atılır. Kopyalamanın ardından ara belleğin ve dizinin içeriği birbirini etkilemeden bağımsız olarak değiştirilebilir.