Shape

حجم المحور غير المعروف أو الحجم الإجمالي غير المعروف لشكل غير معروف.

إرجاع شكل جديد، مع إضافة بُعد أخير جديد. لكي ينجح هذا الاستدعاء، يجب أن تكون isUnknown() false .

إرجاع شكل جديد، مع إضافة أبعاد أشكال أخرى. لكل من هذا الشكل والشكل الآخر، يجب أن يُرجع التابع isUnknown() false. على سبيل المثال @code Shape.of(3,4).append(Shape.of(1,2)) => Shape.of(3,4,1,2) }

إرجاع نسخة دفاعية من محاور هذا الشكل. التغييرات التي تم إجراؤها على المصفوفة التي تم إرجاعها حتى لا تغير حالة هذا الشكل. يُرجع قيمة فارغة إذا كانت isUnknown() ‎ صحيحة.

يساوي التنفيذ للأشكال. يعتبر الشكلان متساويين إذا:

• عدد الأبعاد محدد ومتساوي لكليهما
• حجم كل بعد محدد ومتساوي لكليهما

إذا كان لأي من الشكلين أبعاد غير معروفة (حتى لو كانت متماثلة في كليهما) أو إذا كان لأي من الشكلين عدد غير معروف من الأبعاد (حتى لو كان كلاهما true لـ isUnknown() ) ، فلا يعتبران متساويين! ومع ذلك، فإن الشكل يساوي نفسه دائمًا، حتى لو كان غير معروف أو يحتوي على أبعاد غير معروفة.

إرجاع ما إذا كان حجم واحد أو أكثر من أبعاد هذا الشكل غير معروف.

إرجاع شكل أحادي البعد مع مطابقة البعد الأول للبعد الأول لهذا الشكل.

اختبار لمعرفة ما إذا كان بعدان للشكل متوافقين.

تكون الأبعاد متوافقة إذا كان أحد البعدين هو 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) .

التوافق ليس هو نفسه البث. يجب أن تحتوي الأشكال المتوافقة على نفس عدد الأبعاد ولكل زوج أبعاد، يجب أن يكون أحد الأبعاد مساويًا للأبعاد الأخرى أو يجب أن يكون أحد الأبعاد في الزوج على الأقل 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 .

تُرجع العدد الإجمالي للعناصر التي قد يحتوي عليها Tensor بهذا الشكل.

إذا كانت isUnknown() صحيحة أو hasUnknownDimension() صحيحة، فسيتم إرجاع UNKNOWN_SIZE .

قم بإرجاع شكل ذو أبعاد end - begin بأبعاد مطابقة لهذا الشكل من begin إلى end .

إرجاع شكل جديد، مع إزالة البعد الأول لهذا الشكل.

إرجاع شكل ذو أبعاد n بأبعاد تطابق الأبعاد n الأولى لهذا الشكل

تُرجع شكلاً ذو أبعاد n بأبعاد تطابق آخر أبعاد n لهذا الشكل.

وصف موجز للشكل المخصص لتصحيح الأخطاء.

إنشاء شكل يمثل عددًا غير معروف من الأبعاد.