IntNdArray

الواجهة العامة IntNdArray
الفئات الفرعية غير المباشرة المعروفة

NdArray من الأعداد الصحيحة.

الأساليب العامة

مجردة IntNdArray
CopyTo ( NdArray <Integer> dst)
ملخص NdArraySequence <IntNdArray>
العناصر (int DimensionIdx)
إرجاع تسلسل لجميع العناصر في بعد معين.
مجردة IntNdArray
الحصول على (طويلة... الإحداثيات)
تُرجع العنصر N-الأبعاد لهذه المصفوفة عند الإحداثيات المحددة.
كثافة العمليات مجردة
getInt (الإحداثيات الطويلة)
تُرجع القيمة الصحيحة للعددية الموجودة في الإحداثيات المحددة.
عدد صحيح مجردة
getObject (إحداثيات طويلة)
إرجاع قيمة العددية الموجودة في الإحداثيات المحددة.
مجردة IntNdArray
IntNdArray مجردة
قراءة ( DataBuffer <Integer> dst)
ملخص NdArraySequence <IntNdArray>
العددية ()
إرجاع تسلسل لجميع الكميات الموجودة في هذه المصفوفة.
IntNdArray مجردة
تعيين ( NdArray <Integer> src، إحداثيات طويلة ...)
IntNdArray مجردة
setInt (قيمة int، إحداثيات طويلة)
يعين القيمة الصحيحة للعددية الموجودة في الإحداثيات المحددة.
IntNdArray مجردة
setObject (قيمة عددية، إحداثيات طويلة)
مجردة IntNdArray
شريحة ( فهرس... فهارس)
ينشئ عرضًا (أو شريحة) متعدد الأبعاد لهذه المصفوفة عن طريق تعيين بُعد واحد أو أكثر لمحددات الفهرس المحددة.
مجردة IntNdArray
الكتابة ( DataBuffer <Integer> src)
IntNdArray مجردة

الطرق الموروثة

الأساليب العامة

الملخص العام IntNdArray CopyTo ( NdArray <Integer> dst)

ملخص عام NdArraySequence <IntNdArray> العناصر (int DimensionIdx)

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

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

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

س 0 ص 0 , س 0 ص 1 , ..., س 0 ص م-1 , س 1 ذ 0 , س 1 ذ 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);
    });
 }

حدود
DimensionIdx مؤشر البعد
المرتجعات
  • تسلسل NdArray

الحصول على الملخص العام IntNdArray (الإحداثيات الطويلة)

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

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

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

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

حدود
الإحداثيات إحداثيات العنصر المراد الوصول إليه، لن يقوم أي منها بإرجاع هذه المصفوفة
المرتجعات
  • العنصر في هذا الفهرس

الملخص العام int getInt (الإحداثيات الطويلة)

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

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

IntNdArray matrix = NdArrays.ofInts(shape(2, 2));  // matrix rank = 2
  matrix.getInt(0, 1);  // succeeds, returns 0
  matrix.getInt(0);  // throws IllegalRankException

  IntNdArray scalar = matrix.get(0, 1);  // scalar rank = 0
  scalar.getInt();  // succeeds, returns 0
 

حدود
الإحداثيات إحداثيات العددية لحلها
المرتجعات
  • قيمة تلك العددية
رميات
IndexOutOfBoundsException إذا كانت بعض الإحداثيات خارج حدود البعد الخاص بها
IllegalRankException إذا كان عدد الإحداثيات غير كاف للوصول إلى عنصر عددي

getObject عدد صحيح مجردة عامة (إحداثيات طويلة)

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

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

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
 
ملاحظة: إذا كانت هذه المصفوفة تخزن قيمًا من النوع البدائي، فيفضل استخدام الطريقة المتخصصة في الفئة الفرعية لذلك النوع. على سبيل المثال، floatArray.getFloat(0); .

حدود
الإحداثيات إحداثيات العددية لحلها
المرتجعات
  • قيمة تلك العددية

قراءة IntNdArray الملخص العام ( IntDataBuffer dst)

قراءة IntNdArray الملخص العام ( DataBuffer <Integer> dst)

الملخص العام NdArraySequence <IntNdArray> العدديات ()

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

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

المرتجعات
  • تسلسل NdArray

مجموعة IntNdArray مجردة عامة ( NdArray <Integer> src، إحداثيات طويلة ...)

الملخص العام IntNdArray setInt (قيمة int، إحداثيات طويلة)

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

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

IntNdArray matrix = NdArrays.ofInts(shape(2, 2));  // matrix rank = 2
  matrix.setInt(10, 0, 1);  // succeeds
  matrix.setInt(10, 0);  // throws IllegalRankException

  IntNdArray scalar = matrix.get(0, 1);  // scalar rank = 0
  scalar.setInt(10);  // succeeds
 

حدود
قيمة قيمة لتعيينها
الإحداثيات إحداثيات العددية لتعيين
المرتجعات
  • هذه المصفوفة
رميات
IndexOutOfBoundsException إذا كانت بعض الإحداثيات خارج حدود البعد الخاص بها
IllegalRankException إذا كان عدد الإحداثيات غير كاف للوصول إلى عنصر عددي

الملخص العام IntNdArray setObject (قيمة عددية، إحداثيات طويلة)

شريحة IntNdArray مجردة عامة ( فهرس... مؤشرات)

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

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

حدود
المؤشرات محددات الفهرس لكل أبعاد، بدءًا من البعد 0 لهذه المصفوفة.
المرتجعات
  • العنصر الناتج عن اختيار الفهرس

كتابة IntNdArray الملخص العام ( DataBuffer <Integer> src)

كتابة الملخص العام IntNdArray ( IntDataBuffer src)