Raw File
README
This is abelianbnf, version 1.0 of September 2020.

abelianbnf is a gp script computing class groups of abelian fields using the
methods described in the paper "Norm relations and computational problems in
number fields" by Jean-François Biasse, Claus Fieker, Tommy Hofmann and
Aurel Page, available at https://hal.inria.fr/hal-02497890
Author: Aurel Page, Copyright (C) Inria 2020 

abelianbnf is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

abelianbnf is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <https://www.gnu.org/licenses/>.

===============================================================================

To get started, you should first get a copy of Pari/gp at

  http://pari.math.u-bordeaux.fr/download.html
  http://pari.math.u-bordeaux.fr/anongit.html

The Pari/gp version should be the development version or stable >= 2.13.

Then, simply include the file abelianbnf.gp with

  \r abelianbnf.gp

The main functions are:

  abelianbnfinit:
    Input: a polynomial defining a number field
    Output: some technical data

  getcyc:
    Input: the technical data output by abelianbnfinit
    Output: the structure of the class group of the number field

  abelianbnfcertify:
    Input: the technical data output by abelianbnfinit
    Output: 1 if the function successfully unconditionally certified the
      correctness of the computed class group

  vprintab:
    This is a global variable, set to 0 by default. Set it to 1 to get verbose
    output.

Run test.gp to check that the script runs correctly.

See examples.gp and unconditional-cyclotomics.gp for some examples of use.

===============================================================================

You can write to me at

  aurel.page@normalesup.org

Please report any bug you find and send me feedback!

You can find the latest version at

  http://www.normalesup.org/~page/software.html

Thanks for you support, and have fun !

back to top