GAP 4.8.9 installation with standard packages -- copy to your CoCalc project to get it
1[1X1 [33X[0;0YAbout the RCWA Package[133X[101X23[33X[0;0YThis package permits to compute in monoids, in particular groups, whose4elements are [13Xresidue-class-wise affine[113X mappings. Probably the widest-known5occurrence of such a mapping is in the statement of the [22X3n+1[122X conjecture,6which asserts that iterated application of the [13XCollatz mapping[113X[133X78/9| n/2 if n even,10T: Z -> Z, n |-> <11| (3n+1)/2 if n odd12\1314[33X[0;0Yto any given positive integer eventually yields 1 (cf. [Lag03]). For15definitions, see Section [14X2.1[114X.[133X1617[33X[0;0YPresently, most research in computational group theory focuses on finite18permutation groups, matrix groups, finitely presented groups, polycyclically19presented groups and automata groups. For details, we refer to [HEO05]. The20purpose of this package is twofold:[133X2122[30X [33X[0;6YOn the one hand, it provides the means to deal with another large23class of groups which are accessible to computational methods, and it24therefore extends the range of groups which can be dealt with by means25of computation.[133X2627[30X [33X[0;6YOn the other -- and perhaps more importantly -- residue-class-wise28affine groups appear to be interesting mathematical objects in their29own right, and this package is intended to serve as a tool to obtain a30better understanding of their rich and often complicated group31theoretical and combinatorial structure.[133X3233[33X[0;0YIn principle this package permits to construct and investigate all groups34which have faithful representations as residue-class-wise affine groups.35Among many others, the following groups and their subgroups belong to this36class:[133X3738[30X [33X[0;6YFinite groups, and certain divisible torsion groups which they embed39into.[133X4041[30X [33X[0;6YFree groups of finite rank.[133X4243[30X [33X[0;6YFree products of finitely many finite groups.[133X4445[30X [33X[0;6YDirect products of the above groups.[133X4647[30X [33X[0;6YWreath products of the above groups with finite groups and with (ℤ,+).[133X4849[33X[0;0YThis list permits already to conclude that there are finitely generated50residue-class-wise affine groups which do not have finite presentations, and51such with algorithmically unsolvable membership problem. However the list is52certainly by far not exhaustive, and using this package it is easy to53construct groups of types which are not mentioned there.[133X5455[33X[0;0YThe group CT(ℤ) which is generated by all [13Xclass transpositions[113X of ℤ -- these56are involutions which interchange two disjoint residue classes, see57[2XClassTransposition[102X ([14X2.2-3[114X) -- is a simple group which has subgroups of all58types listed above. It is countable, but it has an uncountable series of59simple subgroups which is parametrized by the sets of odd primes.[133X6061[33X[0;0YProofs of most of the results mentioned so far can be found in [Koh10].62Descriptions of a part of the algorithms and methods which are implemented63in this package can be found in [Koh08].[133X6465[33X[0;0YThe reader might want to know what type of results one can obtain with [5XRCWA[105X.66However, the answer to this is that the package can be applied in various67ways to various different problems, and it is simply not possible to say in68general what can be found out with its help. So one really cannot give a69better answer here than for the same question about [5XGAP[105X itself. The best way70to get familiar with the package and its capabilities is likely to71experiment with the examples discussed in this manual and the groups72generated by 3 class transpositions from the corresponding data library.[133X7374[33X[0;0YOf course, sometimes this package does not provide an out-of-the-box75solution for a given problem. But quite often it is still possible to find76an answer by an interactive trial-and-error approach. With substantial help77of this package, the author has found the results mentioned above.78Interactive sessions with this package have also led to the development of79most of the algorithms which are now implemented in it. Just to mention one80example, developing the factorization method for residue-class-wise affine81permutations (see [2XFactorizationIntoCSCRCT[102X ([14X2.5-1[114X)) solely by means of theory82would likely have been very hard.[133X83848586