Navigation

Operators and Keywords

Function List:

C++ API

  This function creates the THSP (Time History Speckle Pattern)[1][2] 
  of a set of M points (pixels) randomly (Gaussian) selected in DATA(:,:,1), 
  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,'on');
  [Y POINTS]= thsp_gaussian(DATA,M,Sigma,P0,'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, 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.
  Show    [Optional] can be used in the last position of input, and its
          function is to enable a graphic output of the selected points that formed the
          THSP. Show='on' to enable. It is disabled in other cases, by default Show='off'.

  Output:
  Y      is the time history speckle patterns. 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