既知の間接サブクラス |
静的に型指定された多次元配列。
TensorFlow Java には、 typed tensors
とraw tensors
2 つのカテゴリのテンソルがあります。前者はテンソルのネイティブ メモリを n 次元の型付きデータ空間にマップし、JVM からの直接 I/O 操作を可能にしますが、後者はネイティブ テンソルへの参照のみであり、基本的な操作とフラット データ アクセスを可能にします。
警告: Tensor オブジェクトによって消費されるリソースは、オブジェクトが不要になったときにclose()
メソッドを呼び出して明示的に解放する必要があります。たとえば、try-with-resources ブロックを使用すると、次のようになります。
try (Tensor t = Tensor.of(...)) {
doSomethingWith(t);
}
Tensor のインスタンスはスレッドセーフではありません。
パブリックメソッド
抽象的なRawTensor | asRawTensor () このテンソルの生の (型なし) 表現を返します。 |
抽象的な空白 | 近い() Tensor に関連付けられたリソースを解放します。 |
抽象データ型 | |
抽象的な長い | numBytes () テンソル データのサイズをバイト単位で返します。 |
抽象静的 <T extends TType > T | |
抽象静的 <T extends TType > T | |
抽象静的 <T extends TType > T | |
抽象静的 <T extends TType > T | |
抽象静的 <T extends TType > T | |
抽象的な形 | 形() テンソルの形状を返します。 |
継承されたメソッド
パブリックメソッド
パブリック抽象 void close ()
Tensor に関連付けられたリソースを解放します。
警告:これは、eager 操作によって生成されなかったすべての tensor に対して呼び出す必要があります。そうしないと、メモリ リークが発生します。
Tensor オブジェクトは、 close
戻った後は使用できなくなります。
パブリック抽象long numBytes ()
テンソル データのサイズをバイト単位で返します。
public static abstract T of (Class<T> 型、 Shape形状、long サイズ、Consumer<T> dataInitializer)
指定されたデータ型、形状、サイズのテンソルを割り当てます。
このメソッドはof(Class, Shape, Consumer)
と同じですが、テンソルの最終サイズをデータ型と形状から計算する代わりに明示的に設定できる点が異なります。
これは、文字列のテンソルのルックアップ テーブルなど、テンソル メモリにデータだけでなくメタデータも格納するテンソル型に役立つ可能性があります。
パラメータ
タイプ | テンソル型クラス |
---|---|
形 | テンソルの形状 |
サイズ | テンソルのバイト単位のサイズ、または形状からサイズを計算する場合は -1 |
データ初期化子 | 初期化のために割り当てられたテンソルデータへのアクセサを受け取るメソッド |
返品
- 割り当てられ初期化されたテンソル
投げる
IllegalArgumentException | size テンソル データを保存するために必要な最小スペースより小さい場合 |
---|---|
IllegalArgumentException | size が -1 に設定されているが、指定されたtype の要素が可変長である場合 (文字列など) |
IllegalArgumentException | shape が完全または部分的にunknown 場合 |
IllegalStateException | テンソルの割り当てに失敗した場合 |
public static abstract T of (Class<T> 型、 Shape形状)
指定されたデータ型と形状のテンソルを割り当てます。
割り当てるメモリの量は、データ型とテンソルの形状から導出され、初期化されないままになります。
パラメータ
タイプ | テンソル型クラス |
---|---|
形 | テンソルの形状 |
返品
- 割り当てられているが初期化されていないテンソル
投げる
IllegalArgumentException | 指定されたtype の要素が可変長の場合 (文字列など) |
---|---|
IllegalArgumentException | shape が完全または部分的にunknown 場合 |
IllegalStateException | テンソルの割り当てに失敗した場合 |
public static abstract T of (Class<T> 型、 Shape形状、ロングサイズ)
指定されたデータ型、形状、サイズのテンソルを割り当てます。
このメソッドはof(Class, Shape)
と同じですが、テンソルの最終サイズをデータ型と形状から計算する代わりに明示的に設定できる点が異なります。これは、データを格納するために必要な実際のスペースより大きくなる可能性がありますが、小さくなることはありません。 。
パラメータ
タイプ | テンソル型クラス |
---|---|
形 | テンソルの形状 |
サイズ | テンソルのバイト単位のサイズ、または形状からサイズを計算する場合は -1 |
返品
- 割り当てられているが初期化されていないテンソル
投げる
IllegalArgumentException | size テンソル データを保存するために必要な最小スペースより小さい場合 |
---|---|
IllegalArgumentException | size が -1 に設定されているが、指定されたtype の要素が可変長である場合 (文字列など) |
IllegalArgumentException | shape が完全または部分的にunknown 場合 |
IllegalStateException | テンソルの割り当てに失敗した場合 |
関連項目
public static abstract T of (Class<T> 型、 Shape形状、Consumer<T> dataInitializer)
指定されたデータ型と形状のテンソルを割り当てて初期化します。
割り当てるメモリの量は、データ型とテンソルの形状から導出されます。テンソル データは、 dataInitializer
呼び出すことによって初期化されます。これは、割り当てられたテンソルに対してERROR(/#data())
によって返された値を引数で受け取ります。例えば:
FloatNdArray data = ...
try (TFloat32 t = Tensor.of(TFloat32.class, Shape.of(2, 2), data::copyTo)) {
...
}
dataInitializer
が失敗して例外をスローした場合、割り当てられた tensor は同じ例外を再スローする前に自動的に解放されます。
パラメータ
タイプ | テンソル型クラス |
---|---|
形 | テンソルの形状 |
データ初期化子 | 初期化のために割り当てられたテンソルデータへのアクセサを受け取るメソッド |
返品
- 割り当てられ初期化されたテンソル
投げる
IllegalArgumentException | 指定されたtype の要素が可変長の場合 (文字列など) |
---|---|
IllegalArgumentException | shape が完全または部分的にunknown 場合 |
IllegalStateException | テンソルの割り当てに失敗した場合 |
public static abstract T of (Class<T> 型、 Shape形状、 ByteDataBuffer rawData)
指定されたバッファーによって提供される生データから任意のタイプの Tensor を作成します。
データは、TensorFlow C APIの仕様に従ってdata
にエンコードされている必要があります。
パラメータ
タイプ | テンソル型クラス |
---|---|
形 | テンソル形状。 |
生データ | テンソル生データを含むバッファ。 |
投げる
IllegalArgumentException | rawData テンソル データを含めるのに十分な大きさではない場合 |
---|---|
IllegalArgumentException | shape が完全または部分的にunknown 場合 |
IllegalStateException | 指定されたパラメータでテンソルを割り当てることができなかった場合 |