ApCoCoA-1:MatlabCoCoAIdeal

Introduction

The CoCoAIdeal class represents an ideal of polynomials over a given polynomial ring (See <a href="MatlabCoCoAPoly.html">Poly class</a>).

Constructor

The constructor for a CoCoAIdeal can have two arguments:

• Generators: Array of polynomials
• Optional: 1/0 : 1 = Compute Groebner-Basis of Ideal

If no input is given the default ideal (1) over Q[x[1]] is returned Generators should be a 1xn CoCoAPoly array. A nx1 array is transposed.

Attributes

basering	A CoCoARing
gens	an array of polynomials
gBasis	the Groebner-Basis of an Ideal
numBasisElements	The number of basis elements. If gBasis is not yet computed the number of generators is stored.

Methods

Method	Operator	Description
computeGBasis		computes the GBasis of the given Ideal and returns a new ideal with the same set of generators and the computed GBasis.
computeLT		computes the leading term of the ideal. Returns a CoCoAPoly.
display		Is used by Matlab to print a CoCoAIdeal to the command window. E.g. when a command is not terminated by a ';'.
eq	==	Compares two ideals. Returns 1 if all generators are equal.
ge	>=	Compares two ideals according to their leading term. Returns 1 if first ideal is greater equal the second ideal.
get		Returns the attributes of an ideal. Syntax: get(idealVar, 'Keyword'), where idealVar is a CoCoAIdeal and 'Keyword' is one of the keywords: 'BaseRing': Returns the ring over which the polynomials in the generator list are defined. 'Gens': returns the generator array of CoCoAPoly's 'GBasis': returns the GBasis of the Ideal if it has been computed. Otherwise [] is returned. 'NumElements': Returns the number of basis elements. If gBasis is not yet computed the number of generators is returned. 'String': Returns the polynomial as a string. 'Latex' will return a string using Latex syntax.
gt	>	Compares two ideals according to their leading term. Returns 1 if first ideal is greater than the second ideal.
isContained		Returns 1 if the first ideal is contained in the second ideal.
isElem		Returns 1 if the polynomial (2. argument) is in the ideal (1. argument)
le	<=	Compares two ideals according to their leading term. Returns 1 if first ideal is less equal the second ideal.
lt	<	Compares two ideals according to their leading term. Returns 1 if first ideal is less than the second ideal.
ne	~=	returns NOT eq.

Examples

A collection of examples is provided in the file TestCoCoAIdeal.m. This file defines the function TestCoCoAIdeal which will run and display many examples. A few common examples are presented below.

• Ideal generated by two polynomials.

<matlab> p1 = CoCoAPoly('x^2-1'); p2 = CoCoAPoly('y+x'); myIdeal = CoCoAIdeal([p1 p2]); </matlab>