Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/e-lab/vid2img

Image dataset from videos
https://github.com/e-lab/vid2img

Last synced: 6 days ago
JSON representation

Image dataset from videos

Awesome Lists containing this project

README

        

# vid2img

A video to image extrator converted from Atcold's original version of MATLAB.

## Annotation

`vid2img` runs with assigned videos saved in `Videos` folder.
Videos should be saved in corresponding categories.
It can be run as follows.

```bash
cd Codes
qlua vid2img.lua
```

After images have been annotated with `vid2img`, patches can be extracted with `crop`.

```bash
th crop.lua
```

For a list of available parameters, run `th crop.lua --help`.

## Directory structure

```
.
├── Codes
├── GUI
├── images
├── labels
├── torch-data
├── Patches
├── README.md
└── Videos
```

### Main folders (uppercase)

- [`Codes`](vid2img/Codes): where the vid2img scripts in Lua are saved.
- [`GUI`](vid2img/GUI): where the graphical user interfaces designed in Qt for vid2img are saved.
- [`Videos`](vid2img/Videos): videos are dropped in this folder with a specific category as the folder name.
Inside the folder there is already a folder named `exampleFolder` containing 4 videos, named 01 - 04 for this particular case.

### Local temporary folders (lowercase)

- `images`: is generated by `vid2img` Lua script, which contains all the frames from chosen videos.
The images are saved in the correponding folder as specified by the file names.
- `labels`: contains the coordinates of the selected object within each (not skipped) frame.
- `patches`: contains the extracted patches

### License

MIT