Cảnh báo: API này không được dùng nữa và sẽ bị xóa trong phiên bản TensorFlow trong tương lai sau khi bản thay thế ổn định.

Tensor

Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
công khai lớp cuối cùng Tensor

Mảng đa chiều được nhập kiểu tĩnh có các phần tử thuộc kiểu được mô tả bởi T.

Các phiên bản của Tensor không an toàn theo luồng.

CẢNH BÁO: Các tài nguyên được sử dụng bởi đối tượng Tensor phải được giải phóng một cách rõ ràng bằng cách gọi phương thức close() khi đối tượng không còn cần thiết nữa. Ví dụ: sử dụng khối try-with-resources:

try (Tensor t = Tensor.create(...)) {
   doSomethingWith(t);
 
 }

Phương thức công khai

boolean
booleanValue ()
Trả về giá trị trong một tensor Boolean vô hướng.
byte []
bytesValue ()
Trả về giá trị trong một tensor String vô hướng.
vô hiệu
đóng ()
Giải phóng tài nguyên liên quan đến Tensor.
<U> U
copyTo (U dst)
Sao chép nội dung của tensor sang dst và trả về dst .
Tensor tĩnh <?>
tạo (Đối tượng đối tượng)
Tạo một tensor từ một đối tượng có lớp được kiểm tra để tìm ra kiểu dữ liệu cơ bản nên là.
static <T> Tensor <T>
tạo (Loại <T> lớp, hình [] dài, dữ liệu ByteBuffer)
Tạo một Tensor của bất kỳ loại nào với dữ liệu từ bộ đệm đã cho.
Tensor tĩnh <Đôi>
tạo (hình [] dài, dữ liệu DoubleBuffer)
Tạo một Tensor Double với dữ liệu từ bộ đệm đã cho.
Tensor tĩnh <Long>
tạo (hình [] dài, dữ liệu LongBuffer)
Tạo một Long Tensor với dữ liệu từ bộ đệm đã cho.
Tensor tĩnh <Integer>
tạo (hình [] dài, dữ liệu IntBuffer)
Tạo một Tensor Integer với dữ liệu từ bộ đệm đã cho.
Tensor tĩnh <Float>
tạo (hình [] dài, dữ liệu FloatBuffer)
Tạo một Tensor Float với dữ liệu từ bộ đệm đã cho.
static <T> Tensor <T>
create (Object obj, Class <T> type)
Tạo một Tensor từ một đối tượng Java.
Loại dữ liệu
dataType ()
Trả về DataType của các phần tử được lưu trữ trong Tensor.
gấp đôi
doubleValue ()
Trả về giá trị trong Double tensor vô hướng.
<U> Tensor <U>
mong đợi (Loại <U> Class)
Trả về đối tượng Tensor này với kiểu Tensor<U> .
Phao nổi
floatValue ()
Trả về giá trị trong một tensor Float vô hướng.
int
intValue ()
Trả về giá trị trong một tensor Integer vô hướng.
Dài
longValue ()
Trả về giá trị trong một tensor Long vô hướng.
int
numBytes ()
Trả về kích thước, tính bằng byte, của dữ liệu tensor.
int
numDimensions ()
Trả về số thứ nguyên (đôi khi được gọi là thứ hạng ) của Tensor.
int
numElements ()
Trả về số phần tử trong chế độ xem phẳng (1-D) của tensor.
Dài[]
hình dạng ()
Trả về hình dạng của Tensor, tức là kích thước của mỗi chiều.
Chuỗi
toString ()
Trả về một chuỗi mô tả kiểu và hình dạng của Tensor.
vô hiệu
writeTo (LongBuffer dst)
Ghi dữ liệu của một tensor Long vào bộ đệm đã cho.
vô hiệu
writeTo (DoubleBuffer dst)
Ghi dữ liệu của một tensor Double vào bộ đệm đã cho.
vô hiệu
writeTo (IntBuffer dst)
Ghi dữ liệu của một tensor Integer vào bộ đệm đã cho.
vô hiệu
writeTo (ByteBuffer dst)
Ghi dữ liệu tensor vào bộ đệm đã cho.
vô hiệu
writeTo (FloatBuffer dst)
Ghi dữ liệu của một tensor Float vào bộ đệm đã cho.

Phương thức kế thừa

Phương thức công khai

public boolean booleanValue ()

Trả về giá trị trong một tensor Boolean vô hướng.

Ném
Ngoại lệ Đối số bất hợp pháp nếu Tensor không đại diện cho một đại lượng vô hướng boolean.

byte công khai [] bytesValue ()

Trả về giá trị trong một tensor String vô hướng.

Ném
Ngoại lệ Đối số bất hợp pháp nếu Tensor không đại diện cho một đại lượng vô hướng boolean.

public void close ()

Giải phóng tài nguyên liên quan đến Tensor.

CẢNH BÁO: Điều này phải được gọi cho tất cả các tensor không được tạo ra bởi một hoạt động háo hức hoặc bộ nhớ sẽ bị rò rỉ.

Đối tượng Tensor không còn sử dụng được sau khi close trả về.

