msolveRealSolutions -- compute all real solutions to a zero dimensional system using symbolic methods

Usage:

msolveRealSolutions(I)

msolveRealSolutions(I, K)
Inputs:
- I, an ideal, which is zero dimensional, in a polynomial ring with coefficients over QQ
- K, a ring or an instance of the type RingFamily, the field to find answers in, which must be one of QQi (default), QQ, RR, or RRi (possibly with specified precision)
Optional inputs:
- Threads => an integer, default value 5, number of processor threads to use;
- Verbosity => an integer, default value 0, level of verbosity between 0, 1, and 2;
Outputs:
- a list, of lists; each entry in the list consists of a list representing the coordinates of a solution. By default each solution coordinate value is also represented by a rational interval consisting of a two element list of rational numbers, {a, b}, this means that that coordinate of the solution has a value greater than or equal to a and less than or equal to b. This interval is computed symbolically and its correctness is guaranteed by exact methods.

Description

This functions uses the msolve package to compute the real solutions to a zero dimensional polynomial ideal with either integer or rational coefficients.

The second input is optional, and indicates the alternative ways to provide output either using an exact rational interval QQi, a real interval RRi, or by taking a rational or real approximation of the midpoint of the intervals.

i1 : R = QQ[x,y]

o1 = R

o1 : PolynomialRing

i2 : I = ideal {(x-1)*x, y^2-5}

             2       2
o2 = ideal (x  - x, y  - 5)

o2 : Ideal of R

i3 : rationalIntervalSols = msolveRealSolutions I

        18446744073709551615  18446744073709551617      10312043428088987147 
o3 = {{{--------------------, --------------------}, {- --------------------,
        18446744073709551616  18446744073709551616       4611686018427387904 
     ------------------------------------------------------------------------
       41248173712355948587                  2803722537994803411           
     - --------------------}}, {{- ---------------------------------------,
       18446744073709551616        340282366920938463463374607431768211456 
     ------------------------------------------------------------------------
               1289205567001833903               41248173712355948591   
     --------------------------------------}, {- --------------------, -
     85070591730234615865843651857942052864      18446744073709551616   
     ------------------------------------------------------------------------
     20624086856177974293      18446744073709551615  18446744073709551617  
     --------------------}}, {{--------------------, --------------------},
      9223372036854775808      18446744073709551616  18446744073709551616  
     ------------------------------------------------------------------------
      41248173712355948587  10312043428088987147       
     {--------------------, --------------------}}, {{-
      18446744073709551616   4611686018427387904       
     ------------------------------------------------------------------------
               2243622435364413879           
     ---------------------------------------,
     170141183460469231731687303715884105728 
     ------------------------------------------------------------------------
               218653757949500255              20624086856177974293 
     --------------------------------------}, {--------------------,
     85070591730234615865843651857942052864     9223372036854775808 
     ------------------------------------------------------------------------
     20624086856177974295
     --------------------}}}
      9223372036854775808

o3 : List

i4 : rationalApproxSols = msolveRealSolutions(I, QQ)

            82496347424711897175              2353099730012532201           
o4 = {{1, - --------------------}, {---------------------------------------,
            36893488147419103232    680564733841876926926749214863536422912 
     ------------------------------------------------------------------------
       82496347424711897177       82496347424711897175     
     - --------------------}, {1, --------------------}, {-
       36893488147419103232       36893488147419103232     
     ------------------------------------------------------------------------
               1806314919465413369            10312043428088987147
     ---------------------------------------, --------------------}}
     340282366920938463463374607431768211456   4611686018427387904

o4 : List

i5 : floatIntervalSols = msolveRealSolutions(I, RRi)

o5 = {{[1,1], [-2.23607,-2.23607]}, {[-8.2394e-21,1.51545e-20],
     ------------------------------------------------------------------------
     [-2.23607,-2.23607]}, {[1,1], [2.23607,2.23607]},
     ------------------------------------------------------------------------
     {[-1.31868e-20,2.57026e-21], [2.23607,2.23607]}}

o5 : List

i6 : floatIntervalSols = msolveRealSolutions(I, RRi_10)

o6 = {{[.999998,1], [-2.23607,-2.23606]}, {[-1.49403e-8,1.07821e-8],
     ------------------------------------------------------------------------
     [-2.23607,-2.23607]}, {[.999997,1], [2.23606,2.23608]},
     ------------------------------------------------------------------------
     {[-5.47061e-9,1.18553e-8], [2.23607,2.23607]}}

o6 : List

i7 : floatApproxSols = msolveRealSolutions(I, RR)

o7 = {{1, -2.23607}, {3.45757e-21, -2.23607}, {1, 2.23607}, {-5.30828e-21,
     ------------------------------------------------------------------------
     2.23607}}

o7 : List

i8 : floatApproxSols = msolveRealSolutions(I, RR_10)

o8 = {{1, -2.23607}, {-2.0791e-9, -2.23607}, {1, 2.23607}, {3.19233e-9,
     ------------------------------------------------------------------------
     2.23607}}

o8 : List

Note in cases where solutions have multiplicity this is not reflected in the output. While the solver does not return multiplicities, it reliably outputs the verified isolating intervals for multiple solutions.

i9 : I = ideal {(x-1)*x^3, (y^2-5)^2}

             4    3   4      2
o9 = ideal (x  - x , y  - 10y  + 25)

o9 : Ideal of R

i10 : floatApproxSols = msolveRealSolutions(I, RRi)

o10 = {{[1,1], [-2.23607,-2.23607]}, {[-8.2394e-21,1.51545e-20],
      -----------------------------------------------------------------------
      [-2.23607,-2.23607]}, {[1,1], [2.23607,2.23607]},
      -----------------------------------------------------------------------
      {[-1.31868e-20,2.57026e-21], [2.23607,2.23607]}}

o10 : List

Ways to use msolveRealSolutions:

msolveRealSolutions(Ideal)
msolveRealSolutions(Ideal,Ring)
msolveRealSolutions(Ideal,RingFamily)

For the programmer

The object msolveRealSolutions is a method function with options.

The source of this document is in /build/macaulay2-BDMbwf/macaulay2-1.25.11+ds/M2/Macaulay2/packages/Msolve.m2:644:0.