ByteNdArray

ส่งกลับลำดับขององค์ประกอบทั้งหมดในมิติที่กำหนด

ตามหลักเหตุผลแล้ว อาร์เรย์ N มิติสามารถทำให้แบนได้ในเวกเตอร์เดียว โดยที่สเกลาร์ขององค์ประกอบที่ (n - 1) นำหน้าองค์ประกอบที่ (n) ที่องค์ประกอบที่ th สำหรับค่า size()

ตัวอย่างเช่น เมื่อกำหนดเมทริกซ์ nxm บนแกน [x, y] องค์ประกอบจะถูกวนซ้ำตามลำดับต่อไปนี้:

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

ลำดับที่ส่งคืนสามารถวนซ้ำเพื่อเยี่ยมชมแต่ละองค์ประกอบ โดยการเรียก forEach(Consumer) หรือ 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);
    });
 }

ส่งคืนองค์ประกอบมิติ N ของอาร์เรย์นี้ที่พิกัดที่กำหนด

สามารถดึงข้อมูลองค์ประกอบของมิติใดๆ ของอาร์เรย์นี้ได้ ตัวอย่างเช่น หากจำนวนพิกัดเท่ากับจำนวนขนาดของอาร์เรย์นี้ อาร์เรย์อันดับ 0 (สเกลาร์) จะถูกส่งกลับ ซึ่งสามารถรับค่านี้ได้โดยการเรียก `array.getObject()`

การเปลี่ยนแปลงใดๆ ที่นำไปใช้กับองค์ประกอบที่ส่งคืนจะส่งผลต่อข้อมูลของอาร์เรย์นี้เช่นกัน เนื่องจากไม่มีการคัดลอกที่เกี่ยวข้อง

โปรดทราบว่าการใช้วิธีนี้เป็นวิธีที่เทียบเท่าและมีประสิทธิภาพมากกว่าในการแบ่งอาร์เรย์นี้เป็นสเกลาร์เดี่ยว เช่น array.get(x, y, z) เท่ากับ array.slice(at(x), at(y), at(z))

ส่งกลับค่าไบต์ของสเกลาร์ที่พบในพิกัดที่กำหนด

ในการเข้าถึงองค์ประกอบสเกลาร์ จำนวนพิกัดที่ระบุจะต้องเท่ากับจำนวนขนาดของอาร์เรย์นี้ (เช่น อันดับ) ตัวอย่างเช่น:

ByteNdArray matrix = NdArrays.ofBytes(shape(2, 2));  // matrix rank = 2
  matrix.getByte(0, 1);  // succeeds, returns 0
  matrix.getByte(0);  // throws IllegalRankException

  ByteNdArray scalar = matrix.get(0, 1);  // scalar rank = 0
  scalar.getByte();  // succeeds, returns 0
 

ส่งกลับค่าของสเกลาร์ที่พบในพิกัดที่กำหนด

ในการเข้าถึงองค์ประกอบสเกลาร์ จำนวนพิกัดที่ระบุจะต้องเท่ากับจำนวนขนาดของอาร์เรย์นี้ (เช่น อันดับ) ตัวอย่างเช่น:

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
 

ส่งกลับลำดับของสเกลาร์ทั้งหมดในอาร์เรย์นี้

ซึ่งเทียบเท่ากับการเรียก elements(shape().numDimensions() - 1)

กำหนดค่าไบต์ของสเกลาร์ที่พบในพิกัดที่กำหนด

ในการเข้าถึงองค์ประกอบสเกลาร์ จำนวนพิกัดที่ระบุจะต้องเท่ากับจำนวนขนาดของอาร์เรย์นี้ (เช่น อันดับ) ตัวอย่างเช่น:

ByteNdArray matrix = NdArrays.ofBytes(shape(2, 2));  // matrix rank = 2
  matrix.setByte(10, 0, 1);  // succeeds
  matrix.setByte(10, 0);  // throws IllegalRankException

  ByteNdArray scalar = matrix.get(0, 1);  // scalar rank = 0
  scalar.setByte(10);  // succeeds
 

สร้างมุมมองหลายมิติ (หรือส่วน) ของอาร์เรย์นี้โดยการแมปมิติหนึ่งหรือหลายมิติกับตัวเลือกดัชนีที่กำหนด

สไลซ์ช่วยให้สามารถสำรวจอาร์เรย์ N มิติในแกนใดๆ ของมัน และ/หรือ เพื่อกรองเฉพาะองค์ประกอบที่สนใจ ตัวอย่างเช่น สำหรับเมทริกซ์ที่กำหนดบนแกน [x, y] เป็นไปได้ที่จะวนซ้ำองค์ประกอบที่ y=0 สำหรับ x ทั้งหมด

การเปลี่ยนแปลงใดๆ ที่นำไปใช้กับส่วนที่ส่งคืนจะส่งผลต่อข้อมูลของอาร์เรย์นี้เช่นกัน เนื่องจากไม่มีการคัดลอกที่เกี่ยวข้อง

ตัวอย่างการใช้งาน:

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