% -*- texinfo -*-
% @deftypefn {Function File} {z = } demodmap (@var{y},@var{fd},@var{fs},'ask',@var{m})
% @deftypefnx {Function File} {z = } demodmap (@var{y},@var{fd},@var{fs},'fsk',@var{m},@var{tone})
% @deftypefnx {Function File} {z = } demodmap (@var{y},@var{fd},@var{fs},'msk')
% @deftypefnx {Function File} {z = } demodmap (@var{y},@var{fd},@var{fs},'psk',@var{m})
% @deftypefnx {Function File} {z = } demodmap (@var{y},@var{fd},@var{fs},'qask',@var{m})
% @deftypefnx {Function File} {z = } demodmap (@var{y},@var{fd},@var{fs},'qask/cir',@var{nsig},@var{amp},@var{phs})
% @deftypefnx {Function File} {z = } demodmap (@var{y},@var{fd},@var{fs},'qask/arb',@var{inphase},@var{quadr})
% @deftypefnx {Function File} {z = } demodmap (@var{y},@var{fd},@var{fs},'qask/arb',@var{map})
% @deftypefnx {Function File} {z = } demodmap (@var{y},[@var{fd}, @var{off}],@var{...})
%
% Demapping of an analog signal to a digital signal. The function
% @dfn{demodmap} must have at least three input arguments and one
% output argument. Argument @var{y} is a complex variable representing
% the analog signal to be demapped. The variables @var{fd} and @var{fs} are
% the sampling rate of the of digital signal and the sampling rate of the
% analog signal respectively. It is required that @code{@var{fs}/@var{fd}}
% is an integer.
%
% The available mapping of the digital signal are
%
% @table @asis
% @item 'ask'
% Amplitude shift keying
% @item 'fsk'
% Frequency shift keying
% @item 'msk'
% Minimum shift keying
% @item 'psk'
% Phase shift keying
% @item 'qask'
% @itemx 'qsk'
% @itemx 'qam'
% Quadraure amplitude shift keying
% @end table
%
% In addition the 'qask', 'qsk' and 'qam' method can be modified with the
% flags '/cir' or '/arb'. That is 'qask/cir' and 'qask/arb', etc are valid
% methods and give circular- and arbitrary-qask mappings respectively. Also
% the method 'fsk' and 'msk' can be modified with the flag '/max', in
% which case @var{y} is assumed to be a matrix with @var{m} columns,
% representing the symbol correlations.
%
% The variable @var{m} is the order of the modulation to use. By default
% this is 2, and in general should be specified.
%
% For 'qask/cir', the additional arguments are the same as for
% @dfn{apkconst}, and you are referred to @dfn{apkconst} for the definitions
% of the additional variables.
%
% For 'qask/arb', the additional arguments @var{inphase} and @var{quadr} give
% the in-phase and quadrature components of the mapping, in a similar mapping
% to the outputs of @dfn{qaskenco} with one argument. Similar @var{map}
% represents the in-phase and quadrature components of the mapping as
% the real and imaginary parts of the variable @var{map}.
% @end deftypefn
% @seealso{modmap,ddemodce,ademodce,apkconst,qaskenco}