JavaGrinders
Class NumberVariable

java.lang.Object
  java.util.AbstractCollection<E>
      java.util.AbstractList<E>
          java.util.Vector
              JavaGrinders.Variable
                  JavaGrinders.NumberVariable

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, java.lang.Iterable, java.util.Collection, java.util.List, java.util.RandomAccess

Direct Known Subclasses:

AngleVariable, IntegerVariable

public class NumberVariable
extends Variable
implements java.lang.Cloneable

handles things that a general variable containing numbers should do or know about. Based on a more generic Variable it supports ways to select rows using a variety of criteria, and reports descriptive (parametric) statistics. All numbers are stored and handled as Doubles.

See Also:

Serialized Form

Field Summary

java.lang.Object[]

validDataSorted

Fields inherited from class JavaGrinders.Variable

allData, autoExtracted, df, itsDescriptives, itsHighlitedColor, itsLineColor, itsLocationColor, rand

Fields inherited from class java.util.Vector

capacityIncrement, elementCount, elementData

Fields inherited from class java.util.AbstractList

modCount

Constructor Summary

NumberVariable(java.lang.String varName, VariableOrganizer theOwner)
Standard constructor for the root number Variable class using a VariableOrganizer

NumberVariable(java.lang.String varName, VariableOrganizer anOrganizer, double[] theData)
Standard constructor for the NumberVariable class using a double array of data

Method Summary

