File: chap20.html

package info (click to toggle)
gap-hap 1.74%2Bds-1
  • links: PTS
  • area: main
  • in suites: forky, sid
  • size: 58,664 kB
  • sloc: xml: 16,678; sh: 197; javascript: 155; makefile: 121; ansic: 47; perl: 24
file content (141 lines) | stat: -rw-r--r-- 12,892 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
         "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
<title>GAP (HAP commands) - Chapter 20:  Words in free ZG-modules </title>
<meta http-equiv="content-type" content="text/html; charset=UTF-8" />
<meta name="generator" content="GAPDoc2HTML" />
<link rel="stylesheet" type="text/css" href="manual.css" />
<script src="manual.js" type="text/javascript"></script>
<script type="text/javascript">overwriteStyle();</script>
</head>
<body class="chap20"  onload="jscontent()">


<div class="chlinktop"><span class="chlink1">Goto Chapter: </span><a href="chap0.html">Top</a>  <a href="chap1.html">1</a>  <a href="chap2.html">2</a>  <a href="chap3.html">3</a>  <a href="chap4.html">4</a>  <a href="chap5.html">5</a>  <a href="chap6.html">6</a>  <a href="chap7.html">7</a>  <a href="chap8.html">8</a>  <a href="chap9.html">9</a>  <a href="chap10.html">10</a>  <a href="chap11.html">11</a>  <a href="chap12.html">12</a>  <a href="chap13.html">13</a>  <a href="chap14.html">14</a>  <a href="chap15.html">15</a>  <a href="chap16.html">16</a>  <a href="chap17.html">17</a>  <a href="chap18.html">18</a>  <a href="chap19.html">19</a>  <a href="chap20.html">20</a>  <a href="chap21.html">21</a>  <a href="chap22.html">22</a>  <a href="chap23.html">23</a>  <a href="chap24.html">24</a>  <a href="chap25.html">25</a>  <a href="chap26.html">26</a>  <a href="chap27.html">27</a>  <a href="chap28.html">28</a>  <a href="chap29.html">29</a>  <a href="chap30.html">30</a>  <a href="chap31.html">31</a>  <a href="chap32.html">32</a>  <a href="chap33.html">33</a>  <a href="chap34.html">34</a>  <a href="chap35.html">35</a>  <a href="chap36.html">36</a>  <a href="chap37.html">37</a>  <a href="chap38.html">38</a>  <a href="chap39.html">39</a>  <a href="chap40.html">40</a>  <a href="chapInd.html">Ind</a>  </div>

<div class="chlinkprevnexttop">&nbsp;<a href="chap0.html">[Top of Book]</a>&nbsp;  <a href="chap0.html#contents">[Contents]</a>&nbsp;  &nbsp;<a href="chap19.html">[Previous Chapter]</a>&nbsp;  &nbsp;<a href="chap21.html">[Next Chapter]</a>&nbsp;  </div>

