Shape

Kích thước của trục không xác định hoặc tổng kích thước không xác định đối với Hình dạng không xác định.

Trả về một Hình dạng mới, với kích thước cuối cùng mới được thêm vào. Để lệnh gọi này thành công, isUnknown() phải là false .

Trả về một Hình dạng mới, với các kích thước của Hình dạng khác được thêm vào. Đối với cả Hình dạng này và Hình dạng khác, isUnknown() phải trả về false. Ví dụ: @code Shape.of(3,4).append(Shape.of(1,2)) => Shape.of(3,4,1,2) }

Trả về bản sao phòng thủ của các trục của Hình dạng này. Thay đổi mảng được trả về để không thay đổi trạng thái của Hình dạng này. Trả về null nếu isUnknown() là đúng.

Triển khai tương đương cho Hình dạng. Hai hình dạng được coi là bằng nhau nếu:

• số lượng kích thước được xác định và bằng nhau cho cả hai
• kích thước của mỗi chiều được xác định và bằng nhau cho cả hai

Nếu một trong hai Hình dạng có kích thước không xác định (ngay cả khi chúng giống nhau ở cả hai) hoặc nếu một trong hai hình dạng có số kích thước không xác định (ngay cả khi cả hai đều trả về true cho isUnknown() ), thì chúng không được coi là bằng nhau! Tuy nhiên, một hình sẽ luôn bằng chính nó, ngay cả khi nó không xác định hoặc chứa các kích thước không xác định.

Trả về xem một hoặc nhiều kích thước của Hình dạng này có kích thước không xác định.

Trả về Hình dạng 1 chiều với chiều thứ nhất khớp với chiều thứ nhất của Hình dạng này.

Kiểm tra xem hai kích thước hình dạng có tương thích hay không.

Các thứ nguyên tương thích nếu một trong hai thứ nguyên là Shape.UNKNOWN_SIZE hoặc cả hai thứ nguyên đều bằng nhau

Xác định xem hình dạng khác có tương thích với hình dạng này hay không.

Hai hình dạng có thể được xác định một phần sẽ tương thích nếu tồn tại một hình dạng được xác định đầy đủ mà cả hai hình dạng đều có thể biểu diễn. Do đó, tính tương thích cho phép mã suy luận hình dạng suy luận về các hình dạng được xác định một phần. Ví dụ:

• Shape.unknown() tương thích với tất cả các hình dạng.
• Shape(UNKNOWN_SIZE, UNKNOWN_SIZE) tương thích với tất cả các hình dạng hai chiều, chẳng hạn như Shape(32, 784) và cả Shape.unknown() . Ví dụ: nó không tương thích với Shape(UNKNOWN_SIZE) hoặc Shape(UNKNOWN_SIZE, UNKNOWN_SIZE, UNKNOWN_SIZE) .
• Shape(32, UNKNOWN_SIZE) tương thích với tất cả các hình dạng hai chiều có kích thước 32 ở chiều thứ 0, cũng như Shape(UNKNOWN_SIZE, UNKNOWN_SIZE) và Shape.unknown() . Nó không tương thích với, ví dụ: Shape(32) , Shape(32, UNKNOWN_SIZE, 1) hoặc Shape(64, UNKNOWN_SIZE) .
• Shape(32, 784) tương thích với chính nó và cả Shape(32, UNKNOWN_SIZE) , Shape(UNKNOWN_SIZE, 784) , Shape(UNKNOWN_SIZE, UNKNOWN_SIZE) và Shape.unknown() . Ví dụ: nó không tương thích với Shape(32, 1, 784) hoặc Shape(UNKNOWN_SIZE) .

Mối quan hệ tương thích có tính chất phản xạ và đối xứng nhưng không mang tính bắc cầu. Ví dụ: Shape(32, 784) tương thích với Shape.unknown() và Shape.unknown() tương thích với Shape(4, 4) , nhưng Shape(32, 784) không tương thích với Shape(4, 4) .

Khả năng tương thích không giống như phát sóng. Các hình dạng tương thích phải có cùng số thứ nguyên và đối với mỗi cặp thứ nguyên, một thứ nguyên phải bằng các thứ nguyên khác hoặc ít nhất một trong các thứ nguyên trong cặp phải là UNKNOWN_SIZE.

Việc phát sóng cho phép các kích thước khác nhau nhưng các kích thước được ghép nối phải bằng nhau hoặc một kích thước phải bằng 1. Nếu một hình có ít kích thước hơn hình khác thì hình nhỏ hơn sẽ được "kéo dài" với kích thước là 1.

Trả về xem Hình dạng này có phải là hình dạng của ma trận hay không

Trả về xem Hình dạng này có đại diện cho một đại lượng vô hướng hay không.

Trả về số lượng kích thước của Hình dạng này có phải là không xác định hay không.

Trả về xem Hình dạng này có phải là hình dạng của vectơ hay không.

Trả về số kích thước của Hình dạng này. -1 nếu không xác định, 0 cho đại lượng vô hướng, 1 cho vectơ, 2 cho ma trận, v.v.

Tạo Hình dạng biểu thị giá trị vô hướng hoặc N chiều.

Tạo Hình dạng biểu thị giá trị vô hướng hoặc N chiều (N ít nhất là 1), với kích thước được cung cấp cho mỗi chiều. A -1 chỉ ra rằng kích thước của kích thước tương ứng là không xác định. Nếu không có kích thước nào được cung cấp thì Hình dạng đại diện cho vô hướng sẽ được tạo. Ví dụ:

// A 2-element vector.
 Shape vector = Shape.of(2);

 // A 2x3 matrix.
 Shape matrix = Shape.of(2, 3);

 // A matrix with 4 columns but an unknown number of rows.
 // This is typically used to indicate the shape of tensors that represent
 // a variable-sized batch of values. The Shape below might represent a
 // variable-sized batch of 4-element vectors.
 Shape batch = Shape.of(-1, 4);

 // A scalar. For readability, you should prefer calling Shape.scalar()
 Shape scalar = Shape.of()
 

Trả về một Hình dạng mới, với các kích thước của Hình dạng khác được thêm vào trước. Đối với cả Hình dạng này và Hình dạng khác, isUnknown() phải trả về false. Ví dụ: Shape.of(3,4).prepend(Shape.of(1,2)) => Shape.of(1,2,3,4)

Trả về một Hình dạng mới, với chiều thứ nguyên đầu tiên mới được thêm vào. Để lệnh gọi này thành công, isUnknown() phải là false .

Tạo một Hình dạng biểu thị một giá trị vô hướng.

Kích thước của kích thước với chỉ số đã cho.

Nếu isUnknown() là đúng hoặc kích thước của thứ nguyên với chỉ mục đã cho có kích thước không xác định thì UNKNOWN_SIZE sẽ được trả về.

Trả về tổng số phần tử mà Tensor có Hình dạng này sẽ có.

Nếu isUnknown() là đúng hoặc hasUnknownDimension() là đúng thì UNKNOWN_SIZE sẽ được trả về.

Trả về một hình dạng có chiều end - begin với các kích thước khớp với Hình dạng này từ begin đến end .

Trả về một Hình dạng mới, với chiều thứ nhất của Hình dạng này đã bị loại bỏ.

Trả về Hình dạng n chiều có kích thước khớp với n kích thước đầu tiên của hình dạng này

Trả về một Hình dạng n chiều với các kích thước khớp với n kích thước cuối cùng của Hình dạng này.

Mô tả ngắn gọn về Hình dạng dùng để gỡ lỗi.

Tạo một Hình dạng đại diện cho một số kích thước không xác định.