PIVMat Function Reference<< Prev | Next >> 
azaverf
Azimuthal average a vector/scalar field.

Description
[R, P] = azaverf(S, X0, Y0), where S is a scalar field, returns the 
azimuthally-averaged profile P(R) of S with respect to the center 
X0, Y0 (given in physical units). The output vector R is the radius 
(in physical units), and the vector P is the profile.  If S is an array 
of N scalar fields, R and P are MxN matrix. Use PLOT(R, P) to plot the 
resulting profiles. 
 
[R, UR, UT] = azaverf(V, X0, Y0), where V is a 2-component vector field, 
returns the radial UR and azimuthal UT components of the azimuthally- 
averaged profiles of V. 
 
[R, UR, UT, UZ] = azaverf(V, X0, Y0), where V is a 3-component vector 
field, returns the radial UR, azimuthal UT, and out-of-plane UZ, 
components of the azimuthally- averaged profiles of V. 
 
The center (X0, Y0) does not need to be inside the field. If X0 and Y0 
are not specified, the point (0,0) is taken (in physical units). 
 
AF = azaverf(F, X0, Y0), where F is a scalar or a vector field, returns 
the azimuthally averaged field AF. If F is an array of fields, AF is 
also an array of fields of same dimension. If no output argument 
specified, the result is displayed with showf. 
 
... = azaverf(..,I0, J0, 'mesh') specifies the center (I0, J0) in mesh 
units instead of physical units (I0 and J0 do not need to be integer, 
and do not need to be inside the field). 
 
... = azaverf(.., 'rmax', RMAX) computes the profile for R<=RMAX only. 
RMAX is given in physical units, unless the argument 'mesh' is 
specified. This option saves computation time if large R are not 
needed. 
 
By default, zero elements are considered as erroneous, and are not used 
for the computation of the azimuthal average. If however you want to 
keep them in the computation, specify  azaverf(...,'keepzero'). 
 
Examples
 
   v=loadvec('*.vc7'); 
   showf(azaverf(v,10,10)); 
 
   k=vec2scal(v,'ken'); 
   [r,e] = azaverf(k,40,32,'mesh'); 
   plot(r,e,'o-'); 
   xlabel('r (mm)');  ylabel('energy'); 
 
   v=addnoisef(vortex,0.2); 
   showf(v); 
   showf(azaverf(v,64,64)); 
 
See Also
showf, averf, spaverf, subaverf, filterf, 
vec2scal, rotatef, subsbr, azprofile 
Published output in the Help browser 
   showdemo azaverf 
 

 Previous: averfNext: azprofile 

2005-2021 PIVMat Toolbox 4.20