Enriching model card for improved discoverability and consumption

README.md

@@ -2,11 +2,59 @@
 language: en
 tags:
 - tvp
+- intel
+- cvpr
+- charades
 license: other
 datasets:
 - charades
+library_name: transformers
 ---
 
+# TVP base model
+
+| Model Detail | Description |
+| ----------- | ----------- | 
+| Model Authors | Yimeng Zhang, Xin Chen, Jinghan Jia, Sijia Liu, Ke Ding | 
+| Date | 2023 | 
+| Version | Base | 
+| Type | Text-Visual Prompting for Temporal Video Grounding | 
+| Paper or Other Resources | Base model: [mosaicml/mpt-7b](https://huggingface.co/mosaicml/mpt-7b); Dataset: [Charades](https://prior.allenai.org/projects/charades) | 
+| License | Other |
+| Questions or Comments | [Community Tab](https://huggingface.co/Intel/tvp-base/discussions) and [Intel DevHub Discord](https://discord.gg/rv2Gp55UJQ)|
+
+| Intended Use | Description |
+| ----------- | ----------- | 
+| Primary intended uses | The TVP model is designed for temporal video grounding (TVG), specifically to predict the start and end times of moments described by a text sentence within a long, untrimmed video. | 
+| Primary intended users | Researchers and developers working in the field of computer vision, particularly those focused on video understanding and cross-modal (text and video) tasks. | 
+| Out-of-scope uses | The model is not intended for real-time video processing or applications requiring 3D visual features extraction due to its design for efficiency with 2D features.  |
+
+
+# Factors
+Relevant factors: The model's performance may vary across different video content, such as variations in video quality, lighting conditions, or genres (e.g., action vs. dialogue-heavy scenes).
+Evaluation factors: Performance has been evaluated on benchmark datasets like Charades-STA and ActivityNet Captions, focusing on metrics relevant to temporal video grounding accuracy. 
+
+# Metrics
+
+Model performance measures: The model employs metrics such as the Temporal-Distance IoU (TDIoU) loss for efficient learning and performance evaluation in TVG tasks.
+
+Experiments on two benchmark datasets, Charades-STA and ActivityNet Captions datasets, empirically show that the proposed TVP significantly boosts the performance of 2D TVG (e.g., 9.79% improvement on Charades-STA and 30.77% improvement on ActivityNet Captions) and achieves 5× inference acceleration over TVG using 3D visual features.
+
+# Training Data
+
+The TVP model was pretrained on public datasets such as Charades.
+
+Charades is dataset composed of 9848 videos of daily indoors activities collected through Amazon Mechanical Turk. 267 different users were presented with a sentence, that includes objects and actions from a fixed vocabulary, and they recorded a video acting out the sentence (like in a game of Charades). The dataset contains 66,500 temporal annotations for 157 action classes, 41,104 labels for 46 object classes, and 27,847 textual descriptions of the videos. This work was presented at ECCV2016.
+
+Each video has been exhaustively annotated using consensus from 4 workers on the training set, and from 8 workers on the test set. Please refer to the updated accompanying publication for details. Please contact vision.amt@allenai.org for questions about the dataset.
+
+# Quantitative Analyses
+
+Unitary results: Refer to Table 2 in the provided paper for TVP's performance on the Temporal Video Grounding task.
+
+![image/png](https://cdn-uploads.huggingface.co/production/uploads/63e1cfa7f9927d9455acdc72/WOeve3VDZU2WvoXfvoK5X.png)
+
+
 # TVP base model
 
 The TVP model was proposed in [Text-Visual Prompting for Efficient 2D Temporal Video Grounding](https://arxiv.org/abs/2303.04995) by Yimeng Zhang, Xin Chen, Jinghan Jia, Sijia Liu, Ke Ding. The goal of
@@ -156,29 +204,6 @@ start, end = round(timestamp[0][0]*duration, 1), round(timestamp[0][1]*duration,
 print(f"The time slot of the video corresponding to the text \"{text}\" is from {start}s to {end}s")
 ```
 
-### Limitations and bias
-
-TODO
-
-## Training data
-
-The TVP model was pretrained on public datasets:
-- [charades](https://prior.allenai.org/projects/charades), 
-
-## Training procedure
-
-### Preprocessing
-
-TODO
-
-### Pretraining
-
-TODO
-
-## Evaluation results
-
-Please refer to [Table 2](https://arxiv.org/pdf/2303.04995.pdf) for TVP's performance on Temporal Video Grounding task.
-
 ### BibTeX entry and citation info
 ```bibtex
 @inproceedings{zhang2023text,
@@ -189,3 +214,6 @@ Please refer to [Table 2](https://arxiv.org/pdf/2303.04995.pdf) for TVP's perfor
   year={2023}
 }
 ```
+
+Disclaimer
+The license on this model does not constitute legal advice. We are not responsible for the actions of third parties who use this model. Please cosult an attorney before using this model for commercial purposes.