diff options
| author | John Morrison <jcm357@cs.drexel.edu> | 2014-10-28 14:31:05 -0400 |
|---|---|---|
| committer | John Morrison <jcm357@cs.drexel.edu> | 2014-10-28 14:31:05 -0400 |
| commit | 3dd70b4d0e20f517f515a8b1d0ad7b5d79f48621 (patch) | |
| tree | bccabe5e9169e2e843fba8d307ab4e117f6cf49f /fly-tools/README.markdown | |
| parent | 01b3b8f87c1d4be14438a0fdc2a4daade9eb3038 (diff) | |
| parent | bda4a425da1073ca38b7ccf006d02f65b25a4755 (diff) | |
Merge branch 'master' of github.com:mutantturkey/FlyTracking
Diffstat (limited to 'fly-tools/README.markdown')
| -rw-r--r-- | fly-tools/README.markdown | 30 |
1 files changed, 26 insertions, 4 deletions
diff --git a/fly-tools/README.markdown b/fly-tools/README.markdown index ac94d8c..60e2b98 100644 --- a/fly-tools/README.markdown +++ b/fly-tools/README.markdown @@ -1,6 +1,8 @@ fly-tools ========= +These are the programs that do all the hard work! + FlyTracking ------------ @@ -13,7 +15,8 @@ Usage: FilterFlyMask ------------ -FilterFlyMask runs some filtering operations on masks to ensure that the FlyTracking tool processes the information correctly. +FilterFlyMask runs some filtering operations on masks to ensure that the +FlyTracking tool processes the information correctly. Usage: @@ -22,8 +25,12 @@ Usage: filter-mask ----------- -filter-mask is an alternative fly filter that works much faster. It utilizes the OpenCV and CvBlob libraries. +filter-mask is an alternative fly filter that works much faster. It utilizes +the OpenCV and CvBlob libraries. +The filter works simply, it counts the number of blobs and grabs the largest +two. Anything else is discarded and the two blobs are written to a new image. + Usage: filter-mask -i <input-file> -o <output-file> -r <ratio> @@ -31,7 +38,17 @@ Usage: mask-generator ------------- -This tool creates masks from cropped video frames, which the need to be filtered by the FilterFlyMask tool. +This tool creates binary masks from cropped video frames, which the need to be +filtered by the FilterFlyMask tool. + +The program works by doing 3 specific image manipulations to the input images. + +1. subtract the background image from the input image +2. auto-level the image. This operation sets the lightest pixel to white and +then normalizes the rest of the image accordingly. This step is important to +ensure that the mask output is relatively similar when ligt conditions are +changing during a sequence. +3. Threshold the image, anything over 30% is marked as white, the rest is black Usage: @@ -44,7 +61,12 @@ Todo: derive-background ----------------- -This tool will generate a common background image of a set of video frames (PNGs), based on the statistical mode of each pixel. +This tool will generate a common background image of a set of video frames +(PNGs), based on the statistical mode of each pixel. + +The program works by iterating through each image, through each pixel, adding +them to a histogram and then calculates each pixel's mode and spews out the +resulting image. Usage: |