Files changed (1) hide show
  1. README.md +18 -36
README.md CHANGED
@@ -6,52 +6,43 @@ tags:
6
  ---
7
 
8
  # VideoPrism Model Card
 
9
 
10
- **Paper page**: https://huggingface.co/papers/2402.13217
11
 
12
- **Arxiv**: https://arxiv.org/pdf/2402.13217
13
 
14
- **Github link**: https://github.com/google-deepmind/videoprism
15
-
16
- **Blogpost**: https://research.google/blog/videoprism-a-foundational-visual-encoder-for-video-understanding/
17
 
18
  VideoPrism is a foundational video encoder that enables state-of-the-art performance on a large variety of video understanding tasks. It takes video frames as input and outputs compact embeddings of the frames, which one can conveniently feed into classifiers, LLMs, retrieval models, etc. When tested on 33 public video understanding benchmarks over four task categories, a single frozen VideoPrism checkpoint outperforms previous best-performing foundation models on 31 of them, with no fine-tuning on target task datasets.
19
 
20
- ## Model Details
21
-
22
- ### Model Description
23
 
 
24
  VideoPrism-B/L are the composition of a Vision Transformer image encoder and four temporal-attention Transformer layers. The image encoder and text encoder are initialized from [CoCa](https://arxiv.org/abs/2205.01917), which is trained on WebLI following the CoCa recipes. VideoPrism is based on the [ViViT](https://arxiv.org/abs/2103.15691) factorized video encoder architecture.
25
 
26
  ### Inputs and outputs
27
  The models take videos with shape (num_frames, 288, 288, 3) as inputs and outputs embeddings with shape (num_frames * 16 * 16, feature_channels) which could be reshaped into (num_frames, 16, 16, feature_channels) for spatiotemporal representations. During model training, num_frames is set to 16 and 8 for VideoPrism-B and VideoPrism-L, respectively. Both models are expected to work with arbitrary num_frames by interpolating the temporal positional embeddings.
28
 
29
-
30
  ## Uses
31
-
32
  VideoPrism has a wide range of applications across various video understanding scenarios. The following lists some primary use cases and yet is not comprehensive. The purpose of this list is to provide contextual information the model creators considered as part of model training and development.
33
  * **Video classification**: By feeding the video embeddings to a lightweight classifier, we can tackle video action recognition, a fundamental task in video understanding, under various scenarios.
34
- * **Temporal and spatiotemporal localization**: We can also use the model to localize actions of interest spatially across time by equipping it with a bounding box proposal.
35
  * **Video retrieval and open-set classification**: By pairing up the video embeddings with a text encoder in the CLIP fashion, we can do text-video retrieval and open-set video classification.
36
 
37
-
38
- ## Ethical Considerations and Risks
39
-
40
  The model inherits the safety benefits and safety risks associated with the image encoder CoCa and the training datasets described above. We recommend that the model should not be used for downstream applications without prior assessment and mitigation of downstream application-specific security and fairness concerns.
41
- * Data Bias: Large datasets scraped from the internet can contain inherent biases, leading to skewed model performance and potentially discriminatory outputs. The presence of "noisy parallel text" like ASR transcripts introduces potential inaccuracies and biases from the speech-to-text process.
42
- * Content Moderation: The sheer volume of data (36M video-caption pairs and 582M video clips) raises concerns about the presence of objectionable or inappropriate content within the training data, which could lead to harmful model outputs.
43
- * Ethical Use: As with any powerful video understanding model, there are risks of misuse, such as in surveillance or the propagation of misinformation.
44
- * Limitations: The reliance on potentially noisy text data can limit the models understanding of the true video content. Further research is needed to refine the models ability to understand long form videos, geometric information in videos, and non-semantic cues.
45
-
46
-
47
- ## How to Get Started with the Model
48
-
49
- Use the code at our Github to get started with the model: https://github.com/google-deepmind/videoprism.
50
 
51
- ## Training Details
 
52
 
53
- ### Training Data
54
 
 
55
  VideoPrism is pre-trained on a wide range of videos (36M video-caption pairs and 582M video clips), including the datasets below. Note that the number of clips are subject to change due to wipeout according to policy.
56
 
57
  | Pretraining datasets | Public | Domain | Caption source | Caption quality | # of videos | # of clips |
@@ -67,7 +58,6 @@ VideoPrism is pre-trained on a wide range of videos (36M video-caption pairs and
67
  ## Evaluation
68
 
69
  ### Results on video-focused tasks with frozen backbones
70
-
71
  | Dataset | K400 | MiT | SSv2 | D48 | Charades | ActivityNet | AVA | AVA-K |
72
  | :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- |
73
  | VideoPrism-B (public) | 82.9 | 39.7 | 62.2 | 64.3 | 43.5 | 36.5 | 28.3 | 30.8 |
@@ -80,27 +70,19 @@ VideoPrism is pre-trained on a wide range of videos (36M video-caption pairs and
80
 
81
  "Public" denotes models we released in this repository. "Paper" and "Prior SOTA" denote our models and previous best-performing models reported in the paper, respectively. Our public models perform slightly worse than the paper models due to different pre-training image-text data we used subject to data policy.
82
 
 
83
 
84
-
85
- ## Implementation Information
86
-
87
- Details about the model internals.
88
-
89
- ### Model Architecture
90
-
91
  Vision model is a [ViViT](https://arxiv.org/abs/2103.15691) factorized video encoder architecture, initialized from the Vision Transformer image encoder ([CoCa](https://arxiv.org/abs/2205.01917)) followed by four temporal-attention Transformer layers.
92
 
93
  ### Hardware
94
-
95
  VideoPrism was trained using [Tensor Processing Unit
96
  (TPU)](https://cloud.google.com/tpu/docs/intro-to-tpu) hardware.
97
 
98
  #### Software
99
-
100
  JAX, Flax
101
 
102
  ## Citation
103
-
104
  VideoPrism:
105
  ```
106
  @inproceedings{zhao2024videoprism,
 
6
  ---
7
 
8
  # VideoPrism Model Card
9
+ **Paper**: https://huggingface.co/papers/2402.13217
10
 
11
+ **arXiv**: https://arxiv.org/pdf/2402.13217
12
 
13
+ **GitHub**: https://github.com/google-deepmind/videoprism
14
 
15
+ **Blog**: https://research.google/blog/videoprism-a-foundational-visual-encoder-for-video-understanding/
 
 
16
 
17
  VideoPrism is a foundational video encoder that enables state-of-the-art performance on a large variety of video understanding tasks. It takes video frames as input and outputs compact embeddings of the frames, which one can conveniently feed into classifiers, LLMs, retrieval models, etc. When tested on 33 public video understanding benchmarks over four task categories, a single frozen VideoPrism checkpoint outperforms previous best-performing foundation models on 31 of them, with no fine-tuning on target task datasets.
18
 
19
+ ## Model details
 
 
20
 
21
+ ### Model description
22
  VideoPrism-B/L are the composition of a Vision Transformer image encoder and four temporal-attention Transformer layers. The image encoder and text encoder are initialized from [CoCa](https://arxiv.org/abs/2205.01917), which is trained on WebLI following the CoCa recipes. VideoPrism is based on the [ViViT](https://arxiv.org/abs/2103.15691) factorized video encoder architecture.
23
 
24
  ### Inputs and outputs
25
  The models take videos with shape (num_frames, 288, 288, 3) as inputs and outputs embeddings with shape (num_frames * 16 * 16, feature_channels) which could be reshaped into (num_frames, 16, 16, feature_channels) for spatiotemporal representations. During model training, num_frames is set to 16 and 8 for VideoPrism-B and VideoPrism-L, respectively. Both models are expected to work with arbitrary num_frames by interpolating the temporal positional embeddings.
26
 
 
27
  ## Uses
 
28
  VideoPrism has a wide range of applications across various video understanding scenarios. The following lists some primary use cases and yet is not comprehensive. The purpose of this list is to provide contextual information the model creators considered as part of model training and development.
29
  * **Video classification**: By feeding the video embeddings to a lightweight classifier, we can tackle video action recognition, a fundamental task in video understanding, under various scenarios.
30
+ * **Temporal and spatiotemporal localization**: We can also use the model to localize actions of interest spatially across time by equipping it with a bounding box proposal.
31
  * **Video retrieval and open-set classification**: By pairing up the video embeddings with a text encoder in the CLIP fashion, we can do text-video retrieval and open-set video classification.
32
 
33
+ ## Ethical considerations and risks
 
 
34
  The model inherits the safety benefits and safety risks associated with the image encoder CoCa and the training datasets described above. We recommend that the model should not be used for downstream applications without prior assessment and mitigation of downstream application-specific security and fairness concerns.
35
+ * Data bias: Large datasets scraped from the internet can contain inherent biases, leading to skewed model performance and potentially discriminatory outputs. The presence of "noisy parallel text" like ASR transcripts introduces potential inaccuracies and biases from the speech-to-text process.
36
+ * Content moderation: The sheer volume of data (36M video-caption pairs and 582M video clips) raises concerns about the presence of objectionable or inappropriate content within the training data, which could lead to harmful model outputs.
37
+ * Ethical use: As with any powerful video understanding model, there are risks of misuse, such as in surveillance or the propagation of misinformation.
38
+ * Limitations: The reliance on potentially noisy text data can limit the models understanding of the true video content. Further research is needed to refine the models ability to understand long form videos, geometric information in videos, and non-semantic cues.
 
 
 
 
 
39
 
40
+ ## How to get started with the model
41
+ Use the code at our GitHub to get started with the model: https://github.com/google-deepmind/videoprism.
42
 
43
+ ## Training details
44
 
45
+ ### Training data
46
  VideoPrism is pre-trained on a wide range of videos (36M video-caption pairs and 582M video clips), including the datasets below. Note that the number of clips are subject to change due to wipeout according to policy.
47
 
48
  | Pretraining datasets | Public | Domain | Caption source | Caption quality | # of videos | # of clips |
 
58
  ## Evaluation
59
 
60
  ### Results on video-focused tasks with frozen backbones
 
61
  | Dataset | K400 | MiT | SSv2 | D48 | Charades | ActivityNet | AVA | AVA-K |
62
  | :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- |
63
  | VideoPrism-B (public) | 82.9 | 39.7 | 62.2 | 64.3 | 43.5 | 36.5 | 28.3 | 30.8 |
 
70
 
71
  "Public" denotes models we released in this repository. "Paper" and "Prior SOTA" denote our models and previous best-performing models reported in the paper, respectively. Our public models perform slightly worse than the paper models due to different pre-training image-text data we used subject to data policy.
72
 
73
+ ## Implementation information
74
 
75
+ ### Model architecture
 
 
 
 
 
 
76
  Vision model is a [ViViT](https://arxiv.org/abs/2103.15691) factorized video encoder architecture, initialized from the Vision Transformer image encoder ([CoCa](https://arxiv.org/abs/2205.01917)) followed by four temporal-attention Transformer layers.
77
 
78
  ### Hardware
 
79
  VideoPrism was trained using [Tensor Processing Unit
80
  (TPU)](https://cloud.google.com/tpu/docs/intro-to-tpu) hardware.
81
 
82
  #### Software
 
83
  JAX, Flax
84
 
85
  ## Citation
 
86
  VideoPrism:
87
  ```
88
  @inproceedings{zhao2024videoprism,