java.lang.Object
- com.singularsys.extensions.matrix.genericmat.GenericMatrixField<E>
- - com.singularsys.extensions.matrix.genericmat.GenericFieldMatrixField<E>

Type Parameters:

E - base type for elements

All Implemented Interfaces:

FieldI, IntegerConvertor, MatrixFieldI, JepComponent, java.io.Serializable
```
public class GenericFieldMatrixField<E>
extends GenericMatrixField<E>
```
A MatrixField where the elements of the matrices and vectors are of type E and the evaluation is carried out using a GenericPowerField of type E. Generally there is no need to provide a concrete subclass just using
```
 RationalField rf = new RationalField();
 MatrixFactoryI mfact
     = new GenericMatrixFactory<>(rf);
 MatrixFieldI mfield = new GenericFieldMatrixField<>(mfact,rf);
 
```
A concrete implementation would just need to provide a constructor. An example use is at RationalMatrixTest2.
Since:

Jep 3.5 / Extensions 2.0

See Also:

GenericMatrixFactory, Serialized Form

Field Summary

Fields
Modifier and Type Field Description

protected GenericField<E> base
- Fields inherited from class com.singularsys.extensions.matrix.genericmat.GenericMatrixField
  mf

Constructor Summary

Constructors
Constructor	Description
`GenericFieldMatrixField(GenericMatrixFactory<E> mf, GenericField<E> base)`	Standard constructor.
`GenericFieldMatrixField(GenericMatrixFactory<E> mf, GenericPowerField<E> base, boolean skipElements)`	Constructor where operations on the base field can be switched off.
`GenericFieldMatrixField(MatrixFactoryI mf, GenericField<E> base)`	Constructor which is easier to use, but has an unchecked cast.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`protected E`	`addEle(E l, E r)`	Adds two elements of the vector/matrix
`protected java.lang.Boolean`	`andEle(E l, E r)`
`java.lang.Object`	`convertFromInt(java.lang.Integer l)`	Attempt to convert argument from an integer
`java.lang.Integer`	`convertToInt(java.lang.Object l)`	Attempt to convert argument to an integer
`protected E`	`divEle(E l, E r)`
`protected java.lang.Boolean`	`eqEle(E l, E r)`
`java.lang.Boolean`	`geEle(E l, E r)`
`JepComponent`	`getLightWeightInstance()`	Returns this
`E`	`getOne()`	Get the multiplicative identity for this field.
`E`	`getZero()`	Get the additive identity for this field
`java.lang.Boolean`	`gtEle(E l, E r)`
`java.lang.Boolean`	`leEle(E l, E r)`
`java.lang.Boolean`	`ltEle(E l, E r)`
`protected E`	`modEle(E l, E r)`
`protected E`	`mulEle(E l, E r)`
`java.lang.Boolean`	`neEle(E l, E r)`
`protected E`	`negEle(E l)`
`protected java.lang.Boolean`	`notEle(E l)`
`protected java.lang.Boolean`	`orEle(E l, E r)`
`protected E`	`powEle(E l, E r)`
`protected E`	`subEle(E l, E r)`

Methods inherited from class com.singularsys.extensions.matrix.genericmat.GenericMatrixField
add, add, add, and, calcSize, cmpSize, cross, cross, det, det, div, div, div, dot, dot, eq, eq, eq, ge, gt, init, inv, invMat, le, lt, minor, mod, mul, mul, mul, mul, mul, mul, mul, ne, neg, neg, neg, not, or, pow, solve, solveMM, solveMV, sub, sub, sub, subtractMul, swapRows, trace, trace, trans, trans

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - base
```
protected GenericField<E> base
```
- Constructor Detail
  - GenericFieldMatrixField
```
public GenericFieldMatrixField(GenericMatrixFactory<E> mf,
                               GenericField<E> base)
```
    Standard constructor.
    
    Parameters:
    
    mf - The factory used to generate matrices
    
    base - base field for calculations on elements
  - GenericFieldMatrixField
```
public GenericFieldMatrixField(MatrixFactoryI mf,
                               GenericField<E> base)
```
    Constructor which is easier to use, but has an unchecked cast. Use the GenericFieldMatrixField(GenericMatrixFactory, GenericPowerField, boolean) constructor to ensure type safety.
    
    Parameters:
    
    mf -
    
    base -
  - GenericFieldMatrixField
```
public GenericFieldMatrixField(GenericMatrixFactory<E> mf,
                               GenericPowerField<E> base,
                               boolean skipElements)
```
    Constructor where operations on the base field can be switched off. By default the add operator will add vectors/matrices over a base field and also add elements in that field. So it will calculate (2,3)+(4,5) but also 6+7. Setting skipElements to true means that it will calculate (2,3)+(4,5) but return null if given 6+7. This will need to be specified by some other field. Its not intended to use this constructor but left here for case where it is needed.
    
    Parameters:
    
    mf - The factory used to generate matrices
    
    base - base field for calculations on elements
    
    skipElements - whether to skip operations on the base elements
- Method Detail
  - addEle
```
protected E addEle(E l,
                   E r)
            throws EvaluationException
```
    Description copied from class: GenericMatrixField
    
    Adds two elements of the vector/matrix
    
    Specified by:
    
    addEle in class GenericMatrixField<E>
    
    Parameters:
    
    l - lhs element
    
    r - rhs element
    
    Returns:
    
    their sum
    
    Throws:
    
    EvaluationException
  - subEle
```
protected E subEle(E l,
                   E r)
            throws EvaluationException
```
    Specified by:
    
    subEle in class GenericMatrixField<E>
    
    Throws:
    
    EvaluationException
  - negEle