<p id="mathjaxlink" class="pcenter"><a href="chap20_mj.html">[MathJax on]</a></p>
<p><a id="X8276B4377D092A80" name="X8276B4377D092A80"></a></p>
<div class="ChapSects"><a href="chap20.html#X8276B4377D092A80">20 <span class="Heading"> Words in free <span class="SimpleMath">ZG</span>-modules </span></a>
<div class="ContSect"><span class="tocline"><span class="nocss">&nbsp;</span><a href="chap20.html#X7CFDEEC07F15CF82">20.1 <span class="Heading">  </span></a>
</span>
<div class="ContSSBlock">
<span class="ContSS"><br /><span class="nocss">&nbsp;&nbsp;</span><a href="chap20.html#X82D71B3F85D5BE77">20.1-1 AddFreeWords</a></span>
<span class="ContSS"><br /><span class="nocss">&nbsp;&nbsp;</span><a href="chap20.html#X7CCBD61A7EEBD996">20.1-2 AddFreeWordsModP</a></span>
<span class="ContSS"><br /><span class="nocss">&nbsp;&nbsp;</span><a href="chap20.html#X7E3F96C27E64EEF9">20.1-3 AlgebraicReduction</a></span>
<span class="ContSS"><br /><span class="nocss">&nbsp;&nbsp;</span><a href="chap20.html#X844F2C187CC85C47">20.1-4 MultiplyWord</a></span>
<span class="ContSS"><br /><span class="nocss">&nbsp;&nbsp;</span><a href="chap20.html#X7CA8A7CB81820EBB">20.1-5 Negate</a></span>
<span class="ContSS"><br /><span class="nocss">&nbsp;&nbsp;</span><a href="chap20.html#X818F12EC81BA4788">20.1-6 NegateWord</a></span>
<span class="ContSS"><br /><span class="nocss">&nbsp;&nbsp;</span><a href="chap20.html#X7FFAEBBD7B35F84C">20.1-7 PrintZGword</a></span>
<span class="ContSS"><br /><span class="nocss">&nbsp;&nbsp;</span><a href="chap20.html#X7D769FB3873B9527">20.1-8 TietzeReduction</a></span>
<span class="ContSS"><br /><span class="nocss">&nbsp;&nbsp;</span><a href="chap20.html#X7D043C4282B27B69">20.1-9 ResolutionBoundaryOfWord</a></span>
</div></div>
</div>

<h3>20 <span class="Heading"> Words in free <span class="SimpleMath">ZG</span>-modules </span></h3>

<p><a id="X7CFDEEC07F15CF82" name="X7CFDEEC07F15CF82"></a></p>

<h4>20.1 <span class="Heading">  </span></h4>

<p><a id="X82D71B3F85D5BE77" name="X82D71B3F85D5BE77"></a></p>

<h5>20.1-1 AddFreeWords</h5>

<div class="func"><table class="func" width="100%"><tr><td class="tdleft"><code class="func">&#8227; AddFreeWords</code>( <var class="Arg">v</var>, <var class="Arg">w</var> )</td><td class="tdright">(&nbsp;function&nbsp;)</td></tr></table></div>
<p>Inputs two words <span class="SimpleMath">v,w</span> in a free <span class="SimpleMath">ZG</span>-module and returns their sum <span class="SimpleMath">v+w</span>. If the characteristic of <span class="SimpleMath">Z</span> is greater than <span class="SimpleMath">0</span> then the next function might be more efficient.</p>

<p><strong class="button">Examples:</strong></p>

<p><a id="X7CCBD61A7EEBD996" name="X7CCBD61A7EEBD996"></a></p>

<h5>20.1-2 AddFreeWordsModP</h5>

<div class="func"><table class="func" width="100%"><tr><td class="tdleft"><code class="func">&#8227; AddFreeWordsModP</code>( <var class="Arg">v</var>, <var class="Arg">w</var>, <var class="Arg">p</var> )</td><td class="tdright">(&nbsp;function&nbsp;)</td></tr></table></div>
<p>Inputs two words <span class="SimpleMath">v,w</span> in a free <span class="SimpleMath">ZG</span>-module and the characteristic <span class="SimpleMath">p</span> of <span class="SimpleMath">Z</span>. It returns the sum <span class="SimpleMath">v+w</span>. If <span class="SimpleMath">p=0</span> the previous function might be fractionally quicker.</p>

<p><strong class="button">Examples:</strong></p>

<p><a id="X7E3F96C27E64EEF9" name="X7E3F96C27E64EEF9"></a></p>

<h5>20.1-3 AlgebraicReduction</h5>

