LongNdArray

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

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ị dài 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ụ:

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
 

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
 

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ị dài 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ụ:

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
 

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