[Next] [Prev] [Right] [Left] [Up] [Index] [Root]
Conjugacy

Conjugacy

Class(H, x) : GrpMat, GrpMatElt -> { GrpMatElt }
Conjugates(H, x) : GrpMat, GrpMatElt -> { GrpMatElt }
Given a group H and an element x belonging to a group K such that H and K are subgroups of the same symmetric group, this function returns the set of conjugates of x under the action of H. If H = K, the function returns the conjugacy class of x in H.
ClassMap(G: parameters) : GrpMat -> Map
Given a group G, construct the conjugacy classes and the class map f for G. For any element x of G, f(x) will be the conjugacy class representative chosen by the Classes function. If the parameter Orbits is set true, the classes are computed as orbits of elements under conjugation and the class map is stored as a list of images of the elements of G (a list of length |G|). This option gives fast evaluation of the class map but is practical only in the case of very small groups. With Orbits := false, WeakLimit and StrongLimit are used to control the random classes algorithm (see function Classes).
ConjugacyClasses(G: parameters) : GrpMat -> [ < RngIntElt, RngIntElt, GrpMatElt > ]
Classes(G: parameters) : GrpMat -> [ < RngIntElt, RngIntElt, GrpMatElt > ]
    WeakLimit: RngIntElt                Default: 200
    StrongLimit: RngIntElt              Default: 500
Construct a set of representatives for the conjugacy classes of G. The classes are returned as a sequence of triples containing the element order, the class length and a representative element for the class. The parameter Al enables the user to select the algorithm that is to be used.

    Al: MonStg                          Default: 

Al := "Action": Create the classes of G by computing the orbits of the set of elements of G under the action of conjugation. This option is only feasible for small groups, i.e. for groups of order less than 100,000. (Default for groups order less than 500).

Al := "Random": Construct the conjugacy classes of elements for a matrix group G using an algorithm that searches for representatives of all conjugacy of G by examining a random selection of group elements and their powers. The behaviour of this algorithm is controlled by two associated optional parameters WeakLimit and StrongLimit, whose values are positive integers n_1 and n_2, say. Before describing the effect of these parameters, a definition is needed: Two matrices are said to be weakly conjugate if they have the same cycle structure. Thus, conjugacy implies weak conjugacy, but the converse is false. The random algorithm first examines n_1 random elements and their powers, using a test for weak conjugacy. It then proceeds to examine a further n_2 random elements and their powers, using a test for ordinary conjugacy. The idea behind this strategy is that the algorithm should attempt to find as many classes as possible using the very cheap test for weak conjugacy, before employing the more expensive ordinary conjugacy test to recognize the remaining classes.

ClassRepresentative(G, x) : GrpMat, GrpMatElt -> GrpMatElt
Given a group G for which the conjugacy classes are known and an element x of G, return the designated representative for the conjugacy class of G containing x.
IsConjugate(G, g, h) : GrpMat, GrpMatElt, GrpMatElt -> BoolElt, GrpMatElt | Unass
Given a group G and elements g and h belonging to G, return the value true if g and h are conjugate in G. The function returns a second value in the event that the elements are conjugate: an element k which conjugates g into h.
[Future release] IsConjugate(G, H, K) : GrpMat, GrpMat, GrpMat -> BoolElt, GrpMatElt | Unass
Given a group G and subgroups H and K belonging to G, return the value true if G and H are conjugate in G. The function returns a second value in the event that the subgroups are conjugate: an element z which conjugates H into K.
Exponent(G) : GrpMat -> RngIntElt
The exponent of the group G.
NumberOfClasses(G) : GrpMat -> RngIntElt
Nclasses(G) : GrpMat -> RngIntElt
The number of conjugacy classes of elements for the group G.
PowerMap(G) : GrpMat -> Map
Given a group G, construct the power map for G. Suppose that the order of G is m and that G has r conjugacy classes. When the classes are determined by Magma, they are numbered from 1 to r. Let C be the set of class indices { 1, ..., r } and let P be the set of integers { 1, ..., m }. The power map f for G is the mapping, f : C x P -> C where the value of f(i, j) for i in C and j in P is the number of the class which contains x_i^j, where x_i is a representative of the i-th conjugacy class.
AssertAttribute(G, "Classes", Q) : GrpMat, MonStgElt, [ GrpMatElt ] ->
Given a group G, and a sequence Q of k distinct elements of G, one from each conjugacy class, use Q to define the classes attribute of G.
[Next] [Prev] [Right] [Left] [Up] [Index] [Root]