ByteNdArray

パブリック インターフェイスByteNdArray
既知の間接サブクラス

バイトのNdArray

パブリックメソッド

抽象ByteNdArray
copyTo ( NdArray <バイト> dst)
抽象NdArraySequence < ByteNdArray >
要素(int dimensionIdx)
指定された次元のすべての要素のシーケンスを返します。
抽象ByteNdArray
get (長い...座標)
指定された座標にあるこの配列の N 次元要素を返します。
抽象バイト
getByte (長い...座標)
指定された座標で見つかったスカラーのバイト値を返します。
抽象バイト
getObject (長い...座標)
指定された座標で見つかったスカラーの値を返します。
抽象ByteNdArray
read ( DataBuffer <バイト> dst)
抽象ByteNdArray
抽象NdArraySequence < ByteNdArray >
スカラー()
この配列内のすべてのスカラーのシーケンスを返します。
抽象ByteNdArray
set ( NdArray <Byte> src、long... 座標)
抽象ByteNdArray
setByte (バイト値、long... 座標)
指定された座標で見つかったスカラーのバイト値を割り当てます。
抽象ByteNdArray
setObject (バイト値、長い...座標)
抽象ByteNdArray
スライス(インデックス...インデックス)
1 つ以上の次元を指定されたインデックス セレクターにマッピングすることにより、この配列の多次元ビュー (またはスライス) を作成します。
抽象ByteNdArray
抽象ByteNdArray
write ( DataBuffer <バイト> src)

継承されたメソッド

パブリックメソッド

public abstract ByteNdArray copyTo ( NdArray <Byte> dst)

public abstract NdArraySequence < ByteNdArray >要素(int DimensionsIdx)

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

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

たとえば、 [x, y]軸上のnxm行列の場合、要素は次の順序で反復されます。

x 0 y 0 、 x 0 y 1 、 ...、 x 0 y m-1 、 x 1 y 0 、 x 1 y 1 、 ...、 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);
    });
 }

パラメータ
寸法Idx次元のインデックス
返品
  • NdArrayシーケンス

public abstract ByteNdArray get (long... 座標)

指定された座標にあるこの配列の N 次元要素を返します。

この配列の任意の次元の要素を取得できます。たとえば、座標の数がこの配列の次元数と等しい場合、ランク 0 (スカラー) 配列が返され、その値は `array.getObject()` を呼び出すことで取得できます。

コピーが含まれないため、返された要素に適用される変更はすべて、この配列のデータにも影響します。

このメソッドの呼び出しは、この配列を単一のスカラーでスライスするのと同等でより効率的な方法であることに注意してください。つまり、 array.get(x, y, z)array.slice(at(x), at(y), at(z))

パラメータ
座標アクセスする要素の座標。この配列を返すものはありません
返品
  • このインデックスの要素

public abstract byte getByte (long... 座標)

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

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

ByteNdArray matrix = NdArrays.ofBytes(shape(2, 2));  // matrix rank = 2
  matrix.getByte(0, 1);  // succeeds, returns 0
  matrix.getByte(0);  // throws IllegalRankException

  ByteNdArray scalar = matrix.get(0, 1);  // scalar rank = 0
  scalar.getByte();  // succeeds, returns 0
 

パラメータ
座標解決するスカラーの座標
返品
  • そのスカラーの値
投げる
IndexOutOfBoundsException一部の座標がそれぞれの次元の制限外にある場合
IllegalRankException座標の数がスカラー要素にアクセスするのに十分でない場合

public abstract Byte getObject (long... 座標)

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

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

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);

パラメータ
座標解決するスカラーの座標
返品
  • そのスカラーの値

public abstract ByteNdArray読み取り( DataBuffer <Byte> dst)

public abstract ByteNdArray読み取り( ByteDataBuffer dst)

パブリック抽象NdArraySequence < ByteNdArray >スカラー()

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

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

返品
  • NdArrayシーケンス

public abstract ByteNdArrayセット( NdArray <Byte> src、long... 座標)

public abstract ByteNdArray setByte (バイト値、long... 座標)

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

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

ByteNdArray matrix = NdArrays.ofBytes(shape(2, 2));  // matrix rank = 2
  matrix.setByte(10, 0, 1);  // succeeds
  matrix.setByte(10, 0);  // throws IllegalRankException

  ByteNdArray scalar = matrix.get(0, 1);  // scalar rank = 0
  scalar.setByte(10);  // succeeds
 

パラメータ
価値割り当てる値
座標割り当てるスカラーの座標
返品
  • この配列
投げる
IndexOutOfBoundsException一部の座標がそれぞれの次元の制限外にある場合
IllegalRankException座標の数がスカラー要素にアクセスするのに十分でない場合

public abstract ByteNdArray setObject (バイト値、long... 座標)

public abstract ByteNdArrayスライス(インデックス...インデックス)

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
    });
 }

パラメータ
インデックスこの配列の次元 0 から始まる次元ごとのインデックス セレクター。
返品
  • インデックス選択の結果の要素

パブリック抽象ByteNdArray書き込み( ByteDataBuffer src)

public abstract ByteNdArray write ( DataBuffer <Byte> src)