Tensor

giao diện công khai Tensor

Một mảng đa chiều đã nhập được dùng trong Tensorflow Lite.

Tên người dùng gốc của Tensor do NativeInterpreterWrapper quản lý và có không cần khách hàng đóng. Tuy nhiên, sau khi NativeInterpreterWrapper đã bị đóng, thì tay cầm tensor sẽ mất hiệu lực.

Lớp lồng ghép

lớp Tensor.QuantizationParams Tham số lượng tử tương ứng với bảng, QuantizationParameters, trong TFLite Tệp giản đồ mô hình.

Phương thức công khai

trừu tượng ByteBuffer
asReadOnlyBuffer()
Trả về khung hiển thị ByteBuffer chỉ đọc của dữ liệu tensor.
trừu tượng DataType
dataType()
Trả về DataType của các phần tử được lưu trữ trong Tensor.
trừu tượng đánh chặn
numBytes()
Trả về kích thước, tính bằng byte, của dữ liệu tensor.
trừu tượng đánh chặn
numDimensions()
Trả về số lượng thứ nguyên (đôi khi được gọi là thứ hạng) của Tensor.
trừu tượng đánh chặn
numElements()
Trả về số phần tử trong hình ảnh phẳng (1-D) của tensor.
trừu tượng Tensor.QuantizationParams
quantizationParams()
Trả về các tham số lượng tử hoá của tensor trong trình thông dịch sở hữu.
trừu tượng int[]
hình dạng()
Trả về hình dạng của Tensor, tức là các kích thước của từng chiều.
trừu tượng int[]
shapeSignature()
Trả về hình dạng ban đầu của Tensor, tức là kích thước của từng chiều – trước khi thực hiện đổi kích thước.

Phương thức công khai

công khai trừu tượng ByteBuffer asReadOnlyBuffer ()

Trả về khung hiển thị ByteBuffer chỉ đọc của dữ liệu tensor.

Nhìn chung, phương pháp này hữu ích nhất trong việc thu thập hình ảnh chỉ đọc của dữ liệu tensor đầu ra, Suy luận *sau khi* đã được thực thi (ví dụ: qua InterpreterApi.run(Object, Object)). Trong cụ thể, một số biểu đồ có đầu ra được định hình động, có thể tạo ra vùng đệm đầu ra cho trình dịch. Ví dụ về cách sử dụng:

 interpreter.run(input, null);
 ByteBuffer outputBuffer = interpreter.getOutputTensor(0).asReadOnlyBuffer();
 // Copy or read from outputBuffer.

CẢNH BÁO: Nếu tensor chưa được phân bổ, chẳng hạn như trước khi thực thi suy luận, kết quả không xác định. Lưu ý rằng con trỏ tensor cơ bản cũng có thể thay đổi khi tensor bị vô hiệu hoá theo bất kỳ cách nào (ví dụ: nếu thực thi suy luận hoặc biểu đồ được đổi kích thước), do đó, việc lưu giữ tham chiếu đến vùng đệm trả về ngoài việc sử dụng trực tiếp ngay lập tức là không an toàn sau suy luận. Ví dụ về trường hợp sử dụng *không hợp lệ*:

 ByteBuffer outputBuffer = interpreter.getOutputTensor(0).asReadOnlyBuffer();
 interpreter.run(input, null);
 // Copy or read from outputBuffer (which may now be invalid).

Gửi
IllegalArgumentException nếu dữ liệu tensor chưa được phân bổ.

công khai trừu tượng DataType dataType ()

Trả về DataType của các phần tử được lưu trữ trong Tensor.

công khai trừu tượng đánh chặn numBytes ()

Trả về kích thước, tính bằng byte, của dữ liệu tensor.

công khai trừu tượng đánh chặn numDimensions ()

Trả về số lượng thứ nguyên (đôi khi được gọi là thứ hạng) của Tensor.

Sẽ là 0 cho đại lượng vô hướng, 1 cho vectơ, 2 cho ma trận, 3 cho tensor 3 chiều, v.v.

công khai trừu tượng đánh chặn numElements ()

Trả về số phần tử trong hình ảnh phẳng (1-D) của tensor.

công khai trừu tượng Tensor.QuantizationParams quantizationParams ()

Trả về các tham số lượng tử hoá của tensor trong trình thông dịch sở hữu.

Chỉ tensor lượng tử hoá mới có QuantizationParameters hợp lệ. Đối với tensor không phải là lượng tử hoá, cả giá trị của tỷ lệ và zero_point đều bằng 0.

công khai trừu tượng int[] hình dạng ()

Trả về hình dạng của Tensor, tức là các kích thước của từng chiều.

Giá trị trả về
  • một mảng trong đó phần tử thứ i là kích thước của chiều thứ i của tensor.

công khai trừu tượng int[] shapeSignature ()

Trả về hình dạng ban đầu của Tensor, tức là kích thước của từng chiều – trước khi thực hiện đổi kích thước. Phương diện không xác định là được chỉ định với giá trị -1.

Giá trị trả về
  • một mảng trong đó phần tử thứ i là kích thước của chiều thứ i của tensor.