TensorBuffer

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

TensorBuffers Dinamis akan mengalokasikan kembali memori saat memuat array atau buffer data dengan ukuran buffer 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 tertentu. Berikut beberapa contohnya:

 // 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 berukuran tetap tidak dapat diubah setelah dibuat.

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

Mengembalikan buffer data.

Mengembalikan tipe data buffer ini.

Mendapatkan flatSize buffer.

Mengembalikan array float dari nilai yang disimpan dalam buffer ini. Jika buffer memiliki tipe berbeda dari float, nilainya akan diubah menjadi float. Misalnya, nilai di TensorBufferUint8 akan dikonversi dari uint8 menjadi float.

Mengembalikan nilai float pada indeks tertentu. Jika buffer memiliki tipe berbeda dari float, nilainya akan diubah menjadi float. Misalnya, saat membaca nilai dari TensorBufferUint8 , nilai tersebut akan dibaca terlebih dahulu sebagai uint8, lalu akan dikonversi dari uint8 menjadi 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);
 

Mengembalikan array int dari nilai yang disimpan dalam buffer ini. Jika buffer bertipe berbeda dari int, nilainya akan diubah menjadi int, dan kehilangan presisi mungkin terjadi. Misalnya, mendapatkan array int dari TensorBufferFloat dengan nilai {400.32f, 23.04f}, outputnya adalah {400, 23}.

Mengembalikan nilai int pada indeks tertentu. Jika buffer bertipe berbeda dari int, nilainya akan diubah menjadi int. Misalnya, saat membaca nilai dari TensorBufferFloat , nilai tersebut akan dibaca terlebih dahulu sebagai float, lalu dikonversi dari float menjadi int. Hilangnya presisi mungkin terjadi.

 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 terduga.)

Mengembalikan jumlah byte dari satu elemen dalam array. Misalnya, buffer float akan mengembalikan 4, dan buffer byte akan mengembalikan 1.

Mengembalikan jika TensorBuffer berukuran dinamis (dapat diubah ukurannya secara sewenang-wenang).

Memuat array int ke dalam buffer ini dengan bentuk tertentu. Jika buffer memiliki tipe yang berbeda dari int, nilainya akan diubah menjadi tipe buffer sebelum dimuat ke dalam buffer, dan kehilangan presisi mungkin terjadi. Misalnya, memuat array int dengan nilai {400, -23} ke dalam TensorBufferUint8 , nilai tersebut akan dijepit ke [0, 255] dan kemudian dilemparkan ke uint8 sebesar {255, 0}.

Memuat array float ke dalam buffer ini dengan bentuk tertentu. Jika buffer memiliki tipe yang berbeda dari float, nilainya akan diubah menjadi tipe buffer sebelum dimuat ke dalam buffer, dan kehilangan presisi mungkin terjadi. Misalnya, memuat array float ke TensorBufferUint8 dengan nilai {400.32f, -23.04f}, nilai tersebut akan dijepit ke [0, 255] dan kemudian dilemparkan ke uint8 sebesar {255, 0}.

Memuat array float ke dalam buffer ini. Jika buffer memiliki tipe yang berbeda dari float, nilainya akan diubah menjadi tipe buffer sebelum dimuat ke dalam buffer, dan kehilangan presisi mungkin terjadi. Misalnya, memuat array float ke TensorBufferUint8 dengan nilai {400.32f, -23.04f}, nilai tersebut akan dijepit ke [0, 255] dan kemudian dilemparkan ke uint8 sebesar {255, 0}.

Penggunaan metode ini mengasumsikan bahwa bentuk src sama dengan bentuk TensorBuffer ini. Oleh karena itu, ukuran buffer ( src.length ) harus selalu sesuai dengan ukuran datar TensorBuffer ini, baik untuk TensorBuffer berukuran tetap maupun dinamis. Gunakan loadArray(float[], int[]) jika src memiliki bentuk yang berbeda.

Memuat array int ke dalam buffer ini. Jika buffer memiliki tipe yang berbeda dari int, nilainya akan diubah menjadi tipe buffer sebelum dimuat ke dalam buffer, dan kehilangan presisi mungkin terjadi. Misalnya, memuat array int dengan nilai {400, -23} ke dalam TensorBufferUint8 , nilai tersebut akan dijepit ke [0, 255] dan kemudian dilemparkan ke uint8 sebesar {255, 0}.

Penggunaan metode ini mengasumsikan bahwa bentuk src sama dengan bentuk TensorBuffer ini. Oleh karena itu, ukuran buffer ( src.length ) harus selalu sesuai dengan ukuran datar TensorBuffer ini, baik untuk TensorBuffer berukuran tetap maupun dinamis. Gunakan loadArray(int[], int[]) jika src memiliki bentuk yang berbeda.

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

Penggunaan metode ini mengasumsikan bahwa bentuk buffer sama dengan bentuk TensorBuffer ini. Oleh karena itu, ukuran buffer ( buffer.limit() ) harus selalu sesuai dengan ukuran datar TensorBuffer ini, baik untuk TensorBuffer berukuran tetap maupun dinamis. Gunakan loadBuffer(ByteBuffer, int[]) jika buffer memiliki bentuk yang berbeda.

Penting: Buffer yang dimuat adalah referensi. JANGAN DIUBAH. Kami tidak membuat salinan di sini karena alasan kinerja, namun jika diperlukan modifikasi, silakan buat salinannya.

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

Jika buffer bersifat read-only, kami mengadopsi strategi copy-on-write untuk performa.

Memuat buffer byte ke TensorBuffer ini dengan bentuk tertentu.

Penting: Buffer yang dimuat adalah referensi. JANGAN DIUBAH. Kami tidak membuat salinan di sini karena alasan kinerja, namun jika diperlukan modifikasi, silakan buat salinannya.

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