WitnessPoints - Maple Help
For the best experience, we recommend viewing online help using Google Chrome or Microsoft Edge.

Online Help

RootFinding

  

WitnessPoints

  

sample real connected components of a polynomial system

 

Calling Sequence

Parameters

Description

Notes

Examples

Calling Sequence

WitnessPoints(sys)

WitnessPoints(sys, vars)

WitnessPoints(sys, vars, digits=d)

Parameters

sys

-

list of equations or list of inequations and strict inequalities

vars

-

(optional) list of names; the indeterminates

d

-

(optional) positive integer; number of significant digits

Description

• 

The function WitnessPoints returns at least one point in each connected component of the real solutions of sys.

• 

The system sys is either:

– 

a list of polynomial equations with rational coefficients

– 

or, a list of polynomial inequations of the form  and strict inequalities of the form  with rational coefficients

• 

The output is a list of points with rational coordinates.

• 

A point is represented by a list of equations of the form .

• 

When sys is a list of equations, then each point of the output is a rational approximation of a solution of sys, the precision of which is controlled  by the option digits=d (default value: Digits). More precisely, if  is a point returned by the command WitnessPoints, then there exists a solution  of sys such that:

• 

When the list of names vars is provided, it must contain all the indeterminates appearing in sys. In this case, the coordinates of the points returned by WitnessPoints are ordered according to vars.

Notes

• 

Several points can belong to the same connected component.

• 

For some inputs, repeated execution of the command WitnessPoints may return different outputs due to the use of randomization in the implementation. A way to keep the function deterministic is to use the command randomize with a fixed seed (see Examples below).

Examples

WitnessPoints computes sample solutions of an equation:

(1)

(2)

or a system of equations

(3)

or a set of inequalities:

(4)

The following example computes points on the interior and the exterior of the unit circle, with -coordinates in the interval .

(5)

In the following example, we check that a system with the equation  has no real solutions.

(6)

The following example illustrates the precision of the computed solutions.

(7)

(8)

(9)

(10)

(11)

In the next example we give a seed to the rand function in order to transform the command WitnessPoints in a deterministic function.

(12)

(13)

(14)

(15)

(16)

The command doesn't handle mixed equations and inequalities/inequations.

Error, (in RootFinding:-WitnessPoints) WitnessPoints does not handle mixed equations and inequalities/inequations

See Also

HasRealRoots

Parametric

randomize

RootFinding

 


Download Help Document