# Category:ApCoCoA-1:Package ncpoly

Package ncpoly is designed to enable us to do *basic calculations* with polynomials in *non-commutative polynomial rings* (or *free associative algebras*), over the field of rational numbers `Q` or over finite fields `Z/(p)` where `p` is a prime. For instance, in the package, there are functions for addition of two (non-commutative) polynomials (via Add(F1,F2)), subtraction (via Sub(F1,F2)), multiplication (via Mul(F1,F2)), getting the leading word (via Lw(F)) and leading coefficient (via Lc(F)) of a non-zero polynomial, computing the normal remainder (via NR(F,G)) of a polynomial w.r.t a LIST of polynomials, interreducing (via Interreduction(G)) a LIST of polynomials, etc. Moreover, the package also contains functions for *Groebner basis computations*. For example, there are functions to check if a LIST of polynomials is a Groebner basis (via IsGB(G)), enumerate (reduced) (partial) Groebner bases (via GB(G[,Optimize,OFlag,DB,LB]) and RedGB(G[,Optimize,OFlag,DB,LB])), and compute truncated Groebner bases (via TruncatedGB(G[,Optimize,OFlag,DB])) of finitely generated (two-sided) ideals. Consequently, we can apply the package to many algebraic applications, i.e. to compute Macaulay basis (via MB(Gb)) and the values of Hilbert function (via HF(Gb)), compute generating systems for leading term ideals, kernel of `K`-algebra homomorphism, intersection of ideals, etc.

**Important issues about this package:**

(a) Predefined alias for this package is as follows.

Alias NC := $apcocoa/ncpoly;

(b) The very first step to use functions in this package is to set non-commutative polynomial ring environment via the command

Use

For instance, the following command

Use QQ[x[1..2],y[1..2]];

sets the ring to be the non-commutative polynomial ring generated by `{x[1],x[2],y[1],y[2]}` over the rational numbers. Note that, for the time being, the package only supports non-commutative polynomial rings over the rational field `QQ` and finite fields `ZZ/(p)` where `p` is a prime.

(c) The word ordering is set via the function

NC.SetOrdering(Ordering)

where the parameter `Ordering` is a STRING indicating which ordering we are working with. Note that word orderings are induced by the order of indeterminates. And, for the time being, the package supports the following word orderings, and among which "LLEX" is the default ordering.

(b1) "LLEX": the *length-lexicographic ordering*

(b2) "ELIM": an *elimination ordering*

(b3) "LRLEX": the *length-reverse-lexicographic ordering*

(b4) "DEGREVLEX": the *degree-reverse-lexicographic ordering*

For instance, the following commands

Use ZZ/(2)[a,b,c,d];

NC.SetOrdering("LLEX");

define the non-commutative polynomial ring generated by `{a,b,c,d}` over the binary field `{0,1}`, and set the word ordering to be the length-lexicographic ordering induced by `a>b>c>d`.

(d) One can use the function

NC.RingEnv();

to get basic information on the working polynomial ring.

**Representation of non-commutative polynomials in this package:**

It is tricky to represent a non-commutative polynomial. In the package, every polynomial is represented as a LIST of LISTs, and each element in every inner LIST involves only one indeterminate or none (a constant). A polynomial represented in this way is said to be in the *CoCoAL format*. For instance, the polynomial

`f=2x[2]y[1]x[2]^2-9y[2]x[1]^2x[2]^3+5`

is represented as

[[2x[1],y[1],x[2]^2], [-9y[2],x[1]^2,x[2]^3], [5]].

Note that functions in this package are using the **ApCoCoAServer**. In the ApCoCoAServer (developed in C++), every polynomial is also presented as a LIST of LISTs, and each inner LIST contains a coefficient and a LIST of indices of indeterminates. A polynomial represented in this way is said to be in the *C format*. For instance, assume that the working ring is

Use QQ[x[1..2],y[1..2]];

then, indeterminates `x[1],x[2],y[1],y[2]` are indexed by `1,2,3,4`, respectively. Thus, polynomial `f` is represented in the C format as

[[2, [1, 3, 2, 2]], [-9, [4, 1, 1, 2, 2, 2]], [5, []]].

Two representations can be converted to each other via the functions

NC.CoCoALToC(F); and NC.CToCoCoAL(F);

## Pages in category "ApCoCoA-1:Package ncpoly"

The following 24 pages are in this category, out of 24 total.

### N

- ApCoCoA-1:NC.Add
- ApCoCoA-1:NC.AdMatrix
- ApCoCoA-1:NC.CoCoALToC
- ApCoCoA-1:NC.CToCoCoAL
- ApCoCoA-1:NC.Deg
- ApCoCoA-1:NC.FindPolys
- ApCoCoA-1:NC.GB
- ApCoCoA-1:NC.HF
- ApCoCoA-1:NC.Interreduction
- ApCoCoA-1:NC.Intersection
- ApCoCoA-1:NC.IsFinite
- ApCoCoA-1:NC.IsGB
- ApCoCoA-1:NC.IsHomog
- ApCoCoA-1:NC.KernelOfHomomorphism
- ApCoCoA-1:NC.LC
- ApCoCoA-1:NC.LW
- ApCoCoA-1:NC.LWIdeal
- ApCoCoA-1:NC.MB
- ApCoCoA-1:NC.Mul
- ApCoCoA-1:NC.NR
- ApCoCoA-1:NC.RedGB
- ApCoCoA-1:NC.SetOrdering
- ApCoCoA-1:NC.Sub
- ApCoCoA-1:NC.TruncatedGB