NdArray

Sao chép nội dung của mảng này vào mảng đích.

shape() của mảng đích phải bằng hình dạng của mảng này, nếu không sẽ xảy ra ngoại lệ. Sau khi sao chép, nội dung của cả hai mảng có thể được thay đổi độc lập mà không ảnh hưởng lẫn nhau.

Trả về một chuỗi gồm tất cả các phần tử ở một thứ nguyên nhất định.

Về mặt logic, mảng N chiều có thể được làm phẳng trong một vectơ duy nhất, trong đó các giá trị vô hướng của phần tử thứ (n - 1) đứng trước các giá trị của phần tử thứ (n) , cho tổng giá trị size() .

Ví dụ: cho ma trận nxm trên trục [x, y] , các phần tử được lặp theo thứ tự sau:

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

Sau đó, chuỗi trả về có thể được lặp lại để truy cập từng phần tử, bằng cách gọi forEach(Consumer) hoặc 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);
    });
 }

Kiểm tra sự bằng nhau giữa các mảng n chiều.

Một mảng bằng một đối tượng khác nếu đối tượng này là một NdArray khác có cùng hình dạng, kiểu và các phần tử bằng nhau và theo cùng thứ tự. Ví dụ:

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
 }

Lưu ý rằng việc tính toán cần thiết để xác minh sự bằng nhau giữa hai mảng có thể tốn kém trong một số trường hợp và do đó, bạn không nên sử dụng phương pháp này trong đường dẫn quan trọng nơi hiệu suất đóng vai trò quan trọng.

Trả về phần tử N chiều của mảng này tại tọa độ đã cho.

Các phần tử có kích thước bất kỳ của mảng này đều có thể được truy xuất. Ví dụ: nếu số tọa độ bằng số thứ nguyên của mảng này thì mảng xếp hạng 0 (vô hướng) sẽ được trả về, sau đó có thể nhận được giá trị nào bằng cách gọi `array.getObject()`.

Bất kỳ thay đổi nào được áp dụng cho các phần tử được trả về cũng ảnh hưởng đến dữ liệu của mảng này vì không có bản sao nào liên quan.

Lưu ý rằng việc gọi phương thức này là một cách tương đương và hiệu quả hơn để cắt mảng này theo một vô hướng đơn, tức là array.get(x, y, z) bằng array.slice(at(x), at(y), at(z))

Trả về giá trị của đại lượng vô hướng được tìm thấy tại tọa độ đã cho.

Để truy cập phần tử vô hướng, số tọa độ được cung cấp phải bằng số chiều của mảng này (tức là thứ hạng của nó). Ví dụ:

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
 

Đọc nội dung của mảng N chiều này vào bộ đệm đích.

Kích thước của bộ đệm phải bằng hoặc lớn hơn size() của mảng này, nếu không sẽ xảy ra ngoại lệ. Sau khi sao chép, nội dung của bộ đệm và mảng có thể được thay đổi độc lập mà không ảnh hưởng lẫn nhau.

Trả về một chuỗi tất cả các đại lượng vô hướng trong mảng này.

Điều này tương đương với elements(shape().numDimensions() - 1)

Gán giá trị của phần tử N chiều được tìm thấy tại tọa độ đã cho.

Số tọa độ được cung cấp có thể nằm trong khoảng từ 0 đến hạng - 1. Ví dụ:

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
 

Gán giá trị của đại lượng vô hướng được tìm thấy tại tọa độ đã cho.

Để truy cập phần tử vô hướng, số tọa độ được cung cấp phải bằng số chiều của mảng này (tức là thứ hạng của nó). Ví dụ:

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
 

Tạo chế độ xem đa chiều (hoặc lát) của mảng này bằng cách ánh xạ một hoặc nhiều thứ nguyên tới các bộ chọn chỉ mục đã cho.

Các lát cắt cho phép duyệt qua một mảng N chiều theo bất kỳ trục nào của nó và/hoặc chỉ lọc các phần tử quan tâm. Ví dụ: đối với một ma trận nhất định trên trục [x, y] , có thể lặp lại các phần tử tại y=0 cho tất cả x .

Bất kỳ thay đổi nào được áp dụng cho lát cắt được trả về cũng ảnh hưởng đến dữ liệu của mảng này vì không có bản sao nào liên quan.

Ví dụ về cách sử dụng:

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

Viết nội dung của mảng N chiều này từ bộ đệm nguồn.

Kích thước của bộ đệm phải bằng hoặc lớn hơn size() của mảng này, nếu không sẽ xảy ra ngoại lệ. Sau khi sao chép, nội dung của bộ đệm và mảng có thể được thay đổi độc lập mà không ảnh hưởng lẫn nhau.