view release on metacpan or  search on metacpan

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

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.
The following topics controls the program behavior when the .xml file is written on disk.

=over

=item Calculate brigthness

If on, the summary brightnesses and the brightness histogram are calculated for
each object. For the backgrounds, however, histogram is not calculated.
The calculation takes significant time and depends on number of objects.

=item Equalize brightness

Can only be on if "Calculate brightness" is on also. Before the brightess
calculations are performed, the image is subject to equalization procedure,
used to make the background of the scene equally illuminated. The calculation
time is very large, but it's not dependant of objects amount.

=item Convex hull derived parameters

If on, perform calculation of set of parameters for every object, which are:
for object: width, length, length/width, and breadth; for convex: area, width, perimeter, form factor,
xcentroid, ycentroid, fxcentroid, fycentroid, object length/convex width, and spreading index.
calculation time is small and depends of number of objects. Cannot be turned off while
"Process index/domain" switch is on.

=item Number of rotations

The topic is under construction

=item Process index/domain

Calculates the area of the holes for every objects. Calculation time: insignificant.

=item Significance level for holes,%

Holes, whose area is less than specified amount ( in percents) are not treated in statistic caulations.
This switch does not apply to the program behavior when it is saving .xml file, it is used
for statistic calulations.

=back

=head3 Batch processing

The program doesn't write any files and starts no calculations unless contours were changes.
It will be laborous task if needed to recalculate parameters on the whole series, in case
they are not present in the .xml files to that series, consequently loading, drawing, undoing and saving
data. Instead, "Recalculate series" command subsequently loads, and saves images, and saves the recalculated data.

=head3 Statistics

The program is also capable of calculating the statistics information, getting the data from sets of .xml files.
The "Calculate statistics" command brings the dialog, that allows select set of .xml files. After files were selected,
the calulation process is then started and it's results are shown in a separate window.

These result could be copies to the system clipboard by using "Copy" command, or saved to files as 
different reports using "Export/Summary" and "Export/Experimental data" commands. Summary, as expected,
is more brief and contains only averaged statistics.

Special statistics window keys:

=over

=item *

Shift+navigation keys - select and area

=item *

Alt+L - select a line ( press twice on different lines to select more than one)

=item *

Alt+B - select a vertical block ( press twice in different positions)

=item *

Ctrl+Ins - copy selected block to the system clipboard

=back

=head2 Productivity tips

Holding Shift key reveals brightness of a pixel under the mouse pointer.

It's possible to change line widths and line colors when drawing a contour ("Edit/Preferences/Appearance").

Toolbar includes two extra icons - "Toggle points/contours" and "Calculate statistics".

To calculate statistics there's no need to load an image.