OPENCV_CREATESAMPLES(1)

💖 OPENCV_CREATESAMPLES 💖

okay bestie, welcome to opencv_createsamples(1) — she's a User Command and she's here to make you some samples. let's go 🫶

---

✨ NAME ✨

opencv_createsamples — create training and testing samples. that's it. that's the girl. 💅

---

🌸 SYNOPSIS 🌸

opencv_createsamples [options]

no subcommands, no drama, just vibes and flags. 👑

---

🦋 DESCRIPTION 🦋

so opencv_createsamples makes positive samples from a single object image or from a whole collection of positive images. pick your fighter. 💖

and the scheme for making test samples? it's basically the same as making training samples, no cap. because every single test sample is a background image, and into that background gets pasted a randomly distorted and randomly scaled instance of your object picture, at a random position. chaotic? yes. iconic? also yes. ✨

---

🎀 OPTIONS 🎀

opencv_createsamples supports the following options, and yes we're doing all of them, every single one, no skipping. periodt. 💜

• -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. it's giving duo energy fr fr. 🫶
• -vec vec_file_name — the output file name that's gonna hold all your generated positive samples for training. your lil bundle of joy. 🎀
• -bg background_file_name — the background description file, aka the negative sample set. it's a list of images, and randomly distorted versions of your object get pasted into them to generate positive samples. 🖼️
• -num number_of_samples — how many positive samples you wanna generate/train. default is 1000. go off. ✨
• -bgcolor background_color — the background color (currently grayscale images are assumed, she's lowkey old school). the background color is the transparent color. default is 0. 💀
• -inv — invert the colors. 🌈
• -maxidev max_intensity_deviation — the desired maximum intensity deviation of the foreground samples pixels. default is 40. 🔥
• -maxxangle max_x_rotation_angle — the maximum rotation angle in the x-direction, in radians. default is 1.1. 📐
• -maxyangle max_y_rotation_angle — the maximum rotation angle in the y-direction, in radians. default is 1.1. 📐
• -maxzangle max_z_rotation_angle — the maximum rotation angle in the z-direction, in radians. default is 0.5. 📐
• -show [scale_factor] — show every sample as it's being created, live, like a lil premiere. you can optionally define a scaling factor. the default is 4.0. 🎬

if <ESC> is pressed, the creation process keeps going, it just stops showing you the samples. super useful for debugging purposes, bestie. 😭

• -h sample_height — when you're creating training samples, this is the resulting sample height. the default is 24. 📏

when you're creating test samples instead, it's the minimal height of the placed object picture.

• -w sample_width — when you're creating training samples, this is the resulting sample width. the default is 24. 📏

when you're creating test samples instead, it's the minimal width of the placed object picture.

also?? the exact same info gets shown if you call opencv_createsamples with no arguments and no options at all. free help, no cap. 🫶

---

🌟 EXAMPLES 🌟

wanna create training samples from one image, apply some distortions, and literally watch the results? say less:

opencv_createsamples -img source.png -num 10 -bg negatives.dat
-vec samples_out.vec -show

and here's how you 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

(yes that second one says opencv_creasamples, not opencv_createsamples — she's a little typo'd, we don't fix her, we just respect her journey 💀🙈)

---

👀 SEE ALSO 👀

• opencv_haartraing(1)
• opencv_performance(1)

more information and examples can be found in the OpenCV documentation. iykyk. 📚✨

---

💜 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). legends, honestly. 👑

---

and that's the whole page, bestie!! 🎀 from OpenCV, dated May 2010 — yeah she's a vintage queen and she still ate. 💅✨🌸🦋💖