```
protected E negEle(E l)
            throws EvaluationException
```
    Specified by:
    
    negEle in class GenericMatrixField<E>
    
    Throws:
    
    EvaluationException
  - mulEle
```
protected E mulEle(E l,
                   E r)
            throws EvaluationException
```
    Specified by:
    
    mulEle in class GenericMatrixField<E>
    
    Throws:
    
    EvaluationException
  - modEle
```
protected E modEle(E l,
                   E r)
            throws EvaluationException
```
    Specified by:
    
    modEle in class GenericMatrixField<E>
    
    Throws:
    
    EvaluationException
  - divEle
```
protected E divEle(E l,
                   E r)
            throws EvaluationException
```
    Specified by:
    
    divEle in class GenericMatrixField<E>
    
    Throws:
    
    EvaluationException
  - powEle
```
protected E powEle(E l,
                   E r)
            throws EvaluationException
```
    Specified by:
    
    powEle in class GenericMatrixField<E>
    
    Throws:
    
    EvaluationException
  - eqEle
```
protected java.lang.Boolean eqEle(E l,
                                  E r)
                           throws EvaluationException
```
    Specified by:
    
    eqEle in class GenericMatrixField<E>
    
    Throws:
    
    EvaluationException
  - neEle
```
public java.lang.Boolean neEle(E l,
                               E r)
                        throws EvaluationException
```
    Specified by:
    
    neEle in class GenericMatrixField<E>
    
    Throws:
    
    EvaluationException
  - gtEle
```
public java.lang.Boolean gtEle(E l,
                               E r)
                        throws EvaluationException
```
    Specified by:
    
    gtEle in class GenericMatrixField<E>
    
    Throws:
    
    EvaluationException
  - geEle
```
public java.lang.Boolean geEle(E l,
                               E r)
                        throws EvaluationException
```
    Specified by:
    
    geEle in class GenericMatrixField<E>
    
    Throws:
    
    EvaluationException
  - ltEle
```
public java.lang.Boolean ltEle(E l,
                               E r)
                        throws EvaluationException
```
    Specified by:
    
    ltEle in class GenericMatrixField<E>
    
    Throws:
    
    EvaluationException
  - leEle
```
public java.lang.Boolean leEle(E l,
                               E r)
                        throws EvaluationException
```
    Specified by:
    
    leEle in class GenericMatrixField<E>
    
    Throws:
    
    EvaluationException
  - andEle
```
protected java.lang.Boolean andEle(E l,
                                   E r)
                            throws EvaluationException
```
    Specified by:
    
    andEle in class GenericMatrixField<E>
    
    Throws:
    
    EvaluationException
  - orEle
```
protected java.lang.Boolean orEle(E l,
                                  E r)
                           throws EvaluationException
```
    Specified by:
    
    orEle in class GenericMatrixField<E>
    
    Throws:
    
    EvaluationException
  - notEle
```
protected java.lang.Boolean notEle(E l)
                            throws EvaluationException
```
    Specified by:
    
    notEle in class GenericMatrixField<E>
    
    Throws:
    
    EvaluationException
  - getZero
```
public E getZero()
```
    Description copied from interface: FieldI
    
    Get the additive identity for this field
    
    Specified by:
    
    getZero in interface FieldI
    
    Specified by:
    
    getZero in class GenericMatrixField<E>
    
    Returns:
    
    object representing zero or null if undefined for this field
  - getOne
```
public E getOne()
```
    Description copied from interface: FieldI
    
    Get the multiplicative identity for this field.
    
    Specified by:
    
    getOne in interface FieldI
    
    Specified by:
    
    getOne in class GenericMatrixField<E>
    
    Returns:
    
    object representing one or null if undefined for this field
  - convertFromInt
```
public java.lang.Object convertFromInt(java.lang.Integer l)
                                throws EvaluationException
```
    Description copied from interface: IntegerConvertor
    
    Attempt to convert argument from an integer
    
    Parameters:
    
    l - value to convert
    
    Returns:
    
    corresponding value in this field or null if it cannot be converted
    
    Throws:
    
    EvaluationException - probably never
  - convertToInt
```
public java.lang.Integer convertToInt(java.lang.Object l)
                               throws EvaluationException
```
    Description copied from interface: IntegerConvertor
    
    Attempt to convert argument to an integer
    
    Parameters:
    
    l - value to convert
    
    Returns:
    
    corresponding integer or null if it cannot be converted
    
    Throws:
    
    EvaluationException - on error
  - getLightWeightInstance
```
public JepComponent getLightWeightInstance()
```
    Returns this
    
    Specified by:
    
    getLightWeightInstance in interface JepComponent
    
    Overrides:
    
    getLightWeightInstance in class GenericMatrixField<E>
    
    Returns:
    
    either an new instance, null or 'this'.

Class GenericFieldMatrixField<E>

Field Summary

Fields inherited from class com.singularsys.extensions.matrix.genericmat.GenericMatrixField

Constructor Summary

Method Summary

Methods inherited from class com.singularsys.extensions.matrix.genericmat.GenericMatrixField

Methods inherited from class java.lang.Object

Field Detail

base

Constructor Detail

GenericFieldMatrixField

GenericFieldMatrixField

GenericFieldMatrixField

Method Detail

addEle

subEle

negEle

mulEle

modEle

divEle

powEle

eqEle

neEle

gtEle

geEle

ltEle

leEle

andEle

orEle

notEle

getZero

getOne

convertFromInt

convertToInt

getLightWeightInstance