Tensor

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

静的に型指定された多次元配列。

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 に関連付けられたリソースを解放します。
抽象データ型
データ・タイプ（）
テンソルに格納されている要素のDataTypeを返します。
抽象的な長い
numBytes ()
テンソル データのサイズをバイト単位で返します。
抽象静的 <T extends TType > T
of (Class<T> タイプ、 Shape形状、ロング サイズ、Consumer<T> dataInitializer)
指定されたデータ型、形状、サイズのテンソルを割り当てます。
抽象静的 <T extends TType > T
( Class<T> タイプ、 Shape形状)
指定されたデータ型と形状のテンソルを割り当てます。
抽象静的 <T extends TType > T
(クラス<T>タイプ、シェイプ形状、ロングサイズ)
指定されたデータ型、形状、サイズのテンソルを割り当てます。
抽象静的 <T extends TType > T
(Class<T> 型、 Shape形状、Consumer<T> dataInitializer)の
指定されたデータ型と形状のテンソルを割り当てて初期化します。
抽象静的 <T extends TType > T
( Class<T> 型、 Shape形状、 ByteDataBuffer rawData)
指定されたバッファーによって提供される生データから任意のタイプの Tensor を作成します。
抽象的な形
形（）
テンソルの形状を返します。

継承されたメソッド

パブリックメソッド

パブリック抽象RawTensor asRawTensor ()

このテンソルの生の (型なし) 表現を返します。

パブリック抽象 void close ()

Tensor に関連付けられたリソースを解放します。

警告:これは、eager 操作によって生成されなかったすべての tensor に対して呼び出す必要があります。そうしないと、メモリがリークします。

Tensor オブジェクトは、 closeから戻った後は使用できなくなります。

public abstract DataType dataType ()

テンソルに格納されている要素のDataTypeを返します。

パブリック抽象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指定されたパラメータでテンソルを割り当てることができなかった場合

公開要約形状形状()

テンソルの形状を返します。