Tensor

lớp cuối cùng công khai Tensor

Mảng nhiều chiều được định 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 cho luồng.

CẢNH BÁO: Tài nguyên mà đối tượng Tensor sử dụng phải được giải phóng 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 pháp công khai

boolean
giá trị boolean ()
Trả về giá trị trong tensor Boolean vô hướng.
byte[]
byteValue ()
Trả về giá trị trong tensor String vô hướng.
trống rỗng
đóng ()
Giải phóng các tài nguyên liên quan đến Tensor.
<U> bạn
sao chépTo (U dst)
Sao chép nội dung của tensor sang dst và trả về dst .
Tenxơ tĩnh <?>
tạo (Đối tượng 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.
tĩnh <T> Tenor <T>
tạo (loại Class<T>, hình dạng dài[], dữ liệu ByteBuffer)
Tạo một Tensor thuộc bất kỳ loại nào với dữ liệu từ bộ đệm đã cho.
Tenxơ tĩnh <Đôi>
tạo (hình dạng [] dài, dữ liệu DoubleBuffer)
Tạo Double Tensor với dữ liệu từ bộ đệm đã cho.
Tenxơ tĩnh <Dài>
tạo (hình dạng dài[], dữ liệu LongBuffer)
Tạo một Tensor Long với dữ liệu từ bộ đệm đã cho.
Tenxơ tĩnh <Số nguyên>
tạo (hình dạng [] dài, dữ liệu IntBuffer)
Tạo Tensor Integer với dữ liệu từ bộ đệm đã cho.
Tenor tĩnh <Float>
tạo (hình dạng [] dài, dữ liệu FloatBuffer)
Tạo Float Tensor với dữ liệu từ bộ đệm đã cho.
tĩnh <T> Tenor <T>
tạo (Đối tượng obj, loại Class<T>)
Tạo một Tensor từ một đối tượng Java.
Kiểu dữ liệu
kiểu dữ liệu ()
Trả về DataType của các phần tử được lưu trữ trong Tensor.
gấp đôi
giá trị gấp đôi ()
Trả về giá trị trong tensor Double .
<U> Tenor <U>
mong đợi (loại Class<U>)
Trả về đối tượng Tensor này với kiểu Tensor&lt;U&gt; .
trôi nổi
floatValue ()
Trả về giá trị trong tensor Float vô hướng.
int
intValue ()
Trả về giá trị trong tensor Integer vô hướng.
dài
giá trị dài ()
Trả về giá trị trong tensor Long hướng.
int
numByte ()
Trả về kích thước, tính bằng byte, của dữ liệu tensor.
int
numKích thước ()
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 từng chiều.
Sợi dây
toString ()
Trả về một chuỗi mô tả loại và hình dạng của Tensor.
trống rỗng
writeTo (LongBuffer dst)
Ghi dữ liệu của một tensor Long vào bộ đệm đã cho.
trống rỗng
writeTo (DoubleBuffer dst)
Ghi dữ liệu của tensor Double vào bộ đệm đã cho.
trống rỗng
writeTo (IntBuffer dst)
Ghi dữ liệu của một tenxơ Integer vào bộ đệm đã cho.
trống rỗng
writeTo (ByteBuffer dst)
Ghi dữ liệu tensor vào bộ đệm đã cho.
trống rỗng
writeTo (FloatBuffer dst)
Ghi dữ liệu của tensor Float vào bộ đệm đã cho.

Phương pháp kế thừa

Phương pháp công khai

giá trị boolean boolean công khai ()

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

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

byte công khai[] byteValue ()

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

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

đóng khoảng trống công khai ()

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

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

Đối tượng Tensor không còn sử dụng được sau khi close lại.

công khai U copyTo (U dst)

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

Đối với các tensor không vô hướng, phương thức này sao chép nội dung của tensor cơ bản vào một mảng Java. Đối với các tensor vô hướng, hãy sử dụng một trong 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);
 }
 

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