public U copyTo (U dst)

Sao chép nội dung của tensor sang dst và trả về dst .

Đối với tensor không vô hướng, phương thức này sao chép nội dung của tensor bên dưới sang một mảng Java. Đối với các tenxơ vô hướng, hãy sử dụng một trong các bytesValue() , floatValue() , doubleValue() , intValue() , longValue() hoặc booleanValue() để thay thế. Loại và hình dạng của dst phải tương thích với tensor. Ví dụ:

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);
 }
 }

Ném
Ngoại lệ Đối số bất hợp pháp nếu tensor là một đại lượng vô hướng hoặc nếu dst không tương thích với tensor (ví dụ: các kiểu dữ liệu hoặc hình dạng không khớp).

public static Tensor <?> create (Object obj)

Tạo một tensor từ một đối tượng có lớp được kiểm tra để tìm ra kiểu dữ liệu cơ bản nên là.

Ném
Ngoại lệ Đối số bất hợp pháp nếu obj không tương thích với hệ thống loại TensorFlow.

public static Tensor <T> create (Class <T> type, long [] shape, ByteBuffer data)

Tạo một Tensor của bất kỳ loại nào với dữ liệu từ bộ đệm đã cho.

Tạo một Tensor với hình dạng được cung cấp của bất kỳ loại nào trong đó dữ liệu của tensor đã được mã hóa thành data theo đặc điểm kỹ thuật của TensorFlow C API .

Thông số
kiểu kiểu phần tử tensor, được biểu diễn như một đối tượng lớp.
hình dạng hình dạng tensor.
dữ liệu một bộ đệm chứa dữ liệu tensor.
Ném
Ngoại lệ Đối số bất hợp pháp Nếu kiểu dữ liệu hoặc hình dạng tensor không tương thích với bộ đệm

public static Tensor <Double> tạo (hình [] dài, dữ liệu DoubleBuffer)

Tạo một Tensor Double với dữ liệu từ bộ đệm đã cho.

Tạo một Tensor với hình dạng đã cho bằng cách sao chép các phần tử từ bộ đệm (bắt đầu từ vị trí hiện tại của nó) vào tensor. Ví dụ: nếu shape = {2,3 } (đại diện cho ma trận 2x3) thì vùng đệm phải còn lại 6 phần tử, phần tử này sẽ được sử dụng theo phương pháp này.

Thông số
hình dạng hình dạng tensor.
dữ liệu một bộ đệm chứa dữ liệu tensor.
Ném
Ngoại lệ Đối số bất hợp pháp Nếu hình dạng tensor không tương thích với bộ đệm

public static Tensor <Long> tạo (hình dạng dài [], dữ liệu LongBuffer)

Tạo một Long Tensor với dữ liệu từ bộ đệm đã cho.

Tạo một Tensor với hình dạng đã cho bằng cách sao chép các phần tử từ bộ đệm (bắt đầu từ vị trí hiện tại của nó) vào tensor. Ví dụ: nếu shape = {2,3 } (đại diện cho ma trận 2x3) thì vùng đệm phải còn lại 6 phần tử, phần tử này sẽ được sử dụng theo phương pháp này.

Thông số
hình dạng hình dạng tensor.
dữ liệu một bộ đệm chứa dữ liệu tensor.
Ném
Ngoại lệ Đối số bất hợp pháp Nếu hình dạng tensor không tương thích với bộ đệm

public static Tensor <Integer> create (long [] shape, IntBuffer data)

Tạo một Tensor Integer với dữ liệu từ bộ đệm đã cho.

Tạo một Tensor với hình dạng đã cho bằng cách sao chép các phần tử từ bộ đệm (bắt đầu từ vị trí hiện tại của nó) vào tensor. Ví dụ: nếu shape = {2,3 } (đại diện cho ma trận 2x3) thì vùng đệm phải còn lại 6 phần tử, phần tử này sẽ được sử dụng theo phương pháp này.

Thông số
hình dạng hình dạng tensor.
dữ liệu một bộ đệm chứa dữ liệu tensor.
Ném
Ngoại lệ Đối số bất hợp pháp Nếu hình dạng tensor không tương thích với bộ đệm

public static Tensor <Float> create (long [] shape, dữ liệu FloatBuffer)

Tạo một Tensor Float với dữ liệu từ bộ đệm đã cho.

Tạo một Tensor với hình dạng đã cho bằng cách sao chép các phần tử từ bộ đệm (bắt đầu từ vị trí hiện tại của nó) vào tensor. Ví dụ: nếu shape = {2,3 } (đại diện cho ma trận 2x3) thì vùng đệm phải còn lại 6 phần tử, phần tử này sẽ được sử dụng theo phương pháp này.

Thông số
hình dạng hình dạng tensor.
dữ liệu một bộ đệm chứa dữ liệu tensor.
Ném
Ngoại lệ Đối số bất hợp pháp Nếu hình dạng tensor không tương thích với bộ đệm

public static Tensor <T> create (Object obj, Class <T> type)

Tạo một Tensor từ một đối tượng Java.

