This function creates the THSP (Time History Speckle Pattern)[1][2] of a set 
  of pixels in a line or column of a datapack (DATA).

  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 Enginnering, 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(DATA,R,S);
  Y = thsp(DATA,'line',100);   % THSP matrix with the line 100 of datapack.
  Y = thsp(DATA,1,100);        % THSP matrix with the line 100 of datapack.
  Y = thsp(DATA,'column',100); % THSP matrix with the column 100 of datapack.
  Y = thsp(DATA,2,100);        % THSP matrix with the column 100 of datapack.
  
  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.
  R    is a parameter of analysis: 
       if R is equal to 1 or 'line', you choose the lines of images to create the THSP and
       if R is equal to 2 or 'column', you choose the columns of images to create the THSP.
       In other cases the function returns error.
  S    is the line or column position used to make the time history speckle patterns.
       The function do not verify if S is in the  possible range, this check must be done by the user.

  Output:
  Y    is the time history speckle patterns matrix. Where Y is a 2D matrix with
       M lines and NTIMES columns, being M equal to NCOL when R is 1 and M equal 
       to NLIN when R is 2.
       Y is a matrix where each column is a representation of one only line or column 
       in the S position of DATA.


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

Package: bsltl