% -*- texinfo -*-
% @deftypefn {Function File} {} renyi_entropy (@var{alpha}, @var{P})
%
% Compute the Renyi entropy of order @var{alpha},
% for the given probability distribution @var{P}.
%
% @math{Halpha(P(x)) = log{\sum_i{(P(x_i)^alpha)}/(1-alpha)}}
%
% special-cases include, when @var{alpha}=1, it reduces to
% regular definition of shannon entropy, and when @var{alpha}=0,
% it reduces to hartley entropy.
%
% @example
% @group
% renyi_entropy(0,[0.2 0.3 0.5])
% @result{} ans = 1.0986
% @end group
% @end example
% @end deftypefn