<div class="func"><table class="func" width="100%"><tr><td class="tdleft"><code class="func">&#8227; AlgebraicReduction</code>( <var class="Arg">w</var> )</td><td class="tdright">(&nbsp;function&nbsp;)</td></tr></table></div>
<div class="func"><table class="func" width="100%"><tr><td class="tdleft"><code class="func">&#8227; AlgebraicReduction</code>( <var class="Arg">w</var>, <var class="Arg">p</var> )</td><td class="tdright">(&nbsp;function&nbsp;)</td></tr></table></div>
<p>Inputs a word <span class="SimpleMath">w</span> in a free <span class="SimpleMath">ZG</span>-module and returns a reduced version of the word in which all pairs of mutually inverse letters have been cancelled. The reduction is performed in a free abelian group unless the characteristic <span class="SimpleMath">p</span> of <span class="SimpleMath">Z</span> is entered.</p>

<p><strong class="button">Examples:</strong></p>

<p><a id="X844F2C187CC85C47" name="X844F2C187CC85C47"></a></p>

<h5>20.1-4 MultiplyWord</h5>

<div class="func"><table class="func" width="100%"><tr><td class="tdleft"><code class="func">&#8227; MultiplyWord</code>( <var class="Arg">n</var>, <var class="Arg">w</var> )</td><td class="tdright">(&nbsp;function&nbsp;)</td></tr></table></div>
<p>Inputs a word <span class="SimpleMath">w</span> and integer <span class="SimpleMath">n</span>. It returns the scalar multiple <span class="SimpleMath">n⋅ w</span>.</p>

<p><strong class="button">Examples:</strong></p>

<p><a id="X7CA8A7CB81820EBB" name="X7CA8A7CB81820EBB"></a></p>

<h5>20.1-5 Negate</h5>

<div class="func"><table class="func" width="100%"><tr><td class="tdleft"><code class="func">&#8227; Negate</code>( [<var class="Arg">i</var>, <var class="Arg">j</var>] )</td><td class="tdright">(&nbsp;function&nbsp;)</td></tr></table></div>
<p>Inputs a pair <span class="SimpleMath">[i,j]</span> of integers and returns <span class="SimpleMath">[-i,j]</span>.</p>

<p><strong class="button">Examples:</strong></p>

<p><a id="X818F12EC81BA4788" name="X818F12EC81BA4788"></a></p>

<h5>20.1-6 NegateWord</h5>

<div class="func"><table class="func" width="100%"><tr><td class="tdleft"><code class="func">&#8227; NegateWord</code>( <var class="Arg">w</var> )</td><td class="tdright">(&nbsp;function&nbsp;)</td></tr></table></div>
<p>Inputs a word <span class="SimpleMath">w</span> in a free <span class="SimpleMath">ZG</span>-module and returns the negated word <span class="SimpleMath">-w</span>.</p>

<p><strong class="button">Examples:</strong></p>

<p><a id="X7FFAEBBD7B35F84C" name="X7FFAEBBD7B35F84C"></a></p>

<h5>20.1-7 PrintZGword</h5>

<div class="func"><table class="func" width="100%"><tr><td class="tdleft"><code class="func">&#8227; PrintZGword</code>( <var class="Arg">w</var>, <var class="Arg">elts</var> )</td><td class="tdright">(&nbsp;function&nbsp;)</td></tr></table></div>
<p>Inputs a word <span class="SimpleMath">w</span> in a free <span class="SimpleMath">ZG</span>-module and a (possibly partial but sufficient) listing elts of the elements of <span class="SimpleMath">G</span>. The function prints the word <span class="SimpleMath">w</span> to the screen in the form</p>

<p><span class="SimpleMath">r_1E_1 + ... + r_nE_n</span></p>

<p>where <span class="SimpleMath">r_i</span> are elements in the group ring <span class="SimpleMath">ZG</span>, and <span class="SimpleMath">E_i</span> denotes the <span class="SimpleMath">i</span>-th free generator of the module.</p>

<p><strong class="button">Examples:</strong> <span class="URL"><a href="../www/SideLinks/About/aboutPeriodic.html">1</a></span> </p>

<p><a id="X7D769FB3873B9527" name="X7D769FB3873B9527"></a></p>

<h5>20.1-8 TietzeReduction</h5>

