.. _spkg_ratpoints:

ratpoints: Find rational points on hyperelliptic curves
=======================================================

Description
-----------

Michael Stoll's program which searches for rational points on
hyperelliptic curves.

NOTE: the ratpoints package has been assimilated by PARI/GP. Therefore,
this package (as Sage package) is deprecated. In the future, it will be
removed from Sage.


Upstream Contact
----------------

-  Author: Michael Stoll
-  Email: Michael.Stoll@uni-bayreuth.de
-  Website: http://www.mathe2.uni-bayreuth.de/stoll/programs/

Dependencies
------------

-  GMP/MPIR
-  (GNU) patch


Special Update/Build Instructions
---------------------------------


Note on SSE2 instructions
~~~~~~~~~~~~~~~~~~~~~~~~~

-  On several architectures, the SSE2 instructions used by ratpoints
   cause
   compiler errors. In the case that ratpoints fails to build with SSE2
   instructions enabled, the build is repeated with SSE2 disabled.

Type
----

standard


Version Information
-------------------

package-version.txt::

    2.1.3.p5


Equivalent System Packages
--------------------------

arch:

.. CODE-BLOCK:: bash

    $ sudo pacman -S  ratpoints

conda:

.. CODE-BLOCK:: bash

    $ conda install ratpoints

Debian/Ubuntu:

.. CODE-BLOCK:: bash

    $ sudo apt-get install  ratpoints

nix:

.. CODE-BLOCK:: bash

    $ nix-env --install ratpoints

See https://repology.org/project/ratpoints/versions

However, these system packages will not be used for building Sage
because spkg-configure.m4 has not been written for this package;
see https://trac.sagemath.org/ticket/27330