Changeset fd5013 in git for Singular/LIB/finvar.lib


Ignore:
Timestamp:
Aug 2, 2006, 5:40:53 PM (18 years ago)
Author:
Hans Schönemann <hannes@…>
Branches:
(u'spielwiese', 'fe61d9c35bf7c61f2b6cbf1b56e25e2f08d536cc')
Children:
f6f1dbfc1e8487ccbf1ca0d7a3d2600069315a9f
Parents:
d1932987874a4523d2a42efe3046b953ed52af76
Message:
*hannes/markwig: typos, format, doc


git-svn-id: file:///usr/local/Singular/svn/trunk@9385 2c84dea3-7e68-4137-9b89-c4e89433aadc
File:
1 edited

Legend:

Unmodified
Added
Removed
  • Singular/LIB/finvar.lib

    rd193298 rfd5013  
    11///////////////////////////////////////////////////////////////////////////////
    2 version="$Id: finvar.lib,v 1.50 2006-07-18 15:48:13 Singular Exp $"
     2version="$Id: finvar.lib,v 1.51 2006-08-02 15:40:47 Singular Exp $"
    33category="Invariant theory";
    44info="
     
    138138RETURN:  a <list>, the first list element will be a gxn <matrix> representing
    139139         the Reynolds operator if we are in the non-modular case; if the
    140          characteristic is >0, minpoly==0 and the finite group non-cyclic the
     140         characteristic is >0, minpoly==0 and the finite group is non-cyclic the
    141141         second list element is an <int> giving the lowest common multiple of
    142142         the matrix group elements' order (used in molien); in general all
     
    148148         (or the generators themselves during the first run). All the ones that
    149149         have been generated before are thrown out and the program terminates
    150          when no new elements found in one run. Additionally each time a new
     150         when no new elements are found in one run. Additionally each time a new
    151151         group element is found the corresponding ring mapping of which the
    152152         Reynolds operator is made up is generated. They are stored in the rows
     
    358358         elements generated by group_reynolds(), lcm is the second return value
    359359         of group_reynolds()
    360 RETURN:  in case of characteristic 0 a 1x2 <matrix> giving enumerator and
     360RETURN:  in case of characteristic 0 a 1x2 <matrix> giving numerator and
    361361         denominator of Molien series; in case of prime characteristic a ring
    362362         with the name `ringname` of characteristic 0 is created where the same
     
    908908         new group element is found the corresponding ring mapping of which the
    909909         Reynolds operator is made up is generated. They are stored in the rows
    910          of the first return value. In characteristic 0 the terms 1/det(1-xE)
     910         of the first return value. In characteristic 0 the term 1/det(1-xE)
    911911         is computed whenever a new element E is found. In prime characteristic
    912912         a Brauer lift is involved and the terms are only computed after the
    913913         entire matrix group is generated (to avoid the modular case). The
    914          returned matrix gives enumerator and denominator of the expanded
     914         returned matrix gives numerator and denominator of the expanded
    915915         version where common factors have been canceled.
    916916EXAMPLE: example reynolds_molien; shows an example
     
    20642064ASSUME:  REY is the first return value of group_reynolds or reynolds_molien and
    20652065         M the one of molien or the second one of reynolds_molien
    2066 DISPLAY: information about the various stages of the programme if v does not
     2066DISPLAY: information about the various stages of the program if v does not
    20672067         equal 0
    20682068RETURN:  primary invariants (type <matrix>) of the invariant ring
     
    22072207         ringname gives the name of a ring of characteristic 0 that has been
    22082208         created by molien or reynolds_molien
    2209 DISPLAY: information about the various stages of the programme if v does not
     2209DISPLAY: information about the various stages of the program if v does not
    22102210         equal 0
    22112211RETURN:  primary invariants (type <matrix>) of the invariant ring
     
    23602360         <int>
    23612361ASSUME:  REY is the first return value of group_reynolds or reynolds_molien
    2362 DISPLAY: information about the various stages of the programme if v does not
     2362DISPLAY: information about the various stages of the program if v does not
    23632363         equal 0
    23642364RETURN:  primary invariants (type <matrix>) of the invariant ring and an
     
    25032503         <int>
    25042504ASSUME:  REY is the first return value of group_reynolds or reynolds_molien
    2505 DISPLAY: information about the various stages of the programme if v does not
     2505DISPLAY: information about the various stages of the program if v does not
    25062506         equal 0
    25072507RETURN:  primary invariants (type <matrix>) of the invariant ring  and an
     
    26442644         G1,G2,...: <matrices> generating a finite matrix group, v: an optional
    26452645         <int>
    2646 DISPLAY: information about the various stages of the programme if v does not
     2646DISPLAY: information about the various stages of the program if v does not
    26472647         equal 0
    26482648RETURN:  primary invariants (type <matrix>) of the invariant ring
     
    27842784         G1,G2,...: <matrices> generating a finite matrix group, flags: an
    27852785         optional <intvec> with three entries, if the first one equals 0 (also
    2786          the default), the programme attempts to compute the Molien series and
    2787          Reynolds operator, if it equals 1, the programme is told that the
     2786         the default), the program attempts to compute the Molien series and
     2787         Reynolds operator, if it equals 1, the program is told that the
    27882788         Molien series should not be computed, if it equals -1 characteristic 0
    27892789         is simulated, i.e. the Molien series is computed as if the base field
    27902790         were characteristic 0 (the user must choose a field of large prime
    2791          characteristic, e.g. 32003) and if the first one is anything else, it
     2791         characteristic, e.g. 32003), and if the first one is anything else, it
    27922792         means that the characteristic of the base field divides the group
    27932793         order, the second component should give the size of intervals between
     
    27972797         common factors should always be canceled when the expansion is simple
    27982798         (the root of the extension field occurs not among the coefficients)
    2799 DISPLAY: information about the various stages of the programme if the third
     2799DISPLAY: information about the various stages of the program if the third
    28002800         flag does not equal 0
    28012801RETURN:  primary invariants (type <matrix>) of the invariant ring and if
     
    28922892        else
    28932893        { if (v)
    2894           { "  Since it is impossible for this programme to calculate the Molien series for";
     2894          { "  Since it is impossible for this program to calculate the Molien series for";
    28952895            "  invariant rings over extension fields of prime characteristic, we have to";
    28962896            "  continue without it.";
     
    31993199ASSUME:  REY is the first return value of group_reynolds or reynolds_molien and
    32003200         M the one of molien or the second one of reynolds_molien
    3201 DISPLAY: information about the various stages of the programme if v does not
     3201DISPLAY: information about the various stages of the program if v does not
    32023202         equal 0
    32033203RETURN:  primary invariants (type <matrix>) of the invariant ring
     
    33463346         ringname gives the name of a ring of characteristic 0 that has been
    33473347         created by molien or reynolds_molien
    3348 DISPLAY: information about the various stages of the programme if v does not
     3348DISPLAY: information about the various stages of the program if v does not
    33493349         equal 0
    33503350RETURN:  primary invariants (type <matrix>) of the invariant ring
     
    34993499         bases elements, v: an optional <int>
    35003500ASSUME:  REY is the first return value of group_reynolds or reynolds_molien
    3501 DISPLAY: information about the various stages of the programme if v does not
     3501DISPLAY: information about the various stages of the program if v does not
    35023502         equal 0
    35033503RETURN:  primary invariants (type <matrix>) of the invariant ring  and an
     
    36463646         bases elements, v: an optional <int>
    36473647ASSUME:  REY is the first return value of group_reynolds or reynolds_molien
    3648 DISPLAY: information about the various stages of the programme if v does not
     3648DISPLAY: information about the various stages of the program if v does not
    36493649         equal 0
    36503650RETURN:  primary invariants (type <matrix>) of the invariant ring  and an
     
    37923792         where -|r| to |r| is the range of coefficients of the random
    37933793         combinations of bases elements, v: an optional <int>
    3794 DISPLAY: information about the various stages of the programme if v does not
     3794DISPLAY: information about the various stages of the program if v does not
    37953795         equal 0
    37963796RETURN:  primary invariants (type <matrix>) of the invariant ring
     
    39433943         where -|r| to |r| is the range of coefficients of the random
    39443944         combinations of bases elements, flags: an optional <intvec> with three
    3945          entries, if the first one equals 0 (also the default), the programme
     3945         entries, if the first one equals 0 (also the default), the program
    39463946         attempts to compute the Molien series and Reynolds operator, if it
    3947          equals 1, the programme is told that the Molien series should not be
     3947         equals 1, the program is told that the Molien series should not be
    39483948         computed, if it equals -1 characteristic 0 is simulated, i.e. the
    39493949         Molien series is computed as if the base field were characteristic 0
    39503950         (the user must choose a field of large prime characteristic, e.g.
    3951          32003) and if the first one is anything else, it means that the
     3951         32003), and if the first one is anything else, it means that the
    39523952         characteristic of the base field divides the group order, the second
    39533953         component should give the size of intervals between canceling common
     
    39573957         always be canceled when the expansion is simple (the root of the
    39583958         extension field does not occur among the coefficients)
    3959 DISPLAY: information about the various stages of the programme if the third
     3959DISPLAY: information about the various stages of the program if the third
    39603960         flag does not equal 0
    39613961RETURN:  primary invariants (type <matrix>) of the invariant ring and if
     
    40604060        else
    40614061        { if (v)
    4062           { "  Since it is impossible for this programme to calculate the Molien series for";
     4062          { "  Since it is impossible for this program to calculate the Molien series for";
    40634063            "  invariant rings over extension fields of prime characteristic, we have to";
    40644064            "  continue without it.";
     
    59545954         Molien series is computed as if the base field were characteristic 0
    59555955         (the user must choose a field of large prime characteristic, e.g.
    5956          32003) and if the first one is anything else, it means that the
     5956         32003), and if the first one is anything else, it means that the
    59575957         characteristic of the base field divides the group order (i.e. it will
    59585958         not even be attempted to compute the Reynolds operator or Molien
     
    60516051        else
    60526052        { if (v)
    6053           { "  Since it is impossible for this programme to calculate the Molien
     6053          { "  Since it is impossible for this program to calculate the Molien
    60546054 series for";
    60556055            "  invariant rings over extension fields of prime characteristic, we
     
    61716171         i.e. the Molien series is computed as if the base field were
    61726172         characteristic 0 (the user must choose a field of large prime
    6173          characteristic, e.g.  32003) and if the first one is anything else,
     6173         characteristic, e.g.  32003), and if the first one is anything else,
    61746174         then the characteristic of the base field divides the group order
    61756175         (i.e. we will not even attempt to compute the Reynolds operator or
     
    62866286        else
    62876287        { if (v)
    6288           { "  Since it is impossible for this programme to calculate the Molien
     6288          { "  Since it is impossible for this program to calculate the Molien
    62896289 series for";
    62906290            "  invariant rings over extension fields of prime characteristic, we
     
    64036403THEORY:  The ideal of algebraic relations of the invariant ring generators is
    64046404         calculated, then the variables of the original ring are eliminated and
    6405          the polynomials that are left over define the orbit variety
     6405         the polynomials that are left over define the orbit variety.
    64066406EXAMPLE: example orbit_variety; shows an example
    64076407"
     
    66206620@*       s: a <string> giving a name for a new ring
    66216621RETURN:  The procedure ends with a new ring named s.
    6622          It contains a Groebner basis
    6623          (type <ideal>, named G) for the ideal defining the
    6624          relative orbit variety with respect to I in the new ring.
     6622         It contains a Groebner basis (type <ideal>, named G) for the ideal
     6623         defining the relative orbit variety with respect to I in the new ring.
    66256624THEORY:  A Groebner basis of the ideal of algebraic relations of the invariant
    66266625         ring generators is calculated, then one of the basis elements plus the
     
    67076706@*       F: a 1xm <matrix> defining an invariant ring of some matrix group
    67086707RETURN:  The <ideal> defining the image under that group of the variety defined
    6709          by I
     6708         by I.
    67106709THEORY:  rel_orbit_variety(I,F) is called and the newly introduced
    67116710@*       variables in the output are replaced by the generators of the
    67126711@*       invariant ring. This ideal in the original variables defines the image
    6713 @*       of the variety defined by I
     6712@*       of the variety defined by I.
    67146713EXAMPLE: example image_of_variety; shows an example
    67156714"
Note: See TracChangeset for help on using the changeset viewer.