ApCoCoALib:RingF4

From ApCoCoAWiki
Revision as of 17:09, 6 March 2008 by Dheldt (talk | contribs) (initial push in.)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

User documentation for files RingF4.C and RingF4.H

These files contain an implementation of the field with 4 elements. The fields representation is ((Z/(2))[x])/(x^2 + x +1).

Internally, the fields elements are stored as numbers (unsigned char's, to be specific). These numbers, interpreted as bit-streams, correspond to the univariate polynomial's sequence of coefficients. For example

3 = 1* 2^1 + 1*2^0 <-> (11)
    <->  1*x^1 + 1*x^0 =  x + 1

So the field element x + 1 is internally stored as '3'.

An instance of RingF14can be created via

  CoCoA::ring R = ApCoCoA::AlgebraicCore::NewRingF4();

To see if a given CoCoA::ring R is an instance of RingF4 you can check

  bool b = ApCoCoa::AlgebraicCore::IsRingF4(R);

Furthermore, any instance of RingF16 can be used like any other ring in CoCoA. To create an element proceed as follows:

  CoCoA::ring R = ApCoCoA::AlgebraicCore::NewRingF4();
  CoCoA::RingElem e(r,3);

and e represents the ring element 'x+1' or equivalently '3'. A warning: adding the element '3' to the element '2' does NOT lead to the element '5', since '3' <-> 'x+1', '2' <-> 'x' and (x+1) + (x) = 1 <-> '1'. Some more details on how elements can be stored and retrieved from this ring can be found in the example ex-RingF16.C in ApCoCoALib's example directory.

Maintainer documentation for files RingF4.C and RingF4.H

Currently, this fields uses 'semi-logarithmic' multiplication and division matrixes. This means both matrices are of size 2 times 4.

To multiply a and b, we split a into its exponents (a_0,a_1) and XOR the elements {m_(i,b) | i=0,..1, a_i =1 } of the multiplication matrix.

To divide a through b, we again split a like above and XOR the elements {d_(i,b) | i=0,..1, a_i =1 } of the division matrix.

Other options would be the usage of a logarithmic matrices or two 'full' 4 times 4 matrices. So we have to make a decision between XOR operations and memory usage. Which of this versions is optimal has to be checked for different problem settings. Since a 2 times 4 matrix of unsigned chars is rather small, here do not occur any paging conflicts, but eventually a 4 times 4 matrix could be more efficient.

Bugs, Shortcomings and other ideas

The current implementation does not support a lot of intractability with other rings. A set of Ringhomomorphisms could be implemented to allow a more easy switch between other representations of F_4 or to map elements in Z[x] or Z/(2)[x] into F_4.

References

[http://apcocoa.org/wiki/ApCoCoA:Representation_of_finite_fields] - more information on the representation of finite fields..

[http://apcocoa.org/wiki/HowTo:Construct_fields] - a description, how the multiplication / division matrices were constructed, including the needed source-code / tools.