chop man page

chop — find irreducible constituents of a matrix


chop [Options] <Name>


This program calculates the irreducible constituents of a given matrix representation.  The representing matrices of the generators are read from input files, see "Input Files" below.  Unless a different number of generators has been specified with -g, two generators are expected.  However, if the -i option is used, and the file Name.cfinfo exists, chop takes the number of generators from this file and ignores the -g option.

For each composition factor chop writes the action of the generators to CFName.1, CFName.2, ....  CFName is the name of the composition factor, which is constructed by appending the dimension and a letter to the module name.  For example, "X10a.1" is the action of the first generator on the first composition factor of dimension 10 of the module X.  If a second, inequivalent composition factor of dimension 10 was found, it would be named "X10b" and so on.  Chop also creates the file Name.cfinfo containing a list of all composition factors.  This file is used by subsequent programs such as pwkond(1).



Quiet, no messages.


Verbose, more messages.

-T <MaxTime>

Set CPU time limit

-G, --gap

Produce output in GAP format.  This option implies -Q.

-g <NGen>

Set the number of generators.  Default: 2.

-s <Word>

Start with word number Word.  Default: 1.

-n <MaxNul>

Set limit on nullity.  Default: 3.

-d <MaxDeg>

Set limit on degrees of polynomials.  Default: 5.

-i, --read-cfinfo

Read Name.cfinfo, if it exists

Implementation Details

Chop repeatedly splits a module into submodule and quotient until it arrives at the irreducible constituents.  Thus, it finds a composition series. The program assumes that the algebra generated by the input matrices contains the unit matrix.

In order to split a given module or to prove its irreducibility the algorithm needs an element of the algebra with a nontrivial but low-dimensional kernel. Such elements are searched by taking linear combinations of certain products of the generators ("words").  By default, chop tries all words in the order defined by the word generator.  The -s option may be used to make chop start with a word different from 1.

For each word A generated in this way, the program calculates its characteristic polynomial and examines the irreducible factors.  If p(x) is an irreducible factor, p(A) has a nontrivial kernel.  Then, one vector of the kernel is chosen and the smallest submodule containing this vector is calculated.  If the vector spans a proper submodule, the action of the generators on this submodule as well as on the quotient are calculated and the same procedure is applied recursively to both submodule and quotient.

To avoid expensive matrix multiplications in the calculation of p(A), there is a limit on the degree of p(x).  This limit can be set with the -d option and defaults to 5.

If a module cannot be split by the program, it may be irreducible.  In order to prove this, chop uses Norton's criterion.  This requires, however, to find an algebra element with a small kernel, because up to scalar multiples each vector in the kernel must be examined to see whether it spins up to the whole module.  For this reason a "nullity threshold" m is maintained by the program.  Initially, m is set to 3 or to the value given in the -n option. Each algebra element that has a nullity less then or equal to m is used for the Norton test.

In some cases the algorithm described is not able to split the module although it is reducible.  These exceptional cases are treated with an alternative strategy described in Lux and Ivanyos, "Treating the exceptional cases of the Meataxe", 19 Feb 1998 (unpublished).

Algebra elements with trivial kernel are useless for the algorithm, so an attempt is made to avoid unnecessary computation of such elements.  Once an element is known to have a trivial kernel on a given module M, the program will mark it as invertible and ignore it for all constituents of M.

If a constituent is irreducible but not absolutely irreducible, the nullity of any element in the algebra will be a multiple of [E:F], where F is the ground field and E the splitting field.  This situation is recognized by calculating the greatest common divisor d of all nullities which occur during the search.  In order to prove that the splitting field degree is equal to d, the following method is used: Take a word with nullity d and two vectors v1, v2 in its null-space. Use these vectors as seeds for a standard basis algorithm.  If the resulting representations are different, [E:F] is less than d, and the word is discarded.  Otherwise, the linear map which transforms one standard basis into the other is an endomorphism e of the module.  If v1, under the action of e, spins up to the whole null space, then [E:F]=d.  Otherwise, take a third vector not in the span and repeat the procedure above.  Again, this yields an endomorphism, or it turns out that [E:F]<d.  These steps are repeated until a word with nullity [E:F] is found.

Input Files



Output Files


Constituent info file


Generators on the constituents.

See Also

cfcomp(1), pseudochop(q), pwkond(1)

Referenced By

cfcomp(1), decomp(1), mkhom(1), mkhom_old(1), precond(1), pseudochop(1), pwkond(1), soc(1), tcond(1).

2.4.24 MeatAxe User Commands