NumberVariable	absolute() set the value to its absolute value
NumberDescriptives	copyNumberDescriptives() returns descriptive Statistic for the variable using the currently selected set of rows
NumberVariable	distance(double theScalar) the absolute value after subtracting the constant from each value of the variable
void	doCorrelationAnalysis(NumberVariable theOtherYVariable) fills the regression statistics for the variable with control over th intercept
NumberVariable	doLinRegressionAnalysis(NumberVariable theXVariable) fills the regression statistics for the variable with control over the intercept
void	fillCompleteTerms(VariableOrganizer aXOrganizer, ANOVAResults theResults) fills the n-way interaction terms for the ANOVA
void	fillDescriptives(java.lang.Double hypMean) fills the descriptive circular statistics for the angle variable with a comparison to an external mean
void	fillWithFormula(java.lang.String aFormula) fills the variable with individual datavalues created through a formula
void	fillWithGaussRandom(double theMean, double theSD) fills the variable with random values from a Gaussian Distribution
void	fillWithParser(DataFileParser aParser, int varNum, boolean firstRowAsLabels) fills the variable with individual datavalues read from a textfile using a DataFileParser object
void	fillWithRandomFromDistribution(NumberVariable theDistribution) fills the variable with random values from a Gaussian Distribution
void	fillWithRowNum() fills the variable with individual datavalues created through a formula
void	fillWithUniformRandom() fills the variable with random values from a uniform distribution between 0 and 1
ANOVAResults	getANOVAResults(Variable theXVariable) fills the ANOVA statistics for the variable
ANOVAResults	getANOVAResults(VariableOrganizer aXOrganizer) fills the ANOVA statistics for a full factorial model
CorrelationResults	getAutoCorrelationResults() obtains the Autocorrelation statistics for the variable
CorrelationResults	getCorrelationResults(NumberVariable theOtherYVariable) fills the regression statistics for the variable with control over th intercept
NumberVariable	getDistancesToMean() returns a variable containing each values relative to its mean
Descriptives[]	getGroupDescriptives(Variable theXVariable) returns the descriptives for the groups identified by X
NumberVariable	getLinRegressionResiduals(NumberVariable theXVariable) fills the regression statistics for the variable with control over th intercept
RegressionResults	getLinRegressionResults(NumberVariable theXVariable) fills the regression statistics for the variable with control over the intercept
ANOVAResults	getManWhitneyUResults(Variable theXVar, double hypAngle) returns the results from an analysis of differences in mean angle distance from a hypothetical direction
double	getMaxValue() returns the maximum value stored in the Vector as a double
double	getMeanValue() returns the average for values stored in the Vector as a double
double	getMinValue() returns the minimum value stored in the Vector as a double
MultRegressionResults	getMultLinRegressionResults(VariableOrganizer theXVariableOrganizer) fills the regression statistics for the variable with control over the intercept
NumberDescriptives	getNumberDescriptives() fills the descriptive statistics for the variable and returns the results
double	getRange() returns the minimum value stored in the Vector as a double
NumberVariable	getRanks() return the ranks for the values in this array of the currently selected subset
double	getSDValue() returns the average for values stored in the Vector as a double
NumberVariable	getSignedRank(double CenterVal) returns the signed ranks of distances to the specified value
double	getSignedRankW(double CenterVal, boolean plus) fills the one-tailed sum of signed ranks
double	getSignedRankWProbability(double W) returns the one-tailed robability of obtaining this Signed Rank W or greater
SquaresCrossproducts	getSSCP(NumberVariable theXVariable) returns the sums of squares and crossproducts for the variable
double	getSumValue() returns the average for values stored in the Vector as a double
tTestResults	gettTestResults(double mean) obtains the t-Test results for the variable
double	gettValue(double hypMean) returns the average for values stored in the Vector as a double
double	getVarianceValue() returns the average for values stored in the Vector as a double
NumberVariable	getzTransform() returns a variable containing each values relative to its mean
void	invalidDescriptives() descriptive stats need to be updated
void	listCorrelationResults(NumberVariable theOtherYVariable) fills the regression statistics for the variable with control over th intercept
void	listGroupDescriptives(Variable theXVariable) lists the descriptives for the groups identified by X
void	listLinRegressionResults(NumberVariable theXVariable) fills the regression statistics for the variable with control over the intercept
void	listMultLinRegressionResults(VariableOrganizer theXVariableOrganizer) fills the regression statistics for the variable with control over the intercept
void	makeNewDescriptives() create a new set of descriptives for the variable the object
NumberVariable	multiply(double theScalar) multiplies the constant with each value of the variable
NumberVariable	multiply(NumberVariable theVar) multiplies the variable with the corresponding value of the other variable
NumberVariable	rank(boolean selectedOnly) rank the values in this array
void	selectAbove(double cutoffValue, boolean fromPrevSelected) select all rows with a value greater than the one provided
void	selectAboveEqual(double cutoffValue, boolean fromPrevSelected) select all rows with a value greater or equal than the one provided
void	selectBelow(double cutoffValue, boolean fromPrevSelected) select all rows with a value less than the one provided
void	selectBelowEqual(double cutoffValue, boolean fromPrevSelected) select all rows with a value less or equal than the one provided
void	selectEqual(double aValue, boolean fromPrevSelected) select all rows with a value greater or equal than the one provided
void	selectRange(double lowValue, double highValue, boolean fromPrevSelected) select all rows with a value between the lower and upper limits provided.
void	setContinuousType() sets the variable to type CONTINUOUS
NumberVariable	sign() returns the sign for each value of the variable
NumberVariable	subtract(double theScalar) subtracts the constant from each value of the variable

Methods inherited from class JavaGrinders.Variable

