This function creates the THSP (Time History Speckle Pattern)[1][2]
of a set of M points (pixels) randomly (Gaussian) selected in EXAMPLE_MATRIX,
and through DATA(:,:,k) for all k value.
Around a point P0, M points are selected randomly, these points are concentrated
mostly in a radius Sigma around the point P0.
References:
[1] OULOMARA, G.; TRIBILLON, J.; DUVERNOY, J. Biological activity measurements
on botanical specimen surfaces using a temporal decorrelation effect of
laser speckle. Journal of Moderns Optics, London, v. 36, n. 2, p. 136-179,
Feb. 1989.
[2] XU, Z.; JOENATHAN, C.; KHORANA, B. M. Temporal and spatial properties of
the time-varying speckles of botanical specimens. Optical Engineering, Virginia,
v. 34, n. 5, p. 1487-1502, May 1995.
After starting the main routine just type the following command at the
prompt:
Y = thsp_gaussian(DATA,M,Sigma);
[Y POINTS]= thsp_gaussian(DATA,M,Sigma);
[Y POINTS]= thsp_gaussian(DATA,M,Sigma,'on');
[Y POINTS]= thsp_gaussian(DATA,M,Sigma,P0);
[Y POINTS]= thsp_gaussian(DATA,M,Sigma,P0,'on');
[Y POINTS]= thsp_gaussian(DATA,M,Sigma,HG);
[Y POINTS]= thsp_gaussian(DATA,M,Sigma,HG,'on');
Input:
DATA is the speckle data pack. Where DATA is a 3D matrix created grouping NTIMES
intensity matrices with NLIN lines and NCOL columns. When N=size(DATA), then
N(1,1) represents NLIN and
N(1,2) represents NCOL and
N(1,3) represents NTIMES.
M is the number of points, Gaussian randomly selected, in analysis.
Sigma is the standard deviation in pixels.
P0 [Optional] is the initial point [line column], around this point, M
values are selected to create the time history speckle pattern. If this parameter
is not used, then a graphic window is enabled to the selection of a point P0.
This parameter only can be the fourth parameter.
HG [Optional] is the used graphic handler; Additionally, it is enable the graphic
selection of a point P0 in the figure pointed by the graphic handler.
This parameter only can be the fourth parameter.
Show [Optional] can be used in the last position of input, and its function
is used to enable a graphic output of the selected points that formed the
THSP. Show='on', Show='on-red', Show='on-green' or Show='on-blue' to enable.
It is disabled in other cases, by default Show='off'.
Show='on' plot the points in the color red, in other cases are used the
specified colors.
Output:
Y is the time history speckle pattern. Where, Y is a 2D matrix with
M lines and NTIMES columns.
POINTS [Optional] is a matrix with two columns and
M lines. Thus, each line represents one point in study, (line,column).
For help, bug reports and feature suggestions, please visit:
http://nongnu.org/bsltl/
Package: bsltl
