OPENCV_CREATESAMPLES(1) 					   User Commands					   OPENCV_CREATESAMPLES(1)

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 ran-
       domly 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).

OpenCV								     May 2010						   OPENCV_CREATESAMPLES(1)