PolynomialIdeals:-command(arguments)

command(arguments)

We first create an ideal J using the PolynomialIdeal command. This ideal is generated by the two polynomials given to the constructor. The ideal is assumed to lie in the polynomial ring $Q_{x,y,z}$ by default.

Now we test if a polynomial $f$ in the polynomial ring $Q_{x,y,z}$ is in the ideal $J$ using the IdealMembership command. Because the polynomial $f$ is a polynomial combination of the generators, it is in $J$.

Now we show how to do this using a shortcut syntax that corresponds more closely to a standard notation for ideals. This syntax is available whenever the package has been loaded using with(PolynomialIdeals). Otherwise, enclosing a quantity in angled brackets constructs a Vector for use with the LinearAlgebra package. For further options and details for constructing polynomial ideals, see PolynomialIdeal.

The PrimeDecomposition and PrimaryDecomposition commands compute prime and primary decompositions, respectively. Both return a sequence of ideals whose intersection contains the input ideal.  For a prime decomposition, this intersection has the same solutions as the original ideal (the intersection is equal to the radical), whereas for a primary decomposition the intersection is identically equal to the given ideal. The Intersect command is used below to compute this intersection.  In this case, our ideal $J$ is radical, so the prime and primary decompositions are the same.

How do we know that $K=J$? The IdealContainment command can be used to test multiple inclusions simultaneously.  It returns true if all of the inclusions are true, and false if any of them fail. A particularly useful form of the command is shown below, where it is used to test ideal equality.

Turning back to the prime decomposition, to extract the set of generators for one of the components:  the Generators command accepts a single ideal, and returns the set of generators in a set.

How are these computations done? An ideal membership test and an ideal decomposition are performed by first computing a Groebner basis for the ideal. If we inspect the data representation for the ideal J, we notice that a Groebner basis was implicitly computed.

Groebner bases are used extensively by almost every command in this package. They are computed by the system as required. You need not be familiar with Groebner bases to use this package. The Groebner:-Basis command computes a Groebner basis explicitly for an ideal with respect to a given monomial order.  A variety of monomial orders are implemented, with a complete list available under MonomialOrders. The default monomial ordering used is known as graded reverse lexicographical order or tdeg in Maple. Here, we explicitly compute a Groebner basis for our ideal J using lexicographic order with $z>y>x$. See Groebner:-Basis for details. From this example, you can see that the Groebner basis depends on the monomial ordering used.  We extract the leading terms of the generators for the Groebner basis; they are $y^3$, $xz$, and $yz$.

The next ideal is the intersection of two components, both of which are maximal, that is, prime over $Q$ and zero-dimensional. We extract the smaller component of interest, and then simplify it.

There are a finite number of solutions.

There are no repeated solutions.

There is more than one irreducible component.

There are 10 distinct solutions.

There are two irreducible components.

The smaller component:

In the mathematical literature, the letters I, J, and K are often used to denote ideals. We have so far refrained from using I because Maple, by default, uses I to denote the imaginary unit whose square is $\mathrm{-1}$.  We can use a different letter for the square root of $\mathrm{-1}$ after using the following command, leaving us free to use the letter I for an ideal.  We show an example of this next.

In addition to the generators (which are always specified as polynomials), we can also input options for the polynomial ring (which are always specified as equations). Two of the most important options are $\mathrm{characteristic}=p$, which forces all computations onto the integers modulo p, and $\mathrm{variables}=S$, in which a set S specifies the variables of the polynomial ring.  We make use of both options in the following example. The resulting ideal will lie in the polynomial ring ${Z_5\left(a\right)}_{x,y}$, rather than the default $Q_{x,y,a}$. When using the shortcut $<...>$ syntax, the Maple operator precedence rules require that you enclose any options in parentheses.

As an example of a computation with ideals, the intersection of two ideals $\mathrm{J1}$ and $\mathrm{J2}$ in $k\&lsqb;\mathrm{x1},\mathrm{x2},...,\mathrm{xn}\&rsqb;$ is given by the following formula: $\mathrm{J1}\mathrm{intersect}\mathrm{J2}=\left(t\mathrm{J1}+\left(1-t\right)\mathrm{J2}\right)\mathrm{intersect}k\&lsqb;\mathrm{x1},\mathrm{x2},\mathrm{...},\mathrm{xn}\&rsqb;$. We make use of the Operators subpackage, which provides binary operators for ideal arithmetic.

Note: When ideal operations are applied to different rings, for example, $k_{t,x}$ and $k_{x,y}$, the ideals are first put into a common ring, in this case, the ring $k_{t,x,y}$. For our final example, we explain how to test if an ideal is zero-dimensional, that is, the polynomial system of equations has finitely many solutions if in characteristic zero. You can use the HilbertDimension command to compute the dimension of an ideal to do this. Another way is the following; an ideal J in $k\&lsqb;\mathrm{x1},...,\mathrm{xn}\&rsqb;$ has dimension zero if the set of leading monomials of the ideal contains $\{{\mathrm{x1}}^{\mathrm{e1}},...,{\mathrm{xn}}^{\mathrm{en}}\}$, for $0\le \mathrm{ei}$.