% -*- texinfo -*-
% @deftypefn {Function File} {@var{y} =} wgn (@var{m},@var{n},@var{p})
% @deftypefnx {Function File} {@var{y} =} wgn (@var{m},@var{n},@var{p},@var{imp})
% @deftypefnx {Function File} {@var{y} =} wgn (@var{m},@var{n},@var{p},@var{imp},@var{seed},)
% @deftypefnx {Function File} {@var{y} =} wgn (@var{...},'@var{type}')
% @deftypefnx {Function File} {@var{y} =} wgn (@var{...},'@var{output}')
%
% Returns a M-by-N matrix @var{y} of white Gaussian noise. @var{p} specifies
% the power of the output noise, which is assumed to be referenced to an
% impedance of 1 Ohm, unless @var{imp} explicitly defines the impedance.
%
% If @var{seed} is defined then the randn function is seeded with this
% value.
%
% The arguments @var{type} and @var{output} must follow the above numerial
% arguments, but can be specified in any order. @var{type} specifies the
% units of @var{p}, and can be 'dB', 'dBW', 'dBm' or 'linear'. 'dB' is
% in fact the same as 'dBW' and is keep as a misnomer of Matlab. The
% units of 'linear' are in Watts.
%
% The @var{output} variable should be either 'real' or 'complex'. If the
% output is complex then the power @var{p} is divided equally betwen the
% real and imaginary parts.
%
% @seealso{randn,awgn}
% @end deftypefn