addValue, append, appendVariable, asJAMAMatrix, asVariableOrganizer, checkMatchingRows, checkMinUseRows, checkNumberIDs, checkSameIDs, checkSameSelectRows, checkSameSelectRows, checkSameUseRows, checkSameUseRows, checkValidRowRange, clone, cloneSelectedRowsOnly, cloneVariableFrom, combineSelectedWithSavedSelectedRows, copyDescriptives, copySelectStateFrom, customColorSelectedRows, deleteAllRows, deleteDuplicateRows, deleteMissingRows, deleteNonSelectedRows, deleteRow, deleteSelectedRows, deselectAllRows, fill, fill, fill, fill, fill, fill, fillDescriptives, fillIDs, fillWithParser, fillWithVariable, findFirstValidRow, findLastValidRow, findNextNonMissingRow, findNextValidRow, findNextValue, findPreviousValidRow, getabasedintValue, getAbasedintValue, getArray, getbooleanValue, getcharValue, getCombinedIDs, getCrossTabulation, getCrossTabulation, getCustomColorRow, getDescriptives, getdoubleArray, getdoubleValue, getfloatValue, getFrequencies, getHighliteColor, getHighlitedRow, getIDMap, getIDs, getIDString, getIDStrings, getInteractions, getintValue, getJaccard, getLineColor, getLocationColor, getlongValue, getManhattan, getMissingRow, getName, getNIDs, getNMissingRows, getNotes, getNRows, getNSelectRows, getNUseRows, getNValidRows, getOrganizer, getProximity, getProximity, getRandomValue, getRowOrder, getRowOrderRow, getSelectRow, getSquEuclidian, getStringArray, getStringValue, getTransitions, getUseRow, getValue, getVariableDesignRole, getVariableDesignRoleString, getVariableFormat, getVariableType, highliteSelectedRows, highliteSelectedRows, invertSelectedRows, isAngleType, isContinuousType, isLocationType, isLocked, isNominalType, isOrdinalType, isXVariable, isYVariable, listDescriptives, listDescriptives, listGroupDescriptivesNoDia, listRowOrder, listRows, listRows, listRows, listSelectedRows, listSelectState, listSelectState, listUseRows, makeTableSubSet, matchedIDs, replaceSelectedRows, restoreSelectedRows, restrictToMatchingUseRows, restrictToMatchingUseRows, restrictToValidRowsOnly, reverseRows, saveSelectedRows, selectAllRows, selectDuplicateRows, selectRows, selectUseRows, selectValue, setAnglesType, setCustomColorRow, setFormula, setHighliteColor, setHighlitedRow, setLineColor, setLocationColor, setLocationsType, setLock, setMissingRow, setName, setNominalType, setNotes, setNRows, setOrdinalType, setOrganizer, setRowOrder, setRowOrderRow, setSelectRow, setSelectRows, setSelectRowsToMissing, setValue, setValue, setValue, setValue, setValue, setValue, setVariableDesignRole, setVariableFormat, setVariableType, sort, sort, sort2, updateRowOrder

Methods inherited from class java.util.Vector

add, add, addAll, addAll, addElement, capacity, clear, contains, containsAll, copyInto, elementAt, elements, ensureCapacity, equals, firstElement, get, hashCode, indexOf, indexOf, insertElementAt, isEmpty, lastElement, lastIndexOf, lastIndexOf, remove, remove, removeAll, removeAllElements, removeElement, removeElementAt, removeRange, retainAll, set, setElementAt, setSize, size, subList, toArray, toArray, toString, trimToSize

Methods inherited from class java.util.AbstractList

iterator, listIterator, listIterator

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.List

iterator, listIterator, listIterator

Field Detail

validDataSorted

public java.lang.Object[] validDataSorted

Constructor Detail

NumberVariable

public NumberVariable(java.lang.String varName,
                      VariableOrganizer theOwner)
               throws java.lang.Exception

Standard constructor for the root number Variable class using a VariableOrganizer

Parameters:

varName - assigns a name (String) to the variable

theOwner - an instance of VariableOrganizer class coordinates a set of variables with respect to number of data points available and the rows that are currently selected

Throws:

java.lang.Exception

NumberVariable

public NumberVariable(java.lang.String varName,
                      VariableOrganizer anOrganizer,
                      double[] theData)
               throws java.lang.Exception

Standard constructor for the NumberVariable class using a double array of data

Parameters:

varName - assigns a name (String) to the variable

anOrganizer - an instance of VariableOrganizer class coordinates a set of variables with respect to number of data points available and the rows that are currently selected

theData - a double array of data

Throws:

java.lang.Exception

Method Detail

setContinuousType

public void setContinuousType()
                       throws java.lang.Exception

sets the variable to type CONTINUOUS

Throws:

java.lang.Exception

fillWithParser

public void fillWithParser(DataFileParser aParser,
                           int varNum,
                           boolean firstRowAsLabels)
                    throws java.lang.Exception

fills the variable with individual datavalues read from a textfile using a DataFileParser object

Overrides:

fillWithParser in class Variable

Parameters:

aParser - the DataFileParser that was used to read data values from a text file

varNum - marks the number of the column to be filled into the variable

firstRowAsLabels - whether the first row contains a variable label

Throws:

java.lang.Exception

fillWithUniformRandom

public void fillWithUniformRandom()
                           throws java.lang.Exception

fills the variable with random values from a uniform distribution between 0 and 1

Throws:

java.lang.Exception

fillWithGaussRandom

public void fillWithGaussRandom(double theMean,
                                double theSD)
                         throws java.lang.Exception

