irsa_normalize

% -*- texinfo -*-
% @deftypefn {Function File} {irsa_normalize.m}
% [@var{xpn},@var{fmaxn},@var{xp1},@var{nfac}] = irsa_normalize( @var{xp},
% [@var{fmax}] ) 
%
% Normalize @var{xp} to [0, (N-1)/N], compute the last
% frequency point below or equal to the given bandlimiting frequency
% @var{fmax} and scale it according to the normalization.  
% 
% Input:
%
% @var{xp}     : Vector -- sampling points 
%
% @var{fmax}   : Scalar -- band limiting frequency of signal sampled at
% @var{xp} 
%
% Output:
%
% @var{xpn}    : Vector -- normalized sampling points
%
% @var{fmaxn}  : Scalar -- last discrete frequency corresponding to @var{xpn}
% 
% @var{xp1}    : Scalar -- offset of @var{xp} ( xp(1) )
% 
% @var{nfac}   : Scalar -- normalization factor
%
% @emph{Note:} 
% 
% You get @var{xp} from @var{xpn} by computing @code{@var{xp} =
% @var{xpn}*@var{nfac}+ @var{xp1}}. Due to discretization the actually
% used @var{fmax} for @var{xp} is @code{@var{fmaxn}/@var{nfac}}.
% @end deftypefn