Tensor

ממשק ציבורי Tensor

מערך רב-ממדי מוקלד שנעשה בו שימוש ב-Tensorflow Lite.

הכינוי המקורי של Tensor מנוהל על ידי NativeInterpreterWrapper, ובנוסף שלא צריך להיסגר על ידי הלקוח. עם זאת, ברגע שה-NativeInterpreterWrapper כולל נסגר, נקודת האחיזה של Tensor תבוטל.

מחלקות מקוננות

מחלקה Tensor.QuantizationParams פרמטרים של כימות שתואמים לטבלה, QuantizationParameters, TFLite קובץ של סכימת מודל.

שיטות ציבוריות

מופשט ByteBuffer
asReadOnlyBuffer()
מחזירה תצוגת ByteBuffer לקריאה בלבד של נתוני הטנזור.
מופשט DataType
dataType()
הפונקציה מחזירה את DataType של האלמנטים שמאוחסנים ב-Tensor.
מופשט INT
numBytes()
מחזירה את הגודל בבייטים של נתוני הטנזור.
מופשט INT
numDimensions()
מחזירה את מספר המאפיינים (נקרא לפעמים דירוג) של ה-Tensor.
מופשט INT
numElements()
מחזירה את מספר הרכיבים בתצוגה שטוחה (1-D) של הtenor.
מופשט Tensor.QuantizationParams
quantizationParams()
מחזירה את פרמטרים הקוונטיזציה של הטנזור בתוך המתרגם שבבעלותו.
מופשט int[]
shape()
הפונקציה מחזירה את הצורה של את Tensor, כלומר, את הגדלים של כל מאפיין.
מופשט int[]
shapeSignature()
הפונקציה מחזירה את הצורה המקורית של ה-Tensor, כלומר, הגדלים של כל מימד - לפני שבוצעה שינוי גודל כלשהו.

שיטות ציבוריות

ציבורי מופשט ByteBuffer asReadOnlyBuffer ()

מחזירה תצוגת ByteBuffer לקריאה בלבד של נתוני הטנזור.

באופן כללי, השיטה הזו הכי שימושית לקבלת תצוגה לקריאה בלבד של נתוני tensor מסוג פלט, *אחרי* ביצוע ההסקה (למשל, דרך InterpreterApi.run(Object, Object)). לחשבון באופן ספציפי, לחלק מהתרשימים יש פלטים בעיצוב דינמי, מה שעשוי להפוך את הפיד למוגדר מראש מאגר נתונים זמני לפירוש, באופן מוזר. שימוש לדוגמה: 

 interpreter.run(input, null);
 ByteBuffer outputBuffer = interpreter.getOutputTensor(0).asReadOnlyBuffer();
 // Copy or read from outputBuffer.

אזהרה: אם הטנזור עדיין לא הוקצה, למשל לפני ביצוע ההסקה, התוצאה לא מוגדרת. חשוב לשים לב שמצביע ה-tensor הבסיסי עשוי להשתנות גם הוא כאשר tensor לא תקף בצורה כלשהי (למשל, אם ההסקה מבוצעת או אם גודל הגרף משתנה), לכן *לא* בטוח לשמור הפניה למאגר הנתונים הזמני שמוחזר מעבר לשימוש ישיר לאחר ההסקה הזו. דוגמה לשימוש *רע*: 

 ByteBuffer outputBuffer = interpreter.getOutputTensor(0).asReadOnlyBuffer();
 interpreter.run(input, null);
 // Copy or read from outputBuffer (which may now be invalid).

קליעות
IllegalArgumentException אם נתוני הטנזור לא הוקצו.

ציבורי מופשט DataType dataType ()

הפונקציה מחזירה את DataType של האלמנטים שמאוחסנים ב-Tensor.

ציבורי מופשט INT numBytes ()

מחזירה את הגודל בבייטים של נתוני הטנזור.

ציבורי מופשט INT numDimensions ()

מחזירה את מספר המאפיינים (נקרא לפעמים דירוג) של ה-Tensor.

יהיה 0 לסקלר, 1 לווקטור, 2 למטריצה, 3 למשתנה תלת-ממדי וכו'.

ציבורי מופשט INT numElements ()

מחזירה את מספר הרכיבים בתצוגה שטוחה (1-D) של הtenor.

ציבורי מופשט Tensor.QuantizationParams quantizationParams ()

מחזירה את פרמטרים הקוונטיזציה של הטנזור בתוך המתרגם שבבעלותו.

רק לטינורים כמותיים יש ערך QuantizationParameters חוקי. עבור tensor שלא כמותית, ערכי הסולם ו-0_point הם 0.

ציבורי מופשט int[] צורה ()

הפונקציה מחזירה את הצורה של את Tensor, כלומר, את הגדלים של כל מאפיין.

החזרות
  • מערך שבו הרכיב i-th הוא גודל המימד ה-i-th של הtenor.

ציבורי מופשט int[] shapeSignature ()

הפונקציה מחזירה את הצורה המקורית של ה-Tensor, כלומר, הגדלים של כל מימד - לפני שבוצעה שינוי גודל כלשהו. מאפיינים לא ידועים הם מסומן עם ערך של 1-.

החזרות
  • מערך שבו הרכיב i-th הוא גודל המימד ה-i-th של הtenor.