fills the variable with random values from a Gaussian Distribution

Parameters:

theMean - the mean for the gaussian distribution

theSD - the standard devaiation for the gaussian distribution

Throws:

java.lang.Exception

fillWithRandomFromDistribution

public void fillWithRandomFromDistribution(NumberVariable theDistribution)
                                    throws java.lang.Exception

fills the variable with random values from a Gaussian Distribution

Parameters:

theDistribution - a distribution from which to sample random numbers

Throws:

java.lang.Exception

fillWithFormula

public void fillWithFormula(java.lang.String aFormula)
                     throws java.lang.Exception

fills the variable with individual datavalues created through a formula

Parameters:

aFormula - the formula to use for filling the variable with values

Throws:

java.lang.Exception

fillWithRowNum

public void fillWithRowNum()
                    throws java.lang.Exception

fills the variable with individual datavalues created through a formula

Throws:

java.lang.Exception

selectEqual

public void selectEqual(double aValue,
                        boolean fromPrevSelected)
                 throws java.lang.Exception

select all rows with a value greater or equal than the one provided

Parameters:

aValue - lists the comparison value

fromPrevSelected - notes whether the search should only be performed on currently selected rows

Throws:

java.lang.Exception

selectAboveEqual

public void selectAboveEqual(double cutoffValue,
                             boolean fromPrevSelected)
                      throws java.lang.Exception

select all rows with a value greater or equal than the one provided

Parameters:

cutoffValue - lists the comparison value

fromPrevSelected - notes whether the search should only be performed on currently selected rows

Throws:

java.lang.Exception

selectAbove

public void selectAbove(double cutoffValue,
                        boolean fromPrevSelected)
                 throws java.lang.Exception

select all rows with a value greater than the one provided

Parameters:

cutoffValue - lists the comparison value

fromPrevSelected - notes whether the search should only be performed on currently selected rows

Throws:

java.lang.Exception

selectBelowEqual

public void selectBelowEqual(double cutoffValue,
                             boolean fromPrevSelected)
                      throws java.lang.Exception

select all rows with a value less or equal than the one provided

Parameters:

cutoffValue - lists the comparison value

fromPrevSelected - notes whether the search should only be performed on currently selected rows

Throws:

java.lang.Exception

selectBelow

public void selectBelow(double cutoffValue,
                        boolean fromPrevSelected)
                 throws java.lang.Exception

select all rows with a value less than the one provided

Parameters:

cutoffValue - lists the comparison value

fromPrevSelected - notes whether the search should only be performed on currently selected rows

Throws:

java.lang.Exception

selectRange

public void selectRange(double lowValue,
                        double highValue,
                        boolean fromPrevSelected)
                 throws java.lang.Exception

select all rows with a value between the lower and upper limits provided. This includes values equal to the lower limit and excludes the upper limit

Parameters:

lowValue - the lower limit

highValue - the upper limit

fromPrevSelected - notes whether the search should only be performed on currently selected rows

Throws:

java.lang.Exception

getMaxValue

public double getMaxValue()
                   throws java.lang.Exception

returns the maximum value stored in the Vector as a double

Throws:

java.lang.Exception

getMinValue

public double getMinValue()
                   throws java.lang.Exception

returns the minimum value stored in the Vector as a double

Throws:

java.lang.Exception

getRange

public double getRange()
                throws java.lang.Exception

returns the minimum value stored in the Vector as a double

Throws:

java.lang.Exception

getMeanValue

public double getMeanValue()
                    throws java.lang.Exception

returns the average for values stored in the Vector as a double

Throws:

java.lang.Exception

getSumValue

public double getSumValue()
                   throws java.lang.Exception

returns the average for values stored in the Vector as a double

Throws:

java.lang.Exception

getVarianceValue

public double getVarianceValue()
                        throws java.lang.Exception

returns the average for values stored in the Vector as a double

Throws:

java.lang.Exception

getSDValue

public double getSDValue()
                  throws java.lang.Exception

returns the average for values stored in the Vector as a double

Throws:

java.lang.Exception

gettValue

public double gettValue(double hypMean)
                 throws java.lang.Exception

returns the average for values stored in the Vector as a double

Throws:

java.lang.Exception

