דף זה תורגם על ידי Cloud Translation API.
Switch to English

tfds.features.Video

צפה במקור ב- GitHub

FeatureConnector לסרטונים, קידוד מסגרות בנפרד על הדיסק.

ירושות מאת: Sequence

וידאו: מחבר התמונה מקבל כקלט מערך tf.uint8 4 ממדי המייצג וידאו, רצף של נתיבים למסגרות מקודדות, או נתיב או אובייקט קובץ הניתן לפענוח באמצעות ffmpeg. שים לב שלא כל הפורמטים ב- ffmpeg תומכים בקריאה מצינורות, ולכן אספקת אובייקט קובץ עשויה להיכשל. יתר על כן, אם ניתן נתיב שאינו במערכת הקבצים המקומית, אנו נעתיק אותו לראשונה לקובץ מקומי זמני לפני שנעביר אותו ל- ffmpeg.

תְפוּקָה:

  • video : tf.tensor מסוג tf.uint8 וצורה [מספר_מסגרות, גובה, רוחב, ערוצים], שבהם הערוצים חייבים להיות 1 או 3

דוגמא:

  • באובייקט DatasetInfo:
features=features.FeatureDict({
    'video': features.Video(shape=(None, 64, 64, 3)),
})
  • במהלך הדור, אתה יכול להשתמש בכל אחד מ:
yield {
    'video': np.ones(shape=(128, 64, 64, 3), dtype=np.uint8),
}

או רשימת מסגרות:

yield {
    'video': ['path/to/frame001.png', 'path/to/frame002.png'],
}

או נתיב לווידיאו:

yield {
    'video': '/path/to/video.avi',
}

או אובייקט קובץ:

yield {
    'video': tf.io.gfile.GFile('/complex/path/video.avi'),
}

shape קלטת אינץ ', צורת הווידיאו (מספר_מסגרות, גובה, רוחב, ערוצים), כאשר הערוצים הם 1 או 3.
encoding_format הסרטון מאוחסן כרצף של תמונות מקודדות. אתה יכול להשתמש בכל פורמט קידוד הנתמך על ידי image_feature.Feature.
ffmpeg_extra_args רצף של טענות נוספות שיועברו לבינארי ffmpeg. באופן ספציפי, ffmpeg ייקרא בשם: ffmpeg -i <input_file> <ffmpeg_extra_args> %010d.<encoding_format>

ValueError אם הצורה אינה תקפה

dtype החזר את ה- dtype (או הכתובת ל- dtype) של FeatureConnector זה.
feature התכונה הפנימית.
shape החזר את הצורה (או הכותרת של הצורה) של FeatureConnector זה.

שיטות

decode_batch_example

ראה מקור

פענח מספר תכונות הנמצאות במעגל tf.tensor יחיד.

פונקציה זו משמשת לפענוח תכונות עטופות ב- tfds.features.Sequence() . כברירת מחדל, פונקציה זו מיישמת decode_example על כל אלמנטים בודדים המשתמשים tf.map_fn . עם זאת, לצורך מיטוב, תכונות יכולות להחליף שיטה זו ליישום פענוח אצווה מותאם אישית.

ארגס
tfexample_data אותם כניסות tf.Tensor כמו decode_example , אך עם ממד ראשון נוסף ואורך הרצף.

החזרות
tensor_data טנסור או מילון טנזור, פלט של האובייקט tf.data.Dataset

decode_example

ראה מקור

פענח את דוגמאות ההמשכים.

ארגס
serialized_example מקונן dict של tf.Tensor
decoders מקונן של אובייקטים Decoder המאפשרים להתאים אישית את הפענוח. המבנה אמור להתאים למבנה התכונה, אך רק מקשי תכונה מותאמים אישית צריכים להיות קיימים. עיין במדריך למידע נוסף.

החזרות
example מקונן dict המכיל דוגמא המקוננות המפוענחות.

decode_ragged_example

ראה מקור

פענח תכונות מקוננות ממכשיר tf.Ragged Tensor.

פונקציה זו משמשת לפענוח תכונות עטופות tfds.features.Sequence() מקוננות tfds.features.Sequence() . כברירת מחדל, פונקציה זו מיישמת decode_batch_example על הערכים השטוחים של הטנסור המרופט. לצורך מיטוב, תכונות יכולות להחליף שיטה זו ליישום פענוח אצווה מותאם אישית.

ארגס
tfexample_data tf.RaggedTensor כניסות המכילות את הדוגמאות המקודדות המקוננות.

החזרות
tensor_data tf.RaggedTensor או מילון הטנזור, הפלט של האובייקט tf.data.Dataset

encode_example

ראה מקור

ממיר את התמונה הנתונה לדיקטט להמרה לדוגמה.

get_serialized_info

ראה מקור

ראה מחלקת בסיס לפרטים.

get_tensor_info

ראה מקור

ראה מחלקת בסיס לפרטים.

load_metadata

ראה מקור

ראה מחלקת בסיס לפרטים.

save_metadata

ראה מקור

ראה מחלקת בסיס לפרטים.

__getitem__

ראה מקור

שיטת נוחות לגישה לתכונות הבסיסיות.