https://github.com/bytedance/portrait-mode-video
Video dataset dedicated to portrait-mode video recognition.
Science Score: 36.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
○CITATION.cff file
-
✓codemeta.json file
Found codemeta.json file -
✓.zenodo.json file
Found .zenodo.json file -
○DOI references
-
✓Academic publication links
Links to: arxiv.org -
○Academic email domains
-
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (13.1%) to scientific vocabulary
Keywords
Repository
Video dataset dedicated to portrait-mode video recognition.
Basic Info
- Host: GitHub
- Owner: bytedance
- Language: Python
- Default Branch: main
- Homepage: https://mingfei.info/PMV
- Size: 3.93 MB
Statistics
- Stars: 48
- Watchers: 4
- Forks: 1
- Open Issues: 2
- Releases: 0
Topics
Metadata Files
README.md
Portrait-Mode Video Recognition
We are releasing our code and dataset regarding Portrait-Mode Video Recognition research. The videos are sourced from Douyin platform. We distribute video content through the provision of links. Users are responsible for downloading the videos independently.
Videos
The high-quality videos are filtered by humans, with human activities across wide-spread categories.
🚀🚀 Thanks for the support from the community. Please check the issue here for cached videos on OneDrive.
🚀🚀 Please check the annotation at Uniformer/data_list/PMV/ and text description of the categories at data/class_name_mapping.csv
Taxonomy
Please check our released taxonomy here. There is also an interactive demo of the taxonomy here.
Usage
We assume two directories for this project. {CODE_DIR} for the code respository; {PROJ_DIR} for the model logs, checkpoints and dataset.
To start with, please clone our code from Github
bash
git clone https://github.com/bytedance/Portrait-Mode-Video.git {CODE_DIR}
Python environment
We train our model with Python 3.7.3 and Pytorch 1.10.0. Please use the following command to install the packages used for our project.
First install pytorch following the official instructions. Then install other packages by
bash
pip3 install -r requirements.txt
Data downloading
Please refer to DATA.md for data downloading. We assume the videos are stored under {PROJ_DIR}/PMV_dataset. Category IDs for the released videos are under {CODE_DIR}/MViT/data_list/PMV and {CODE_DIR}/Uniformer/data_list/PMV.
Training
We provide bash scripts for training models using our PMV-400 data, as in exps/PMV/. A demo running script is
bash
bash exps/PMV/run_MViT_PMV.sh
For each model, e.g., MViT, we provide the scripts for different training recipes in a single bash scripts, e.g., exps/PMV/run_MViT_PMV.sh. Please choose the one suiting your purpose.
Note that you should set some environment variables in the bash scripts, such as WORKER_0_HOST, WORKER_NUM and WORKER_ID in run_SlowFast_MViTv2_S_16x4_PMV_release.sh; PROJ_DIR in run_{model}_PMV.sh.
Inference
We provide inference scripts for obtaining the report results in our paper. We also provide the trained model checkpoints.
License
Our code is licensed under an Apache 2.0 License. Our data is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International (CC BY-NC-SA 4.0) License. The data is released for non-commercial research purposes only.
By engaging in the downloading process, users are considered to have agreed to comply with our distribution license terms and conditions.
We would like to extend our thanks to the teams behind SlowFast code repository, 3Massiv, Kinetics and Uniformer. Our work builds upon their valuable contributions. Please acknowledge these resources in your work.
Owner
- Name: Bytedance Inc.
- Login: bytedance
- Kind: organization
- Location: Singapore
- Website: https://opensource.bytedance.com
- Twitter: ByteDanceOSS
- Repositories: 255
- Profile: https://github.com/bytedance
GitHub Events
Total
- Issues event: 3
- Watch event: 12
- Issue comment event: 3
- Push event: 1
Last Year
- Issues event: 3
- Watch event: 12
- Issue comment event: 3
- Push event: 1
Issues and Pull Requests
Last synced: about 1 year ago
All Time
- Total issues: 6
- Total pull requests: 0
- Average time to close issues: about 1 month
- Average time to close pull requests: N/A
- Total issue authors: 5
- Total pull request authors: 0
- Average comments per issue: 1.5
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0
Past Year
- Issues: 2
- Pull requests: 0
- Average time to close issues: about 2 months
- Average time to close pull requests: N/A
- Issue authors: 2
- Pull request authors: 0
- Average comments per issue: 1.0
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0
Top Authors
Issue Authors
- zhimin-z (2)
- Kerin637 (1)
- jmgrn61 (1)
- pear-blossoms (1)
- saicoco (1)
Pull Request Authors
Top Labels
Issue Labels
Pull Request Labels
Dependencies
- av *
- detectron2 *
- fairscale *
- matplotlib *
- opencv-python *
- pandas *
- pillow *
- psutil *
- pyyaml >=5.1
- simplejson *
- sklearn *
- tensorboard *
- termcolor >=1.1
- torchvision >=0.4.2
- tqdm *
- yacs >=0.1.6
- av *
- detectron2 *
- fairscale *
- matplotlib *
- moviepy *
- opencv-python *
- pandas *
- pillow *
- psutil *
- pyyaml >=5.1
- simplejson *
- sklearn *
- tensorboard *
- termcolor >=1.1
- torchvision >=0.4.2
- tqdm *
- yacs >=0.1.6
- av *
- detectron2 *
- matplotlib *
- opencv-python *
- pandas *
- pillow *
- psutil *
- pyyaml >=5.1
- simplejson *
- sklearn *
- tensorboard *
- termcolor >=1.1
- timm *
- torchvision >=0.4.2
- tqdm *
- yacs >=0.1.6
- Babel ==2.10.3
- Cython ==0.29.32
- Deprecated ==1.2.13
- GitPython ==3.1.27
- Jinja2 ==3.1.2
- Markdown ==3.4.1
- MarkupSafe ==2.1.1
- Pillow ==9.0.1
- PyGObject ==3.30.4
- PyJWT ==1.7.1
- PyYAML ==6.0
- Pygments ==2.13.0
- QtPy ==2.2.0
- Send2Trash ==1.8.0
- Werkzeug ==2.2.2
- absl-py ==1.2.0
- addict ==2.4.0
- aiohttp ==3.8.1
- aiosignal ==1.2.0
- antlr4-python3-runtime ==4.9.3
- anyio ==3.6.1
- argon2-cffi ==21.3.0
- argon2-cffi-bindings ==21.2.0
- asn1crypto ==1.4.0
- async-timeout ==4.0.2
- asynctest ==0.13.0
- attributee ==0.1.5
- attrs ==21.2.0
- av ==9.2.0
- backcall ==0.2.0
- beautifulsoup4 ==4.11.1
- bidict ==0.22.1
- black ==22.3.0
- bleach ==5.0.1
- braceexpand ==0.1.7
- bypy ==1.7.12
- cachetools ==5.2.0
- certifi ==2021.10.8
- cffi ==1.15.0
- chardet ==5.2.0
- charset-normalizer ==2.0.12
- chumpy ==0.70
- click ==7.1.2
- cloudpickle ==2.2.1
- colorama ==0.4.5
- commonmark ==0.9.1
- coverage ==6.4.4
- cryptography ==37.0.4
- cycler ==0.11.0
- datasets ==1.15.1
- debugpy ==1.6.3
- decorator ==4.4.2
- decord ==0.6.0
- defusedxml ==0.7.1
- dill ==0.3.5.1
- distlib ==0.3.8
- distro-info ==0.21
- dnspython ==2.2.1
- docker-pycreds ==0.4.0
- dotty-dict ==1.3.1
- ecdsa ==0.14.1
- einops ==0.4.1
- entrypoints ==0.4
- fairscale ==0.4.6
- fastjsonschema ==2.16.1
- filelock ==3.12.2
- findspark ==2.0.1
- fonttools ==4.35.0
- frozenlist ==1.3.1
- fsspec ==2021.11.1
- ftfy ==6.1.1
- future ==0.18.2
- gevent ==21.12.0
- gitdb ==4.0.9
- google-auth ==2.10.0
- google-auth-oauthlib ==0.4.6
- greenlet ==1.1.2
- grpcio ==1.47.0
- gunicorn ==20.1.0
- h11 ==0.14.0
- horovod ==0.24.2
- huggingface-hub ==0.9.0
- hydra-core ==1.2.0
- idna ==3.3
- imageio ==2.21.1
- imageio-ffmpeg ==0.4.7
- importlib-metadata ==6.7.0
- importlib-resources ==5.9.0
- iniconfig ==1.1.1
- iopath ==0.1.9
- iotop ==0.6
- ipaddress ==1.0.23
- ipykernel ==5.4.3
- ipython ==7.19.0
- ipython-genutils ==0.2.0
- ipywidgets ==7.7.1
- jedi ==0.18.1
- joblib ==1.1.0
- json-tricks ==3.15.5
- json5 ==0.9.9
- jsonschema ==4.9.1
- jupyter ==1.0.0
- jupyter-client ==6.1.12
- jupyter-console ==6.4.4
- jupyter-core ==4.11.1
- jupyter-kernel-gateway ==2.5.1
- jupyter-server ==1.18.1
- jupyterlab ==3.4.5
- jupyterlab-pygments ==0.2.2
- jupyterlab-server ==2.15.0
- jupyterlab-widgets ==1.1.1
- kiwisolver ==1.4.4
- lap ==0.4.0
- line-profiler ==3.5.1
- lxml ==4.9.1
- matplotlib ==3.5.3
- matplotlib-inline ==0.1.3
- memory-profiler ==0.60.0
- mistune ==0.8.4
- mmcls ==0.23.1
- mmcv-full ==1.3.18
- mmdet ==2.25.1
- mmpose ==0.28.1
- mmtrack ==0.13.0
- mock ==4.0.3
- model-index ==0.1.11
- motmetrics ==1.2.5
- moviepy ==1.0.3
- multidict ==6.0.2
- multiprocess ==0.70.13
- munkres ==1.1.4
- mypy-extensions ==0.4.3
- namesgenerator ==0.3
- nbclassic ==0.4.3
- nbclient ==0.6.6
- nbconvert ==6.5.3
- nbformat ==5.4.0
- nest-asyncio ==1.5.5
- networkx ==2.6.3
- notebook ==6.4.12
- notebook-shim ==0.1.0
- numpy ==1.21.5
- oauthlib ==3.2.0
- omegaconf ==2.2.2
- opencv-contrib-python ==4.6.0.66
- opencv-python ==4.6.0.66
- openmim ==0.2.1
- ordered-set ==4.1.0
- packaging ==21.3
- pandas ==1.3.5
- pandocfilters ==1.5.0
- parameterized ==0.8.1
- parso ==0.8.3
- pathlib2 ==2.3.7.post1
- pathspec ==0.9.0
- pathtools ==0.1.2
- pexpect ==4.8.0
- pickleshare ==0.7.5
- pkgutil_resolve_name ==1.3.10
- platformdirs ==4.0.0
- pluggy ==1.0.0
- ply ==3.11
- portalocker ==2.5.1
- proglog ==0.1.10
- prometheus-client ==0.14.1
- promise ==2.3
- prompt-toolkit ==3.0.30
- protobuf ==3.19.4
- psutil ==5.9.0
- ptyprocess ==0.7.0
- py ==1.11.0
- py-spy ==0.3.14
- pyOpenSSL ==22.0.0
- pyarrow ==6.0.1
- pyasn1 ==0.4.8
- pyasn1-modules ==0.2.8
- pycocotools ==2.0.4
- pycparser ==2.21
- pycryptodomex ==3.19.1
- pycurl ==7.43.0.2
- pydot ==1.4.2
- pyparsing ==3.0.9
- pyrsistent ==0.18.1
- pytest ==6.2.5
- pytest-cov ==3.0.0
- pytest-cover ==3.0.0
- pytest-coverage ==0.0
- python-apt ==1.8.4.3
- python-consul ==1.1.0
- python-dateutil ==2.8.2
- python-engineio ==4.8.1
- python-etcd ==0.4.5
- python-jose ==3.2.0
- python-snappy ==0.6.1
- python-socketio ==5.10.0
- pytorchvideo ==0.1.5
- pytz ==2022.2.1
- pyzmq ==23.2.1
- qtconsole ==5.3.1
- regex ==2022.7.25
- requests ==2.27.1
- requests-oauthlib ==1.3.1
- requests-toolbelt ==0.9.1
- rich ==12.5.1
- rsa ==4.9
- schedule ==0.6.0
- scikit-learn ==1.0.2
- scipy ==1.7.3
- seaborn ==0.11.2
- sentry-sdk ==1.9.5
- setproctitle ==1.3.2
- shortuuid ==1.0.9
- simple-websocket ==1.0.0
- simplejson ==3.17.6
- six ==1.16.0
- sklearn ==0.0
- smmap ==5.0.0
- sniffio ==1.2.0
- soupsieve ==2.3.2.post1
- tabulate ==0.8.10
- tensorboard ==2.10.0
- tensorboard-data-server ==0.6.1
- tensorboard-plugin-wit ==1.8.1
- termcolor ==1.1.0
- terminado ==0.15.0
- terminaltables ==3.1.10
- threadpoolctl ==3.1.0
- thriftpy2 ==0.4.14
- timm ==0.6.7
- tinycss2 ==1.1.1
- toml ==0.10.2
- tomli ==2.0.1
- tornado ==6.2
- tox ==3.28.0
- tqdm ==4.64.0
- traitlets ==5.3.0
- typed-ast ==1.5.4
- typing_extensions ==4.7.1
- unattended-upgrades ==0.1
- urllib3 ==1.26.12
- virtualenv ==20.25.0
- watchdog ==3.0.0
- wcwidth ==0.2.5
- webdataset ==0.1.103
- webencodings ==0.5.1
- websocket-client ==1.3.3
- widgetsnbextension ==3.6.1
- wrapt ==1.14.1
- wsproto ==1.2.0
- xmltodict ==0.13.0
- xtcocotools ==1.12
- xxhash ==3.0.0
- yacs ==0.1.8
- yapf ==0.32.0
- yarl ==1.8.1
- zipp ==3.8.1
- zope.event ==4.5.0
- zope.interface ==5.4.0
- zstandard ==0.18.0