ShortNdArray

指定された次元のすべての要素のシーケンスを返します。

論理的には、N 次元配列は単一のベクトルで平坦化できます。ここで、 size()値の合計については、 (n - 1)番目の要素のスカラーが(n)番目の要素のスカラーよりも前になります。

たとえば、 [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 次元要素を返します。

この配列の任意の次元の要素を取得できます。たとえば、座標の数がこの配列の次元数と等しい場合、ランク 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
 

指定された座標で見つかったスカラーの short 値を返します。

スカラー要素にアクセスするには、指定された座標の数がこの配列の次元数 (つまり、そのランク) と等しくなければなりません。例:

ShortNdArray matrix = NdArrays.ofShorts(shape(2, 2));  // matrix rank = 2
  matrix.getShort(0, 1);  // succeeds, returns 0.0f
  matrix.getShort(0);  // throws IllegalRankException

  ShortNdArray scalar = matrix.get(0, 1);  // scalar rank = 0
  scalar.getShort();  // succeeds, returns 0.0f
 

この配列内のすべてのスカラーのシーケンスを返します。

これは、 elements(shape().numDimensions() - 1)を呼び出すことと同じです。

指定された座標で見つかったスカラーの short 値を割り当てます。

スカラー要素にアクセスするには、指定された座標の数がこの配列の次元数 (つまり、そのランク) と等しくなければなりません。例:

ShortNdArray matrix = NdArrays.ofShorts(shape(2, 2));  // matrix rank = 2
  matrix.setShort(10.0f, 0, 1);  // succeeds
  matrix.setShort(10.0f, 0);  // throws IllegalRankException

  ShortNdArray scalar = matrix.get(0, 1);  // scalar rank = 0
  scalar.setShort(10.0f);  // succeeds
 

1 つ以上の次元を指定されたインデックス セレクターにマッピングすることにより、この配列の多次元ビュー (またはスライス) を作成します。

スライスを使用すると、任意の軸で 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
    });
 }