<div class="func"><table class="func" width="100%"><tr><td class="tdleft"><code class="func">&#8227; TietzeReduction</code>( <var class="Arg">S</var>, <var class="Arg">w</var> )</td><td class="tdright">(&nbsp;function&nbsp;)</td></tr></table></div>
<p>Inputs a set <span class="SimpleMath">S</span> of words in a free <span class="SimpleMath">ZG</span>-module, and a word <span class="SimpleMath">w</span> in the module. The function returns a word <span class="SimpleMath">w'</span> such that {<span class="SimpleMath">S,w'</span>} generates the same abelian group as {<span class="SimpleMath">S,w</span>}. The word <span class="SimpleMath">w'</span> is possibly shorter (and certainly no longer) than <span class="SimpleMath">w</span>. This function needs to be improved!</p>

<p><strong class="button">Examples:</strong></p>

<p><a id="X7D043C4282B27B69" name="X7D043C4282B27B69"></a></p>

<h5>20.1-9 ResolutionBoundaryOfWord</h5>

<div class="func"><table class="func" width="100%"><tr><td class="tdleft"><code class="func">&#8227; ResolutionBoundaryOfWord</code>( <var class="Arg">R</var>, <var class="Arg">n</var>, <var class="Arg">w</var> )</td><td class="tdright">(&nbsp;function&nbsp;)</td></tr></table></div>
<p>Inputs a resolution <span class="SimpleMath">R</span>, a positive integer <span class="SimpleMath">n</span> and a list <span class="SimpleMath">w</span> representing a word in the free module <span class="SimpleMath">R_n</span>. It returns the image of <span class="SimpleMath">w</span> under the <span class="SimpleMath">n</span>-th boundary homomorphism.</p>

<p><strong class="button">Examples:</strong> <span class="URL"><a href="../tutorial/chap14.html">1</a></span> </p>


<div class="chlinkprevnextbot">&nbsp;<a href="chap0.html">[Top of Book]</a>&nbsp;  <a href="chap0.html#contents">[Contents]</a>&nbsp;  &nbsp;<a href="chap19.html">[Previous Chapter]</a>&nbsp;  &nbsp;<a href="chap21.html">[Next Chapter]</a>&nbsp;  </div>


<div class="chlinkbot"><span class="chlink1">Goto Chapter: </span><a href="chap0.html">Top</a>  <a href="chap1.html">1</a>  <a href="chap2.html">2</a>  <a href="chap3.html">3</a>  <a href="chap4.html">4</a>  <a href="chap5.html">5</a>  <a href="chap6.html">6</a>  <a href="chap7.html">7</a>  <a href="chap8.html">8</a>  <a href="chap9.html">9</a>  <a href="chap10.html">10</a>  <a href="chap11.html">11</a>  <a href="chap12.html">12</a>  <a href="chap13.html">13</a>  <a href="chap14.html">14</a>  <a href="chap15.html">15</a>  <a href="chap16.html">16</a>  <a href="chap17.html">17</a>  <a href="chap18.html">18</a>  <a href="chap19.html">19</a>  <a href="chap20.html">20</a>  <a href="chap21.html">21</a>  <a href="chap22.html">22</a>  <a href="chap23.html">23</a>  <a href="chap24.html">24</a>  <a href="chap25.html">25</a>  <a href="chap26.html">26</a>  <a href="chap27.html">27</a>  <a href="chap28.html">28</a>  <a href="chap29.html">29</a>  <a href="chap30.html">30</a>  <a href="chap31.html">31</a>  <a href="chap32.html">32</a>  <a href="chap33.html">33</a>  <a href="chap34.html">34</a>  <a href="chap35.html">35</a>  <a href="chap36.html">36</a>  <a href="chap37.html">37</a>  <a href="chap38.html">38</a>  <a href="chap39.html">39</a>  <a href="chap40.html">40</a>  <a href="chapInd.html">Ind</a>  </div>

<hr />
<p class="foot">generated by <a href="https://www.math.rwth-aachen.de/~Frank.Luebeck/GAPDoc">GAPDoc2HTML</a></p>
</body>
</html>