@c -----------------------------------------------------------------------------
@c File     : ggf.de.texi
@c License  : GNU General Public License (GPL)
@c Language : German
@c Date     : 08.11.2010
@c 
@c This file is part of Maxima -- GPL CAS based on DOE-MACSYMA
@c -----------------------------------------------------------------------------

@menu
* Functions and Variables for ggf::
@end menu

@c -----------------------------------------------------------------------------
@node Functions and Variables for ggf,  , ggf, ggf
@section Functions and Variables for ggf

@c -----------------------------------------------------------------------------
@defvr {Option variable} GGFINFINITY
Default value: 3

This is an option variable for function @code{ggf}.

When computing the continued fraction of the
generating function, a partial quotient having a degree
(strictly) greater than @var{GGFINFINITY} will be discarded and
the current convergent will be considered as the exact value
of the generating function; most often the degree of all
partial quotients will be 0 or 1; if you use a greater value,
then you should give enough terms in order to make the
computation accurate enough.


See also @code{ggf}.

@c @opencatbox
@c @category{Package ggf}
@c @closecatbox
@end defvr

@c -----------------------------------------------------------------------------
@defvr {Option variable} GGFCFMAX
Default value: 3

This is an option variable for function @code{ggf}.

When computing the continued fraction of the
generating function, if no good result has been found (see
the @var{GGFINFINITY} flag) after having computed @var{GGFCFMAX} partial
quotients, the generating function will be considered as
not being a fraction of two polynomials and the function will
exit. Put freely a greater value for more complicated
generating functions.

See also @code{ggf}.

@c @opencatbox
@c @category{Package ggf}
@c @closecatbox
@end defvr

@c -----------------------------------------------------------------------------
@deffn {Function} ggf (@var{l})

Compute the generating function (if it is a fraction of two
polynomials) of a sequence, its first terms being given. @var{l}
is a list of numbers.

The solution is returned as a fraction of two polynomials.
If no solution has been found, it returns with @code{done}.

This function is controlled by global variables @var{GGFINFINITY} and 
@var{GGFCFMAX}. See also @var{GGFINFINITY} and @var{GGFCFMAX}.

To use this function write first @code{load("ggf")}.

@c @opencatbox
@c @category{Generating functions} @category{Share packages} @category{Package ggf}
@c @closecatbox
@end deffn

@c --- End of file ggf.de.texi -------------------------------------------------

