Section: User Commands (1)Updated: May 2008Local indexUp
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.
-bgthresh background_color_threshold
The amount of color tolerance
The background color threshold. Pixels whose colors are in range ±
background_color_threshold
are considered as transparent.
-inv
Invert the colors.
-randinv
Invert the colors randomly.
-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:
