/STAIR-actions

Large Scale Video Dataset for Action Recognition

Primary LanguageShell

STAIR Actions

"STAIR Actions" is a large-scale video dataset for action recognition research.  It consists of 100 categories of everyday human actions, which is listed in this table. For each action, there are around 1000 videos, 10% of which are kept unpublished for possible future competition. For more detailed information, please refer to http://actions.stair.center .

Terms of Use

By downloading "STAIR Actions" (the Dataset), you agree to the following terms.

  • You will use the Dataset only for the purpose of AI research.
  • You will NOT distribute the Dataset or any parts thereof.
  • You will treat people appearing in the Dataset with respect and dignity.
  • The Dataset comes with no warranty or guarantee of any kind, and you accept full liability.

License

Assuming you agree the terms of use,

  • STAIR Actions metadata file (.json) is licensed under Creative Commons Attribution 4.0 International license (CC BY 4.0)  - (https://creativecommons.org/licenses/by/4.0/legalcode)
  • The type field of STAIR Actions medata file (.json) indicates license condition of individual movie file by one character, where C, X, Y indicate Creative Commons CC0 Public Domain Dedication, ordinary YouTube license, CC BY, respectively.  - (https://creativecommons.org/publicdomain/zero/1.0/deed.en)
  • Other code in this repository is delivered under the Apache 2 license.

Version 1.0 Release Notes

Files in the following lists are recommended to be removed. inappropriate.csv includes files, the contents of which is regarded as "inappropriate" by anonymous reviewers.

audio_problem.csv includes files that have some trouble in audio channel.

tooshort_toolong.csv includes files too short (less than 3 sec) or too long (longer than 10 sec).

Some movies may be wrongly categorized.  The following list includes known mistakes with recommended categories.

recommend_recategorize.csv

How to get STAIR Actions V1.0

We provide a download script for STAIR Actions download.sh, which enables you to download both STAIR Actions (C) and (Y) at one time. We highly recommend that you will run the script on a storage with over 1TB space.

The download script uses the crawler included in ActivityNet repository to get YouTube videos. To run the crawler, you need to construct python environment, following this README. Additionally, you need to install git, ffmpeg and jq in advance to run the download script.

After the construction of the enviromnent, you can download STAIR Actions by just executing the following command.

$ bash download.sh

It will takes a few days until the end of the execution. Finally, STAIR Actions will be created in STAIR_Actions_[version]/ directory, where [version] is the version number of STAIR Actions to be downloaded. Note that some video clips will not be generated because some YouTube videos cannot be downloaded ater constructing this dataset.

References

  • Yuya Yoshikawa, Jiaqing Lin, Akikazu Takeuchi, "STAIR Actions: A Video Dataset of Everyday Home Actions," arXiv:1804.04326, Apr. 2018. [PDF]
  • Yuya Yoshikawa, Akikazu Takeuchi, "Constructing a Large-Scale Video Dataset for Human Action Recognition at Home and Office," Annual Meeting of the Japanese Society for Artificial Intelligence (JSAI2017), 2017. (In Japanese) [PDF]