com.itemanalysis.psychometrics.data

Class VariableAttributes

java.lang.Object

com.itemanalysis.psychometrics.data.VariableAttributes

All Implemented Interfaces:

java.lang.Comparable<VariableAttributes>

public class VariableAttributes
extends java.lang.Object
implements java.lang.Comparable<VariableAttributes>

This class holds descriptive information about the variables in the database. It corresponds to entries in the Variable View of the graphical user interface. It also serves as a wrapper to the DefaultItemScoring object.

Constructor Summary

Constructors

Constructor and Description
VariableAttributes(java.lang.String variableName, int order)
VariableAttributes(java.lang.String name, java.lang.String label, ItemType itemType, DataType dataType, int order, java.lang.String itemGroup)
VariableAttributes(VariableName variableName, int order)
VariableAttributes(VariableName variableName, VariableLabel variableLabel, DataType dataType, int order)
VariableAttributes(VariableName variableName, VariableLabel variableLabel, ItemType itemType, DataType dataType, int order, java.lang.String itemGroup)

Method Summary

Modifier and Type	Method and Description
void	addAllCategories(java.lang.String optionScoreKey)
void	clearCategory()
int	compareTo(VariableAttributes o) compare by item name.
double	computeItemScore(double response)
double	computeItemScore(int response)
double	computeItemScore(java.lang.String response) First checks for missing data.
boolean	equals(java.lang.Object o)
java.lang.String[]	getAttributeArray()
java.lang.String	getDatabaseTypeString() For use when creating database columns from this object
DataType	getDataType()
java.lang.String	getItemGroup()
ItemScoring	getItemScoring()
ItemType	getItemType()
VariableLabel	getLabel()
java.lang.Double	getMaximumPossibleItemScore()
double	getMaxItemScore()
double	getMinimumPossibleItemScore()
VariableName	getName()
SpecialDataCodes	getSpecialDataCodes()
java.lang.String	getSubscale(boolean useItemNameWhenEmpty) This version of getItemGroup is needed for com.itemanalysis.psychometrics.rasch.JMLE.
int	getTestItemOrder()
VariableType	getType()
int	getVarcharSize()
int	hashCode()
boolean	hasScoring()
boolean	isMissing(java.lang.String response)
int	positionInDb() Mostly used for ordering variables according to their order in the database or result set
java.lang.String	printAttributes()
java.lang.String	printOptionScoreKey()
double[]	scoreArray()
void	setDataType(DataType dataType)
void	setItemGroup(java.lang.String itemGroup)
void	setItemScoring(ItemScoring itemScoring)
void	setItemType(ItemType itemType)
void	setLabel(java.lang.String label)
void	setName(VariableName name)
void	setSpecialDataCodes(SpecialDataCodes specialDataCodes)
void	setTestItemOrder(int testItemOrder)
void	setVarcharSize(int varcharSize)
java.lang.String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

VariableAttributes

public VariableAttributes(java.lang.String name,
                          java.lang.String label,
                          ItemType itemType,
                          DataType dataType,
                          int order,
                          java.lang.String itemGroup)

Parameters:

name - name of variable

label - label for variable

itemType - type of item (see VariableType class)

dataType - type of data (see VariableType class)

order - column position of teh variable in the database

itemGroup - a code indicating the item group to which the item belongs

VariableAttributes

public VariableAttributes(VariableName variableName,
                          VariableLabel variableLabel,
                          ItemType itemType,
                          DataType dataType,
                          int order,
                          java.lang.String itemGroup)

VariableAttributes

public VariableAttributes(VariableName variableName,
                          VariableLabel variableLabel,
                          DataType dataType,
                          int order)

VariableAttributes

public VariableAttributes(VariableName variableName,
                          int order)

VariableAttributes

public VariableAttributes(java.lang.String variableName,
                          int order)

Method Detail

getName

public VariableName getName()

Returns:

name of variable

setName

public void setName(VariableName name)

getLabel

public VariableLabel getLabel()

setLabel

public void setLabel(java.lang.String label)

getType

public VariableType getType()

getDataType

public DataType getDataType()

getItemType

public ItemType getItemType()

setItemType

public void setItemType(ItemType itemType)

setDataType

public void setDataType(DataType dataType)

hasScoring

public boolean hasScoring()

setItemScoring

public void setItemScoring(ItemScoring itemScoring)

positionInDb

public int positionInDb()

Mostly used for ordering variables according to their order in the database or result set

Returns:

getItemGroup

public java.lang.String getItemGroup()

setSpecialDataCodes

public void setSpecialDataCodes(SpecialDataCodes specialDataCodes)

isMissing

public boolean isMissing(java.lang.String response)

computeItemScore

public double computeItemScore(java.lang.String response)

First checks for missing data. If missing then the missing response is scored. Otherwise, an item score is computed. IF the item scoring object it is assumed that the data are already scored and are integers. It will parse the response as an integer and return it. If the response is a String and no scoring or special data codes are associated with it, then a NumberFormatException will occur.

Parameters:

response - an item response.

Returns:

a score for the response

computeItemScore

public double computeItemScore(double response)

computeItemScore

public double computeItemScore(int response)

getMaxItemScore

public double getMaxItemScore()

getAttributeArray

public java.lang.String[] getAttributeArray()

getSubscale

public java.lang.String getSubscale(boolean useItemNameWhenEmpty)

This version of getItemGroup is needed for com.itemanalysis.psychometrics.rasch.JMLE. Items that have no itemGroup are treated as their own itemGroup. Therefore, when useItemNameWhenEmpty is true, the item name will be used as the itemGroup ID so that each item has its own itemGroup.

Parameters:

useItemNameWhenEmpty -

Returns:

setItemGroup

public void setItemGroup(java.lang.String itemGroup)

setTestItemOrder

public void setTestItemOrder(int testItemOrder)

getTestItemOrder

public int getTestItemOrder()

setVarcharSize

public void setVarcharSize(int varcharSize)

getVarcharSize

public int getVarcharSize()

getDatabaseTypeString

public java.lang.String getDatabaseTypeString()

For use when creating database columns from this object

Returns:

compareTo

public int compareTo(VariableAttributes o)

compare by item name.

Specified by:

compareTo in interface java.lang.Comparable<VariableAttributes>

Parameters:

o - another VariableInfo object

Returns:

equals

public boolean equals(java.lang.Object o)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

getSpecialDataCodes

public SpecialDataCodes getSpecialDataCodes()

printAttributes

public java.lang.String printAttributes()

addAllCategories

public void addAllCategories(java.lang.String optionScoreKey)

getItemScoring

public ItemScoring getItemScoring()

getMinimumPossibleItemScore

public double getMinimumPossibleItemScore()

getMaximumPossibleItemScore

public java.lang.Double getMaximumPossibleItemScore()

clearCategory

public void clearCategory()

scoreArray

public double[] scoreArray()

printOptionScoreKey

public java.lang.String printOptionScoreKey()