% -*- texinfo -*-
% @deftypefn {Function File} {} scatterplot (@var{x})
% @deftypefnx {Function File} {} scatterplot (@var{x},@var{n})
% @deftypefnx {Function File} {} scatterplot (@var{x},@var{n},@var{off})
% @deftypefnx {Function File} {} scatterplot (@var{x},@var{n},@var{off},@var{str})
% @deftypefnx {Function File} {} scatterplot (@var{x},@var{n},@var{off},@var{str},@var{h})
% @deftypefnx {Function File} {@var{h} =} scatterplot (@var{...})
%
% Display the scatter plot of a signal. The signal @var{x} can be either in
% one of three forms
%
% @table @asis
% @item A real vector
% In this case the signal is assumed to be real and represented by the vector
% @var{x}. The scatterplot is plotted along the x axis only.
% @item A complex vector
% In this case the in-phase and quadrature components of the signal are
% plotted seperately on the x and y axes respectively.
% @item A matrix with two columns
% In this case the first column represents the in-phase and the second the
% quadrature components of a complex signal and are plotted on the x and
% y axes respectively.
% @end table
%
% Each point of the scatter plot is assumed to be seperated by @var{n}
% elements in the signal. The first element of the signal to plot is
% determined by @var{off}. By default @var{n} is 1 and @var{off} is 0.
%
% The string @var{str} is a plot style string (example 'r+'),
% and by default is the default gnuplot point style.
%
% The figure handle to use can be defined by @var{h}. If @var{h} is not
% given, then the next available figure handle is used. The figure handle
% used in returned on @var{hout}.
% @end deftypefn
% @seealso{eyediagram}