Package sage :: Package libs :: Package mwrank :: Module interface :: Class mwrank_MordellWeil
[hide private]
[frames] | no frames]

Class mwrank_MordellWeil

source code

                      object --+    
                               |    
structure.sage_object.SageObject --+
                                   |
                                  mwrank_MordellWeil


The \class{mwrank_MordellWeil} class represents a subgroup of a
Mordell-Weil group.  Use this class to saturate a specified list
of points on an \class{mwrank_EllipticCurve}, or to search for
points up to some bound.



Instance Methods [hide private]
 
__init__(self, curve, verbose=True, pp=1, maxr=999)
Create a \class{mwrank_MordellWeil} instance.
source code
 
__reduce__(self)
helper for pickle
source code
 
__repr__(self)
File: sage/structure/sage_object.pyx (starting at line 86)
source code
 
process(self, v, sat=0)
This function allows one to add points to a mwrank_MordellWeil object.
source code
 
regulator(self)
Return the regulator of the points in this subgroup of the Mordell-Weil group.
source code
 
rank(self)
Return the rank of this subgroup of the Mordell-Weil group.
source code
 
saturate(self, max_prime=-1, odd_primes_only=False)
Saturate this subgroup of the Mordell-Weil group.
source code
 
search(self, height_limit=18, verbose=False)
Search for new points, and add them to this subgroup of the Mordell-Weil group.
source code
 
points(self)
Return a list of the generating points in this Mordell-Weil group.
source code

Inherited from structure.sage_object.SageObject: __hash__, __new__, _axiom_, _axiom_init_, _gap_, _gap_init_, _gp_, _gp_init_, _interface_, _interface_init_, _interface_is_cached_, _kash_, _kash_init_, _macaulay2_, _macaulay2_init_, _magma_, _magma_init_, _maple_, _maple_init_, _mathematica_, _mathematica_init_, _maxima_, _maxima_init_, _octave_, _octave_init_, _pari_, _pari_init_, _r_init_, _sage_, _singular_, _singular_init_, category, db, dump, dumps, plot, rename, reset_name, save, version

Inherited from object: __delattr__, __getattribute__, __reduce_ex__, __setattr__, __str__

Properties [hide private]

Inherited from object: __class__

Method Details [hide private]

__init__(self, curve, verbose=True, pp=1, maxr=999)
(Constructor)

source code 

Create a \class{mwrank_MordellWeil} instance.

INPUT:
    curve -- \class{mwrank_EllipticCurve} instance
    verbose -- bool
    pp -- int
    maxr -- int

Overrides: object.__init__

__reduce__(self)

source code 
helper for pickle

Overrides: object.__reduce__
(inherited documentation)

__repr__(self)
(Representation operator)

source code 
File: sage/structure/sage_object.pyx (starting at line 86)

Overrides: structure.sage_object.SageObject.__repr__
(inherited documentation)

process(self, v, sat=0)

source code 

This function allows one to add points to a mwrank_MordellWeil object.

Process points in the list v, with saturation at primes up to
sat.  If sat = 0 (the default), then saturate at all primes.

INPUT:

    v -- a point (3-tuple of ints), or a
         list of 3-tuples of integers, which define points on the curve.
         
    sat -- int, saturate at primes up to sat, or at all primes if sat=0.
    

saturate(self, max_prime=-1, odd_primes_only=False)

source code 

Saturate this subgroup of the Mordell-Weil group.

INPUT:
    max_prime (int) -- (default: 97), saturation is performed
                       for all primes up to max_prime
                       
    odd_primes_only (bool) -- only do saturation at odd primes

OUTPUT:
    ok (bool) -- True if and only if the saturation
                 is provably correct at \emph{all} primes.
    index (int) -- The index of the group generated by
                   points in their saturation
    saturation (list) -- list of points that form
                         a basis for the saturation

\begin{notice}
We emphasize that if this function returns True as the first
return argument, then the points it found are saturated at
\emph{all} primes, i.e., saturating at the primes up to
\code{max_prime} are sufficient to saturate at all primes.
Note that the function might not have needed to saturate at
all primes up to \code{max_prime}.
It has worked out what prime you need to saturate up to,
and that prime is $\leq $ \code{max_prime}.

\end{notice}

\begin{notice}
Currently (July 2005), this does not remember the result of
calling search.  So calling search up to height 20 then
calling saturate results in another search up to height 18.
\end{notice}

   

search(self, height_limit=18, verbose=False)

source code 

Search for new points, and add them to this subgroup of the
Mordell-Weil group.

INPUT:
    height_limit -- float (default: 18) search up to
                    this logarithmetic height.
           On 32-bit machines, h_lim MUST be < 21.48 else
           $\exp(h_lim)>2^31$ and overflows.