TensorBuffer

Membuat TensorBuffer dinamis kosong dengan DataType yang ditentukan. Bentuk dari TensorBuffer yang dibuat adalah {0}.

TensorBuffers Dinamis akan mengalokasikan ulang memori saat memuat array atau buffer data ukuran buffer yang berbeda. Berikut beberapa contohnya:

 // Creating a float dynamic TensorBuffer:
 TensorBuffer tensorBuffer = TensorBuffer.createDynamic(DataType.FLOAT32);
 // Loading a float array:
 float[] arr1 = new float[] {1, 2, 3};
 tensorBuffer.loadArray(arr, new int[] {arr1.length});
 // loading another float array:
 float[] arr2 = new float[] {1, 2, 3, 4, 5};
 tensorBuffer.loadArray(arr, new int[] {arr2.length});
 // loading a third float array with the same size as arr2, assuming shape doesn't change:
 float[] arr3 = new float[] {5, 4, 3, 2, 1};
 tensorBuffer.loadArray(arr);
 // loading a forth float array with different size as arr3 and omitting the shape will result
 // in error:
 float[] arr4 = new float[] {3, 2, 1};
 tensorBuffer.loadArray(arr); // Error: The size of byte buffer and the shape do not match.
 

Membuat TensorBuffer dengan shape dan DataType yang ditentukan. Berikut beberapa contoh:

 // Creating a float TensorBuffer with shape {2, 3}:
 int[] shape = new int[] {2, 3};
 TensorBuffer tensorBuffer = TensorBuffer.createFixedSize(shape, DataType.FLOAT32);
 

 // Creating an uint8 TensorBuffer of a scalar:
 int[] shape = new int[] {};
 TensorBuffer tensorBuffer = TensorBuffer.createFixedSize(shape, DataType.UINT8);
 

 // Creating an empty uint8 TensorBuffer:
 int[] shape = new int[] {0};
 TensorBuffer tensorBuffer = TensorBuffer.createFixedSize(shape, DataType.UINT8);
 

Ukuran TensorBuffer yang berukuran tetap tidak dapat diubah setelah dibuat.

Membuat TensorBuffer yang menyalin data secara mendalam dari data lain, dengan DataType yang ditentukan.

Menampilkan buffer data.

Menampilkan jenis data buffer ini.

Mendapatkan flatSize buffer.

Menampilkan array float dari nilai yang disimpan dalam buffer ini. Jika buffer memiliki jenis berbeda dari {i>float<i}, nilai akan dikonversi menjadi {i>float<i}. Misalnya, nilai dalam TensorBufferUint8 akan dikonversi dari uint8 menjadi float.

Menampilkan nilai float pada indeks yang diberikan. Jika {i>buffer<i} memiliki jenis yang berbeda dari float, akan dikonversi menjadi {i>float<i}. Misalnya, saat membaca nilai dari TensorBufferUint8, nilai tersebut akan dibacakan terlebih dahulu sebagai uint8, lalu akan dikonversi dari uint8 agar mengambang (float).

 For example, a TensorBuffer with shape {2, 3} that represents the following array,
 [[0.0f, 1.0f, 2.0f], [3.0f, 4.0f, 5.0f]].

 The fourth element (whose value is 3.0f) in the TensorBuffer can be retrieved by:
 float v = tensorBuffer.getFloatValue(3);
 

Menampilkan array int dari nilai yang disimpan dalam buffer ini. Jika buffer memiliki jenis yang berbeda dari int, nilainya akan dikonversi menjadi int, dan kemungkinan kehilangan presisi. Misalnya, mendapatkan array int dari TensorBufferFloat dengan nilai {400.32f, 23.04f}, output adalah {400, 23}.

Menampilkan nilai int pada indeks yang diberikan. Jika buffer memiliki jenis yang berbeda dari int, akan dikonversi menjadi int. Misalnya, saat membaca nilai dari TensorBufferFloat, nilai akan dibacakan terlebih dahulu sebagai {i>float<i}, dan kemudian akan dikonversi dari {i>float<i} ke {i>int<i}. Turun presisi mungkin berlaku.

 For example, a TensorBuffer with shape {2, 3} that represents the following array,
 [[0.0f, 1.0f, 2.0f], [3.0f, 4.0f, 5.0f]].

 The fourth element (whose value is 3.0f) in the TensorBuffer can be retrieved by:
 int v = tensorBuffer.getIntValue(3);
 Note that v is converted from 3.0f to 3 as a result of type conversion.
 

