ABLE 2.0.0 07/02/2003 10:25:01

com.ibm.able.data
Class AbleDiscreteField

java.lang.Object
  |
  +--com.ibm.able.data.AbleLhs
        |
        +--com.ibm.able.data.AbleVariable
              |
              +--com.ibm.able.data.AbleGenericVariable
                    |
                    +--com.ibm.able.data.AbleTypedVariable
                          |
                          +--com.ibm.able.data.AbleDiscreteVariable
                                |
                                +--com.ibm.able.data.AbleDiscreteField
All Implemented Interfaces:
AbleField, AbleRd, AbleWr, java.io.Serializable

public class AbleDiscreteField
extends AbleDiscreteVariable
implements AbleField

Discrete fields are numeric fields with a finite set of possible values.

See Also:
Serialized Form

Field Summary
protected  int column
          An index representing this field's position in a record.
protected  double max
          The maximum of the allowed values for this field.
protected  double mean
          The mean of the allowed values for this field.
protected  double min
          The minimum of the allowed values for this field.
protected  java.util.Hashtable table
          A Hashtable where the key is an Integer value representing an element in a dictionary; the object is one valid discrete value in String form.
protected  int usage
          Values representing input, output, or ignore.
 
Fields inherited from class com.ibm.able.data.AbleDiscreteVariable
myInitialValue, myMaxValue, myMaxValueKnown, myMinValue, myMinValueKnown, myValue, myValueList
 
Fields inherited from class com.ibm.able.data.AbleTypedVariable
myDataTypeClass, myDataTypeClassName, myDataTypeName, myInitialParms
 
Fields inherited from class com.ibm.able.data.AbleVariable
myBoundFlag, myChgSupport, myComment, myContext, myDataType, myGlobalFlag, myId, myName, myPrompt, myReferences, myStaticFlag, myTemplateFlag, myValueInitial
 
Constructor Summary
AbleDiscreteField(AbleFieldDefinition def)
          Construct a Discrete field.
 
Method Summary
 void computeStatistics(java.lang.Object inValue)
          Add unique discrete values to a symbol table and maintain a dictionary of legal values as well as the field minimum and maxium.
static java.lang.String Copyright()
          Determine the copyright of this class.
 int getColumn()
          Get the column index position of this field in a record.
 java.lang.String getDataTypeString()
          Get the data type of this field as a string - "continuous" for example.
 AbleTranslateTemplate getInputTranslateTemplate()
          Provide an input translate template for this field.
 java.util.Map getMap()
          Get the Map of all unique values that are possible for this field.
 int getNormalizedSize()
          Return the number of unique categories for 1 of N code.
 double getNumericValue(java.lang.Object inValue)
          Translate a value into an index in the dictionary.
 AbleTranslateTemplate getOutputTranslateTemplate()
          Provide an output translate template for this field.
 int getUsage()
          Get the usage type of this field - "input" for example.
 java.lang.String getUsageString()
          Get the usage type of this field as a string - "input" for example.
 void setColumn(int col)
          Set the index position in the record, based on field definition order.
 void setUsage(java.lang.String usage)
          Set the usage type of this from a string - "input" for example.
 
Methods inherited from class com.ibm.able.data.AbleDiscreteVariable
addValue, arlDclString, asgnEq, cmpEq, cmpGt, cmpGtEq, cmpLt, cmpLtEq, cmpNeq, getBooleanValue, getDataTypeClass, getDataTypeClassName, getFuzzyValue, getGenericValue, getIndexOf, getLiteralClass, getMaxValue, getMinValue, getNumericValue, getRawValue, getStringValue, getValue, getValueAt, getValueList, getValueListSize, getValueString, init, removeValue, reset, setBooleanValue, setFuzzyValue, setGenericValue, setInitialValue, setNumericValue, setStringValue, setValue, setValueList, setValueString, toString, traceString, valueExist, xmlDclString
 
Methods inherited from class com.ibm.able.data.AbleTypedVariable
getDataTypeName, setRawValue
 
Methods inherited from class com.ibm.able.data.AbleGenericVariable
cmpIs, compDivide, compMinus, compMultiply, compPlus, compUnaryMinus, replaceValues
 
Methods inherited from class com.ibm.able.data.AbleVariable
arlCRdString, arlInitializerString, getArlComment, getChgSupport, getComment, getContext, getDataType, getDataTypeAsString, getId, getName, getPrompt, getPromptString, getReferences, getReferent, getReferents, getTemplateString, isBound, isConstant, isGlobal, isLocal, isStatic, isTemplate, notStatic, setChgSupport, setComment, setContext, setId, setPrompt, setReferences, setStatic, setTemplate, xmlCRdString, xmlCWrString, xmlInitializerString
 
