Shape

اندازه یک محور ناشناخته یا اندازه مجهول کل برای یک شکل ناشناخته.

یک شکل جدید را با آخرین بعد جدید اضافه می کند. برای موفقیت این فراخوانی، isUnknown() باید false باشد.

یک شکل جدید را با ابعاد شکل های دیگر اضافه می کند. هم برای این شکل و هم برای شکل دیگر، isUnknown() باید false را برگرداند. به عنوان مثال @code Shape.of(3,4).append(Shape.of(1,2)) => Shape.of(3,4,1,2) }

یک کپی دفاعی از محورهای این شکل را برمی‌گرداند. تغییر در آرایه برگشتی برای تغییر نکردن وضعیت این شکل. اگر isUnknown() true باشد، null را برمی گرداند.

برابر است با اجرای Shapes. دو شکل برابر در نظر گرفته می شوند که:

• تعداد ابعاد برای هر دو تعریف شده و برابر است
• اندازه هر بعد تعریف شده و برای هر دو برابر است

اگر یکی از Shape ابعاد مجهولی داشته باشد (حتی اگر در هر دو یکسان باشند) یا اگر هر کدام از شکل ها دارای تعداد نامعلومی از ابعاد باشند (حتی اگر هر دو برای isUnknown() true باشند، آنها برابر در نظر گرفته نمی شوند! با این حال، یک شکل همیشه با خودش برابر است، حتی اگر ناشناخته باشد یا دارای ابعاد ناشناخته باشد.

نشان می دهد که آیا یک یا چند بعد از این شکل اندازه نامعلومی دارند یا خیر.

یک شکل 1 بعدی با بعد اول مطابق با بعد اول این شکل را برمی‌گرداند.

تست کنید تا ببینید آیا دو بعد شکل با هم سازگار هستند یا خیر.

اگر هر یک از ابعاد Shape.UNKNOWN_SIZE یا هر دو بعد مساوی باشند، ابعاد سازگار هستند

تعیین می کند که آیا شکل دیگری با این شکل سازگار است یا خیر.

اگر یک شکل کاملاً تعریف شده وجود داشته باشد که هر دو شکل بتوانند آن را نشان دهند، دو شکل احتمالاً جزئی با هم سازگار هستند. بنابراین، سازگاری به کد استنتاج شکل اجازه می دهد تا در مورد اشکال نیمه تعریف شده استدلال کند. مثلا:

• Shape.unknown() با همه اشکال سازگار است.
• Shape(UNKNOWN_SIZE, UNKNOWN_SIZE) با تمام اشکال دو بعدی، مانند Shape(32, 784) و همچنین Shape.unknown() سازگار است. برای مثال، با Shape(UNKNOWN_SIZE) یا Shape(UNKNOWN_SIZE, UNKNOWN_SIZE, UNKNOWN_SIZE) سازگار نیست.
• Shape(32, UNKNOWN_SIZE) با تمام اشکال دو بعدی با اندازه 32 در بعد 0 و همچنین Shape(UNKNOWN_SIZE, UNKNOWN_SIZE) و Shape.unknown() سازگار است. برای مثال، با Shape(32) ، Shape(32, UNKNOWN_SIZE, 1) یا Shape(64, UNKNOWN_SIZE) سازگار نیست.
• Shape(32, 784) با خودش سازگار است و همچنین Shape(32, UNKNOWN_SIZE) , Shape(UNKNOWN_SIZE, 784) , Shape(UNKNOWN_SIZE, UNKNOWN_SIZE) و Shape.unknown() . برای مثال با Shape(32, 1, 784) یا Shape(UNKNOWN_SIZE) سازگار نیست.

رابطه سازگاری بازتابی و متقارن است، اما انتقالی نیست. برای مثال، Shape(32, 784) با Shape.unknown() و Shape.unknown() با Shape(4, 4) سازگار است، اما Shape(32, 784) با Shape(4, 4) سازگار نیست. Shape(4, 4) .

سازگاری با پخش یکسان نیست. اشکال سازگار باید تعداد ابعاد یکسانی داشته باشند و برای هر جفت بعد، یک بعد باید با ابعاد دیگر برابر باشد یا حداقل یکی از ابعاد در جفت باید UNKNOWN_SIZE باشد.

پخش ابعاد مختلف را مجاز می‌سازد، اما ابعاد زوج یا باید مساوی باشند، یا یک بعد باید 1 باشد. اگر ابعاد یک شکل کمتر از شکل دیگر باشد، شکل کوچک‌تر با ابعاد 1 "کشیده" می‌شود.

نشان می دهد که آیا این شکل شکل یک ماتریس است یا خیر

نشان می دهد که آیا این شکل یک اسکالر را نشان می دهد یا خیر.

نشان می دهد که آیا تعداد ابعاد این شکل ناشناخته است یا خیر.

برمی‌گرداند که آیا این شکل شکل یک بردار است یا خیر.

تعداد ابعاد این شکل را برمی‌گرداند. -1 در صورت ناشناخته، 0 برای یک اسکالر، 1 برای یک بردار، 2 برای یک ماتریس و غیره.

یک شکل ایجاد کنید که نشان دهنده یک مقدار اسکالر یا یک N بعدی است.

شکلی ایجاد می‌کند که نشان‌دهنده یک مقدار اسکالر یا یک N بعدی است (N حداقل 1 باشد)، با اندازه ارائه شده برای هر بعد. A -1 نشان می دهد که اندازه ابعاد مربوطه ناشناخته است. اگر هیچ اندازه ای ارائه نشود، شکلی که یک اسکالر را نشان می دهد ایجاد می شود. به عنوان مثال:

// 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()
 

یک شکل جدید را با ابعاد شکل دیگری برمی‌گرداند. هم برای این شکل و هم برای شکل دیگر، isUnknown() باید false را برگرداند. به عنوان مثال Shape.of(3,4).prepend(Shape.of(1,2)) => Shape.of(1,2,3,4)

یک شکل جدید را با یک بعد اول جدید اضافه می کند. برای موفقیت این فراخوانی، isUnknown() باید false باشد.

شکلی ایجاد می کند که یک مقدار اسکالر را نشان می دهد.

اندازه بعد با شاخص داده شده.

اگر isUnknown() درست باشد یا اندازه بعد با شاخص داده شده دارای اندازه ناشناخته باشد، UNKNOWN_SIZE برگردانده می شود.

تعداد کل عناصری که یک تانسور با این شکل خواهد داشت را برمی‌گرداند.

اگر isUnknown() true باشد یا hasUnknownDimension() true باشد، UNKNOWN_SIZE برگردانده می شود.

یک شکل بعدی end - begin با ابعادی مطابق با این شکل از begin تا end برگردانید.

یک شکل جدید را برمی‌گرداند که بعد اول این شکل حذف شده است.

یک شکل n بعدی را با ابعاد مطابق با n بعد اول این شکل برمی‌گرداند.

یک شکل n بعدی با ابعاد مطابق با n بعد آخر این شکل برمی‌گرداند.

شرح مختصر شکلی که برای اشکال زدایی در نظر گرفته شده است.

شکلی ایجاد می کند که تعداد نامعلومی از ابعاد را نشان می دهد.