Mendapatkan bentuk saat ini. (mengembalikan salinan di sini untuk menghindari modifikasi yang tidak diharapkan.)

Menampilkan jumlah byte dari satu elemen di array. Misalnya, {i> float buffer <i}akan hasil 4, dan buffer byte akan mengembalikan 1.

Menampilkan jika TensorBuffer berukuran dinamis (dapat mengubah ukuran secara bebas).

Memuat array int ke dalam buffer ini dengan bentuk tertentu. Jika buffer memiliki jenis berbeda dari int, nilai akan dikonversi ke dalam tipe {i>buffer<i} sebelum dimuat ke dalam buffer, dan kehilangan presisi mungkin terjadi. Misalnya, memuat array int dengan nilai {400, -23} menjadi TensorBufferUint8 , nilai akan dibulatkan ke [0, 255] lalu menjadi dilemparkan ke uint8 oleh {255, 0}.

Memuat array float ke dalam buffer ini dengan bentuk tertentu. Jika buffer memiliki jenis berbeda dari {i>float<i}, nilai akan dikonversi ke dalam tipe {i>buffer<i} sebelum dimuat ke dalam buffer, dan kehilangan presisi mungkin terjadi. Misalnya, memuat array float ke dalam TensorBufferUint8 dengan nilai {400.32f, -23.04f}, nilai tersebut akan dibulatkan ke [0, 255] dan kemudian dilemparkan ke uint8 oleh {255, 0}.

Memuat array float ke buffer ini. Jika buffer memiliki jenis berbeda dari float, dikonversi ke dalam tipe {i>buffer<i} sebelum dimuat ke dalam {i>buffer<i}, dan presisi mungkin berlaku. Misalnya, memuat array float ke TensorBufferUint8 dengan nilai {400.32f, -23.04f}, nilai akan dibulatkan ke [0, 255] dan kemudian ditransmisikan ke uint8 oleh {255, 0}.

Menggunakan metode ini mengasumsikan bahwa bentuk src sama dengan bentuk ini TensorBuffer. Dengan demikian ukuran buffer (src.length) harus selalu cocok ukuran datar TensorBuffer ini, untuk TensorBuffer ukuran tetap dan dinamis. Gunakan loadArray(float[], int[]) jika src memiliki bentuk yang berbeda.

Memuat array int ke buffer ini. Jika buffer memiliki jenis yang berbeda dari int, akan dikonversi ke dalam tipe {i>buffer<i} sebelum dimuat ke dalam {i>buffer<i}, dan hilangnya presisi mungkin berlaku. Misalnya, memuat array int dengan nilai {400, -23} menjadi TensorBufferUint8, nilai tersebut akan dibulatkan ke [0, 255], lalu ditransmisikan ke uint8 dengan {255, 0}.

Menggunakan metode ini mengasumsikan bahwa bentuk src sama dengan bentuk ini TensorBuffer. Dengan demikian ukuran buffer (src.length) harus selalu cocok ukuran datar TensorBuffer ini, untuk TensorBuffer ukuran tetap dan dinamis. Gunakan loadArray(int[], int[]) jika src memiliki bentuk yang berbeda.

Memuat buffer byte ke TensorBuffer ini. Ukuran buffer harus sama dengan ukuran datar TensorBuffer ini.

Menggunakan metode ini mengasumsikan bahwa bentuk buffer sama dengan bentuk ini TensorBuffer. Dengan demikian ukuran buffer (buffer.limit()) harus selalu cocokkan ukuran datar TensorBuffer ini, untuk TensorBuffer ukuran tetap dan dinamis. Gunakan loadBuffer(ByteBuffer, int[]) jika buffer memiliki bentuk tertentu.

Penting: Buffering yang dimuat adalah referensi. JANGAN DIMODIFIKASI. Kita tidak membuat salinan untuk masalah performa, tetapi jika perlu perubahan, buat salinannya.

Untuk performa terbaik, selalu muat ByteBuffer atau ByteBuffer langsung didukung oleh suatu array.

Jika buffer bersifat hanya baca, kami akan menerapkan strategi salin-saat-menulis untuk performa.

Memuat buffer byte ke TensorBuffer ini dengan bentuk tertentu.

Penting: Buffering yang dimuat adalah referensi. JANGAN DIMODIFIKASI. Kita tidak membuat salinan untuk masalah performa, tetapi jika perlu perubahan, buat salinannya.

Untuk performa terbaik, selalu muat ByteBuffer atau ByteBuffer langsung didukung oleh suatu array.