From 754edf136d1020462f65d60c963aeea4da5df1a6 Mon Sep 17 00:00:00 2001 From: mutantturkey Date: Wed, 31 Oct 2012 17:37:29 -0400 Subject: add basic explaination of how some of the tools work, and set line wrapping to 80 lines. --- fly-tools/README.markdown | 30 ++++++++++++++++++++++++++---- 1 file 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 -o -r @@ -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: -- cgit v1.2.1