Array multidimensi yang diketik secara statis yang elemen-elemennya bertipe seperti yang dijelaskan oleh T.
Instance Tensor tidak aman untuk thread.
PERINGATAN: Sumber daya yang digunakan oleh objek Tensor harus dibebaskan secara eksplisit dengan memanggil metode close()
saat objek tidak lagi diperlukan. Misalnya, menggunakan blok coba-dengan-sumber daya:
try (Tensor t = Tensor.create(...)) {
doSomethingWith(t);
}
Metode Publik
boolean | Nilai boolean () Mengembalikan nilai dalam tensor skalar Boolean . |
byte[] | |
ruang kosong | menutup () Rilis sumber daya yang terkait dengan Tensor. |
<U> kamu | salinKe (U dst) Menyalin konten tensor ke dst dan mengembalikan dst . |
Tensor statis <?> | buat (Objek objek) Membuat tensor dari objek yang kelasnya diperiksa untuk mengetahui tipe data yang mendasarinya. |
statis <T> Tensor <T> | buat (tipe Kelas<T>, bentuk panjang[], data ByteBuffer) Buat Tensor jenis apa pun dengan data dari buffer yang diberikan. |
Tensor statis <Ganda> | |
Tensor statis <Panjang> | |
Tensor statis <Bilangan Bulat> | |
Tensor statis <Float> | |
statis <T> Tensor <T> | buat (Obj objek, tipe Kelas<T>) Membuat Tensor dari objek Java. |
Tipe Data | |
dobel | Nilai ganda () Mengembalikan nilai dalam tensor skalar Double . |
<U> Tensornya <U> | harapkan (tipe Kelas<U>) Mengembalikan objek Tensor ini dengan tipe Tensor<U> . |
mengambang | Nilai float () Mengembalikan nilai dalam tensor Float skalar. |
ke dalam | |
panjang | Nilai panjang () Mengembalikan nilai dalam tensor skalar Long . |
ke dalam | jumlahBytes () Mengembalikan ukuran, dalam byte, data tensor. |
ke dalam | jumlah Dimensi () Mengembalikan jumlah dimensi (terkadang disebut sebagai rank ) Tensor. |
ke dalam | numElements () Mengembalikan jumlah elemen dalam tampilan tensor yang diratakan (1-D). |
panjang[] | |
Rangkaian | keString () Mengembalikan string yang menjelaskan jenis dan bentuk Tensor. |
ruang kosong | |
ruang kosong | |
ruang kosong | |
ruang kosong | writeTo (ByteBuffer dst) Tulis data tensor ke dalam buffer yang diberikan. |
ruang kosong |
Metode Warisan
Metode Publik
nilai boolean boolean publik ()
Mengembalikan nilai dalam tensor skalar Boolean
.
Melempar
Pengecualian Argumen Ilegal | jika Tensor tidak mewakili skalar boolean. |
---|
byte publik[] byteValue ()
Mengembalikan nilai dalam tensor String
skalar.
Melempar
Pengecualian Argumen Ilegal | jika Tensor tidak mewakili skalar boolean. |
---|
penutupan kekosongan publik ()
Rilis sumber daya yang terkait dengan Tensor.
PERINGATAN: Ini harus dijalankan karena semua tensor yang tidak dihasilkan oleh operasi yang mendesak atau memori akan bocor.
Objek Tensor tidak lagi dapat digunakan setelah close
return.
salin U publikKe (U dst)
Menyalin konten tensor ke dst
dan mengembalikan dst
.
Untuk tensor non-skalar, metode ini menyalin konten tensor yang mendasarinya ke array Java. Untuk tensor skalar, gunakan salah satu bytesValue()
, floatValue()
, doubleValue()
, intValue()
, longValue()
atau booleanValue()
sebagai gantinya. Jenis dan bentuk dst
harus sesuai dengan tensor. Misalnya:
int matrix[2][2] = { {1,2},{3,4} };
try(Tensor t = Tensor.create(matrix)) {
// Succeeds and prints "3"
int[][] copy = new int[2][2];
System.out.println(t.copyTo(copy)[1][0]);
// Throws IllegalArgumentException since the shape of dst does not match the shape of t.
int[][] dst = new int[4][1];
t.copyTo(dst);
}
Parameter
dst |
---|
Melempar
Pengecualian Argumen Ilegal | jika tensornya adalah skalar atau jika dst tidak kompatibel dengan tensor (misalnya, tipe atau bentuk data tidak cocok). |
---|
Tensor statis publik <?> buat (Obj objek)
Membuat tensor dari objek yang kelasnya diperiksa untuk mengetahui tipe data yang mendasarinya.
Parameter
keberatan |
---|
Melempar
Pengecualian Argumen Ilegal | jika obj tidak kompatibel dengan sistem tipe TensorFlow. |
---|
Tensor statis publik <T> buat (tipe Kelas<T>, bentuk panjang[], data ByteBuffer)
Buat Tensor jenis apa pun dengan data dari buffer yang diberikan.
Membuat Tensor dengan bentuk apa pun yang disediakan di mana data tensor telah dikodekan menjadi data
sesuai spesifikasi TensorFlow C API .
Parameter
jenis | tipe elemen tensor, direpresentasikan sebagai objek kelas. |
---|---|
membentuk | bentuk tensornya. |
data | buffer yang berisi data tensor. |
Melempar
Pengecualian Argumen Ilegal | Jika tipe data atau bentuk tensor tidak kompatibel dengan buffer |
---|
Tensor statis publik <Double> buat (bentuk panjang[], data DoubleBuffer)
Buat Tensor Double
dengan data dari buffer yang diberikan.
Membuat Tensor dengan bentuk tertentu dengan menyalin elemen dari buffer (mulai dari posisinya saat ini) ke tensor. Misalnya, jika shape = {2,3}
(yang mewakili matriks 2x3) maka buffer harus memiliki 6 elemen tersisa, yang akan digunakan oleh metode ini.
Parameter
membentuk | bentuk tensornya. |
---|---|
data | buffer yang berisi data tensor. |
Melempar
Pengecualian Argumen Ilegal | Jika bentuk tensor tidak kompatibel dengan buffer |
---|
Tensor statis publik <Panjang> buat (bentuk panjang[], data LongBuffer)
Buat Tensor Long
dengan data dari buffer yang diberikan.
Membuat Tensor dengan bentuk tertentu dengan menyalin elemen dari buffer (mulai dari posisinya saat ini) ke tensor. Misalnya, jika shape = {2,3}
(yang mewakili matriks 2x3) maka buffer harus memiliki 6 elemen tersisa, yang akan digunakan oleh metode ini.
Parameter
membentuk | bentuk tensornya. |
---|---|
data | buffer yang berisi data tensor. |
Melempar
Pengecualian Argumen Ilegal | Jika bentuk tensor tidak kompatibel dengan buffer |
---|
Tensor statis publik <Integer> buat (bentuk [] panjang, data IntBuffer)
Buat Tensor Integer
dengan data dari buffer yang diberikan.
Membuat Tensor dengan bentuk tertentu dengan menyalin elemen dari buffer (mulai dari posisinya saat ini) ke tensor. Misalnya, jika shape = {2,3}
(yang mewakili matriks 2x3) maka buffer harus memiliki 6 elemen tersisa, yang akan digunakan oleh metode ini.
Parameter
membentuk | bentuk tensornya. |
---|---|
data | buffer yang berisi data tensor. |
Melempar
Pengecualian Argumen Ilegal | Jika bentuk tensor tidak kompatibel dengan buffer |
---|
Tensor statis publik <Float> buat (bentuk panjang[], data FloatBuffer)
Buat Float
Tensor dengan data dari buffer yang diberikan.
Membuat Tensor dengan bentuk tertentu dengan menyalin elemen dari buffer (mulai dari posisinya saat ini) ke tensor. Misalnya, jika shape = {2,3}
(yang mewakili matriks 2x3) maka buffer harus memiliki 6 elemen tersisa, yang akan digunakan oleh metode ini.
Parameter
membentuk | bentuk tensornya. |
---|---|
data | buffer yang berisi data tensor. |
Melempar
Pengecualian Argumen Ilegal | Jika bentuk tensor tidak kompatibel dengan buffer |
---|
Tensor statis publik <T> buat (Obj objek, tipe Kelas<T>)
Membuat Tensor dari objek Java.
Tensor
adalah larik elemen multidimensi dengan sekumpulan tipe terbatas. Tidak semua objek Java dapat dikonversi menjadi Tensor
. Secara khusus, argumen obj
harus berupa primitif (float, double, int, long, boolean, byte) atau array multidimensi dari salah satu primitif tersebut. type
argumen menentukan cara menafsirkan argumen pertama sebagai tipe TensorFlow. Misalnya:
// Valid: A 64-bit integer scalar.
Tensor<Long> s = Tensor.create(42L, Long.class);
// Valid: A 3x2 matrix of floats.
float[][] matrix = new float[3][2];
Tensor<Float> m = Tensor.create(matrix, Float.class);
// Invalid: Will throw an IllegalArgumentException as an arbitrary Object
// does not fit into the TensorFlow type system.
Tensor<?> o = Tensor.create(new Object())
// Invalid: Will throw an IllegalArgumentException since there are
// a differing number of elements in each row of this 2-D array.
int[][] twoD = new int[2][];
twoD[0] = new int[1];
twoD[1] = new int[2];
Tensor<Integer> x = Tensor.create(twoD, Integer.class);
String
adalah larik multidimensi dengan urutan byte arbitrer, sehingga dapat diinisialisasi dari larik elemen byte[]
. Misalnya:// Valid: A String tensor.
Tensor<String> s = Tensor.create(new byte[]{1, 2, 3}, String.class);
// Java Strings will need to be encoded into a byte-sequence.
String mystring = "foo";
Tensor<String> s = Tensor.create(mystring.getBytes("UTF-8"), String.class);
// Valid: Matrix of String tensors.
// Each element might have a different length.
byte[][][] matrix = new byte[2][2][];
matrix[0][0] = "this".getBytes("UTF-8");
matrix[0][1] = "is".getBytes("UTF-8");
matrix[1][0] = "a".getBytes("UTF-8");
matrix[1][1] = "matrix".getBytes("UTF-8");
Tensor<String> m = Tensor.create(matrix, String.class);
Parameter
keberatan | Objek yang akan diubah menjadi Tensor<T> . Perhatikan apakah kompatibel dengan tipe T tidak diperiksa oleh sistem tipe. Untuk pembuatan tensor yang aman untuk tipe, gunakan Tensors . |
---|---|
jenis | Objek kelas yang mewakili tipe T. |
Melempar
Pengecualian Argumen Ilegal | jika obj tidak kompatibel dengan sistem tipe TensorFlow. |
---|
nilai ganda ganda publik ()
Mengembalikan nilai dalam tensor skalar Double
.
Melempar
Pengecualian Argumen Ilegal | jika Tensor tidak mewakili skalar ganda. |
---|
Tensor publik <U> yang diharapkan (tipe Kelas<U>)
Mengembalikan objek Tensor ini dengan tipe Tensor<U>
. Metode ini berguna ketika diberi nilai bertipe Tensor<?>
.
Parameter
jenis | array apa pun (bukan nol) dengan tipe yang benar. |
---|
Melempar
Pengecualian Argumen Ilegal | jika tipe data sebenarnya dari objek ini tidak cocok dengan tipe U . |
---|
float publik floatValue ()
Mengembalikan nilai dalam tensor Float
skalar.
Melempar
Pengecualian Argumen Ilegal | jika Tensor tidak mewakili skalar float. |
---|
int publik intValue ()
Mengembalikan nilai dalam tensor Integer
skalar.
Melempar
Pengecualian Argumen Ilegal | jika Tensor tidak mewakili skalar int. |
---|
nilai panjang publik ()
Mengembalikan nilai dalam tensor skalar Long
.
Melempar
Pengecualian Argumen Ilegal | jika Tensor tidak mewakili skalar panjang. |
---|
int publik numBytes ()
Mengembalikan ukuran, dalam byte, data tensor.
public int numDimensi ()
Mengembalikan jumlah dimensi (terkadang disebut sebagai rank ) Tensor.
Akan menjadi 0 untuk skalar, 1 untuk vektor, 2 untuk matriks, 3 untuk tensor 3 dimensi, dll.
int publik numElements ()
Mengembalikan jumlah elemen dalam tampilan tensor yang diratakan (1-D).
publik panjang[] bentuk ()
Mengembalikan bentuk Tensor, yaitu ukuran setiap dimensi.
Kembali
- array yang elemen ke-i adalah ukuran dimensi tensor ke-i.
String publik keString ()
Mengembalikan string yang menjelaskan jenis dan bentuk Tensor.
public void writeTo (LongBuffer dst)
Tulis data tensor Long
ke dalam buffer yang diberikan.
Menyalin elemen numElements()
ke buffer.
Parameter
dst | penyangga tujuan |
---|
Melempar
Pengecualian BufferOverflow | Jika ruang di buffer yang diberikan tidak mencukupi untuk data di tensor ini |
---|---|
Pengecualian Argumen Ilegal | Jika tipe data tensornya tidak Long |
public void writeTo (DoubleBuffer dst)
Tulis data tensor Double
ke dalam buffer yang diberikan.
Menyalin elemen numElements()
ke buffer.
Parameter
dst | penyangga tujuan |
---|
Melempar
Pengecualian BufferOverflow | Jika ruang di buffer yang diberikan tidak mencukupi untuk data di tensor ini |
---|---|
Pengecualian Argumen Ilegal | Jika tipe data tensornya bukan Double |
public void writeTo (IntBuffer dst)
Tulis data tensor Integer
ke dalam buffer yang diberikan.
Menyalin elemen numElements()
ke buffer.
Parameter
dst | penyangga tujuan |
---|
Melempar
Pengecualian BufferOverflow | Jika ruang di buffer yang diberikan tidak mencukupi untuk data di tensor ini |
---|---|
Pengecualian Argumen Ilegal | Jika tipe data tensornya bukan Integer |
public void writeTo (ByteBuffer dst)
Tulis data tensor ke dalam buffer yang diberikan.
Menyalin numBytes()
byte ke buffer dalam urutan byte asli untuk tipe primitif.
Parameter
dst | penyangga tujuan |
---|
Melempar
Pengecualian BufferOverflow | Jika ruang di buffer yang diberikan tidak mencukupi untuk data di tensor ini |
---|
public void writeTo (FloatBuffer dst)
Tulis data tensor Float
ke dalam buffer yang diberikan.
Menyalin elemen numElements()
ke buffer.
Parameter
dst | penyangga tujuan |
---|
Melempar
Pengecualian BufferOverflow | Jika ruang di buffer yang diberikan tidak mencukupi untuk data di tensor ini |
---|---|
Pengecualian Argumen Ilegal | Jika tipe data tensor bukan Float |