opencv_createsamples - create training and testing samples
opencv_createsamples [options]
opencv_createsamples creates positive samples from a single
object image or a collection of positive images.
The scheme of test samples creation is similar to training samples
creation since each test sample is a background image into which a randomly
distorted and randomly scaled instance of the object picture is pasted at a
random position.
opencv_createsamples supports the following options:
- -info
collection_file_name
- A database of positive source images. Use it together with -img to
create test samples instead.
- -img
image_file_name
- A positive source image. Use it together with -info to create test
samples instead.
- -vec
vec_file_name
- The output file name containing the generated positive samples for
training.
- -bg
background_file_name
- The background description file (the negative sample set). It contains a
list of images into which randomly distorted versions of the object are
pasted for positive sample generation.
- -num
number_of_samples
- The number of positive samples to generate/train. The default is
1000.
- -bgcolor
background_color
- The background color (currently grayscale images are assumed); the
background color denotes the transparent color. The default is 0.
- -inv
- Invert the colors.
- -maxidev
max_intensity_deviation
- The desired maximum intensity deviation of foreground samples pixels. The
default is 40.
- -maxxangle
max_x_rotation_angle
- The maximum rotation angle in x-direction in radians. The default is
1.1.
- -maxyangle
max_y_rotation_angle
- The maximum rotation angle in y-direction in radians. The default is
1.1.
- -maxzangle
max_z_rotation_angle
- The maximum rotation angle in z-direction in radians. The default is
0.5.
- -show
[scale_factor]
- Show each created sample during the creation process. Optionally a scaling
factor can be defined. The default is 4.0.
- If <ESC> is pressed, the creation process will continue
without showing the samples. This can be useful for debugging purposes.
- -h
sample_height
- For the creation of training samples, it is the resulting sample height.
The default is 24.
- In case of creating test samples, it is the minimal height of placed
object picture.
- -w
sample_width
- For the creation of training samples, it is the resulting sample width.
The default is 24.
- In case of creating test samples, it is the minimal width of placed object
picture.
The same information is shown, if opencv_createsamples is
called without any arguments/options.
To create training samples from one image applying distortions and
show the results:
- opencv_createsamples -img source.png -num 10 -bg negatives.dat -vec
samples_out.vec -show
To create training samples of size 40x40 from some images without
applying distortions:
- opencv_creasamples -info source.dat -vec samples_out.vec -w 40 -h
40
This manual page was written by Daniel Leidert
<daniel.leidert@wgdd.de> and Nobuhiro Iwamatsu
<iwamatsu@debian.org> for the Debian project (but may be used by
others).