NdArray

انسخ محتوى هذه المصفوفة إلى المصفوفة الوجهة.

يجب أن يكون shape() مساوياً لشكل هذه المصفوفة، وإلا فسيتم طرح استثناء. بعد النسخ، يمكن تغيير محتوى كلا المصفوفتين بشكل مستقل، دون التأثير على بعضهما البعض.

إرجاع تسلسل لجميع العناصر في بعد معين.

منطقيًا، يمكن تسوية المصفوفة ذات الأبعاد N في متجه واحد، حيث تسبق الكميات القياسية للعنصر (n - 1) تلك الخاصة بالعنصر (n) ، لإجمالي قيم size() .

على سبيل المثال، بالنظر إلى مصفوفة nxm على المحاور [x, y] ، يتم تكرار العناصر بالترتيب التالي:

س ₀ ص ₀ , س ₀ ص ₁ , ..., س ₀ ص _م-1 , س ₁ ص ₀ , س ₁ ذ ₁ , ..., س _ن-1 ص _م-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.

تكون المصفوفة مساوية لكائن آخر إذا كان هذا الكائن عبارة عن NdArray آخر من نفس الشكل والنوع والعناصر متساوية وبنفس الترتيب. على سبيل المثال:

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
 }

لاحظ أن الحساب المطلوب للتحقق من المساواة بين صفيفين يمكن أن يكون مكلفًا في بعض الحالات، وبالتالي، يوصى بعدم استخدام هذه الطريقة في مسار حرج حيث يكون الأداء مهمًا.

تُرجع العنصر N-الأبعاد لهذه المصفوفة عند الإحداثيات المحددة.

يمكن استرجاع عناصر أي من أبعاد هذه المصفوفة. على سبيل المثال، إذا كان عدد الإحداثيات يساوي عدد أبعاد هذه المصفوفة، فسيتم إرجاع مصفوفة من المرتبة 0 (عددية)، ويمكن بعد ذلك الحصول على القيمة عن طريق استدعاء `array.getObject()`.

أي تغييرات يتم تطبيقها على العناصر التي تم إرجاعها تؤثر على بيانات هذه المصفوفة أيضًا، حيث لا توجد نسخة معنية.

لاحظ أن استدعاء هذه الطريقة هو طريقة مكافئة وأكثر فعالية لتقسيم هذه المصفوفة إلى عددية فردية، على سبيل المثال array.get(x, y, z) يساوي array.slice(at(x), at(y), at(z))

إرجاع قيمة العددية الموجودة في الإحداثيات المحددة.

للوصول إلى العنصر العددي، يجب أن يكون عدد الإحداثيات المقدمة مساويًا لعدد أبعاد هذه المصفوفة (أي رتبتها). على سبيل المثال:

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
 

اقرأ محتوى هذه المصفوفة ذات الأبعاد N في المخزن المؤقت للوجهة.

يجب أن يكون حجم المخزن المؤقت مساويا أو أكبر لحجم size() هذا المصفوفة، أو سيتم طرح استثناء. بعد النسخ، يمكن تغيير محتوى المخزن المؤقت والمصفوفة بشكل مستقل، دون التأثير على بعضهما البعض.

إرجاع تسلسل لجميع الكميات الموجودة في هذه المصفوفة.

وهذا يعادل استدعاء elements(shape().numDimensions() - 1)

يعين قيمة العنصر N-الأبعاد الموجود في الإحداثيات المحددة.

يمكن أن يتراوح عدد الإحداثيات المقدمة بين 0 والرتبة - 1. على سبيل المثال:

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
 

يعين قيمة العددية الموجودة في الإحداثيات المحددة.

للوصول إلى العنصر العددي، يجب أن يكون عدد الإحداثيات المقدمة مساويًا لعدد أبعاد هذه المصفوفة (أي رتبتها). على سبيل المثال:

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
 

ينشئ عرضًا (أو شريحة) متعدد الأبعاد لهذه المصفوفة عن طريق تعيين بُعد واحد أو أكثر لمحددات الفهرس المحددة.

تسمح الشرائح باجتياز مصفوفة ذات أبعاد 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
    });
 }

اكتب محتوى هذه المصفوفة ذات الأبعاد N من المخزن المؤقت المصدر.

يجب أن يكون حجم المخزن المؤقت مساويا أو أكبر لحجم size() هذا المصفوفة، أو سيتم طرح استثناء. بعد النسخ، يمكن تغيير محتوى المخزن المؤقت والمصفوفة بشكل مستقل، دون التأثير على بعضهما البعض.