decompose parameter space into open cells
CellDecomposition(sys, vars, pars, options)
CellDecomposition(eqs, posineqs, vars, pars, options)
CellDecomposition(eqs, posineqs, nzineqs, vars, pars, options)
list of equations, strict inequalities, and inequations between polynomials with rational coefficients
list of names; the indeterminates
(optional in the first two calling sequences) list of names; the parameters
list of polynomials f with rational coefficients, representing the equations of the form f=0
list of polynomials g with rational coefficients, representing constraint inequalities of the form 0<g
list of polynomials g with rational coefficients, representing constraint inequations of the form g≠0
sequence of optional equations of the form keyword=value, where keyword is either output or method
output=cad or witnesspoints: type of decomposition
If output=cad, the command computes an open Cylindrical Algebraic Decomposition (CAD) of the parameter space. In addition, the record contains the projection polynomials describing the CAD of the parameter space such that the number of solutions of the input system is constant on each full-dimensional open cell of the decomposition.
The option output is set to cad by default.
The option output=witnesspoints avoids the computation of a CAD by using the command RootFinding[WitnessPoints] internally. When output=witnesspoints, the output does not include the field ProjectionPolynomials.
method=GB or RC: algorithm to use
By default, the Groebner basis method (GB) is used. The RegularChains method can be accessed by specifying method=RC.
When output=witnesspoints is specified, the Groebner basis method will be used even if method=RC.
The CellDecomposition command decomposes the parameter space of a parametric polynomial system into cells in which the original system has a constant number of solutions.
The command returns a data structure that can be used for (for example):
Plotting the regions of the parameter space for which the system has a given number of solutions (see CellPlot)
Extracting sample points in the parameter space for which the system has a given number of solutions (see SampleSolutions)
Extracting boxes in the parameter space in which the system has a given number of solutions (see EnclosingBox)
The type of the output is a solution record with the following fields: Equations, Inequalities, Filter, Variables, Parameters, DiscriminantVariety, ProjectionPolynomials (sometimes present), and SamplePoints. The field Boxes is not initially present, but is added if you call EnclosingBox on a solution from CellDecomposition, as shown in the Examples section below.
The record returned captures information about the solutions of the system depending on the parameter values, including:
A discriminant variety (see DiscriminantVariety)
For each full-dimensional open cell, a sample point strictly in the interior of the cell; if possible, the coordinates of the sample point are chosen to be integers
The input system must satisfy the following properties:
The number of equations is equal to or greater than the number of indeterminates
At most finitely many complex solutions exist for almost all complex parameter values (that is, the system is generically zero-dimensional)
For almost all complex parameter values, there are no solutions of multiplicity greater than 1 (that is, the system is generically radical); in particular, the input equations are square-free
An error occurs if one of these conditions is violated.
If pars is not specified, it defaults to all the names in sys that are not indeterminates.
Note that if the input system sys contains an inequality of the form 0<parameter (or ineqs contains parameter), then sample points for those cells lying entirely in the octant described by the inequality parameter<0 may not be computed (see the examples below).
This command is part of the RootFinding[Parametric] package, so it can be used in the form CellDecomposition(..) only after executing the command with(RootFinding[Parametric]). However, it can always be accessed through the long form of the command by using RootFinding[Parametric][CellDecomposition](..).
In the following univariate example, obtain the well-known discriminant of a quadratic polynomial.
m1 ≔ CellDecomposition⁡x2+a⁢x+b=0,x
Thus, there are 4 full-dimensional open cells, which you can illustrate graphically:
The number of solutions for x on each of these cells can be computed using the following command:
So, the univariate equation has exactly two solutions in the yellow and pink cells, below the parabola, and no solution in the blue cell, above the parabola. In fact, it has one solution of multiplicity 2 exactly on the parabola, but this is a lower-dimensional sub-manifold, which is not considered by this command.
The next two examples illustrate the alternate calling sequences. Since the output of the assignment is the same for m2 and m3, they will each produce the same image using the CellPlot command.
m2 ≔ CellDecomposition⁡x6−a⁢x2+b=0,0<b,x
m3 ≔ CellDecomposition⁡m2:-Equations,m2:-Inequalities,m2:-Variables,m2:-Parameters
Sample points lying entirely in a negative octant are omitted. For example, the open cells represented by the sample points a=1,b=−1 and a=2,b=−1 from m4:-SamplePoints are not included in m3:-SamplePoints.
m4 ≔ CellDecomposition⁡x6−a⁢x2+b=0,x
The following system has no solutions for almost all parameters values.
m5 ≔ CellDecomposition⁡x6+a⁢y2−a=0,x6+a⁢y2−b=0,x,y
In this example, we use two different strategies to compute the sample points.
m6 ≔ CellDecomposition⁡x6+a⁢y2−a=0,a3⁢x6+a⁢y2−b=0,x,y
m7 ≔ CellDecomposition⁡x6+a⁢y2−a=0,a3⁢x6+a⁢y2−b=0,x,y,'output'='witnesspoints'
When we use the strategy witnesspoints, the record m7 contains no ProjectionPolynomials.
m6 and m7 can be visualized with CellPlot.
When EnclosingBox has been applied to the solutions, the enclosing boxes are also displayed by CellPlot.
The option output=witnesspoints usually returns fewer points.
p ≔ −51⁢a+77⁢b+95⁢c+1⁢x3+a+55⁢b−28⁢c+16⁢x2+30⁢a−27⁢b−15⁢c−59⁢x−96⁢a+72⁢b−87⁢c+47
m8 ≔ CellDecomposition⁡p=0,x:
m9 ≔ CellDecomposition⁡p=0,x,'output'='witnesspoints':
The option method=RC computes the equivalent solution record as the default GB method, but usually gives different sample points.
m10 ≔ CellDecomposition⁡x3+a⁢x2+b⁢x+a=0,x,a,b,method=RC
m10 ≔ CellDecomposition⁡x3+a⁢x2+b⁢x+a=0,x,a,b
The following examples illustrate invalid inputs:
This system has solutions of multiplicity greater than 1 for all parameter values.
Error, (in RootFinding:-Parametric:-CellDecomposition) cannot solve the system: either there are infinitely many complex solutions, or there are solutions of multiplicity > 1, for almost all parameter values
This system has infinitely many solutions for all parameter values.
Error, (in RootFinding:-Parametric:-CellDecomposition) cannot solve the system: there are infinitely many complex solutions, for almost all parameter values
The method option was introduced in Maple 15.
For more information on Maple 15 changes, see Updates in Maple 15.
Download Help Document
What kind of issue would you like to report? (Optional)