mirror of https://github.com/davisking/dlib.git
41 lines
1.8 KiB
Plaintext
41 lines
1.8 KiB
Plaintext
imglab is a simple graphical tool for annotating images with object bounding
|
|
boxes and optionally their part locations. Generally, you use it when you want
|
|
to train an object detector (e.g. a face detector) since it allows you to
|
|
easily create the needed training dataset.
|
|
|
|
You can compile imglab with the following commands:
|
|
cd dlib/tools/imglab
|
|
mkdir build
|
|
cd build
|
|
cmake ..
|
|
cmake --build . --config Release
|
|
Note that you may need to install CMake (www.cmake.org) for this to work. On a
|
|
unix system you can also install imglab into /usr/local/bin by running
|
|
sudo make install
|
|
This will make running it more convenient.
|
|
|
|
Next, to use it, lets assume you have a folder of images called /tmp/images.
|
|
These images should contain examples of the objects you want to learn to
|
|
detect. You will use the imglab tool to label these objects. Do this by
|
|
typing the following command:
|
|
./imglab -c mydataset.xml /tmp/images
|
|
This will create a file called mydataset.xml which simply lists the images in
|
|
/tmp/images. To add bounding boxes to the objects you run:
|
|
./imglab mydataset.xml
|
|
and a window will appear showing all the images. You can use the up and down
|
|
arrow keys to cycle though the images and the mouse to label objects. In
|
|
particular, holding the shift key, left clicking, and dragging the mouse will
|
|
allow you to draw boxes around the objects you wish to detect.
|
|
|
|
Once you finish labeling objects go to the file menu, click save, and then
|
|
close the program. This will save the object boxes back to mydataset.xml. You
|
|
can verify this by opening the tool again with:
|
|
./imglab mydataset.xml
|
|
and observing that the boxes are present.
|
|
|
|
|
|
imglab can do a few additional things. To see these run:
|
|
imglab -h
|
|
and also read the instructions in the About->Help menu.
|
|
|