Tenor tĩnh công khai <?> tạo (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.

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

tạo Tensor tĩnh công khai <T> (loại Class<T>, hình dạng dài [], dữ liệu ByteBuffer)

Tạo một Tensor thuộc 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 thuộc 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 API TensorFlow C.

Thông số
kiểu kiểu phần tử tensor, được biểu diễn dưới dạng đố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
Đối số bất hợp phápNgoại lệ Nếu kiểu dữ liệu tensor hoặc hình dạng không tương thích với bộ đệm

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

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

Tạo một Tensor có hình dạng nhất định 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ì bộ đệm phải còn lại 6 phần tử, phần tử này sẽ được phương thức này sử dụng.

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
Đối số bất hợp phápNgoại lệ Nếu hình dạng tensor không tương thích với bộ đệm

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

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

Tạo một Tensor có hình dạng nhất định 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ì bộ đệm phải còn lại 6 phần tử, phần tử này sẽ được phương thức này sử dụng.

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
Đối số bất hợp phápNgoại lệ Nếu hình dạng tensor không tương thích với bộ đệm

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

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

Tạo một Tensor có hình dạng nhất định 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ì bộ đệm phải còn lại 6 phần tử, phần tử này sẽ được phương thức này sử dụng.

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
Đối số bất hợp phápNgoại lệ Nếu hình dạng tensor không tương thích với bộ đệm

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

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

Tạo một Tensor có hình dạng nhất định 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ì bộ đệm phải còn lại 6 phần tử, phần tử này sẽ được phương thức này sử dụng.

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
Đối số bất hợp phápNgoại lệ Nếu hình dạng tensor không tương thích với bộ đệm

Công khai tĩnh Tensor <T> tạo (Object obj, Class<T> loại)

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ử thuộc 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 đối số nguyên thủy (float, double, int, long, boolean, byte) hoặc một mảng đa chiều của một trong những đối số nguyên thủy đó. type đối số chỉ định cách diễn giải đối số đầu tiên dưới dạng loại TensorFlow. Ví dụ:

// Valid: A 64-bit integer scalar.
 Tensor&lt;Long&gt; s = Tensor.create(42L, Long.class);

 // Valid: A 3x2 matrix of floats.
 float[][] matrix = new float[3][2];
 Tensor&lt;Float&gt; m = Tensor.create(matrix, Float.class);

 // Invalid: Will throw an IllegalArgumentException as an arbitrary Object
 // does not fit into the TensorFlow type system.
 Tensor&lt;?&gt; 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&lt;Integer&gt; x = Tensor.create(twoD, Integer.class);
 
Tensor được gõ kiểu String là các 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 các phần tử byte[] . Ví dụ:
// Valid: A String tensor.
 Tensor&lt;String&gt; 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&lt;String&gt; 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&lt;String&gt; m = Tensor.create(matrix, String.class);
 

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

Kiểu dữ liệu công khai Kiểu dữ liệu ()

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

công khai doubleValue ()

Trả về giá trị trong tensor Double .

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

Tensor công khai <U> mong đợi (loại Class<U>)

Trả về đối tượng Tensor này với kiểu Tensor&lt;U&gt; . Phương pháp này hữu ích khi cho trước một giá trị kiểu Tensor&lt;?&gt; .

Thông số
kiểu bất kỳ mảng (không null) nào đúng loại.
Ném
Đối số bất hợp phápNgoại lệ 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

float công khai Giá trị ()

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

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

int công khai intValue ()

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

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

công khai longValue ()

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

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

int công khai 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 đại lượng 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.

hình dạng dài [] công khai ()

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

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

Chuỗi công khai toString ()

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

public void writeTo (LongBuffer dst)

Ghi dữ liệu của 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
BufferOverflowNgoại lệ Nếu không có đủ dung lượng trong bộ đệm đã cho cho dữ liệu trong tensor này
Đối số bất hợp phápNgoại lệ Nếu kiểu dữ liệu tensor không Long

public void writeTo (DoubleBuffer dst)

Ghi dữ liệu của 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
BufferOverflowNgoại lệ Nếu không có đủ dung lượng trong bộ đệm đã cho cho dữ liệu trong tensor này
Đối số bất hợp phápNgoại lệ 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 tenxơ 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
BufferOverflowNgoại lệ Nếu không có đủ dung lượng trong bộ đệm đã cho cho dữ liệu trong tensor này
Đối số bất hợp phápNgoại lệ 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 byte numBytes() vào bộ đệm theo thứ tự byte gốc cho các kiểu nguyên thủy.

Thông số
dst bộ đệm đích
Ném
BufferOverflowNgoại lệ Nếu không có đủ dung lượng trong bộ đệm đã cho cho dữ liệu trong tensor này

public void writeTo (FloatBuffer dst)

Ghi dữ liệu của 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
BufferOverflowNgoại lệ Nếu không có đủ dung lượng trong bộ đệm đã cho cho dữ liệu trong tensor này
Đối số bất hợp phápNgoại lệ Nếu kiểu dữ liệu tensor không phải là Float