Difference between revisions of "ApCoCoA-1:NC.Add"
| Line 13: | Line 13: | ||
<item>@param <em>F1</em>: left operand of addition operator. It is a polynomial in <tt>K<X></tt>. Each polynomial in <tt>K<X></tt> is represented as a LIST of LISTs, which are pairs of form <tt>[c, w]</tt> where <tt>c</tt> is in <tt>K</tt> and <tt>w</tt> is a word in <tt>X*</tt>. Unit in <tt>X*</tt> is empty word represented as an empty STRING <quotes></quotes>. 0 polynomial is represented as an empty LIST <tt>[]</tt>. For example, polynomial <tt>F:=xy-y+1</tt> in <tt>K<x,y></tt> is represented as <tt>F:=[[1,<quotes>xy</quotes>], [-1, <quotes>y</quotes>], [1,<quotes></quotes>]]</tt>.</item> | <item>@param <em>F1</em>: left operand of addition operator. It is a polynomial in <tt>K<X></tt>. Each polynomial in <tt>K<X></tt> is represented as a LIST of LISTs, which are pairs of form <tt>[c, w]</tt> where <tt>c</tt> is in <tt>K</tt> and <tt>w</tt> is a word in <tt>X*</tt>. Unit in <tt>X*</tt> is empty word represented as an empty STRING <quotes></quotes>. 0 polynomial is represented as an empty LIST <tt>[]</tt>. For example, polynomial <tt>F:=xy-y+1</tt> in <tt>K<x,y></tt> is represented as <tt>F:=[[1,<quotes>xy</quotes>], [-1, <quotes>y</quotes>], [1,<quotes></quotes>]]</tt>.</item> | ||
<item>@param <em>F2</em>: right operand of addition operator. It is a polynomial in <tt>K<X></tt>.</item> | <item>@param <em>F2</em>: right operand of addition operator. It is a polynomial in <tt>K<X></tt>.</item> | ||
| − | <item>@return: a LIST which represents | + | <item>@return: a LIST which represents polynomial <tt>F1+F2</tt>.</item> |
</itemize> | </itemize> | ||
<example> | <example> | ||
| Line 59: | Line 59: | ||
<see>NC.Multiply</see> | <see>NC.Multiply</see> | ||
<see>NC.NR</see> | <see>NC.NR</see> | ||
| + | <see>NC.SetFp</see> | ||
| + | <see>NC.SetOrdering</see> | ||
| + | <see>NC.SetRelations</see> | ||
| + | <see>NC.SetRules</see> | ||
| + | <see>NC.SetX</see> | ||
<see>NC.Subtract</see> | <see>NC.Subtract</see> | ||
| + | <see>NC.UnsetFp</see> | ||
| + | <see>NC.UnsetOrdering</see> | ||
| + | <see>NC.UnsetRelations</see> | ||
| + | <see>NC.UnsetRules</see> | ||
| + | <see>NC.UnsetX</see> | ||
<see>Gbmr.MRSubtract</see> | <see>Gbmr.MRSubtract</see> | ||
<see>Gbmr.MRMultiply</see> | <see>Gbmr.MRMultiply</see> | ||
Revision as of 12:48, 17 July 2010
NC.Add
Addition of two polynomials over a free associative K-algebra.
Syntax
NC.Add(F1:LIST, F2:LIST):LIST
Description
Please note: The function(s) explained on this page is/are using the ApCoCoAServer. You will have to start the ApCoCoAServer in order to use it/them.
Before calling the function, please set ring environment coefficient field (K), alphabet (X) and ordering through the functions NC.SetFp(Prime) (or NC.UnsetFp()), NC.SetX(X) and NC.SetOrdering(Ordering) respectively. Default coefficient field is Q. Default ordering is length-lexicographic ordering ("LLEX"). For more information, please check the relevant functions.
@param F1: left operand of addition operator. It is a polynomial in K<X>. Each polynomial in K<X> is represented as a LIST of LISTs, which are pairs of form [c, w] where c is in K and w is a word in X*. Unit in X* is empty word represented as an empty STRING "". 0 polynomial is represented as an empty LIST []. For example, polynomial F:=xy-y+1 in K<x,y> is represented as F:=[[1,"xy"], [-1, "y"], [1,""]].
@param F2: right operand of addition operator. It is a polynomial in K<X>.
@return: a LIST which represents polynomial F1+F2.
Example
NC.SetX(<quotes>abc</quotes>); NC.SetOrdering(<quotes>ELIM</quotes>); F1 := [[1,<quotes>a</quotes>],[1,<quotes></quotes>]]; F2 := [[1,<quotes>b</quotes>],[1,<quotes>ba</quotes>]]; NC.Add(F1,F2); -- computation over Q [[1, <quotes>ba</quotes>], [1, <quotes>a</quotes>], [1, <quotes>b</quotes>], [1, <quotes></quotes>]] ------------------------------- NC.RingEnv(); Coefficient ring : Q (float type in C++) Alphabet : abc Ordering : ELIM ------------------------------- NC.SetFp(); -- default Fp = F2 NC.RingEnv(); Coefficient ring : Fp = Z/(2) Alphabet : abc Ordering : ELIM ------------------------------- NC.Add(F1,F2); -- computation over F2 [[1, <quotes>ba</quotes>], [1, <quotes>a</quotes>], [1, <quotes>b</quotes>], [1, <quotes></quotes>]] ------------------------------- NC.Add(F1,F1); -- computation over F2 [ ] ------------------------------- NC.UnsetFp(); -- set the coefficient field back to Q NC.RingEnv(); Coefficient ring : Q (float type in C++) Alphabet : abc Ordering : ELIM -------------------------------
See also