getDistancesToMean

public NumberVariable getDistancesToMean()
                                  throws java.lang.Exception

returns a variable containing each values relative to its mean

Throws:

java.lang.Exception

getzTransform

public NumberVariable getzTransform()
                             throws java.lang.Exception

returns a variable containing each values relative to its mean

Throws:

java.lang.Exception

getRanks

public NumberVariable getRanks()
                        throws java.lang.Exception

return the ranks for the values in this array of the currently selected subset

Throws:

java.lang.Exception

subtract

public NumberVariable subtract(double theScalar)
                        throws java.lang.Exception

subtracts the constant from each value of the variable

Parameters:

theScalar - the number to subtract

Throws:

java.lang.Exception

multiply

public NumberVariable multiply(double theScalar)
                        throws java.lang.Exception

multiplies the constant with each value of the variable

Parameters:

theScalar - the number to multiply

Throws:

java.lang.Exception

multiply

public NumberVariable multiply(NumberVariable theVar)
                        throws java.lang.Exception

multiplies the variable with the corresponding value of the other variable

Parameters:

theVar - the numbers to multiply

Throws:

java.lang.Exception

distance

public NumberVariable distance(double theScalar)
                        throws java.lang.Exception

the absolute value after subtracting the constant from each value of the variable

Parameters:

theScalar - the number to subtract

Throws:

java.lang.Exception

sign

public NumberVariable sign()
                    throws java.lang.Exception

returns the sign for each value of the variable

Throws:

java.lang.Exception

absolute

public NumberVariable absolute()
                        throws java.lang.Exception

set the value to its absolute value

Throws:

java.lang.Exception

rank

public NumberVariable rank(boolean selectedOnly)
                    throws java.lang.Exception

rank the values in this array

Parameters:

selectedOnly - only use the selected values of the sample, the others will be set to missing

Throws:

java.lang.Exception

makeNewDescriptives

public void makeNewDescriptives()

create a new set of descriptives for the variable the object

Overrides:

makeNewDescriptives in class Variable

getNumberDescriptives

public NumberDescriptives getNumberDescriptives()
                                         throws java.lang.Exception

fills the descriptive statistics for the variable and returns the results

Throws:

java.lang.Exception

copyNumberDescriptives

public NumberDescriptives copyNumberDescriptives()
                                          throws java.lang.Exception

returns descriptive Statistic for the variable using the currently selected set of rows

Throws:

java.lang.Exception

invalidDescriptives

public void invalidDescriptives()

descriptive stats need to be updated

Overrides:

invalidDescriptives in class Variable

fillDescriptives

public void fillDescriptives(java.lang.Double hypMean)
                      throws java.lang.Exception

fills the descriptive circular statistics for the angle variable with a comparison to an external mean

Overrides:

fillDescriptives in class Variable

Parameters:

hypMean - the value of the a-priori hypothesis mean

Throws:

java.lang.Exception

getGroupDescriptives

public Descriptives[] getGroupDescriptives(Variable theXVariable)
                                    throws java.lang.Exception

returns the descriptives for the groups identified by X

Parameters:

theXVariable - the independent NumberVariable

Throws:

java.lang.Exception

listGroupDescriptives

public void listGroupDescriptives(Variable theXVariable)
                           throws java.lang.Exception

lists the descriptives for the groups identified by X

Overrides:

listGroupDescriptives in class Variable

Parameters:

theXVariable - the independent NumberVariable

Throws:

java.lang.Exception

getSignedRank

public NumberVariable getSignedRank(double CenterVal)
                             throws java.lang.Exception

returns the signed ranks of distances to the specified value

Parameters:

CenterVal - the median/center of the sample

Throws:

java.lang.Exception

getSignedRankW

public double getSignedRankW(double CenterVal,
                             boolean plus)
                      throws java.lang.Exception

fills the one-tailed sum of signed ranks

Parameters:

CenterVal - the mean/median of the sample

plus - the positive tail of the distribution

Throws:

java.lang.Exception

getSignedRankWProbability

public double getSignedRankWProbability(double W)
                                 throws java.lang.Exception

returns the one-tailed robability of obtaining this Signed Rank W or greater

Parameters:

W - Wilcoxon's Signed Rank Statistic W

Throws:

