% -*- texinfo -*-
% @deftypefn {Function File} {irsa_jitsp.m}
% @var{jitxp} = irsa_jitsp (@var{Tm}, @var{jit}, @var{N} [, @var{rfunc}])
%
% Generate @var{N} sampling points with a minimum distance @var{Tm} and
% an additional random distance @var{jit} with random distribution
% @var{rfunc}
%
% Input:
%
% @var{Tm} : Scalar -- mean sampling period
%
% @var{N} : Scalar -- number of sampling points to generate
%
% @var{jit} : Scalar -- factor in [0,1] describing the part of Tm
% which is jittered.
%
% @var{rfunc}: String (i.e. in quotes) of a random distribution
% function. Has to take the number of rows as the first and the number of
% columns as the second argument. Default is 'rand'.
%
% @var{rmin} : Scalar -- Lower limit of random distribution function
% computed with @var{rfunc}
%
% @var{rmax} : Scalar -- Upper limit of random distribution function
%
% Output:
%
% @var{jitxp} : Columnvector -- sampling points with a jitter
%
% @emph{Note:}
%
% 1) The first sampling point will be 0, the last (N-1)*Tm. No
% jitter is added to them.
%
% 2) If you use a random distribution function and dont give a upper
% or lower limit it's assumed to be limited by its present computed
% maximum or minimum values.
% @end deftypefn