BoundingBoxUtil

שיעור הגמר הציבורי BoundingBoxUtil

מחלקה עוזרת להמרת ערכים המייצגים תיבות תוחמות למלבנים.

המחלקה מספקת פונקציה סטטית ליצירת תיבות תוחמות כ- RectF מסוגים שונים של תצורות.

בדרך כלל, תיבה תוחמת יכולה להיות מיוצגת על ידי 4 ערכי צפים, אך ניתן לפרש את הערכים בדרכים רבות. כעת אנו תומכים ב-3 BoundingBoxUtil.Type של תצורות, וסדר האלמנטים בכל סוג ניתן להגדרה גם כן.

כיתות מקוננות

enum BoundingBoxUtil.CoordinateType מציין אם הקואורדינטות הן פיקסלים בפועל או יחסים יחסיים.
enum BoundingBoxUtil.Type מציין כיצד מיוצגת תיבה תוחמת.

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

רשימה סטטית <RectF>
convert ( TensorBuffer tensor, int[] valueIndex, int boundingBoxAxis, BoundingBoxUtil.Type type, BoundingBoxUtil.CoordinateType coordinateType, int height, int width)
יוצר רשימה של תיבות תוחמות מתוך TensorBuffer המייצג תיבות תוחמות.

שיטות בירושה

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

רשימה סטטית ציבורית <RectF> המרה ( TensorBuffer tensor, int[] valueIndex, int boundingBoxAxis, BoundingBoxUtil.Type type, BoundingBoxUtil.CoordinateType coordinateType, int height, int width)

יוצר רשימה של תיבות תוחמות מתוך TensorBuffer המייצג תיבות תוחמות.

פרמטרים
מוֹתֵחַ מחזיק את הנתונים המייצגים כמה תיבות.
valueIndex מציין את סדר האלמנטים המוגדרים בכל סוג תיבה תוחמת. מערך אינדקס ריק מייצג את סדר ברירת המחדל של כל סוג תיבה תוחמת. לדוגמה, כדי לציין את סדר ברירת המחדל של BOUNDARIES, {left, top, right, bottom}, האינדקס צריך להיות {0, 1, 2, 3}. כדי לציין את הסדר {left, right, top, bottom}, הסדר צריך להיות {0, 2, 1, 3}.

ניתן להחיל את מערך האינדקס על כל סוגי התיבות התוחמות כדי להתאים את הסדר של האלמנטים הבסיסיים המתאימים להם.

boundingBoxAxis מציין את האינדקס של הממד המייצג את התיבה התוחמת. הגודל של הממד הזה נדרש להיות 4. האינדקס כאן מתחיל מ-0. לדוגמה, אם לטנזור יש צורה 4x10, סביר להניח שהציר עבור תיבות תוחמות יהיה 0. ציר שלילי נתמך גם: -1 נותן את הציר האחרון ו-2 נותן את השני וכו'. עבור צורה 10x4, הציר צפוי להיות 1 (או -1, באופן שווה ערך).
סוּג מגדיר כיצד יש להמיר ערכים לתיבות. ראה BoundingBoxUtil.Type
coordinateType מגדיר כיצד ערכים מתפרשים לקואורדינטות. ראה BoundingBoxUtil.CoordinateType
גוֹבַה גובה התמונה שאליה שייכות הקופסאות. יש השפעות רק כאשר coordinateType הוא BoundingBoxUtil.CoordinateType.RATIO
רוֹחַב רוחב התמונה שאליה שייכות הקופסאות. יש השפעות רק כאשר coordinateType הוא BoundingBoxUtil.CoordinateType.RATIO
החזרות
  • רשימה של תיבות תוחמות tensor מייצג. כל הממדים למעט boundingBoxAxis יכוווצו עם הסדר שנשמר. לדוגמה, בהינתן tensor עם צורה {1, 4, 10, 2} ו- boundingBoxAxis = 1 , התוצאה תהיה רשימה של 20 תיבות תוחמות.
זורק
חריג טיעון לא חוקי אם הגודל של ממד התיבה התוחמת (מוגדר על ידי boundingBoxAxis ) אינו 4.
חריג טיעון לא חוקי אם boundingBoxAxis אינו ב (-(D+1), D) כאשר D הוא מספר הממדים של tensor .
חריג טיעון לא חוקי אם tensor יש סוג נתונים אחר מאשר DataType.FLOAT32 .