java.lang.Exception

doCorrelationAnalysis

public void doCorrelationAnalysis(NumberVariable theOtherYVariable)
                           throws java.lang.Exception

fills the regression statistics for the variable with control over th intercept

Parameters:

theOtherYVariable - the independent NumberVariable

Throws:

java.lang.Exception

getCorrelationResults

public CorrelationResults getCorrelationResults(NumberVariable theOtherYVariable)
                                         throws java.lang.Exception

fills the regression statistics for the variable with control over th intercept

Parameters:

theOtherYVariable - the independent NumberVariable

Throws:

java.lang.Exception

listCorrelationResults

public void listCorrelationResults(NumberVariable theOtherYVariable)

fills the regression statistics for the variable with control over th intercept

Parameters:

theOtherYVariable - the independent NumberVariable

doLinRegressionAnalysis

public NumberVariable doLinRegressionAnalysis(NumberVariable theXVariable)
                                       throws java.lang.Exception

fills the regression statistics for the variable with control over the intercept

Parameters:

theXVariable - the independent NumberVariable

Throws:

java.lang.Exception

listLinRegressionResults

public void listLinRegressionResults(NumberVariable theXVariable)

fills the regression statistics for the variable with control over the intercept

Parameters:

theXVariable - the independent NumberVariable

getLinRegressionResults

public RegressionResults getLinRegressionResults(NumberVariable theXVariable)
                                          throws java.lang.Exception

fills the regression statistics for the variable with control over the intercept

Parameters:

theXVariable - the independent NumberVariable

Throws:

java.lang.Exception

getLinRegressionResiduals

public NumberVariable getLinRegressionResiduals(NumberVariable theXVariable)
                                         throws java.lang.Exception

fills the regression statistics for the variable with control over th intercept

Parameters:

theXVariable - the independent NumberVariable

Throws:

java.lang.Exception

getMultLinRegressionResults

public MultRegressionResults getMultLinRegressionResults(VariableOrganizer theXVariableOrganizer)
                                                  throws java.lang.Exception

fills the regression statistics for the variable with control over the intercept

Parameters:

theXVariableOrganizer - the independent variables in a VariableOrganizer

Throws:

java.lang.Exception

listMultLinRegressionResults

public void listMultLinRegressionResults(VariableOrganizer theXVariableOrganizer)

fills the regression statistics for the variable with control over the intercept

Parameters:

theXVariableOrganizer - the independent variables in a VariableOrganizer

fillCompleteTerms

public void fillCompleteTerms(VariableOrganizer aXOrganizer,
                              ANOVAResults theResults)
                       throws java.lang.Exception

fills the n-way interaction terms for the ANOVA

Throws:

java.lang.Exception

getAutoCorrelationResults

public CorrelationResults getAutoCorrelationResults()
                                             throws java.lang.Exception

obtains the Autocorrelation statistics for the variable

Throws:

java.lang.Exception

gettTestResults

public tTestResults gettTestResults(double mean)
                             throws java.lang.Exception

obtains the t-Test results for the variable

Parameters:

mean - the mean to compare to

Throws:

java.lang.Exception

getANOVAResults

public ANOVAResults getANOVAResults(Variable theXVariable)
                             throws java.lang.Exception

fills the ANOVA statistics for the variable

Parameters:

theXVariable - the independent Variable

Throws:

java.lang.Exception

getANOVAResults

public ANOVAResults getANOVAResults(VariableOrganizer aXOrganizer)
                             throws java.lang.Exception

fills the ANOVA statistics for a full factorial model

Parameters:

aXOrganizer - the VariableOrganizer containing independent variables

Throws:

java.lang.Exception

getSSCP

public SquaresCrossproducts getSSCP(NumberVariable theXVariable)
                             throws java.lang.Exception

returns the sums of squares and crossproducts for the variable

Parameters:

theXVariable - the independent NumberVariable

Throws:

java.lang.Exception

getManWhitneyUResults

public ANOVAResults getManWhitneyUResults(Variable theXVar,
                                          double hypAngle)
                                   throws java.lang.Exception

returns the results from an analysis of differences in mean angle distance from a hypothetical direction

Parameters:

theXVar - variable that contains information on group assignment

Throws:

java.lang.Exception