Methods inherited from class com.ibm.able.data.AbleLhs
asgnIs, asgnIs, bitwiseAND, bitwiseNOT, bitwiseOR, bitwiseShiftLeft, bitwiseShiftRight, bitwiseShiftRightZeroFill, bitwiseXOR, compModulo, logicalAND, logicalNOT, logicalOR
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 
Methods inherited from interface com.ibm.able.data.AbleField
getName, getStringValue
 

Field Detail

usage

protected int usage
Values representing input, output, or ignore.

column

protected int column
An index representing this field's position in a record.

min

protected double min
The minimum of the allowed values for this field.

max

protected double max
The maximum of the allowed values for this field.

mean

protected double mean
The mean of the allowed values for this field.

table

protected java.util.Hashtable table
A Hashtable where the key is an Integer value representing an element in a dictionary; the object is one valid discrete value in String form.
Constructor Detail

AbleDiscreteField

public AbleDiscreteField(AbleFieldDefinition def)
Construct a Discrete field. Must call setColumn to set the position in the record.
Parameters:
def - An AbleFieldDefinition which provides the name and usage for this field.
Method Detail

computeStatistics

public void computeStatistics(java.lang.Object inValue)
Add unique discrete values to a symbol table and maintain a dictionary of legal values as well as the field minimum and maxium. This is used to create symbol tables for translate filters.
Specified by:
computeStatistics in interface AbleField

getNumericValue

public double getNumericValue(java.lang.Object inValue)
Translate a value into an index in the dictionary. The first dictionary element has numeric value 1. Useful for converting to one-of-N code.
Specified by:
getNumericValue in interface AbleField
Returns:
An index position in the range of 1 to N. A value of 0 indicates the value is absent.

getNormalizedSize

public int getNormalizedSize()
Return the number of unique categories for 1 of N code.
Specified by:
getNormalizedSize in interface AbleField

getInputTranslateTemplate

public AbleTranslateTemplate getInputTranslateTemplate()
Provide an input translate template for this field.
  • if the field usage is input, scale from 0.0 to 1.0 using the mean as the midpoint of the scale.
  • if the field usage is output, create a one of N code.
  • if the field usage is ignore, then ignore it.
    Specified by:
    getInputTranslateTemplate in interface AbleField
    Returns:
    the fully configured AbleTranslateTemplate.

  • getOutputTranslateTemplate

    public AbleTranslateTemplate getOutputTranslateTemplate()
    Provide an output translate template for this field.
    Specified by:
    getOutputTranslateTemplate in interface AbleField
    Returns:
    the fully configured AbleTranslateTemplate if usage is output, and null otherwise.

    setColumn

    public void setColumn(int col)
    Description copied from interface: AbleField
    Set the index position in the record, based on field definition order.
    Specified by:
    setColumn in interface AbleField

    getColumn

    public int getColumn()
    Description copied from interface: AbleField
    Get the column index position of this field in a record.
    Specified by:
    getColumn in interface AbleField

    getDataTypeString

    public java.lang.String getDataTypeString()
    Description copied from interface: AbleField
    Get the data type of this field as a string - "continuous" for example. Data types are listed in AbleData.DataType(int).
    Specified by:
    getDataTypeString in interface AbleField

    getUsageString

    public java.lang.String getUsageString()
    Description copied from interface: AbleField
    Get the usage type of this field as a string - "input" for example. Usage types are listed in AbleData.UsageType(java.lang.String).
    Specified by:
    getUsageString in interface AbleField

    getUsage

    public int getUsage()
    Description copied from interface: AbleField
    Get the usage type of this field - "input" for example. Usage types are listed in AbleData.UsageType(java.lang.String).
    Specified by:
    getUsage in interface AbleField

    setUsage

    public void setUsage(java.lang.String usage)
    Description copied from interface: AbleField
    Set the usage type of this from a string - "input" for example. Usage types are listed in AbleData.UsageType(java.lang.String).
    Specified by:
    setUsage in interface AbleField

    getMap

    public java.util.Map getMap()
    Description copied from interface: AbleField
    Get the Map of all unique values that are possible for this field. The Map's key should be a string representation of an integer, and the object should be the value itself. Fields which do not have a unique number of values should return null.
    Specified by:
    getMap in interface AbleField

    Copyright

    public static java.lang.String Copyright()
    Determine the copyright of this class.
    Returns:
    A String containing this class's copyright statement.


    ABLE 2.0.0 07/02/2003 10:25:01

    (C) Copyright IBM Corporation 1999, 2003