NdArray

এই অ্যারের বিষয়বস্তু গন্তব্য অ্যারেতে অনুলিপি করুন।

গন্তব্য অ্যারের shape() অবশ্যই এই অ্যারের আকৃতির সমান হতে হবে, অথবা একটি ব্যতিক্রম নিক্ষেপ করা হবে। অনুলিপি করার পরে, উভয় অ্যারের বিষয়বস্তু একে অপরকে প্রভাবিত না করে স্বাধীনভাবে পরিবর্তন করা যেতে পারে।

একটি প্রদত্ত মাত্রায় সমস্ত উপাদানের একটি ক্রম দেখায়।

যৌক্তিকভাবে, N-মাত্রিক অ্যারে একটি একক ভেক্টরে সমতল করা যেতে পারে, যেখানে (n - 1) তম উপাদানের স্কেলারগুলি (n) তম উপাদানের আগে থাকে, মোট size() মানের জন্য।

উদাহরণস্বরূপ, [x, y] অক্ষগুলিতে একটি nxm ম্যাট্রিক্স দেওয়া হলে, উপাদানগুলিকে নিম্নলিখিত ক্রমে পুনরাবৃত্তি করা হয়:

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-মাত্রিক অ্যারেগুলির মধ্যে সমতা পরীক্ষা করে।

একটি অ্যারে অন্য বস্তুর সমান যদি এই বস্তুটি একই আকৃতির অন্য 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] অক্ষের একটি প্রদত্ত ম্যাট্রিক্সের জন্য, সমস্ত x এর জন্য y=0 এ উপাদানগুলিকে পুনরাবৃত্তি করা সম্ভব।

প্রত্যাবর্তিত স্লাইসে প্রয়োগ করা যেকোনো পরিবর্তন এই অ্যারের ডেটাকেও প্রভাবিত করে, কারণ এতে কোনো অনুলিপি জড়িত নেই।

ব্যবহারের উদাহরণ:

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() এর সমান বা বড় হতে হবে, অথবা একটি ব্যতিক্রম নিক্ষেপ করা হবে। অনুলিপি করার পরে, বাফার এবং অ্যারের বিষয়বস্তু একে অপরকে প্রভাবিত না করে স্বাধীনভাবে পরিবর্তন করা যেতে পারে।