irsa_rgenreal

% -*- texinfo -*-
% @deftypefn {Function File} {irsa_rgenreal.m}
% [@var{yp,fxp,fyp}] = irsa_rgenreal (@var{xp}, @var{fmax}, @var{arfunc},
% @var{prfunc})    
% 
% Generate a real-valued band-limited timeseries with sampling points
% @var{xp} and maximum frequency @var{fmax}.
% 
% Input:
%
% @var{xp}    : Vector -- sampling points 
%
% @var{fmax}  : Scalar -- maximum (band-limiting) frequency 
% 
% @var{arfunc}: String -- name of random number generator with desired
% distribution for the generated frequency amplitudes. Default is
% @code{randn}. 
%
% @var{prfunc}: String -- name of random number generator with desired
% distribution for the generated frequency phases taken
% times @code{2*@var{pi}}. Default is @code{rand}.
%
% The random number generators have to take the number of rows as the first
% and the number of columns as the second argument.
%
% Output:
%
% @var{yp}  : Columnvector -- sampling values
% 
% @var{fxp} : Columnvector -- frequency points
%
% @var{fyp} : Columnvector -- frequency values
% @end deftypefn