GAP 4.8.9 installation with standard packages -- copy to your CoCalc project to get it
<!-- #################################################################### -->1<!-- ## ## -->2<!-- ## about.xml RCWA documentation Stefan Kohl ## -->3<!-- ## ## -->4<!-- #################################################################### -->56<Chapter Label="ch:AboutRCWA"><Heading>About the RCWA Package</Heading>78<Index Key="Collatz conjecture">Collatz conjecture</Index>9<Index Key="Collatz conjecture">Collatz mapping</Index>10This package permits to compute in monoids, in particular groups,11whose elements are <E>residue-class-wise affine</E> mappings.12Probably the widest-known occurrence of such a mapping is in the statement13of the <M>3n+1</M> conjecture, which asserts that iterated application of14the <E>Collatz mapping</E>15<Alt Only="LaTeX">16<Display>17<![CDATA[T: \ \ \mathbb{Z} \longrightarrow \mathbb{Z}, \ \ \ \18n \ \longmapsto \19\begin{cases}20\frac{n}{2} & \text{if} \ \ n \ \ \text{is even}, \\21\frac{3n+1}{2} & \text{if} \ \ n \ \ \text{is odd}22\end{cases}]]>23</Display>24</Alt>25<Alt Only="HTML"><![CDATA[<center>26<img src = "collatz.png" width = "342" height = "63"27alt = "T: Z -> Z, n |-> (n/2 if n even, (3n+1)/2 if n odd)"/>28</center>]]></Alt>29<Alt Only="Text"><Verb><![CDATA[30/31| n/2 if n even,32T: Z -> Z, n |-> <33| (3n+1)/2 if n odd34\35]]></Verb></Alt>36to any given positive integer eventually yields 137(cf. <Cite Key="Lagarias06"/>).38For definitions, see Section <Ref Label="sec:basicdefinitions"/>. <P/>3940Presently, most research in computational group theory focuses on finite41permutation groups, matrix groups, finitely presented groups, polycyclically42presented groups and automata groups.43For details, we refer to <Cite Key="HoltEickOBrien05"/>.44The purpose of this package is twofold:4546<List>4748<Item>49On the one hand, it provides the means to deal with another large50class of groups which are accessible to computational methods, and51it therefore extends the range of groups which can be dealt with52by means of computation.53</Item>5455<Item>56On the other -- and perhaps more importantly -- residue-class-wise57affine groups appear to be interesting mathematical objects in their58own right, and this package is intended to serve as a tool to obtain59a better understanding of their rich and often complicated group60theoretical and combinatorial structure.61</Item>6263</List>6465In principle this package permits to construct and investigate all groups66which have faithful representations as residue-class-wise affine groups.67Among many others, the following groups and their subgroups belong to this68class:6970<List>7172<Item>73Finite groups, and certain divisible torsion groups which they74embed into.75</Item>7677<Item>78Free groups of finite rank.79</Item>8081<Item>82Free products of finitely many finite groups.83</Item>8485<Item>86Direct products of the above groups.87</Item>8889<Item>90Wreath products of the above groups with finite groups and91with (&ZZ;,+).92</Item>9394</List>9596This list permits already to conclude that there are finitely generated97residue-class-wise affine groups which do not have finite presentations,98and such with algorithmically unsolvable membership problem.99However the list is certainly by far not exhaustive, and using this100package it is easy to construct groups of types which are not mentioned101there. <P/>102103The group CT(&ZZ;) which is generated by all <E>class transpositions</E>104of &ZZ; -- these are involutions which interchange two disjoint residue105classes, see <Ref Func="ClassTransposition" Label="r1, m1, r2, m2"/>106-- is a simple group which has subgroups of all types listed above.107It is countable, but it has an uncountable series of simple subgroups108which is parametrized by the sets of odd primes. <P/>109110Proofs of most of the results mentioned so far can be found111in <Cite Key="Kohl09"/>. Descriptions of a part of the algorithms112and methods which are implemented in this package can be found113in <Cite Key="Kohl08b"/>. <P/>114115The reader might want to know what type of results one can obtain116with &RCWA;. However, the answer to this is that the package can be117applied in various ways to various different problems, and it is simply118not possible to say in general what can be found out with its help.119So one really cannot give a better answer here than for the same question120about &GAP; itself. The best way to get familiar with the package and121its capabilities is likely to experiment with the examples discussed in122this manual and the groups generated by 3 class transpositions from the123corresponding data library. <P/>124125Of course, sometimes this package does not provide an out-of-the-box126solution for a given problem. But quite often it is still possible to127find an answer by an interactive trial-and-error approach.128With substantial help of this package, the author has found the results129mentioned above. Interactive sessions with this package have also led to130the development of most of the algorithms which are now implemented in it.131Just to mention one example, developing the factorization method for132residue-class-wise affine permutations133(see <Ref Attr="FactorizationIntoCSCRCT"134Label="for an rcwa permutation of Z"/>)135solely by means of theory would likely have been very hard.136137<!-- #################################################################### -->138139</Chapter>140141<!-- #################################################################### -->142143144