NAME¶
opencv_createsamples - create training and testing samples
SYNOPSIS¶
opencv_createsamples [options]
DESCRIPTION¶
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.
OPTIONS¶
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.
EXAMPLES¶
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
SEE ALSO¶
opencv_haartraing(1),
opencv_performance(1)
More information and examples can be found in the OpenCV documentation.
AUTHORS¶
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).