RegularChains[ChainTools]
IsIncluded
inclusion test for two regular chains
Calling Sequence
Parameters
Description
Examples
References
IsIncluded(rc1, rc2, R)
rc1
-
regular chain
rc2
R
polynomial ring
The command IsIncluded(rc1, rc2, R) returns true if the saturated ideal of rc1 is detected to be contained in that of rc2, false otherwise, where rc1 and rc2 are regular chains of R.
The answer is true if the following conditions hold.
(1) all equations of rc1 are reduced to zero by rc2
(2) the initials of rc1 are regular modulo rc2
The answer is also true if the following conditions hold.
(2) the regular chain rc1 is primitive, that is, it generates its saturated ideal.
Other criteria are implemented. Some inclusions are not detected by any of those criteria. When they all fail, then false is returned.
Even though there exists a general algorithm for deciding whether the saturated ideal rc1 is contained in that of rc2, this algorithm is not implemented since it too costly to execute in most cases. On the criteria the implemented criteria are in general much less costly to execute.
This command is part of the RegularChains[ChainTools] package, so it can be used in the form IsIncluded(..) only after executing the command with(RegularChains[ChainTools]). However, it can always be accessed through the long form of the command by using RegularChains[ChainTools][IsIncluded](..).
with⁡RegularChains:with⁡ChainTools:
R≔PolynomialRing⁡x,y,z
R≔polynomial_ring
sys≔x2+y+z−1,x+y2+z−1,x+y+z2−1
sys≔x2+y+z−1,y2+x+z−1,z2+x+y−1
dec≔Triangularize⁡sys,R,normalized=yes
dec≔regular_chain,regular_chain,regular_chain,regular_chain
epdec≔EquiprojectableDecomposition⁡dec,R
epdec≔regular_chain,regular_chain
foritonops⁡decdoforjtonops⁡epdecdoT≔deci;U≔epdecj;print⁡Equations⁡T,R;print⁡Equations⁡U,R;print⁡IsIncluded⁡T,U,R;print⁡Equations⁡U,R;print⁡Equations⁡T,R;print⁡IsIncluded⁡U,T,Renddoenddo
x−z,y−z,z2+2⁢z−1
2⁢x+z2−1,2⁢y+z2−1,z3+z2−3⁢z+1
true
false
x+y−1,y2−y,z
x,y,z−1
x,y−1,z
x−1,y,z
Xie, Y. "Fast Algorithms, Modular Methods, Parallel Approaches and Software Engineering for Solving Polynomial Systems Symbolically" PhD Thesis, University of Western Ontario, Canada, 2007.
See Also
EqualSaturatedIdeals
Equations
EquiprojectableDecomposition
IsInSaturate
PolynomialRing
RegularChains
RemoveRedundantComponents
Triangularize
Download Help Document