  
  [1X3 [33X[0;0YFurther functions[133X[101X
  
  [33X[0;0YA  short  remark  is  probably  in  order  on the three global variables the
  package  is using: [9XHeLP_CT[109X, [9XHeLP_sol[109X and [9XHeLP_settings[109X. The first one stores
  the  character  table  for  which  the last calculations were performed, the
  second  one  containing  at  the  [9Xk[109X's spot the already calculated admissible
  partial augmentations of elements of order [23Xk[123X (and its powers [23Xu^d[123X for [23Xd \not=
  k[123X  a  divisor  of  [23Xk[123X).  If  a  function of the HeLP-package is called with a
  character  table  different  from  the one saved in [9XHeLP_CT[109X then the package
  tries to check if the character tables belong to the same group. This can be
  done  in  particular  for tables from the ATLAS. If this check is successful
  the  solutions already written in [9XHeLP_sol[109X are kept, otherwise this variable
  is   reset.   For  a  more  detailed  account  see  Sections  [14X4.2[114X,  [14X5.2[114X  and
  [2XHeLP_ChangeCharKeepSols[102X  ([14X3.4-1[114X). In most situations, the user does not have
  to  worry  about  this, the program will take care of it as far as possible.
  [9XHeLP_settings[109X  is  a  varaible  which  is used to store some settings of the
  program.[133X
  
  
  [1X3.1 [33X[0;0YChecks for specific orders[133X[101X
  
  [1X3.1-1 HeLP_WithGivenOrder[101X
  
  [29X[2XHeLP_WithGivenOrder[102X( [3XCharacterTable|ListOfClassFunctions[103X, [3Xord[103X ) [32X function
  [6XReturns:[106X  [33X[0;10YList of admissible partial augmentations[133X
  
  [33X[0;0YCalculates  the  admissible  partial augmentations for elements of order [3Xord[103X
  using  only  the data given in the first argument. The first argument can be
  an  ordinary  character table, a Brauer table, or a list of class functions,
  all  having the same underlying character table. This function only uses the
  constraints  of  the  HeLP method (from the class functions given), but does
  not apply the Wagner test [14X5.4[114X. If the constraints allow only a finite number
  of  solutions, these lists will be written in [9XHeLP_sol[ord][109X. If for divisors
  [22Xd[122X  of  [3Xord[103X solutions are already calculated and stored in [9XHeLP_sol[d][109X, these
  will  be  used,  otherwise  the  function  [9XHeLP_WithGivenOrder[109X will first be
  applied to this order and the data given in the first argument.[133X
  
  [4X[32X  Example  [32X[104X
    [4X[25Xgap>[125X [27XC := CharacterTable("A5");[127X[104X
    [4X[28XCharacterTable( "A5" )[128X[104X
    [4X[25Xgap>[125X [27XHeLP_WithGivenOrder(C, 5);[127X[104X
    [4X[28X#I  Number of solutions for elements of order 5: 2; stored in HeLP_sol[5].[128X[104X
    [4X[28X[ [ [ 0, 1 ] ], [ [ 1, 0 ] ] ][128X[104X
    [4X[25Xgap>[125X [27XHeLP_PrintSolution(5);[127X[104X
    [4X[28XSolutions for elements of order 5:[128X[104X
    [4X[28X[ [               u ],.[128X[104X
    [4X[28X  [  [ "5a", "5b" ] ],[128X[104X
    [4X[28X  [             --- ],[128X[104X
    [4X[28X  [        [ 0, 1 ] ],[128X[104X
    [4X[28X  [        [ 1, 0 ] ] ][128X[104X
  [4X[32X[104X
  
  [33X[0;0YTests which partial augmentations for elements of order 5 are admissible.[133X
  
  [4X[32X  Example  [32X[104X
    [4X[25Xgap>[125X [27XC := CharacterTable("A6");[127X[104X
    [4X[28XCharacterTable( "A6" )[128X[104X
    [4X[25Xgap>[125X [27XHeLP_WithGivenOrder(C, 4);[127X[104X
    [4X[28X#I  Number of solutions for elements of order 4: 4; stored in HeLP_sol[4].[128X[104X
    [4X[28X[ [ [ 1 ], [ -1, 2 ] ], [ [ 1 ], [ 2, -1 ] ], [ [ 1 ], [ 1, 0 ] ], [128X[104X
    [4X[28X  [ [ 1 ], [ 0, 1 ] ] ][128X[104X
    [4X[25Xgap>[125X [27XHeLP_sol[4];              [127X[104X
    [4X[28X[ [ [ 1 ], [ -1, 2 ] ], [ [ 1 ], [ 2, -1 ] ], [ [ 1 ], [ 1, 0 ] ], [128X[104X
    [4X[28X  [ [ 1 ], [ 0, 1 ] ] ][128X[104X
  [4X[32X[104X
  
  [33X[0;0YTwo  of the non-trivial partial augmentations can be eliminated by using the
  Brauer table modulo the prime [23X3[123X:[133X
  
  [4X[32X  Example  [32X[104X
    [4X[25Xgap>[125X [27XHeLP_WithGivenOrder(C mod 3, 4);                                                                    [127X[104X
    [4X[28X#I  Number of solutions for elements of order 4: 2; stored in HeLP_sol[4].[128X[104X
    [4X[28X[ [ [ 1 ], [ 1, 0 ] ], [ [ 1 ], [ 0, 1 ] ] ][128X[104X
  [4X[32X[104X
  
  [33X[0;0YWhen  using [9XHeLP_ZC[109X also the last remaining non-trivial partial augmentation
  disappears,   as  this  function  applies  the  Wagner  test,  cf.  [14X5.4[114X  and
  [2XHeLP_WagnerTest[102X ([14X3.7-1[114X):[133X
  
  [4X[32X  Example  [32X[104X
    [4X[25Xgap>[125X [27XHeLP_ZC(C);               [127X[104X
    [4X[28X#I  ZC can't be solved, using the given data, for the orders: [ 6 ].[128X[104X
    [4X[28Xfalse[128X[104X
    [4X[25Xgap>[125X [27XHeLP_sol[4]; HeLP_sol[6];[127X[104X
    [4X[28X[ [ [ 1 ], [ 0, 1 ] ] ][128X[104X
    [4X[28X[ [ [ 1 ], [ 0, 1 ], [ -2, 2, 1 ] ], [ [ 1 ], [ 1, 0 ], [ -2, 1, 2 ] ] ][128X[104X
  [4X[32X[104X
  
  [33X[0;0YThe  following  example  demonstrates how one can use lists of characters to
  obtain constraints for partial augmentations:[133X
  
  [4X[32X  Example  [32X[104X
    [4X[25Xgap>[125X [27XC := CharacterTable("L2(49).2_1");   [127X[104X
    [4X[28XCharacterTable( "L2(49).2_1" )[128X[104X
    [4X[25Xgap>[125X [27XHeLP_WithGivenOrder(Irr(C), 7);;[127X[104X
    [4X[28X#I  Number of solutions for elements of order 7: 1; stored in HeLP_sol[7].[128X[104X
    [4X[25Xgap>[125X [27XHeLP_WithGivenOrder(Irr(C){[2]}, 14);[127X[104X
    [4X[28X#I  The given data admit infinitely many solutions for elements of order 14.[128X[104X
    [4X[25Xgap>[125X [27XHeLP_WithGivenOrder(Irr(C){[44]}, 14);[127X[104X
    [4X[28X#I  The given data admit infinitely many solutions for elements of order 14.[128X[104X
    [4X[25Xgap>[125X [27XHeLP_WithGivenOrder(Irr(C){[2,44]}, 14);[127X[104X
    [4X[28X#I  Number of solutions for elements of order 14: 0; stored in HeLP_sol[14].[128X[104X
    [4X[28X[  ][128X[104X
  [4X[32X[104X
  
  [33X[0;0YBrauer  tables  can  provide  more  restrictions on partial augmentations of
  certain torsion units:[133X
  
  [4X[32X  Example  [32X[104X
    [4X[25Xgap>[125X [27XC := CharacterTable("J1");       [127X[104X
    [4X[28XCharacterTable( "J1" )[128X[104X
    [4X[25Xgap>[125X [27XHeLP_WithGivenOrder(C, 6);;[127X[104X
    [4X[28X#I  Number of solutions for elements of order 6: 73; stored in HeLP_sol[6].[128X[104X
    [4X[25Xgap>[125X [27XB := C mod 11;[127X[104X
    [4X[28XBrauerTable( "J1", 11 )[128X[104X
    [4X[25Xgap>[125X [27XHeLP_WithGivenOrder(B, 6);;       [127X[104X
    [4X[28X#I  Number of solutions for elements of order 6: 6; stored in HeLP_sol[6].[128X[104X
    [4X[25Xgap>[125X [27XHeLP_WithGivenOrder(Irr(B){[2,3]}, 6);;[127X[104X
    [4X[28X#I  Number of solutions for elements of order 6: 6; stored in HeLP_sol[6].[128X[104X
    [4X[25Xgap>[125X [27XHeLP_PrintSolution(6);[127X[104X
    [4X[28XSolutions for elements of order 6:[128X[104X
    [4X[28X[ [                   u^3,                   u^2,                     u ],[128X[104X
    [4X[28X  [              [ "2a" ],              [ "3a" ],  [ "2a", "3a", "6a" ] ],[128X[104X
    [4X[28X  [                   ---,                   ---,                   --- ],[128X[104X
    [4X[28X  [                 [ 1 ],                 [ 1 ],          [ -2, 0, 3 ] ],[128X[104X
    [4X[28X  [                 [ 1 ],                 [ 1 ],          [ 2, 0, -1 ] ],[128X[104X
    [4X[28X  [                 [ 1 ],                 [ 1 ],           [ 0, 0, 1 ] ],[128X[104X
    [4X[28X  [                 [ 1 ],                 [ 1 ],          [ -4, 3, 2 ] ],[128X[104X
    [4X[28X  [                 [ 1 ],                 [ 1 ],          [ 0, 3, -2 ] ],[128X[104X
    [4X[28X  [                 [ 1 ],                 [ 1 ],          [ -2, 3, 0 ] ] ][128X[104X
  [4X[32X[104X
  
  [33X[0;0YThe result of the previous example can be found in [BJK11].[133X
  
  [33X[0;0YWhen  dealing  with  many  variables  using lists of characters instead of a
  complete  character  table  might  also speed up the calculations a lot, see
  Section [14X4.3[114X.[133X
  
  [4X[32X  Example  [32X[104X
    [4X[25Xgap>[125X [27XC := CharacterTable("L2(27)");[127X[104X
    [4X[28XCharacterTable( "L2(27)" )[128X[104X
    [4X[25Xgap>[125X [27XHeLP_WithGivenOrder(C,7);;[127X[104X
    [4X[28X#I  Number of solutions for elements of order 7: 78; stored in HeLP_sol[7].[128X[104X
    [4X[25Xgap>[125X [27XSetInfoLevel(HeLP_Info,4);[127X[104X
    [4X[25Xgap>[125X [27XHeLP_WithGivenOrder(C,3*7); [127X[104X
    [4X[28X#I      Solutions for order 3 not yet calculated.  Restart for this order.[128X[104X
    [4X[28X#I  Number of solutions for elements of order 21: 0; stored in HeLP_sol[21].  [128X[104X
    [4X[28X[  ][128X[104X
    [4X[25Xgap>[125X [27XSetInfoLevel(HeLP_Info,1);[127X[104X
  [4X[32X[104X
  
  [33X[0;0Y[9XHeLP_WithGivenOrder[109X  often  needs to consider many cases. Set the info class
  HeLP_Info  to a level 4 or higher to keep track of the progress, see Section
  [14X4.4[114X on info levels.[133X
  
  [1X3.1-2 HeLP_WithGivenOrderAndPA[101X
  
  [29X[2XHeLP_WithGivenOrderAndPA[102X( [3XCharacterTable|ListOfClassFunctions[103X, [3Xord[103X, [3Xpartaugs[103X ) [32X function
  [6XReturns:[106X  [33X[0;10YList of admissible partial augmentations[133X
  
  [33X[0;0YCalculates  the  admissible  partial augmentations for elements of order [3Xord[103X
  using  only  the data given in the first argument. The first argument can be
  an  ordinary  character table, a Brauer table, or a list of class functions,
  all  having  the  same  underlying  character  table.  The function uses the
  partial augmentations for the powers [22Xu^d[122X with [22Xd[122X divisors of [22Xk[122X different from
  [22X1[122X  and  [22Xk[122X  given in [3Xpartaugs[103X. Here, the [22Xd[122X's have to be in a descending order
  (i.e.  the  orders  of the [23Xu^d[123X's are ascending). This function only uses the
  constraints of the HeLP method, but does not apply the Wagner test [14X5.4[114X. Note
  that this function will not affect [9XHeLP_sol[109X.[133X
  
  [4X[32X  Example  [32X[104X
    [4X[25Xgap>[125X [27XG := SmallGroup(48,33);; StructureDescription(G);[127X[104X
    [4X[28X"SL(2,3) : C2"[128X[104X
    [4X[25Xgap>[125X [27XC := CharacterTable(G);;[127X[104X
    [4X[25Xgap>[125X [27XHeLP_WithGivenOrder(C, 4);;[127X[104X
    [4X[28X#I  Number of solutions for elements of order 4: 4; stored in HeLP_sol[4].[128X[104X
    [4X[25Xgap>[125X [27XHeLP_WithGivenOrder(C, 6);;[127X[104X
    [4X[28X#I  Number of solutions for elements of order 6: 2; stored in HeLP_sol[6].[128X[104X
    [4X[25Xgap>[125X [27XHeLP_sol[4]; HeLP_sol[6];[127X[104X
    [4X[28X[ [ [ 1, 0 ], [ 0, 1, 0, 0, 0 ] ], [ [ 1, 0 ], [ 0, 0, 0, 0, 1 ] ], [128X[104X
    [4X[28X  [ [ 1, 0 ], [ 0, 0, 0, 1, 0 ] ], [ [ 1, 0 ], [ 0, 0, 1, 0, 0 ] ] ][128X[104X
    [4X[28X[ [ [ 1, 0 ], [ 0, 1 ], [ 0, 0, 0, 0, 1, 0 ] ], [128X[104X
    [4X[28X  [ [ 1, 0 ], [ 1, 0 ], [ 0, 0, 0, 0, 0, 1 ] ] ][128X[104X
    [4X[25Xgap>[125X [27XHeLP_WithGivenOrderAndPA(C, 12, [ [ 1, 0 ],  [ 0, 1 ], [ 0, 0, 0, 0, 1 ],[127X[104X
    [4X[25X>[125X [27X    [ 0, 0, 0, 0, 1, 0 ] ]); [127X[104X
    [4X[28X#I  Number of solutions for elements of order 12 with these partial augmentation[128X[104X
    [4X[28Xs for the powers: 1.[128X[104X
    [4X[28X[ [ [ 1, 0 ], [ 0, 1 ], [ 0, 0, 0, 0, 1 ], [ 0, 0, 0, 0, 1, 0 ], [128X[104X
    [4X[28X      [ 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 0, 0 ] ] ][128X[104X
    [4X[25Xgap>[125X [27XHeLP_WithGivenOrderAndPA(C, 12, [ [ 1, 0 ],  [ 0, 1 ], [ 0, 0, 0, 1, 0 ],[127X[104X
    [4X[25X>[125X [27X    [ 0, 0, 0, 0, 1, 0 ] ]);[127X[104X
    [4X[28X#I  Number of solutions for elements of order 12 with these partial augmentation[128X[104X
    [4X[28Xs for the powers: 0.[128X[104X
    [4X[28X[  ][128X[104X
  [4X[32X[104X
  
  [33X[0;0YIn  the  calls  of  [9XHeLP_WithGivenOrderAndPA[109X the function uses the following
  partial augmentations:[133X
  
  [30X    [33X[0;6Y[9X[ 1, 0 ][109X for the element [22Xu^6[122X of order 2,[133X
  
  [30X    [33X[0;6Y[9X[ 0, 1 ][109X for the element [22Xu^4[122X of order 3,[133X
  
  [30X    [33X[0;6Y[9X[ 0, 0, 0, 0, 1 ][109X and [9X[ 0, 0, 0, 1, 0 ][109X for the element [22Xu^3[122X of order 4
        respectively,[133X
  
  [30X    [33X[0;6Y[9X[ 0, 0, 0, 0, 1, 0 ][109X for the element [22Xu^2[122X of order 6.[133X
  
  [1X3.1-3 HeLP_WithGivenOrderAndPAAndSpecificSystem[101X
  
  [29X[2XHeLP_WithGivenOrderAndPAAndSpecificSystem[102X( [3Xlist[103X, [3Xord[103X, [3Xpartaugs[103X[, [3Xb[103X] ) [32X function
  [6XReturns:[106X  [33X[0;10YList of admissible partial augmentations[133X
  
  [33X[0;0YCalculates  the  admissible  partial augmentations for elements of order [3Xord[103X
  using  only  the  data  given in the first argument. The first argument is a
  list,  which  can contains as entries characters or pairs with first entry a
  character  and  second  entrie  an  integer or a mixture of these. The first
  argument  is  understood as follows: If a character [22Xχ[122X is not given in a pair
  all  inequalities obtainable by this character are used. If it is given in a
  pair with the integer [22Xm[122X the inequalities obtainable from the multiplicity of
  [9XE(ord)[109X taken to the power [22Xm[122X as an eigenvalue of a representation affording [22Xχ[122X
  are  used.  The  function  uses the partial augmentations for the powers [22Xu^d[122X
  with [22Xd[122X divisors of [22Xk[122X different from [22X1[122X and [22Xk[122X given in [3Xpartaugs[103X. Here, the [22Xd[122X's
  have  to  be  in  a  descending  order  (i.e.  the  orders  of the [23Xu^d[123X's are
  ascending).  This function only uses the constraints of the HeLP method, but
  does  not apply the Wagner test [14X5.4[114X. Note that this function will not affect
  [9XHeLP_sol[109X.[133X
  
  [4X[32X  Example  [32X[104X
    [4X[25Xgap>[125X [27XC := CharacterTable("A5");[127X[104X
    [4X[28XCharacterTable( "A5" )[128X[104X
    [4X[25Xgap>[125X [27Xchi := Irr(C)[2];; psi := Irr(C)[4];[127X[104X
    [4X[28XCharacter( CharacterTable( "A5" ), [ 4, 0, 1, -1, -1 ] )[128X[104X
    [4X[25Xgap>[125X [27XHeLP_WithGivenOrderAndPAAndSpecificSystem([[chi, 1], [chi, 2]],[127X[104X
    [4X[25X>[125X [27X 5, [ ], true);[127X[104X
    [4X[28X[ [ [ [ 0, 1 ] ], [ [ 1, 0 ] ] ], [ [ -3/5, 2/5 ], [ 2/5, -3/5 ] ], [ 3/5, 3/5 ] ][128X[104X
    [4X[25Xgap>[125X [27Xsol5 := HeLP_WithGivenOrderAndPAAndSpecificSystem([[chi, 1], [chi, 2]], [127X[104X
    [4X[25X>[125X [27X 5, [ ]);      [127X[104X
    [4X[28X[ [ [ 0, 1 ] ], [ [ 1, 0 ] ] ][128X[104X
  [4X[32X[104X
  
  [33X[0;0YThe inequalities in the above examples are:[133X
  
  
        [33X[1;6Y[24X[33X[0;0Y\frac{-3}{5}\varepsilon_{5a}(u) + \frac{2}{5}\varepsilon_{5b}(u) +
        \frac{3}{5} \in \mathbb{Z}_{\geq 0} \ \ {\rm{and}} \ \
        \frac{2}{5}\varepsilon_{5a}(u) + \frac{-3}{5}\varepsilon_{5b}(u) +
        \frac{3}{5} \in \mathbb{Z}_{\geq 0}.[133X [124X[133X
  
  
  [33X[0;0YContinuing the above example:[133X
  
  [4X[32X  Example  [32X[104X
    [4X[25Xgap>[125X [27XHeLP_WithGivenOrderAndPAAndSpecificSystem([psi], [127X[104X
    [4X[25X>[125X [27X 2*5, [[1], sol5[1][1]], true);     [127X[104X
    [4X[28X[ [  ], [ [ 0, -2/5, -2/5 ], [ 0, -1/10, -1/10 ], [ 0, 1/10, 1/10 ],[128X[104X
    [4X[28X [ 0, -1/10, -1/10 ], [ 0, 1/10, 1/10 ], [ 0, 2/5, 2/5 ], [128X[104X
    [4X[28X [ 0, 1/10, 1/10 ], [ 0, -1/10, -1/10 ], [ 0, 1/10, 1/10 ], [128X[104X
    [4X[28X[ 0, -1/10, -1/10 ] ], [ 0, 1/2, 1/2, 1/2, 1/2, 0, 1/2, 1/2, 1/2, 1/2 ] ][128X[104X
    [4X[25Xgap>[125X [27XHeLP_WithGivenOrderAndPAAndSpecificSystem([[psi, 0], [psi, 2], [psi, 5]], [127X[104X
    [4X[25X>[125X [27X 2*5, [[1], sol5[2][1]], true); [127X[104X
    [4X[28X[ [  ], [ [ 0, -2/5, -2/5 ], [ 0, 1/10, 1/10 ], [ 0, 2/5, 2/5 ] ], [ 0, 1/2, 0 ] ][128X[104X
  [4X[32X[104X
  
  
  [1X3.2 [33X[0;0YChecks for specific orders with s-constant characters[133X[101X
  
  [33X[0;0YWhen  considering elements of order [23Xst[123X (in absence of elements of this order
  in  the  group  ;  in  particular  when  trying to prove (PQ)) and there are
  several  conjugacy  classes  of  elements  of order [23Xs[123X, it might be useful to
  consider [23Xs[123X-constant characters (cf. Section [14X5.5[114X) to reduce the computational
  complexity.[133X
  
  [1X3.2-1 HeLP_WithGivenOrderSConstant[101X
  
  [29X[2XHeLP_WithGivenOrderSConstant[102X( [3XCharacterTable|ListOfClassFunctions[103X, [3Xs[103X, [3Xt[103X ) [32X function
  [6XReturns:[106X  [33X[0;10YList of admissible "partial augmentations" or [9X"infinite"[109X[133X
  
  [33X[0;0YCalculates  the admissible partial augmentations for elements [22Xu[122X of order [22Xs*t[122X
  using  only  the  [23Xs[123X-constant class functions that are contained in the first
  argument.  The  first  argument can be an ordinary character table, a Brauer
  table,  or  a  list  of  class  functions,  all  having  the same underlying
  character table. [3Xs[103X and [3Xt[103X have to be different prime numbers, such that there
  are elements of order [3Xs[103X and [3Xt[103X in the group, but no elements of order [22Xs*t[122X.[133X
  
  [33X[0;0YThe  function  filters which class functions given in the first argument are
  constant  on  all  conjugacy classes of elements of order [3Xs[103X. For the element
  [22Xu^s[122X  of  order [3Xt[103X the partial augmentations given in [9XHeLP_sol[t][109X are used. If
  they  are  not yet calculated, the function calculates them first, using the
  data  given  in  the  first  argument  and  stores them in [9XHeLP_sol[t][109X. This
  function  only  uses  the constraints of the HeLP method, but does not apply
  the  Wagner  test  [14X5.4[114X.  If  these  calculations allow an infinite number of
  solutions   of  elements  of  order  [23Xst[123X  the  function  returns  [9X"infinite"[109X,
  otherwiese  it  returns  the  finite list of solutions for elements of order
  [22Xs*t[122X.   The  first  entry  of  every  solution  is  a  list  of  the  partial
  augmentations  of  [22Xu^s[122X  and  the  second  entry  is  a  list of the "partial
  augmentations" for [22Xu[122X: the first entry of this list is the sum of the partial
  augmentations  on  all  classes of elements of order [3Xs[103X and the other entries
  are  the  partial  augmentations on the classes of order [3Xt[103X. Only in the case
  that  the  existence  of units of order [23Xs*t[123X can be excluded by this function
  the variable [9XHeLP_sol[s*t][109X will be affected and [9XHeLP_sol[s*t][109X will be set to
  [9X[ ][109X.[133X
  
  [4X[32X  Example  [32X[104X
    [4X[25Xgap>[125X [27XC := CharacterTable("A6");;[127X[104X
    [4X[25Xgap>[125X [27XHeLP_WithGivenOrder(C, 6);            [127X[104X
    [4X[28X#I  Number of solutions for elements of order 6: 2; stored in HeLP_sol[6].[128X[104X
    [4X[28X[ [ [ 1 ], [ 0, 1 ], [ -2, 2, 1 ] ], [ [ 1 ], [ 1, 0 ], [ -2, 1, 2 ] ] ][128X[104X
    [4X[25Xgap>[125X [27XHeLP_WithGivenOrderSConstant(C, 2, 3);[127X[104X
    [4X[28X[ [ [ 0, 1 ], [ -2, 2, 1 ] ], [ [ 1, 0 ], [ -2, 1, 2 ] ] ][128X[104X
    [4X[25Xgap>[125X [27XHeLP_WithGivenOrderSConstant(C, 3, 2);     [127X[104X
    [4X[28X[ [ [ 1 ], [ 3, -2 ] ] ][128X[104X
  [4X[32X[104X
  
  [4X[32X  Example  [32X[104X
    [4X[25Xgap>[125X [27XC := CharacterTable("Sz(8)");;[127X[104X
    [4X[25Xgap>[125X [27XSetInfoLevel(HeLP_Info, 4);[127X[104X
    [4X[25Xgap>[125X [27XHeLP_WithGivenOrderSConstant(C, 7, 13);[127X[104X
    [4X[28X#I    Partial augmentations for elements of order 13 not yet calculated.  Restar[128X[104X
    [4X[28Xt for this order.[128X[104X
    [4X[28X#I    Number of non-trivial 7-constant characters in the list: 7.[128X[104X
    [4X[28X[  ][128X[104X
    [4X[25Xgap>[125X [27XSetInfoLevel(HeLP_Info, 1);[127X[104X
  [4X[32X[104X
  
  [33X[0;0YThe  last example can also be checked by using all characters in [9XC[109X, but this
  takes notably longer.[133X
  
  [4X[32X  Example  [32X[104X
    [4X[25Xgap>[125X [27XC := CharacterTable("Sz(32)");[127X[104X
    [4X[28XCharacterTable( "Sz(32)" )[128X[104X
    [4X[25Xgap>[125X [27XL := Filtered(OrdersClassRepresentatives(C), x-> x = 31);; Size(L);[127X[104X
    [4X[28X15           # I.e. HeLP_WithGivenOrder(C,31) would take hopelessly long[128X[104X
    [4X[25Xgap>[125X [27XHeLP_WithGivenOrderSConstant(C mod 2, 31, 5);[127X[104X
    [4X[28X[  ][128X[104X
    [4X[25Xgap>[125X [27XIsBound(HeLP_sol[31]);[127X[104X
    [4X[28Xfalse [128X[104X
  [4X[32X[104X
  
  [33X[0;0YWe  still  have  no  clue  about elements of order 31, but there are none of
  order 5*31.[133X
  
  [1X3.2-2 HeLP_AddGaloisCharacterSums[101X
  
  [29X[2XHeLP_AddGaloisCharacterSums[102X( [3XCT[103X ) [32X function
  [6XReturns:[106X  [33X[0;10YList of characters[133X
  
  [33X[0;0YGiven  an  ordinary  character  table  [3XCT[103X the function calculates the orbits
  under  the  action  of  the  Galois  group  and returns a list of characters
  containing  the ones contained in [3XCT[103X and the ones obtained by summing up the
  Galois-orbits.[133X
  
  
  [1X3.3 [33X[0;0YChecks for all orders[133X[101X
  
  [1X3.3-1 HeLP_AllOrders[101X
  
  [29X[2XHeLP_AllOrders[102X( [3XCharacterTable|Group[103X ) [32X function
  [6XReturns:[106X  [33X[0;10Y[9Xtrue[109X if (ZC) can be solved using the given data, [9Xfalse[109X otherwise[133X
  
  [33X[0;0YThis function does almost the same as [2XHeLP_ZC[102X ([14X2.1-1[114X). It checks whether the
  Zassenhaus  Conjecture can be verified for a group, but does not compute the
  partial augmentations of elements of order [23Xk[123X, if [9XHeLP_sol[k][109X already exists.
  It  does  however verify the solutions given in [9XHeLP_sol[109X using all available
  tables   for   the   group,   see  [2XHeLP_VerifySolution[102X  ([14X3.6-1[114X).  Thus  some
  precalculations  using  e.g.  [2XHeLP_WithGivenOrder[102X  ([14X3.1-1[114X) are respected. In
  contrast  to  [2XHeLP_ZC[102X  ([14X2.1-1[114X) this function also does not check whether the
  group  is  nilpotent  to  use the Weiss-result to have an immediate positive
  solution for (ZC).[133X
  
  [33X[0;0YThis  function  is  interesting  if one wants to save time or possesses some
  information,  which  was  not  obtained  using  this package and was entered
  manually into [9XHeLP_sol[109X.[133X
  
  [4X[32X  Example  [32X[104X
    [4X[25Xgap>[125X [27XC := CharacterTable(PSL(2,7));         [127X[104X
    [4X[28XCharacterTable( Group([ (3,7,5)(4,8,6), (1,2,6)(3,4,8) ]) )[128X[104X
    [4X[25Xgap>[125X [27XHeLP_ZC(C);        [127X[104X
    [4X[28X#I  The Brauer tables for the following primes are not available: [ 2, 3, 7 ].[128X[104X
    [4X[28X#I  (ZC) can't be solved, using the given data, for the orders: [ 6 ].[128X[104X
    [4X[28Xfalse[128X[104X
    [4X[25Xgap>[125X [27XHeLP_sol[6] := [ ];[127X[104X
    [4X[28X[  ][128X[104X
    [4X[25Xgap>[125X [27XHeLP_AllOrders(C);[127X[104X
    [4X[28Xtrue[128X[104X
  [4X[32X[104X
  
  [1X3.3-2 HeLP_AllOrdersPQ[101X
  
  [29X[2XHeLP_AllOrdersPQ[102X( [3XCharacterTable|Group[103X ) [32X function
  [6XReturns:[106X  [33X[0;10Y[9Xtrue[109X if (PQ) can be solved using the given data, [9Xfalse[109X otherwise[133X
  
  [33X[0;0YThis function does almost the same as [2XHeLP_PQ[102X ([14X2.2-1[114X). It checks whether the
  Prime  Graph  Question can be verified for a group, but does not compute the
  partial augmentations of elements of order [23Xk[123X, if [9XHeLP_sol[k][109X already exists.
  Thus   some  precalculations  using  e.g.  [2XHeLP_WithGivenOrder[102X  ([14X3.1-1[114X)  are
  respected.  In contrast to [2XHeLP_PQ[102X ([14X2.2-1[114X) this function also does not check
  whether  the  group  is  solvable  to  use  the  Kimmerle-result  to have an
  immediate positive solution for (ZC).[133X
  
  [33X[0;0YThis  function  is  interesting  if one wants to save time or possesses some
  information,  which  was  not  obtained  using  this package and was entered
  manually into [9XHeLP_sol[109X.[133X
  
  [4X[32X  Example  [32X[104X
    [4X[25Xgap>[125X [27XC := CharacterTable("A12");[127X[104X
    [4X[28XCharacterTable( "A12" )[128X[104X
    [4X[25Xgap>[125X [27XHeLP_WithGivenOrder(Irr(C){[2, 4, 7]}, 2);;[127X[104X
    [4X[28X#I  Number of solutions for elements of order 2: 37; stored in HeLP_sol[2].[128X[104X
    [4X[25Xgap>[125X [27XHeLP_WithGivenOrderSConstant(C mod 3,11,2);[127X[104X
    [4X[28X[  ][128X[104X
    [4X[25Xgap>[125X [27XHeLP_WithGivenOrder(Irr(C mod 2){[2, 3, 4, 6]}, 3);;[127X[104X
    [4X[28X#I  Number of solutions for elements of order 3: 99; stored in HeLP_sol[3].[128X[104X
    [4X[25Xgap>[125X [27XHeLP_WithGivenOrderSConstant(C mod 2, 11, 3);[127X[104X
    [4X[28X[  ][128X[104X
    [4X[25Xgap>[125X [27XHeLP_AllOrdersPQ(C);[127X[104X
    [4X[28Xtrue[128X[104X
  [4X[32X[104X
  
  [33X[0;0YThus  the Prime Graph Question holds for the alternating group of degree 12.
  Just using [9XHeLP_PQ(C)[109X would take hopelessly long.[133X
  
  
  [1X3.4 [33X[0;0YChanging the used Character Table[133X[101X
  
  [1X3.4-1 HeLP_ChangeCharKeepSols[101X
  
  [29X[2XHeLP_ChangeCharKeepSols[102X( [3XCT[103X ) [32X function
  [6XReturns:[106X  [33X[0;10Ynothing[133X
  
  [33X[0;0YThis function changes the used character table to the character table [3XCT[103X and
  keeps  all  the  solutions  calculated  so  far.  It  is  in  this  case the
  responsibility  of the user that the tables belong to the same group and the
  ordering  of  the  conjugacy classes in [3XCT[103X is consistent with the one in the
  previously used table. This function can be used to change from one table of
  the  group to another, e.g. from a Brauer table to the ordinary table if the
  calculations  will  involve  [23Xp[123X-singular  elements.  (In  case  the  involved
  character tables come from the ATLAS and their InfoText begins with "origin:
  ATLAS  of finite groups", this is done automatically by the program.) A user
  may also use characters, which are normally not accessible in GAP.[133X
  
  [33X[0;0YTo keep track of the change of the character tables one can set HeLP_Info to
  level  5. In this first example it is not realized that the character tables
  belong  to  the  same  group,  so  the solutions for elements of order 2 are
  recalculated (they have been reset, as another character table is used).[133X
  
  [4X[32X  Example  [32X[104X
    [4X[25Xgap>[125X [27XSetInfoLevel(HeLP_Info, 5);[127X[104X
    [4X[25Xgap>[125X [27XC := CharacterTable(SymmetricGroup(4)); [127X[104X
    [4X[28XCharacterTable( Sym( [ 1 .. 4 ] ) )[128X[104X
    [4X[25Xgap>[125X [27XHeLP_WithGivenOrder(C mod 2, 3); [127X[104X
    [4X[28X#I  USED CHARACTER TABLE CHANGED TO BrauerTable( SymmetricGroup( [ 1 .. 4 ] ), 2[128X[104X
    [4X[28X ), ALL GLOBAL VARIABLES RESET.[128X[104X
    [4X[28X#I  Number of solutions for elements of order 3: 1; stored in HeLP_sol[3].[128X[104X
    [4X[28X[ [ [ 1 ] ] ][128X[104X
    [4X[25Xgap>[125X [27XHeLP_WithGivenOrder(C, 2*3);    [127X[104X
    [4X[28X#I  USED CHARACTER TABLE CHANGED TO CharacterTable( SymmetricGroup( [ 1 .. 4 ] )[128X[104X
    [4X[28X ), ALL GLOBAL VARIABLES RESET.[128X[104X
    [4X[28X#I      Solutions for order 2 not yet calculated.  Restart for this order.[128X[104X
    [4X[28X#I      Solutions for order 3 not yet calculated.  Restart for this order.[128X[104X
    [4X[28X#I  Number of solutions for elements of order 6: 0; stored in HeLP_sol[6].[128X[104X
    [4X[28X[  ][128X[104X
  [4X[32X[104X
  
  [33X[0;0YThe   recalculations   of   the   solutions   can   be  avoided  by  calling
  [9XHeLP_ChangeCharKeepSols[109X before using another character table.[133X
  
  [4X[32X  Example  [32X[104X
    [4X[25Xgap>[125X [27XD := CharacterTable(SymmetricGroup(4));[127X[104X
    [4X[28XCharacterTable( Sym( [ 1 .. 4 ] ) )[128X[104X
    [4X[25Xgap>[125X [27XHeLP_WithGivenOrder(D mod 2, 3);       [127X[104X
    [4X[28X#I  USED CHARACTER TABLE CHANGED TO BrauerTable( SymmetricGroup( [ 1 .. 4 ] ), 2[128X[104X
    [4X[28X ), ALL GLOBAL VARIABLES RESET.[128X[104X
    [4X[28X#I  Number of solutions for elements of order 3: 1; stored in HeLP_sol[3].[128X[104X
    [4X[28X[ [ [ 1 ] ] ][128X[104X
    [4X[25Xgap>[125X [27XHeLP_ChangeCharKeepSols(D);[127X[104X
    [4X[28X#I  WARNING: Change used character table without checking if the character table[128X[104X
    [4X[28Xs have the same underlying groups and the ordering of the conjugacy classes are [128X[104X
    [4X[28Xthe same![128X[104X
    [4X[25Xgap>[125X [27XHeLP_WithGivenOrder(D, 2*3);    [127X[104X
    [4X[28X#I  Using same character table as until now; all known solutions kept.[128X[104X
    [4X[28X#I      Solutions for order 2 not yet calculated.  Restart for this order.[128X[104X
    [4X[28X#I  Number of solutions for elements of order 6: 0; stored in HeLP_sol[6].[128X[104X
    [4X[28X[  ][128X[104X
  [4X[32X[104X
  
  [33X[0;0YWhen using tables from the ATLAS this is done automatically:[133X
  
  [4X[32X  Example  [32X[104X
    [4X[25Xgap>[125X [27XCA := CharacterTable("A5");[127X[104X
    [4X[28XCharacterTable( "A5" )[128X[104X
    [4X[25Xgap>[125X [27XHeLP_WithGivenOrder(CA mod 2, 5);[127X[104X
    [4X[28X#I  USED CHARACTER TABLE CHANGED TO BrauerTable( "A5", 2 ), ALL GLOBAL VARIABLES[128X[104X
    [4X[28X RESET.[128X[104X
    [4X[28X#I  Testing possibility 1 out of 1.[128X[104X
    [4X[28X#I  Number of solutions for elements of order 5: 2; stored in HeLP_sol[5].[128X[104X
    [4X[28X[ [ [ 0, 1 ] ], [ [ 1, 0 ] ] ][128X[104X
    [4X[25Xgap>[125X [27XHeLP_WithGivenOrder(CA, 2*5);    [127X[104X
    [4X[28X#I  Using character table of the same group; all known solutions kept.[128X[104X
    [4X[28X#I      Solutions for order 2 not yet calculated.  Restart for this order.[128X[104X
    [4X[28X#I  Number of solutions for elements of order 10: 0; stored in HeLP_sol[10].[128X[104X
    [4X[28X[  ][128X[104X
    [4X[25Xgap>[125X [27XSetInfoLevel(HeLP_Info, 1);[127X[104X
  [4X[32X[104X
  
  [1X3.4-2 HeLP_Reset[101X
  
  [29X[2XHeLP_Reset[102X(  ) [32X function
  [6XReturns:[106X  [33X[0;10Ynothing[133X
  
  [33X[0;0YThis  function delets all the values calculated so far and resets the global
  variables  [9XHeLP_CT[109X  and  [9XHeLP_CT[109X  to  their  initial  value  [9X[ [ [1] ] ][109X and
  [9XCharacterTable(SmallGroup(1,1))[109X respectively.[133X
  
  
  [1X3.5 [33X[0;0YInfluencing how the Systems of Inequalities are solved[133X[101X
  
  [33X[0;0YHeLP uses currently three external programs (i.e. programs that are not part
  of the GAP-system): zsolve from 4ti2 and/or normaliz to solve the systems of
  linear  inequalities  and  redund  from  lrslib  to simplify the inequlities
  before handing them over to the solver (HeLP can also be used without lrslib
  installed. In general it is recommanded to have lrslib installed, if 4ti2 is
  used  as  the  solver). The following functions can be used to influence the
  behaviour of these external programms.[133X
  
  [1X3.5-1 HeLP_Solver[101X
  
  [29X[2XHeLP_Solver[102X( [[3Xstring[103X] ) [32X function
  [6XReturns:[106X  [33X[0;10Ynothing[133X
  
  [33X[0;0YThis  function  can  be  used  to change the solver used for the HeLP-system
  between  4ti2 and normaliz. If the function is called without an argument it
  prints  which solver is currently used. If the argument it is called with is
  one  of  the  stings  "4ti2"  or "normaliz", then the solver used for future
  calculations  is changed to the one given as argument in case this solver is
  found  by  the  HeLP-package.  If both solvers are found when the package is
  loaded normaliz is taken as default.[133X
  
  [1X3.5-2 HeLP_UseRedund[101X
  
  [29X[2XHeLP_UseRedund[102X( [3Xbool[103X ) [32X function
  [6XReturns:[106X  [33X[0;10Ynothing[133X
  
  [33X[0;0YThis  function determines whether HeLP uses 'redund' from the lrslib-package
  to remove redundant equations from the HeLP system. If [3Xbool[103X is [9Xtrue[109X 'redund'
  will  be  used in all calculation that follow, if it is [9Xfalse[109X, 'redund' will
  not  be  used  (which  might take significantly longer). If 'redund' was not
  found  by  GAP  a  warning  will  be  printed  and  the calculations will be
  performed  without  'redund'.  As  default  'redund'  will  be  used  in all
  calculations,  if  4ti2 is the chosen solver, and 'redund' will not be used,
  if normaliz is used.[133X
  
  [1X3.5-3 HeLP_Change4ti2Precision[101X
  
  [29X[2XHeLP_Change4ti2Precision[102X( [3Xstring[103X ) [32X function
  [6XReturns:[106X  [33X[0;10Ynothing[133X
  
  [33X[0;0YThis  function  changes the maximum precision of the calculations of 4ti2 to
  solve  the  occurring systems of linear inequalities. The possible arguments
  are  [9X"32"[109X, [9X"64"[109X and [9X"gmp"[109X. After calling the function the new precision will
  be  used  until  this  function  is used again. The default value is [9X"32"[109X. A
  higher precision causes slower calculations. But this function might be used
  to  increase  the  precision  of  4ti2,  when one gets an error message like
  "Error,  4ti2  Error:  Results  were  near maximum precision (32bit). Please
  restart  with  higher precision!" stating that the results were close to the
  maximum  4ti2-precision.  normaliz  does automatically change its precision,
  when it reaches an overflow.[133X
  
  [33X[0;0YSometimes it is desirable to perform calculations without redund (even if it
  is  installed  and in many cases improves the performance of the package) or
  with  a higher precision. For example, determining the partial augmentations
  for   units   of  order  [23X14[123X  for  [9XSmallGroup(392,  30)[109X  involves  very  long
  calculations  (when  called  with  redund  and precision 32) or cause errors
  (when  called without redund and precision 32). However, the following works
  in a reasonable time.[133X
  
  [4X[32X  Example  [32X[104X
    [4X[25Xgap>[125X [27XC := CharacterTable(SmallGroup(392,30));[127X[104X
    [4X[28XCharacterTable( <pc group of size 392 with 5 generators> )[128X[104X
    [4X[25Xgap>[125X [27XHeLP_Solver("4ti2");[127X[104X
    [4X[28X'4ti2' will be used from now on.[128X[104X
    [4X[25Xgap>[125X [27XHeLP_UseRedund(false);[127X[104X
    [4X[28XThe calculations will be performed without using 'redund' from now on.[128X[104X
    [4X[25Xgap>[125X [27XHeLP_ZC(C);[127X[104X
    [4X[28XError, 4ti2 Error:[128X[104X
    [4X[28XResults were near maximum precision (32bit).[128X[104X
    [4X[28XPlease restart with higher precision![128X[104X
    [4X[28XIf you continue, your results might be wrong called from[128X[104X
    [4X[28X4ti2Interface_zsolve_equalities_and_inequalities( [128X[104X
    [4X[28X [ ListWithIdenticalEntries( Size( T[1] ), 1 ) ], [ 1 ], temp[1], - temp[2] [128X[104X
    [4X[28X ) called from[128X[104X
    [4X[28XHeLP_TestSystemINTERNAL( W[1], W[2], k, arg[3] ) called from[128X[104X
    [4X[28XHeLP_WithGivenOrderAndPAINTERNAL( C, k, pa ) called from[128X[104X
    [4X[28XHeLP_WithGivenOrderINTERNAL( Irr( T ), k ) called from[128X[104X
    [4X[28X<function "HeLP_ZC">( <arguments> )[128X[104X
    [4X[28X called from read-eval loop at line 19 of *stdin*[128X[104X
    [4X[28Xyou can 'quit;' to quit to outer loop, or[128X[104X
    [4X[28Xyou can 'return;' to continue[128X[104X
    [4X[25Xgap>[125X [27Xbrk> quit;[127X[104X
    [4X[28X#I  Options stack has been reset[128X[104X
    [4X[25Xgap>[125X [27XHeLP_Change4ti2Precision("64");[127X[104X
    [4X[28XThe calculations of 4ti2 will be performed with precision 64 from now on.[128X[104X
    [4X[25Xgap>[125X [27XHeLP_ZC(C);[127X[104X
    [4X[28Xtrue[128X[104X
  [4X[32X[104X
  
  [1X3.5-4 HeLP_Vertices[101X
  
  [29X[2XHeLP_Vertices[102X( [3Xstring[103X ) [32X function
  [6XReturns:[106X  [33X[0;10Ynothing[133X
  
  [33X[0;0YIf  normlaiz  is  used  as  the  solver  of  the  HeLP-system  this function
  influences,  whether the "VerticesOfPolyhedron" are computed by normaliz. By
  default  these  are only computed, if the system has a trivial solution. The
  function  takes  "vertices", "novertices" and "default" as arguments. If you
  do not understand what this means, don't worry.[133X
  
  
  [1X3.6 [33X[0;0YChecking solutions, calculating and checking solutions[133X[101X
  
  [1X3.6-1 HeLP_VerifySolution[101X
  
  [29X[2XHeLP_VerifySolution[102X( [3XCharacterTable|ListOfClassFunctions[103X, [3Xk[103X[, [3Xlist_paraugs[103X] ) [32X function
  [6XReturns:[106X  [33X[0;10YList of admissible partial augmentations[133X
  
  [33X[0;0YThis  function  checks  which  of  the partial augmentations for elements of
  order  [9Xk[109X  given  in  [9XHeLP_sol[k][109X or the optional third argument [9Xlist_paraugs[109X
  fulfill  the  HeLP  equations  obtained  from  the  characters  in the first
  argument. This function does not solve any inequalities, but only checks, if
  the  given  partial  augmentations fulfill them. It is for this reason often
  faster then e.g. [2XHeLP_WithGivenOrder[102X ([14X3.1-1[114X).[133X
  
  [33X[0;0YIf there is no third argument given, i.e. the augmentations from [9XHeLP_sol[k][109X
  are used, the result overwrites [9XHeLP_sol[k][109X.[133X
  
  [4X[32X  Example  [32X[104X
    [4X[25Xgap>[125X [27XC := CharacterTable("A6");;[127X[104X
    [4X[25Xgap>[125X [27XHeLP_WithGivenOrder(C, 4);[127X[104X
    [4X[28X#I  Number of solutions for elements of order 4: 4; stored in HeLP_sol[4].[128X[104X
    [4X[28X[ [ [ 1 ], [ -1, 2 ] ], [ [ 1 ], [ 2, -1 ] ], [ [ 1 ], [ 1, 0 ] ], [128X[104X
    [4X[28X  [ [ 1 ], [ 0, 1 ] ] ][128X[104X
    [4X[25Xgap>[125X [27XHeLP_VerifySolution(C mod 3, 4);[127X[104X
    [4X[28X[ [ [ 1 ], [ 1, 0 ] ], [ [ 1 ], [ 0, 1 ] ] ][128X[104X
    [4X[25Xgap>[125X [27XHeLP_sol[4];[127X[104X
    [4X[28X[ [ [ 1 ], [ 1, 0 ] ], [ [ 1 ], [ 0, 1 ] ] ][128X[104X
  [4X[32X[104X
  
  [4X[32X  Example  [32X[104X
    [4X[25Xgap>[125X [27XC := CharacterTable("S12");;[127X[104X
    [4X[25Xgap>[125X [27XHeLP_WithGivenOrder(Irr(C mod 5){[2..6]}, 2);;[127X[104X
    [4X[28X#I  Number of solutions for elements of order 2: 563; stored in HeLP_sol[2].[128X[104X
    [4X[25Xgap>[125X [27XHeLP_VerifySolution(C mod 5, 2);;[127X[104X
    [4X[25Xgap>[125X [27XSize(HeLP_sol[2]);[127X[104X
    [4X[28X387[128X[104X
    [4X[25Xgap>[125X [27XHeLP_VerifySolution(C mod 3, 2);;[127X[104X
    [4X[25Xgap>[125X [27XSize(HeLP_sol[2]);[127X[104X
    [4X[28X324[128X[104X
  [4X[32X[104X
  
  [33X[0;0YUsing  [9XHeLP_WithGivenOrder(C  mod  5,  2)[109X or [9XHeLP_WithGivenOrder(C mod 3, 2)[109X
  takes much longer since in that case a bigger system of inequalities must be
  solved.[133X
  
  [1X3.6-2 HeLP_FindAndVerifySolution[101X
  
  [29X[2XHeLP_FindAndVerifySolution[102X( [3XCharacterTable|ListOfClassFunctions[103X, [3Xk[103X ) [32X function
  [6XReturns:[106X  [33X[0;10YList of admissible partial augmentations or "infinite"[133X
  
  [33X[0;0YThis function provides the same functionality as [2XHeLP_WithGivenOrder[102X ([14X3.1-1[114X)
  but  instead  of  constructiong the corresponding system with all characters
  from  the  first  argument  [3XCharacterTable|ListOfClassFunctions[103X  it  does it
  consecutively  with  larger  sets  of  characters  from the argument until a
  finite  list  of  solutions  is  found  and then applies [2XHeLP_VerifySolution[102X
  ([14X3.6-1[114X)  to  these solutions with the entirety of the class functions in the
  first argument.[133X
  
  [33X[0;0YThis  function is sometimes faster than [2XHeLP_WithGivenOrder[102X ([14X3.1-1[114X), but the
  output  is the same, thus the examples from [2XHeLP_WithGivenOrder[102X ([14X3.1-1[114X) also
  apply here.[133X
  
  [1X3.6-3 HeLP_PossiblePartialAugmentationsOfPowers[101X
  
  [29X[2XHeLP_PossiblePartialAugmentationsOfPowers[102X( [3Xn[103X ) [32X function
  [6XReturns:[106X  [33X[0;10YList of partial augmentations of powers.[133X
  
  [33X[0;0YThis  function  provides the possible partial augmentations of the powers of
  units of a given order [23Xn,[123X if the partial augmentations if units of order [23Xn/p[123X
  have  been  already  computed for all primes [23Xp[123X dividing [23Xn.[123X The possibilities
  are  sorted  in  the  same  way as, if the order [23Xn[123X is checked with any other
  function  like e.g. [2XHeLP_WithGivenOrder[102X ([14X3.1-1[114X) or [2XHeLP_ZC[102X ([14X2.1-1[114X). Thus, if
  the  InfoLevel  is  high enough and one obtains that the computation of some
  possibility    is    taking    too    long,   one   can   check   it   using
  [2XHeLP_WithGivenOrderAndPA[102X ([14X3.1-2[114X).[133X
  
  [4X[32X  Example  [32X[104X
    [4X[25Xgap>[125X [27XSetInfoLevel(HeLP_Info,4);[127X[104X
    [4X[25Xgap>[125X [27XC := CharacterTable(SmallGroup(160,91));[127X[104X
    [4X[28XCharacterTable( <pc group of size 160 with 6 generators> )[128X[104X
    [4X[25Xgap>[125X [27XHeLP_WithGivenOrder(C,4);;[127X[104X
    [4X[28X#I      Solutions for order 2 not yet calculated.  Restart for this order.[128X[104X
    [4X[28X#I  Number of solutions for elements of order 4: 22; stored in HeLP_sol[4].   [128X[104X
    [4X[25Xgap>[125X [27XHeLP_WithGivenOrder(C,10);;[127X[104X
    [4X[28X#I      Solutions for order 5 not yet calculated.  Restart for this order.[128X[104X
    [4X[28X#I  Number of solutions for elements of order 10: 6; stored in HeLP_sol[10].  [128X[104X
    [4X[25Xgap>[125X [27XLP := HeLP_PossiblePartialAugmentationsOfPowers(20);;[127X[104X
    [4X[25Xgap>[125X [27XHeLP_WithGivenOrderAndPA(Irr(C){[2..20]},20,LP[1]);[127X[104X
    [4X[28X#I  Number of solutions for elements of order 20 with these partial augmentations[128X[104X
    [4X[28X for the powers: 0.[128X[104X
    [4X[28X[  ][128X[104X
  [4X[32X[104X
  
  
  [1X3.7 [33X[0;0YThe Wagner test[133X[101X
  
  [1X3.7-1 HeLP_WagnerTest[101X
  
  [29X[2XHeLP_WagnerTest[102X( [3Xk[103X[, [3Xlist_paraugs[103X, [3XOrdinaryCharacterTable[103X] ) [32X function
  [6XReturns:[106X  [33X[0;10YList of admissible partial augmentations[133X
  
  [33X[0;0YThis  function  applies the Wagner test (cf. Section [14X5.4[114X) to the given data.
  If only the order [3Xk[103X is given as argument, the Wagner test will be applied to
  the  solutions  stored  in  [9XHeLP_sol[k][109X. If the arguments are the order [3Xk[103X, a
  list  of  possible  solutions  [3Xlist_paraugs[103X  and an ordinary character table
  [3XOrdinaryCharacterTable[103X  it  applies  the  test  to  the  solutions  given in
  [3Xlist_paraugs[103X  and  using  the  number  of  conjugacy  classes for elements a
  divisor    of    [3Xk[103X,   which   will   be   extracted   from   the   head   of
  [3XOrdinaryCharacterTable[103X.[133X
  
  [4X[32X  Example  [32X[104X
    [4X[25Xgap>[125X [27XC := CharacterTable("M11");[127X[104X
    [4X[28XCharacterTable( "M11" )[128X[104X
    [4X[25Xgap>[125X [27XHeLP_WithGivenOrder(C,8);;[127X[104X
    [4X[28X#I  Number of solutions for elements of order 8: 36; stored in HeLP_sol[8].[128X[104X
    [4X[25Xgap>[125X [27XHeLP_sol[8] := HeLP_WagnerTest(8);;[127X[104X
    [4X[25Xgap>[125X [27XSize(HeLP_sol[8]);[127X[104X
    [4X[28X24[128X[104X
  [4X[32X[104X
  
  [33X[0;0YThus  the  Wagner-Test  eliminates  12  possible  partial  augmentations for
  elements of order 8. Continuing the example:[133X
  
  [4X[32X  Example  [32X[104X
    [4X[25Xgap>[125X [27XHeLP_WithGivenOrder(C,12);[127X[104X
    [4X[28X#I  Number of solutions for elements of order 12: 7; stored in HeLP_sol[12].[128X[104X
    [4X[28X[ [ [ 1 ], [ 1 ], [ 2, -1 ], [ 0, 3, -2 ], [ 1, 0, -1, 1 ] ], [128X[104X
    [4X[28X  [ [ 1 ], [ 1 ], [ 1, 0 ], [ 0, 3, -2 ], [ 0, 0, 0, 1 ] ], [128X[104X
    [4X[28X  [ [ 1 ], [ 1 ], [ -1, 2 ], [ 0, 3, -2 ], [ 0, 0, 2, -1 ] ], [128X[104X
    [4X[28X  [ [ 1 ], [ 1 ], [ 0, 1 ], [ 0, 3, -2 ], [ 1, 0, 1, -1 ] ], [128X[104X
    [4X[28X  [ [ 1 ], [ 1 ], [ 0, 1 ], [ 0, 3, -2 ], [ -1, 0, 1, 1 ] ], [128X[104X
    [4X[28X  [ [ 1 ], [ 1 ], [ 1, 0 ], [ 0, -3, 4 ], [ 0, 0, 0, 1 ] ], [128X[104X
    [4X[28X  [ [ 1 ], [ 1 ], [ -1, 2 ], [ 0, -3, 4 ], [ 1, 0, -1, 1 ] ] ][128X[104X
    [4X[25Xgap>[125X [27XHeLP_sol[12] := HeLP_WagnerTest(12);[127X[104X
    [4X[28X[ [ [ 1 ], [ 1 ], [ 1, 0 ], [ 0, 3, -2 ], [ 0, 0, 0, 1 ] ], [128X[104X
    [4X[28X  [ [ 1 ], [ 1 ], [ -1, 2 ], [ 0, 3, -2 ], [ 0, 0, 2, -1 ] ], [128X[104X
    [4X[28X  [ [ 1 ], [ 1 ], [ 1, 0 ], [ 0, -3, 4 ], [ 0, 0, 0, 1 ] ] ][128X[104X
    [4X[25Xgap>[125X [27XHeLP_sol[4] := HeLP_WagnerTest(4);;[127X[104X
    [4X[25Xgap>[125X [27XHeLP_WithGivenOrder(C,12);[127X[104X
    [4X[28X#I  Number of solutions for elements of order 12: 3; stored in HeLP_sol[12].[128X[104X
    [4X[28X[ [ [ 1 ], [ 1 ], [ 2, -1 ], [ 0, 3, -2 ], [ 1, 0, -1, 1 ] ], [128X[104X
    [4X[28X  [ [ 1 ], [ 1 ], [ 0, 1 ], [ 0, 3, -2 ], [ 1, 0, 1, -1 ] ], [128X[104X
    [4X[28X  [ [ 1 ], [ 1 ], [ 0, 1 ], [ 0, 3, -2 ], [ -1, 0, 1, 1 ] ] ][128X[104X
    [4X[25Xgap>[125X [27XHeLP_sol[12] := HeLP_WagnerTest(12);[127X[104X
    [4X[28X[  ][128X[104X
  [4X[32X[104X
  
  [33X[0;0YThus there are no normalized units of order 12 in the integral group ring of
  [23XM_{11}.[123X[133X
  
  [4X[32X  Example  [32X[104X
    [4X[25Xgap>[125X [27XC := CharacterTable("M22");[127X[104X
    [4X[28XCharacterTable( "M22" )[128X[104X
    [4X[25Xgap>[125X [27XHeLP_WagnerTest(12, [ [ [1], [1], [1,0], [0,0,1], [-3,3,2,3,-4] ] ],C);[127X[104X
    [4X[28X[  ][128X[104X
  [4X[32X[104X
  
  [33X[0;0YThis example is taken from the appendix of [BKL08].[133X
  
  [33X[0;0YSometimes the Wagner-Test may even prove the Zassenhaus Conjecture:[133X
  
  [4X[32X  Example  [32X[104X
    [4X[25Xgap>[125X [27XG := SmallGroup(96,187);[127X[104X
    [4X[28X<pc group of size 96 with 6 generators>[128X[104X
    [4X[25Xgap>[125X [27XC := CharacterTable(G);[127X[104X
    [4X[28XCharacterTable( <pc group of size 96 with 6 generators> )[128X[104X
    [4X[25Xgap>[125X [27XHeLP_WithGivenOrder(C,4);;[127X[104X
    [4X[28X#I  Number of solutions for elements of order 4: 34; stored in HeLP_sol[4].[128X[104X
    [4X[25Xgap>[125X [27XHeLP_WagnerTest(4);       [127X[104X
    [4X[28X[ [ [ 0, 0, 1, 0, 0 ], [ 0, 0, 0, 0, 0, 0, 0, 0, 1 ] ],[128X[104X
    [4X[28X  [ [ 0, 0, 1, 0, 0 ], [ 0, 0, 0, 0, 0, 0, 1, 0, 0 ] ],[128X[104X
    [4X[28X  [ [ 0, 1, 0, 0, 0 ], [ 0, 0, 0, 0, 0, 1, 0, 0, 0 ] ], [128X[104X
    [4X[28X  [ [ 0, 1, 0, 0, 0 ], [ 0, 0, 0, 0, 0, 0, 0, 1, 0 ] ] ][128X[104X
    [4X[25Xgap>[125X [27XHeLP_ZC(C);[127X[104X
    [4X[28Xtrue[128X[104X
  [4X[32X[104X
  
  
  [1X3.8 [33X[0;0YOutput[133X[101X
  
  [1X3.8-1 HeLP_PrintSolution[101X
  
  [29X[2XHeLP_PrintSolution[102X( [[3Xk[103X] ) [32X function
  [6XReturns:[106X  [33X[0;10Ynothing[133X
  
  [33X[0;0YThis  function  prints the possible solutions in a pretty way. If a positive
  integer  [3Xk[103X  as  argument  is  given,  then  it prints the admissible partial
  augmentations  of  units  of  order [3Xk[103X, if they are already calculated. If no
  argument  is  given, the function prints information on all orders for which
  there are already informations.[133X
  
  [4X[32X  Example  [32X[104X
    [4X[25Xgap>[125X [27XC := CharacterTable("A5");;[127X[104X
    [4X[25Xgap>[125X [27XHeLP_ZC(C);          [127X[104X
    [4X[28Xtrue[128X[104X
    [4X[25Xgap>[125X [27XHeLP_PrintSolution();[127X[104X
    [4X[28XSolutions for elements of order 2:[128X[104X
    [4X[28X[ [         u ],[128X[104X
    [4X[28X  [  [ "2a" ] ],[128X[104X
    [4X[28X  [       --- ],[128X[104X
    [4X[28X  [     [ 1 ] ] ][128X[104X
    [4X[28XSolutions for elements of order 3:[128X[104X
    [4X[28X[ [         u ],[128X[104X
    [4X[28X  [  [ "3a" ] ],[128X[104X
    [4X[28X  [       --- ],[128X[104X
    [4X[28X  [     [ 1 ] ] ][128X[104X
    [4X[28XSolutions for elements of order 5:[128X[104X
    [4X[28X[ [               u ],[128X[104X
    [4X[28X  [  [ "5a", "5b" ] ],[128X[104X
    [4X[28X  [             --- ],[128X[104X
    [4X[28X  [        [ 0, 1 ] ],[128X[104X
    [4X[28X  [        [ 1, 0 ] ] ][128X[104X
    [4X[28XThere are no admissible partial augmentations for elements of order 6.[128X[104X
    [4X[28XThere are no admissible partial augmentations for elements of order 10.[128X[104X
    [4X[28XThere are no admissible partial augmentations for elements of order 15.[128X[104X
    [4X[28XThere are no admissible partial augmentations for elements of order 30.[128X[104X
    [4X[25Xgap>[125X [27XC := CharacterTable("A6");;[127X[104X
    [4X[25Xgap>[125X [27XHeLP_ZC(C);           [127X[104X
    [4X[28X#I  ZC can't be solved, using the given data, for the orders: [ 6 ].[128X[104X
    [4X[28Xfalse[128X[104X
    [4X[25Xgap>[125X [27XHeLP_PrintSolution(6);[127X[104X
    [4X[28XSolutions for elements of order 6:[128X[104X
    [4X[28X[ [                   u^3,                   u^2,                     u ],[128X[104X
    [4X[28X  [              [ "2a" ],        [ "3a", "3b" ],  [ "2a", "3a", "3b" ] ],[128X[104X
    [4X[28X  [                   ---,                   ---,                   --- ],[128X[104X
    [4X[28X  [                 [ 1 ],              [ 0, 1 ],          [ -2, 2, 1 ] ],[128X[104X
    [4X[28X  [                 [ 1 ],              [ 1, 0 ],          [ -2, 1, 2 ] ] ][128X[104X
  [4X[32X[104X
  
  
  [1X3.9 [33X[0;0YEigenvalue multiplicities and character values[133X[101X
  
  [1X3.9-1 HeLP_MultiplicitiesOfEigenvalues[101X
  
  [29X[2XHeLP_MultiplicitiesOfEigenvalues[102X( [3Xchi[103X, [3Xk[103X, [3Xparaugs[103X ) [32X function
  [6XReturns:[106X  [33X[0;10Ya list of multiplicities of eigenvalues[133X
  
  [33X[0;0YThe  returned  list contains at the [22Xl[122X-th spot the multiplicity of [9XE(k)^(l-1)[109X
  as  eigenvalue of a unit [22Xu[122X of order [3Xk[103X under the representation corresponding
  to  [3Xchi[103X  having  the  partial augmentations [3Xparaugs[103X for the elements [22Xu^d[122X for
  divisors [22Xd[122X different from [3Xk[103X.[133X
  
  [1X3.9-2 HeLP_CharacterValue[101X
  
  [29X[2XHeLP_CharacterValue[102X( [3Xchi[103X, [3Xk[103X, [3Xparaug[103X ) [32X function
  [6XReturns:[106X  [33X[0;10Ythe character value [22Xchi(u)[122X[133X
  
  [33X[0;0YThe  function  returns the character value [22Xchi(u)[122X of an element [22Xu[122X of order [23Xk[123X
  having the partial augmentations [3Xparaug[103X.[133X
  
  [4X[32X  Example  [32X[104X
    [4X[25Xgap>[125X [27XC := CharacterTable("A6");;[127X[104X
    [4X[25Xgap>[125X [27XHeLP_WithGivenOrder(C, 6);                               [127X[104X
    [4X[28X#I  Number of solutions for elements of order 6: 2; stored in HeLP_sol[6].[128X[104X
    [4X[28X[ [ [ 1 ], [ 0, 1 ], [ -2, 2, 1 ] ], [ [ 1 ], [ 1, 0 ], [ -2, 1, 2 ] ] ][128X[104X
    [4X[25Xgap>[125X [27Xchi := Irr(C)[2];;   # a character of degree 5[127X[104X
    [4X[25Xgap>[125X [27XHeLP_MultiplicitiesOfEigenvalues(chi, 6, HeLP_sol[6][2]);[127X[104X
    [4X[28X[ 1, 0, 1, 2, 1, 0 ][128X[104X
    [4X[25Xgap>[125X [27XHeLP_CharacterValue(chi, 6, HeLP_sol[6][2][3]);          [127X[104X
    [4X[28X-2[128X[104X
    [4X[25Xgap>[125X [27XHeLP_CharacterValue(chi, 6, [-2,1,2]);[127X[104X
    [4X[28X-2[128X[104X
    [4X[25Xgap>[125X [27XHeLP_CharacterValue(chi, 6, [-2,2,1]);[127X[104X
    [4X[28X1[128X[104X
  [4X[32X[104X
  
  [33X[0;0YThese  eigenvalues were computed manually by M. Hertweck and may be found in
  [Her08c].[133X
  
