% -*- texinfo -*-
% @deftypefn {Function File} {@var{c} =} condeig (@var{a})
% @deftypefnx {Function File} {[@var{v}, @var{lambda}, @var{c}] =} condeig (@var{a})
% Compute condition numbers of the eigenvalues of a matrix. The
% condition numbers are the reciprocals of the cosines of the angles
% between the left and right eigenvectors.
%
% @subheading Arguments
%
% @itemize @bullet
% @item
% @var{a} must be a square numeric matrix.
% @end itemize
%
% @subheading Return values
%
% @itemize @bullet
% @item
% @var{c} is a vector of condition numbers of the eigenvalue of
% @var{a}.
%
% @item
% @var{v} is the matrix of right eigenvectors of @var{a}. The result is
% the same as for @code{[v, lambda] = eig (a)}.
%
% @item
% @var{lambda} is the diagonal matrix of eigenvalues of @var{a}. The
% result is the same as for @code{[v, lambda] = eig (a)}.
% @end itemize
%
% @subheading Example
%
% @example
% @group
% a = [1, 2; 3, 4];
% c = condeig (a)
% @result{} [1.0150; 1.0150]
% @end group
% @end example
% @end deftypefn