view release on metacpan or  search on metacpan

lib/App/PLab/MorphometryI.pod  view on Meta::CPAN

=head1 Morphometry I

The Morphometry application is used to acquire and gather morphological parameters from the gray-level images.

=head2 Navigation

=over

=item Contours

Program deals with object contours, which are used for gathering information. Most usual way is to draw
the contour upon the image. It's possible to draw lines and draw "freehand" curves. Once the left mouse button is pressed over
the image, the "freehand" curve is drawn, and when released, the line mode is turned on - the marquee 
thin line shows where line will be plotted. To stop drawing, press Esc or right mouse button.
Any file operation aborts drawing session also.<br> &nbsp;The figure drawn in one session called contour.

=item Undo

There are provided three of undo commands. As far as mouse movement is recorded and set of straight lines,
the first undo, "Undo drawing", erases last line drawn. <br>
Second step is "Group undo", which erases the whole contour. Both of these operation are irreversible,
so third step, "Undo dialog" bring an dialog that masters drawings in more flexible way.
Command "Clear all drwaings" clear all contours, respectively.

=back

=head2 Objects and background

Program is capable of collecting information of two different kinds of contours, namely
I<objects> and I<backgrounds>. Their difference is only when calculations take place,
in visual representaions they differs only in the color drawn. Default object color is green, background - 
yellow. It could be changed in Preferences, Appearance bookmark.

Before program calculates data, it has to validate the contours drawn in some way. This is accomplished
using image-processign algorithm, that leaves only closed contours. This function activated either by
"Edit/Validate contours" command or implicitly when closing and image.

=for podview <img src="mIc1.gif">

=for podview <img src="mIc2.gif">

The contour in picures above is an example of the algorithm.

As shown from above, to quickly get rid of the unneeded closed contour, it's enough to break it.
For that purpose used third "pen", "Remove", which default color is white. All that drawn with "Remove" pen,
applied to the image before the validation, so giving handy tool for corrections.

To switch to another pen, use "Edit/Object sets" menu selection. To the same purpose used the color rectangle
between scrollbars, which, when clicked, changes it's color and current object set.

Contours are saved in .xml file. If needed to use contours that were drawn for another file, use
"File/Import contours" command.

=head2 Contours recognition

"Edit/Recognintion setup" brings up the dialog that facilitates the automatic recognintion of the contours.
It consists of five numberic fields, three partial preview buttons, "apply"  and "restore" buttons.

"Apply" command applies chain of image processing algorithms on the current image, with purpose of extracting
contours automatically. 

First algorithm, I<union find>, quanitzes 256 levels of gray into less, and its threshold given
toggles whether the pixel belongs to some area or not. For example, if we have pixels with brighthess 105,110,115 and 120,
and threshold is 10, pixels with brightness 105 and 110 will transform into area with average brigthness between 105 and 110,
and will not include pixels with brightness below or above. The result of the algorighm shown by first preview button.

Second algorithm is I<binary threshold>, which turns pixels below threshold to black, and above to white. Compound preview
of these two algorithms could be seen by pressing secong preview button.

Third algorithm finds areas with minimal and maximal areas given ( in pixels), that could be contoured by line with width equal to
"edge size" amount. It's preview button provides black and white image which conturs will be added to object set, when "apply"
button pressed. If you see black or white image, that means no contours were found with given settings.

=head2 Point anchors

"Toggle point - drawings" command toggles between line plotting and point anchoring modes.
It's possible to set points on every image, but if the points are set on the very first image in the series,
then their location will be indicated by cross ( red by default) on every image in the continuous series.

=head2 Processing and calculations

The supplementary data is strored into filename with extension xml, which stands for 
"eXtended Markup Language" and allows in this case storage of different contour characteristics.
By default, no calculations ( except contour validation) is taken on image closure, but it's
possible ( see "Edit/Properties/Calculations") tell the program to calculate certain parameters 
after image is processed. These calculations are turned off by default because they require significanmt
time to run. But once calculated, some morphological parameters are stored into .xml file along with
contours. 

=head2 Advanced object information

The program can collect more information about the objects, but since it requires
quite a lot time to compute, these features are turned off by default.
The "Calculation" page in preferences dialog contains settings of these calculations.