This function creates the THSP (Time History Speckle Pattern)[1][2] of a set
  of  M points (pixels) randomly (Uniform) selected in DATA(:,:,1), and through 
  DATA(:,:,k) for all k value.

  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_random(DATA, M);
  [Y POINTS]= thsp_random(DATA, M);
  [Y POINTS]= thsp_random(DATA, M, '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, randomly selected, in analysis.
  Show    [Optional] can be used in the last position of input, and its
          function is to enable a graphic outcome of selected points in the
          THSP. Show='on' to enable. And disable in other cases, by default Show='off'.

  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 under study. (line,column).


  For help, bug reports and feature suggestions, please visit:
  http://nongnu.org/bsltl/

Package: bsltl