NdArray

محتوای این آرایه را در آرایه مقصد کپی کنید.

shape() آرایه مقصد باید با شکل این آرایه برابر باشد، در غیر این صورت استثنا ایجاد می شود. پس از کپی، محتوای هر دو آرایه را می توان به طور مستقل تغییر داد، بدون اینکه بر یکدیگر تأثیر بگذارند.

دنباله ای از همه عناصر را در یک بعد معین برمی گرداند.

به طور منطقی، آرایه بعدی N را می توان در یک بردار واحد مسطح کرد، جایی که اسکالرهای عنصر (n - 1) قبل از عنصر (n) ام، برای کل مقادیر 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 بعدی را بررسی می کند.

یک آرایه با شی دیگری برابر است اگر این شی 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() این آرایه باشد، در غیر این صورت یک استثنا ایجاد می شود. پس از کپی، محتوای بافر و آرایه را می توان به طور مستقل تغییر داد، بدون اینکه بر یکدیگر تأثیر بگذارند.