cmvbtf
Contents:
Introduction
The cmvbtf application set out to integrate the color classification package
CMVision (more information about the CMVision package can be found at the
CMVision project page).
Cmvbtf takes advantage of CMVision's fast color segmentation routines, which it uses to track objects
in to the btf file format (more information about btf can be found at the
btf File Guide).
cmvbtf will only open files that can be opened with the LibDV codec. Usually, these files are 720x480 pixels, and come from digital video (DV) cameras.
Return to top
Compiling
cmvbtf is copiled by running gnu make.
Return to top
Running
To run cmvbtf, go to the directory where the executable is and type ./cmvbtf .
This will result in the following output to the terminal:
./cmvbtf USAGE:
./cmvbtf input_avi color_config output_dir_btf [OPTIONS]
./cmvbtf OPTIONS: (# is a number, x is a filename)
-sf # --startframe # //Frame to start processing on
-ef # --endframe # //Frame to end processing on
-oa x --outputavi x //Name for processed avi
-df x --debugfile x //Name of file to put debug info in
-mrs # --minimumregionsize # //The minimum number of pixels per region to output (16)
Lets look at this in a little more detail:
Required Arguments
| Argument Name |
What it Means |
input_avi |
This is the filename of the input avi to do the processing on. |
color_config |
This is the configuration file for CMVision. You can generate these with CTag. |
output_dir_btf |
This is the directory you want to create for the btf project. It cannot previously exist. |
Note for required arguments: Any failure regarding the three main arguments will cause the program to abort execution.
Return to top
Optional Arguments
| Argument Name |
What it Means |
| Short Name |
Long Name |
-sf # |
--startframe # |
Cmvbtf will begin processing with frame #. The very first frame in an avi file is frame number 0.
By not specifying this option, cmvbtf will assume that you want to start from frame 0. |
-ef # |
--endframe # |
Cmvbtf will stop processing with the frame before #. The very last frame in an avi file is the total
amount of frames minus 1. By not specifying this option, cmvbtf will assume that you want to process till the last frame. |
-oa x |
--outputavi x |
Specifing this option will make an avi of filename x that contains the processed CMVision pixel data.
This is not overly helpful other then to check that CMVision is classifying your avi correctly. |
-df x |
--debugfile x |
Specifying this option will result in a file x being created and populated full of development
debugging information. Really not useful at all unless you are having major problems. |
-mrs # |
--minimumregionsize # |
Blobs of color can come in all different sizes, and it would be a shame to see that some misclassified noise
ruined your experimental data. This option will allow you to specify the amount of pixels that a blob of color
must contain before it is recorded to the btf folder. By default, this option is 16. NOTE: This option does
not affect the -oa x command. |
Note for optional arguments: Any failure regarding optional arguments will result in that argument being ignored.
Also Note: Failure to specify a parameter for optional arguments that require one (like the # or x
will cause undefined results.
Return to top
Downloading
The files have been consolidated in a single package. Get GTrack version 1.0
here MD5: 9b17ce83dda6851fe1528d20a2554583
Return to top
Examples
This section will show you how to get your feet wet.
Running cmvbtf in the most basic way:
./cmvbtf movies/bees-07-21-03.avi colors.conf BEES-07-21_BTF
Starting from frame 100 and continuing to the end:
./cmvbtf movies/bees-07-21-03.avi colors.conf BEES-07-21_BTF -sf 100
Starting from the beginning, but ending at frame 203:
./cmvbtf movies/bees-07-21-03.avi colors.conf BEES-07-21_BTF -ef 203
Just processing frames 100 through 200:
./cmvbtf movies/bees-07-21-03.avi colors.conf BEES-07-21_BTF -sf 100 -ef 201
A sample frame from the -oa option, when CMVision is setup to look for orange/red things:
./cmvbtf movies/dogseq02.avi colors.conf DOGS-07-21_BTF -oa out.avi
On the left is the original shot, on the right is the classified shot
Return to top
|
