annotation_path parameter in torchvision.datasets.UCF101 is not clear.

[damtharvey]

📚 Documentation

Please describe what kind of files should be in annotation_path, and what the files should contain. It is not obvious.

cc @pmeier

[fmassa]

Hi,

It's the folder that contain the following files:

classInd.txt  testlist01.txt  testlist02.txt  testlist03.txt  trainlist01.txt  trainlist02.txt  trainlist03.txt 

Which describes how the train / test split are selected.

Here is an example of what is in trainlist01.txt:

head annotation/trainlist01.txt

gives

ApplyEyeMakeup/v_ApplyEyeMakeup_g08_c01.avi 1
ApplyEyeMakeup/v_ApplyEyeMakeup_g08_c02.avi 1
ApplyEyeMakeup/v_ApplyEyeMakeup_g08_c03.avi 1
ApplyEyeMakeup/v_ApplyEyeMakeup_g08_c04.avi 1
ApplyEyeMakeup/v_ApplyEyeMakeup_g08_c05.avi 1
ApplyEyeMakeup/v_ApplyEyeMakeup_g09_c01.avi 1
ApplyEyeMakeup/v_ApplyEyeMakeup_g09_c02.avi 1
ApplyEyeMakeup/v_ApplyEyeMakeup_g09_c03.avi 1
ApplyEyeMakeup/v_ApplyEyeMakeup_g09_c04.avi 1
ApplyEyeMakeup/v_ApplyEyeMakeup_g09_c05.avi 1

I believe I've answered your question and as such I'm closing this issue. If you think the documentation can be improved in some way, please let us know or even better, send a pull request with proposed improvements.

[damtharvey]

In case someone doesn't know you don't have to make this yourself, these files can be found in https://www.crcv.ucf.edu/wp-content/uploads/2019/03/UCF101TrainTestSplits-RecognitionTask.zip.

[fmassa]

@bjuncek aren't those files available in the original download link for the datasets?

[damtharvey]

The official web page is https://www.crcv.ucf.edu/data/UCF101.php, which contains the official download link https://www.crcv.ucf.edu/data/UCF101/UCF101.rar, which contains only directories of video files. There are various annotations available, including the action recognition annotations that are expected in annotation_path.

[fmassa]

We should probably make it clear in the documentation then what is the link for the annotations, or at least where to find them in the webpage

[bjuncek]

Sounds good - I'll add that to the docstring!