PIVMat Function Reference<< Prev | Next >> 
statf
Statistics of a vector/scalar field

Description
STAT = statf(F) returns a structure that contains statistics of the 
vector/scalar field F.  F is a structure (or structure array) of fields 
as obtained by loadvec (vector field) or vec2scal (scalar field). 
If F is a scalar field, STAT contains the following fields: 
  mean, std, rms:  mean, standard deviation and rms. 
  n:         number of nonzero elements. 
  zeros:     number of zero elements. 
  mom:       non-centered moments, <s^n> 
  momabs:    non-centered absolute moments, <|s^n|> 
  cmom:      centered moments, <(s-<s>)^n> 
  cmomabs:   centered absolute moments, <|s-<s>|^n> 
  skewness:  normalized 3rd order non-centered moment. 
  flatness:  normalized 4th order non-centered moment. 
  skewnessc: normalized 3rd order centered moment. 
  flatnessc: normalized 4th order centered moment. 
  history:   remind for which field statf has been called. 
 
For the "centered" quantities, the brackets <> means spatial and 
ensemble average over the whole fields. 
 
If F is a vector field, use [STATX,STATY] = statf(F), where STATX and 
STATY are the statistics for each component of the vector field. 
 
... = statf(F,MAXORDER) specifies the maximum order for the moments. 
MAXORDER=6 is used by default (although its convergence may not be 
guaranteed). 
 
If the fields contain 0 (zero) values, they are considered as 
erroneous and are not included into the computations. 
 
Examples
    statrot = statf(vec2scal(filterf(loadset,1),'rot')); 
 
See Also
loadvec, vec2scal, histf, corrf, vsf. 

 Previous: spaverfNext: statvec_disp 

2005-2007 PIVMat Toolbox 1.60