Tensor là một mảng đa chiều gồm các phần tử của một tập hợp các loại giới hạn. Không phải tất cả các đối tượng Java đều có thể được chuyển đổi thành Tensor . Cụ thể, đối số obj phải là một nguyên thủy (float, double, int, long, boolean, byte) hoặc một mảng đa chiều của một trong các nguyên thủy đó. Đối số type quy định cụ thể như thế nào để giải thích các số đầu tiên như một loại TensorFlow. Ví dụ:

// 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);
 
Tensors kiểu String là mảng đa chiều gồm các chuỗi byte tùy ý, do đó có thể được khởi tạo từ mảng gồm các phần tử byte[] . Ví dụ:
// 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 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 m = Tensor.create(matrix, String.class);
 }

Thông số
phản đối Đối tượng chuyển đổi thành Tensor<T> . Lưu ý rằng liệu nó có tương thích với loại T hay không sẽ không được hệ thống loại kiểm tra. Để tạo ra các tensors an toàn về loại, hãy sử dụng Tensors .
kiểu Đối tượng lớp đại diện cho kiểu T.
Ném
Ngoại lệ Đối số bất hợp pháp nếu obj không tương thích với hệ thống loại TensorFlow.

public DataType dataType ()

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

public double doubleValue ()

Trả về giá trị trong Double tensor vô hướng.

Ném
Ngoại lệ Đối số bất hợp pháp nếu Tensor không đại diện cho một đại lượng vô hướng kép.

public Tensor <U> mong đợi (loại Class <U>)

Trả về đối tượng Tensor này với kiểu Tensor<U> . Phương thức này hữu ích khi cho một giá trị kiểu Tensor<?> .

Thông số
kiểu bất kỳ mảng (không phải null) thuộc loại chính xác.
Ném
Ngoại lệ Đối số bất hợp pháp nếu kiểu dữ liệu thực tế của đối tượng này không khớp với kiểu U

public float floatValue ()

Trả về giá trị trong một tensor Float vô hướng.

Ném
Ngoại lệ Đối số bất hợp pháp nếu Tensor không đại diện cho một đại lượng vô hướng float.

public int intValue ()

Trả về giá trị trong một tensor Integer vô hướng.

Ném
Ngoại lệ Đối số bất hợp pháp nếu Tensor không đại diện cho một vô hướng int.

public long longValue ()

Trả về giá trị trong một tensor Long vô hướng.

Ném
Ngoại lệ Đối số bất hợp pháp nếu Tensor không đại diện cho một đại lượng vô hướng dài.

public int numBytes ()

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

public int numDimensions ()

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

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

public int numElements ()

Trả về số phần tử trong chế độ xem phẳng (1-D) của tensor.

public long [] shape ()

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

Lợi nhuận
  • một mảng trong đó phần tử thứ i là kích thước của kích thước thứ i của tensor.

public String toString ()

Trả về một chuỗi mô tả kiểu và hình dạng của Tensor.

public void writeTo (LongBuffer dst)

Ghi dữ liệu của một tensor Long vào bộ đệm đã cho.

Sao chép các phần tử numElements() vào bộ đệm.

Thông số
dst bộ đệm đích
Ném
BufferOverflowException Nếu không có đủ không gian trong bộ đệm nhất định cho dữ liệu trong tensor này
Ngoại lệ Đối số bất hợp pháp Nếu kiểu dữ liệu tensor không Long

public void writeTo (DoubleBuffer dst)

Ghi dữ liệu của một tensor Double vào bộ đệm đã cho.

Sao chép các phần tử numElements() vào bộ đệm.

Thông số
dst bộ đệm đích
Ném
BufferOverflowException Nếu không có đủ không gian trong bộ đệm nhất định cho dữ liệu trong tensor này
Ngoại lệ Đối số bất hợp pháp Nếu kiểu dữ liệu tensor không phải là Double

public void writeTo (IntBuffer dst)

Ghi dữ liệu của một tensor Integer vào bộ đệm đã cho.

Sao chép các phần tử numElements() vào bộ đệm.

Thông số
dst bộ đệm đích
Ném
BufferOverflowException Nếu không có đủ không gian trong bộ đệm nhất định cho dữ liệu trong tensor này
Ngoại lệ Đối số bất hợp pháp Nếu kiểu dữ liệu tensor không phải là Integer

public void writeTo (ByteBuffer dst)

Ghi dữ liệu tensor vào bộ đệm đã cho.

Sao chép các numBytes() vào bộ đệm theo thứ tự byte riêng cho các kiểu nguyên thủy.

Thông số
dst bộ đệm đích
Ném
BufferOverflowException Nếu không có đủ không gian trong bộ đệm nhất định cho dữ liệu trong tensor này

public void writeTo (FloatBuffer dst)

Ghi dữ liệu của một tensor Float vào bộ đệm đã cho.

Sao chép các phần tử numElements() vào bộ đệm.

Thông số
dst bộ đệm đích
Ném
BufferOverflowException Nếu không có đủ không gian trong bộ đệm nhất định cho dữ liệu trong tensor này
Ngoại lệ Đối số bất hợp pháp Nếu kiểu dữ liệu tensor không phải là Float