NdArray

Salin konten array ini ke array tujuan.

shape() array tujuan harus sama dengan bentuk array ini, atau pengecualian akan dilemparkan. Setelah penyalinan, konten kedua array dapat diubah secara independen, tanpa mempengaruhi satu sama lain.

Mengembalikan urutan semua elemen pada dimensi tertentu.

Logikanya, array berdimensi-N dapat diratakan dalam satu vektor, dengan skalar elemen ke- (n - 1) mendahului skalar elemen ke- (n) , dengan total nilai size() .

Misalnya, matriks nxm pada sumbu [x, y] , elemen diiterasi dalam urutan berikut:

x ₀ kamu ₀ , x ₀ kamu ₁ , ..., x ₀ kamu _{m-1 ,} x ₁ kamu 0 , x ₁ kamu ₁ , ..., x _n-1 kamu _m-1

Urutan yang dikembalikan kemudian dapat diulang untuk mengunjungi setiap elemen, baik dengan memanggil forEach(Consumer) atau 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);
    });
 }

Memeriksa kesetaraan antara array n-dimensi.

Sebuah array sama dengan objek lain jika objek tersebut adalah NdArray lain dengan bentuk, tipe, dan elemen yang sama serta dalam urutan yang sama. Misalnya:

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
 }

Perhatikan bahwa komputasi yang diperlukan untuk memverifikasi kesetaraan antara dua larik bisa jadi mahal dalam beberapa kasus dan oleh karena itu, disarankan untuk tidak menggunakan metode ini di jalur kritis yang mengutamakan performa.

Mengembalikan elemen berdimensi N dari larik ini pada koordinat yang ditentukan.

Elemen dari dimensi mana pun dari array ini dapat diambil. Misalnya, jika jumlah koordinat sama dengan jumlah dimensi array ini, maka array peringkat-0 (skalar) dikembalikan, yang nilainya kemudian dapat diperoleh dengan memanggil `array.getObject()`.

Setiap perubahan yang diterapkan pada elemen yang dikembalikan juga akan memengaruhi data array ini, karena tidak ada salinan yang terlibat.

Perhatikan bahwa menjalankan metode ini adalah cara yang setara dan lebih efisien untuk mengiris array ini pada skalar tunggal, yaitu array.get(x, y, z) sama dengan array.slice(at(x), at(y), at(z))

Mengembalikan nilai skalar yang ditemukan pada koordinat tertentu.

Untuk mengakses elemen skalar, jumlah koordinat yang diberikan harus sama dengan jumlah dimensi array ini (yaitu peringkatnya). Misalnya:

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
 

Baca konten array N-dimensi ini ke dalam buffer tujuan.

Ukuran buffer harus sama atau lebih besar dengan size() array ini, atau pengecualian akan dilemparkan. Setelah penyalinan, konten buffer dan array dapat diubah secara independen, tanpa mempengaruhi satu sama lain.

Mengembalikan urutan semua skalar dalam larik ini.

Ini setara dengan elements(shape().numDimensions() - 1)

Menetapkan nilai elemen berdimensi N yang ditemukan pada koordinat tertentu.

Jumlah koordinat yang diberikan bisa berkisar antara 0 hingga pangkat - 1. Contoh:

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
 

Menetapkan nilai skalar yang ditemukan pada koordinat yang diberikan.

Untuk mengakses elemen skalar, jumlah koordinat yang diberikan harus sama dengan jumlah dimensi array ini (yaitu peringkatnya). Misalnya:

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
 

Membuat tampilan (atau potongan) multidimensi dari larik ini dengan memetakan satu atau lebih dimensi ke pemilih indeks tertentu.

Irisan memungkinkan untuk melintasi array berdimensi N di salah satu sumbunya dan/atau memfilter hanya elemen yang diinginkan. Misalnya, untuk matriks tertentu pada sumbu [x, y] , dimungkinkan untuk melakukan iterasi elemen pada y=0 untuk semua x .

Perubahan apa pun yang diterapkan pada potongan yang dikembalikan akan memengaruhi data larik ini juga, karena tidak ada penyalinan yang terlibat.

Contoh penggunaan:

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

Tulis konten array N-dimensi ini dari buffer sumber.

Ukuran buffer harus sama atau lebih besar dengan size() array ini, atau pengecualian akan dilemparkan. Setelah penyalinan, konten buffer dan array dapat diubah secara independen, tanpa mempengaruhi satu sama lain.