---
name: "opencv-createsamples"
section: "1"
platform: "linux"
package: "libcv-dev"
version: "1.0.0-6.1"
release: "Debian 5.0 (Lenny)"
platforms: ["linux"]
url: "https://new.carta.tech/opencv-createsamples"
---

# opencv-createsamples(1)

create training and testing samples

## 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:

-

  **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)](/opencv-performance/1.md)

More information and examples can be found in the OpenCV documentation.

## AUTHORS

This manual page was written by **Daniel Leidert** \<daniel.leidert@wgdd.de\> for the Debian project (but may be used by others).