aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorSebastiano Tronto <sebastiano.tronto@gmail.com>2022-01-30 14:42:57 +0100
committerSebastiano Tronto <sebastiano.tronto@gmail.com>2022-01-30 14:42:57 +0100
commit5cb52882924253a2ec643cc9f259d57e368412a6 (patch)
treebd5decb9dd23c08457a3c5831748de996794d8e7 /README.md
parent6376666f2050a28d09edce77e2ff4dcf9d4c6f1e (diff)
downloadkummer-degrees-5cb52882924253a2ec643cc9f259d57e368412a6.tar.gz
kummer-degrees-5cb52882924253a2ec643cc9f259d57e368412a6.zip
Fixing markdown readmeHEADmaster
Diffstat (limited to 'README.md')
-rw-r--r--README.md23
1 files changed, 13 insertions, 10 deletions
diff --git a/README.md b/README.md
index 97ce1e9..741ae3f 100644
--- a/README.md
+++ b/README.md
@@ -4,21 +4,22 @@ the rational numbers. In order to use the functions KummerDegree and
4TotalKummerFailure (described below), simply download the file 4TotalKummerFailure (described below), simply download the file
5kummer_degree.sage and include it in your SageMath session/project, 5kummer_degree.sage and include it in your SageMath session/project,
6for example with 6for example with
7
7``` 8```
8attach(\"kummer_degree.sage\") 9attach("kummer_degree.sage")
9``` 10```
10 11
11A Kummer Extension of Q is a field extension of the form Q_{M,N}:= 12A Kummer Extension of Q is a field extension of the form Q{M,N}:=
12Q(\zeta_M,G^{1/N}), where: 13Q(z,G^1/N ), where:
13 14
14* M and N are integers with N dividing M; 15* M and N are integers with N dividing M;
15* \zeta_M is a root of unity of order M; 16* z is a root of unity of order M;
16* G is a finitely generated subgroup of the multiplicative group Q* of Q; 17* G is a finitely generated subgroup of the multiplicative group Q* of Q;
17* G^{1/N} is the set of all elements x of an algebraic closure of Q such that 18* G^1/N is the set of all elements x of an algebraic closure of Q such that
18x^n belongs to G. 19x^n belongs to G.
19 20
20In other words, it is a number field generated by finitely many elements of 21In other words, it is a number field generated by finitely many elements of
21the form a^{1/n} and "at least sufficiently many" roots of unity to make 22the form a^1/n and "at least sufficiently many" roots of unity to make
22this field Galois over Q. 23this field Galois over Q.
23 24
24The main importance of this script is to show that, for a fixed group G as 25The main importance of this script is to show that, for a fixed group G as
@@ -47,7 +48,7 @@ computation of degrees for the same group G only require constant time
47 48
48## KummerDegree( G, M, N ) 49## KummerDegree( G, M, N )
49 50
50Returns the degree of the Kummer extension Q_{M,N}=Q(\zeta_M,G^{1/N}) over Q. 51Returns the degree of the Kummer extension Q{M,N}=Q(z,G^1/N ) over Q.
51 52
52INPUT: 53INPUT:
53 54
@@ -57,9 +58,10 @@ INPUT:
57 58
58OUTPUT: 59OUTPUT:
59 60
60The degree of the Kummer Extensions Q_{M,N}=Q(\zeta_M,G^{1/N}) over Q. 61The degree of the Kummer Extensions Q{M,N}=Q(z,G^1/N ) over Q.
61 62
62EXAMPLES: 63EXAMPLES:
64
63``` 65```
64sage: KummerDegree([5],10,2) 66sage: KummerDegree([5],10,2)
654 674
@@ -80,8 +82,8 @@ G - a list of generators for the group G
80 82
81OUPUT: 83OUPUT:
82 84
83The first part of the output consist of two positive integers M_0 and N_0. 85The first part of the output consist of two positive integers M0 and N0.
84N_0 is always a divisor of M_0. 86N0 is always a divisor of M0.
85 87
86The second part of the output can be either one or two tables, depending on 88The second part of the output can be either one or two tables, depending on
87the group G. In case -1 is not an element of G, there is only one table, 89the group G. In case -1 is not an element of G, there is only one table,
@@ -155,6 +157,7 @@ M/N is ODD and is read as the previous one.
155``` 157```
156 158
157Uncommenting the line of code: 159Uncommenting the line of code:
160
158``` 161```
159print_case_list( ret ) 162print_case_list( ret )
160``` 163```

Generated with cgit - Back to sebastiano.tronto.net