NumberTheory - Maple Programming Help

Online Help

All Products    Maple    MapleSim


Home : Support : Online Help : Mathematics : Number Theory : NumberTheory/IntegralBasis

NumberTheory

  

IntegralBasis

  

integral base of an algebraic number field

 

Calling Sequence

Parameters

Description

Examples

Compatibility

Calling Sequence

IntegralBasis(k)

IntegralBasis(k, primes = primopt, method = methopt)

Parameters

k

-

algebraic number, a set of algebraic numbers, or a univariate irreducible polynomial over an algebraic number field

primes = primopt

-

(optional) keyword argument where primopt is a prime number or a set of prime numbers

method = methopt

-

(optional) keyword argument where methopt is one of the symbols roundfour, roundtwo, or padic; valid only when k is a polynomial, an algebraic number, or a set of one algebraic number

Description

• 

The IntegralBasis(k) command computes an integral basis for an algebraic number field K specified by the parameter k. The output is a list of elements of K which generate the Z-module of integral elements of K, where Z denotes the ring of integers. An element K is said to be integral over Z if it annihilates a monic univariate polynomial with coefficients in Z.

• 

There are several ways to specify K with k:

– 

by a RootOf or a set of RootOf expressions representing algebraic numbers. The RootOf expressions must be independent. The output will be in RootOf notation.

– 

by a radical number or a set of radical numbers. The output will be in radical notation, but the output radicals may differ from the input radicals.

– 

by a univariate polynomial over the rational numbers or over an algebraic number field in RootOf or radical notation. The polynomial must be irreducible over its coefficients field and the RootOf appearing in the coefficients must be independent. The output will be expressed in terms of the variable.

• 

If the keyword argument primes is given, then a local integral basis at these primes is computed instead of an integral basis over Z.

• 

The following are valid values for the keyword argument method:

– 

roundfour: The Ford & Zassenhaus Round Four algorithm is used. See "Implementing the Round Four Maximal Order Algorithm", by D. Ford & P. Letard, Journal de Theorie des Nombres de Bordeaux, 1994, 6, p. 39-80. This is the default.

– 

roundtwo: The Zassenhaus Round Two algorithm is used. See "A Course in Computational Algebraic Number Theory" by Henri Cohen, Springer.

– 

padic: With this option the algorithm will try to compute roots of k in the form of p-adic numbers if k is a polynomial. If k is an algebraic number or a set of one algebraic number, then the algorithm will work with the minimal polynomial of that number. Let d be the discriminant of the polynomial. The primes that are used are the primes of the keyword argument primes whose square divides d, or if primes is not given, the prime factors of d with multiplicity of at least 2. If at a prime p no wild ramification occurs then the integral basis at the prime p is computed using these p-adic roots, see  "An algorithm for computing an integral basis in an algebraic function field", J. of Symbolic Computation, 1994, 18, p. 353-363. If a wild ramification (that is, p divides the ramification index) does occur then this method does not work. A warning message will be given and the integral basis at the prime p will be computed using the Round Four algorithm.

Examples

withNumberTheory:

q412966864t+1128t2336t36t5+t6

qt66t5336t3+1128t26864t+41296

(1)

IntegralBasisq

1,t,t22,t34,124t4+13t2+12t+23,11443432t5+4513360858t4+31066180429t3+36025180429t2+32903180429t+8819180429

(2)

IntegralBasisq,primes=2,method=padic

1,t,t22,t34,18t4+12t,t58

(3)

IntegralBasisq,primes=2,3

1,t,t22,t34,124t4+13t2+12t+23,124t5+112t3+23t

(4)

IntegralBasis1013

1,1013,10233+10133+13

(5)

IntegralBasis612,1012

1,10,102+62,1062

(6)

rRootOfx315x2+75x4825,x

rRootOf_Z315_Z2+75_Z4825

(7)

By setting the infolevel for this command to a positive value, some information will be printed during computation.

infolevelIntegralBasis1:

IntegralBasisr

IntegralBasis:   factorizing the discriminant   -596430000
IntegralBasis:   set of primes   {2, 3, 5, 47}
IntegralBasis:   computing local integral basis in the prime   2
IntegralBasis:   calling Round 4 method
IntegralBasis:   computing local integral basis in the prime   3
IntegralBasis:   calling Round 4 method
IntegralBasis:   computing local integral basis in the prime   5
IntegralBasis:   calling Round 4 method
IntegralBasis:   computing local integral basis in the prime   47
IntegralBasis:   calling Round 4 method

1,RootOf_Z315_Z2+75_Z4825,RootOf_Z315_Z2+75_Z4825210+12

(8)

Compatibility

• 

The NumberTheory[IntegralBasis] command was introduced in Maple 2016.

• 

For more information on Maple 2016 changes, see Updates in Maple 2016.

See Also

algcurves:-integral_basis

NumberTheory