doc/info/ggf.texi

   1 @menu
   2 * Functions and Variables for ggf::
   3 @end menu
   4
   5 @node Functions and Variables for ggf,  , ggf-pkg, ggf-pkg
   6 @section Functions and Variables for ggf
   7
   8 @defvr {Option variable} GGFINFINITY
   9 Default value: 3
  10
  11 This is an option variable for function @code{ggf}.
  12
  13 When computing the continued fraction of the
  14 generating function, a partial quotient having a degree
  15 (strictly) greater than @var{GGFINFINITY} will be discarded and
  16 the current convergent will be considered as the exact value
  17 of the generating function; most often the degree of all
  18 partial quotients will be 0 or 1; if you use a greater value,
  19 then you should give enough terms in order to make the
  20 computation accurate enough.
  21
  22
  23 See also @mref{ggf}.
  24
  25 @opencatbox{Categories:}
  26 @category{Package ggf}
  27 @closecatbox
  28
  29 @end defvr
  30
  31
  32 @defvr {Option variable} GGFCFMAX
  33 Default value: 3
  34
  35 This is an option variable for function @code{ggf}.
  36
  37 When computing the continued fraction of the
  38 generating function, if no good result has been found (see
  39 the @var{GGFINFINITY} flag) after having computed @var{GGFCFMAX} partial
  40 quotients, the generating function will be considered as
  41 not being a fraction of two polynomials and the function will
  42 exit. Put freely a greater value for more complicated
  43 generating functions.
  44
  45 See also @mref{ggf}.
  46
  47 @opencatbox{Categories:}
  48 @category{Package ggf}
  49 @closecatbox
  50
  51 @end defvr
  52
  53 @anchor{ggf}
  54 @deffn {Function} ggf (@var{l})
  55 Compute the generating function (if it is a fraction of two
  56 polynomials) of a sequence, its first terms being given. @var{l}
  57 is a list of numbers.
  58
  59 The solution is returned as a fraction of two polynomials.
  60 If no solution has been found, it returns with @code{done}.
  61
  62 This function is controlled by global variables @var{GGFINFINITY} and @var{GGFCFMAX}. See also @var{GGFINFINITY} and @var{GGFCFMAX}.
  63
  64 To use this function write first @code{load("ggf")}.
  65
  66 @opencatbox{Categories:}
  67 @category{Generating functions}
  68 @category{Share packages}
  69 @category{Package ggf}
  70 @closecatbox
  71
  72 @end deffn