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,'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.
  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.
  MAT     [Optional] is a matrix thats enable the graphic 
          selection of a point P0 in the figure created of imagesc the MAT.
  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-red-filled', Show='on-green', 
          Show='on-green-filled', Show='on-blue' , Show='on-blue-filled'
          Show='on-cyan', Show='on-cyan-filled', Show='on-magenta', 
          Show='on-magenta-filled', Show='on-yellow', Show='on-yellow-filled',
          Show='on-black', Show='on-black-filled', Show='on-gray' or  
          Show='on-gray-filled', Show='on-white' or  
          Show='on-white-filled' 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