Shape

הגודל של ציר לא ידוע או סך הגודל הלא ידוע עבור צורה לא ידועה.

מחזירה צורה חדשה, עם ממד אחרון חדש נוסף. כדי שהקריאה הזו תצליח, isUnknown() חייב להיות false .

מחזירה צורה חדשה, עם מימדים של צורות אחרות מצורפות. הן עבור הצורה הזו והן עבור הצורה האחרת, isUnknown() חייב להחזיר false. למשל @code Shape.of(3,4).append(Shape.of(1,2)) => Shape.of(3,4,1,2) }

מחזיר עותק הגנתי של הצירים של הצורה הזו. שינויים במערך המוחזר כדי לא לשנות את מצב הצורה הזו. מחזירה null אם isUnknown() נכון.

שווה יישום עבור Shapes. שתי צורות נחשבות שוות אם:

• מספר הממדים מוגדר ושווה עבור שניהם
• הגודל של כל מימד מוגדר ושווה עבור שניהם

אם לכל אחת מהצורה יש ממדים לא ידועים (גם אם הם זהים בשניהם) או אם לכל אחת מהצורה יש מספר לא ידוע של ממדים (גם אם שניהם מחזירים true עבור isUnknown() ), הם לא נחשבים שווים! עם זאת, צורה תמיד תשתווה לעצמה, גם אם היא לא ידועה או מכילה ממדים לא ידועים.

מחזירה אם לממד אחד או יותר של Shape זה יש גודל לא ידוע.

מחזירה צורה חד מימדית עם ממד ראשון התואם לממד הראשון של צורה זו.

בדוק אם שני ממדי צורות תואמים.

המידות תואמות אם אחד הממדים הוא 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.

מחזירה אם הצורה הזו היא צורה של מטריצה

מחזירה אם הצורה הזו מייצגת סקלאר.

מחזירה אם מספר הממדים של Shape זה אינו ידוע.

מחזירה אם הצורה הזו היא צורה של וקטור.

מחזירה את מספר הממדים של צורה זו. -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() הוא true או שלגודל הממד עם האינדקס הנתון יש גודל לא ידוע, UNKNOWN_SIZE מוחזר.

מחזירה את המספר הכולל של אלמנטים שיהיו לטנסור עם צורה זו.

אם isUnknown() הוא true או hasUnknownDimension() הוא true, UNKNOWN_SIZE מוחזר.

החזר צורת מימד end - begin עם ממדים התואמים את הצורה הזו begin ועד end .

מחזירה צורה חדשה, כשהממד הראשון של הצורה הזה הוסר.

מחזירה צורה N-ממדית עם הממדים התואמים ל-n הממדים הראשונים של צורה זו

מחזירה צורה N-ממדית עם הממדים התואמים ל-n הממדים האחרונים של צורה זו.

תיאור תמציתי של הצורה המיועדת לניפוי באגים.

יוצר צורה המייצגת מספר לא ידוע של ממדים.