psdi.plusc.app.pluscds.pluscmobilecommon

Class PlusCDSCalculation

java.lang.Object

psdi.plusc.app.pluscds.pluscmobilecommon.PlusCDSCalculation

public class PlusCDSCalculation
extends java.lang.Object

Author:

Diego Moreira Extends the PlusCFldToleranceUpdate class where originaly all the calculations were done. Now the equations will be mounted and used here returning just the final calculated value. BASIC FUNCTIONALITY: Generates the Equations for Data Sheet tolerance range values. Based on Desired Output value, generates the range from \ to values for each Formula: -EU -%SPAN -%URVwilson -%READING Type of Ranges: - Regular - Summed - Square Root

Field Summary

Fields

Modifier and Type	Field and Description
static int	DEVIATION_N Calculate standard deviation with an N divisor
static int	DEVIATION_N_MINUS_1 Calculate standard deviation with an N - 1 divisor
static int	INPUT_FROM constant to get input from value
static int	INPUT_TO constant to get input to value
static int	MAXFRACTION
static int	OUTPUT_FROM constant to get output from value
static int	OUTPUT_TO constant to get output to value

Constructor Summary

Constructors

Constructor and Description
PlusCDSCalculation(java.util.HashMap dsConfig) Default Constructor

Method Summary

Methods

Modifier and Type	Method and Description
void	calcPointRangeLimits(PlusCMboRemote mboRemote) Calculate the calibration points range limits based on the Nominal Input and the Range limits defined o the Asset Function.
boolean	calculateAveragesAndStdDevs(PlusCMboRemote[] groupPoints, PlusCMboRemote groupAveragePoint, java.lang.String fieldName) Calculates the averages and standard deviations for the given group of repeated calibration points.
boolean	calculateToleranceRangeSquared(PlusCMboRemote owner, java.lang.String fieldName) Calculate the Tolerance ranges based on squared equations for each formula: - EU -%SPAN -%URV -%READING Squared Calculation for Reverse Flow Calibration - Issue # 07-10511
boolean	calculateToleranceRangeSquareRoot(PlusCMboRemote owner, java.lang.String fieldName) Calculate the Tolerance ranges based on square root equations for each formula: - EU -%SPAN -%URV -%READING
java.lang.String	checkAndAdjustFldValueSize(java.lang.String value, java.text.DecimalFormatSymbols df, int minFraction, java.util.Locale locale)
java.lang.String	checkAndAdjustFldValueSize(java.lang.String value, java.text.DecimalFormatSymbols df, java.util.Locale locale, boolean shouldRound) If the given value exceeds the field's length, reduces it's precision to make it fit.
static double[]	directionCheck(PlusCMboRemote owner, java.util.Locale locale) This method makes the check direction of data
boolean	doUpdateErrorValues(PlusCMboRemote mboRemote, java.lang.String asFoundOrLeft, boolean bShowOutOfTolMsg) Check if tolerance is exceded
void	doUpdateOutputValue(PlusCMboRemote mboRemote, boolean bValidateWhenSetting) This method updates the output values in mboRemote
void	doUpdateRonValues(PlusCMboRemote mboRemote) This method updates ron values
boolean	doUpdateTolValues(PlusCMboRemote mboRemote, java.lang.String fieldName) This method updates tolerances values
java.lang.String	doWOUpdateOutputValue(PlusCMboRemote owner, java.lang.String sPrefix)
int	getAssetError() Gets the PLUSCDSCONFIG.ASSETERROR value
int	getAssetNPlaces() Gets the PLUSCDSCONFIG.ASSETNPLACES value
int	getAssetPrecision(int minOutputPrecision, int actualOutputPrecision, int actualInputPrecision) Defines the right precision to be used for asset and process errors.
boolean	getAssetTruncate() Gets the PLUSCDSCONFIG.ASSETTRUNCATE value
boolean	getDesiredOutputTruncate() Gets the PLUSCDSCONFIG.OUTPUTTRUNCATE value
boolean	getRangeLimitsTruncate() Gets the PLUSCDSCONFIG.RANGETRUNCATE value
int	getStdDeviationType() Gets the standard deviation type configuration option.
int	getTolError() Gets the PLUSCDSCONFIG.TOLERROR value
int	getTolNPlaces() Gets the PLUSCDSCONFIG.TOLNPLACES value
int	getTolPrecision(int minOutputPrecision, int actualOutputPrecision, int actualInputPrecision) Defines the right precision to be used for tolerance limits and errors.
boolean	getTolTruncate() Gets the PLUSCDSCONFIG.TOLTRUNCATE value
java.lang.String	squaredDesiredOutputValue(PlusCMboRemote owner) Squared Calculation for Reverse Flow Calibration - Issue # 07-10511
static java.lang.String	squaredOutputValue(java.util.Locale locale, java.lang.String instrcalrangefrom, java.lang.String instrcalrangeto, java.lang.String instroutrangefrom, java.lang.String instrOutputSpan, java.lang.String invalue, double sign, int precision) Calculates desired output for squared instruments.
static java.lang.String	squaredOutputValueNegative(java.util.Locale locale, java.lang.String instrcalrangefrom, java.lang.String instrcalrangeto, java.lang.String instroutrangefrom, java.lang.String instrOutputSpan, java.lang.String invalue, int precision) Calculates desired output for squared instruments with negative inputs.
java.lang.String	squareRootDesiredOutputValue(PlusCMboRemote owner) Calculate the desired output value for calibration points that uses Square Root of input.
static java.lang.String	squareRootOutputValueNegative(java.util.Locale locale, java.lang.String instrcalrangeto, java.lang.String instroutrangefrom, java.lang.String instrOutputSpan, java.lang.String invalue) Calculates desired output for square root instruments with negative inputs.
boolean	summedToleranceEquations(PlusCMboRemote owner, java.lang.String fieldName, int tol, boolean[] summedCalcTypes) Calculate the Tolerance Range Values based on the summed range values entered.
double[]	summedToleranceEquationsTightesWidest(PlusCMboRemote owner, java.lang.String fieldName, int tol, boolean[] summedCalcTypes) TIGHTEST to WIDEST used equstion just to calculate the tigh to widest rule on summed equations, remove this code on next patch and include a call to the existing method.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

MAXFRACTION

public static int MAXFRACTION

INPUT_FROM

public static final int INPUT_FROM

constant to get input from value

See Also:

Constant Field Values

INPUT_TO

public static final int INPUT_TO

constant to get input to value

See Also:

Constant Field Values

OUTPUT_FROM

public static final int OUTPUT_FROM

constant to get output from value

See Also:

Constant Field Values

OUTPUT_TO

public static final int OUTPUT_TO

constant to get output to value

See Also:

Constant Field Values

DEVIATION_N

public static final int DEVIATION_N

Calculate standard deviation with an N divisor

See Also:

Constant Field Values

DEVIATION_N_MINUS_1

public static final int DEVIATION_N_MINUS_1

Calculate standard deviation with an N - 1 divisor

See Also:

Constant Field Values

Constructor Detail

PlusCDSCalculation

public PlusCDSCalculation(java.util.HashMap dsConfig)

Default Constructor

Method Detail

getTolPrecision

public int getTolPrecision(int minOutputPrecision,
                  int actualOutputPrecision,
                  int actualInputPrecision)

Defines the right precision to be used for tolerance limits and errors. Formula Rounding or Truncation - Issue # 06-13862

Parameters:

minOutputPrecision - Input Min Field Resolution (PLUSCDSINSTR.INPUTPRECISION)

actualOutputPrecision - Precision of tha actual entered output value

actualInputPrecision - Precision of tha actual entered input value

Returns:

getAssetPrecision

public int getAssetPrecision(int minOutputPrecision,
                    int actualOutputPrecision,
                    int actualInputPrecision)

Defines the right precision to be used for asset and process errors. Formula Rounding or Truncation - Issue # 06-13862

Parameters:

minOutputPrecision - Input Min Field Resolution (PLUSCDSINSTR.INPUTPRECISION)

actualOutputPrecision - Precision of tha actual entered output value

actualInputPrecision - Precision of tha actual entered input value

Returns:

getTolError

public int getTolError()

Gets the PLUSCDSCONFIG.TOLERROR value

Returns:

getAssetError

public int getAssetError()

Gets the PLUSCDSCONFIG.ASSETERROR value

Returns:

getTolNPlaces

public int getTolNPlaces()

Gets the PLUSCDSCONFIG.TOLNPLACES value

Returns:

getAssetNPlaces

public int getAssetNPlaces()

Gets the PLUSCDSCONFIG.ASSETNPLACES value

Returns:

getTolTruncate

public boolean getTolTruncate()

Gets the PLUSCDSCONFIG.TOLTRUNCATE value

Returns:

getAssetTruncate

public boolean getAssetTruncate()

Gets the PLUSCDSCONFIG.ASSETTRUNCATE value

Returns:

getDesiredOutputTruncate

public boolean getDesiredOutputTruncate()

Gets the PLUSCDSCONFIG.OUTPUTTRUNCATE value

Returns:

getStdDeviationType

public int getStdDeviationType()

Gets the standard deviation type configuration option.

Returns:

DEVIATION_N or DEVIATION_N_MINUS_1

summedToleranceEquationsTightesWidest

public double[] summedToleranceEquationsTightesWidest(PlusCMboRemote owner,
                                             java.lang.String fieldName,
                                             int tol,
                                             boolean[] summedCalcTypes)

TIGHTEST to WIDEST used equstion just to calculate the tigh to widest rule on summed equations, remove this code on next patch and include a call to the existing method. This method do not set any value. Calculate the Tolerance Range Values based on the summed range values entered. The equations are the same used for regular tolerances regarding: - EU -%SPAN -%URV -%READING IMPORTANT - All the changes made to any equations should be double checked here and in the regular equations method above. So they won't be different.

Parameters:

mboRemote -

fieldName -

tol - - int counter used in the equations method to loop through the tolerances.

Returns:

Returns true if tightest to widest off range happens to fire the exception dialog

squaredDesiredOutputValue

public java.lang.String squaredDesiredOutputValue(PlusCMboRemote owner)

Squared Calculation for Reverse Flow Calibration - Issue # 07-10511

Returns:

squareRootDesiredOutputValue

public java.lang.String squareRootDesiredOutputValue(PlusCMboRemote owner)

Calculate the desired output value for calibration points that uses Square Root of input.

Parameters:

mboRemote -

Returns:

desiredOutputValue

squareRootOutputValueNegative

public static java.lang.String squareRootOutputValueNegative(java.util.Locale locale,
                                             java.lang.String instrcalrangeto,
                                             java.lang.String instroutrangefrom,
                                             java.lang.String instrOutputSpan,
                                             java.lang.String invalue)

Calculates desired output for square root instruments with negative inputs.

Parameters:

locale - Locale for parsing of numbers

instrcalrangeto - input range upper limit

instroutrangefrom - output range lower limit

instrOutputSpan - output range span

invalue - input value: nominal or actual

Returns:

desiredOutputValue

squaredOutputValueNegative

public static java.lang.String squaredOutputValueNegative(java.util.Locale locale,
                                          java.lang.String instrcalrangefrom,
                                          java.lang.String instrcalrangeto,
                                          java.lang.String instroutrangefrom,
                                          java.lang.String instrOutputSpan,
                                          java.lang.String invalue,
                                          int precision)

Calculates desired output for squared instruments with negative inputs.

Parameters:

locale - Locale for parsing of numbers

instrcalrangefrom - input range lower limit

instrcalrangeto - input range upper limit

instroutrangefrom - output range lower limit

instrOutputSpan - output range span

invalue - input value: nominal or actual

precision - precision

Returns:

desiredOutputValue

squaredOutputValue

public static java.lang.String squaredOutputValue(java.util.Locale locale,
                                  java.lang.String instrcalrangefrom,
                                  java.lang.String instrcalrangeto,
                                  java.lang.String instroutrangefrom,
                                  java.lang.String instrOutputSpan,
                                  java.lang.String invalue,
                                  double sign,
                                  int precision)

Calculates desired output for squared instruments.

Parameters:

locale - Locale for parsing of numbers

instrcalrangefrom - input range lower limit

instrcalrangeto - input range upper limit

instroutrangefrom - output range lower limit

instrOutputSpan - output range span

invalue - input value: nominal or actual

sign - sign of input (-1 for negative or 1 for positive)

precision - precision

Returns:

desiredOutputValue

calculateToleranceRangeSquareRoot

public boolean calculateToleranceRangeSquareRoot(PlusCMboRemote owner,
                                        java.lang.String fieldName)

Calculate the Tolerance ranges based on square root equations for each formula: - EU -%SPAN -%URV -%READING

Parameters:

mboRemote -

Returns:

boolean

calculateToleranceRangeSquared

public boolean calculateToleranceRangeSquared(PlusCMboRemote owner,
                                     java.lang.String fieldName)

Calculate the Tolerance ranges based on squared equations for each formula: - EU -%SPAN -%URV -%READING Squared Calculation for Reverse Flow Calibration - Issue # 07-10511

Parameters:

mboRemote -

Returns:

boolean

calcPointRangeLimits

public void calcPointRangeLimits(PlusCMboRemote mboRemote)

Calculate the calibration points range limits based on the Nominal Input and the Range limits defined o the Asset Function. If the range limits asre blank no range limits are calculated for calibraiton points.

Parameters:

mboRemote -

getRangeLimitsTruncate

public boolean getRangeLimitsTruncate()

Gets the PLUSCDSCONFIG.RANGETRUNCATE value

Returns:

summedToleranceEquations

public boolean summedToleranceEquations(PlusCMboRemote owner,
                               java.lang.String fieldName,
                               int tol,
                               boolean[] summedCalcTypes)

Calculate the Tolerance Range Values based on the summed range values entered. The equations are the same used for regular tolerances regarding: - EU -%SPAN -%URV -%READING IMPORTANT - All the changes made to any equations should be double checked here and in the regular equations method above. So they won't be different.

Parameters:

mboRemote -

fieldName -

tol - - int counter used in the equations method to loop through the tolerances.

Returns:

directionCheck

public static double[] directionCheck(PlusCMboRemote owner,
                      java.util.Locale locale)

This method makes the check direction of data

Parameters:

owner -

locale -

Returns:

double [], which values should be taken using constants defined in PlusCDSCalculation.

doUpdateOutputValue

public void doUpdateOutputValue(PlusCMboRemote mboRemote,
                       boolean bValidateWhenSetting)

This method updates the output values in mboRemote

Parameters:

mboRemote -

bValidateWhenSetting -

doWOUpdateOutputValue

public java.lang.String doWOUpdateOutputValue(PlusCMboRemote owner,
                                     java.lang.String sPrefix)

Parameters:

mboRemote -

sPrefix -

Returns:

doUpdateRonValues

public void doUpdateRonValues(PlusCMboRemote mboRemote)

This method updates ron values

Parameters:

mboRemote -

doUpdateTolValues

public boolean doUpdateTolValues(PlusCMboRemote mboRemote,
                        java.lang.String fieldName)

This method updates tolerances values

Parameters:

mboRemote -

fieldName -

Returns:

true if tighest to widest validation is correct or false,, otherwise

doUpdateErrorValues

public boolean doUpdateErrorValues(PlusCMboRemote mboRemote,
                          java.lang.String asFoundOrLeft,
                          boolean bShowOutOfTolMsg)

Check if tolerance is exceded

Parameters:

mboRemote -

asFoundOrLeft -

bShowOutOfTolMsg -

Returns:

boolean

checkAndAdjustFldValueSize

public java.lang.String checkAndAdjustFldValueSize(java.lang.String value,
                                          java.text.DecimalFormatSymbols df,
                                          int minFraction,
                                          java.util.Locale locale)

checkAndAdjustFldValueSize

public java.lang.String checkAndAdjustFldValueSize(java.lang.String value,
                                          java.text.DecimalFormatSymbols df,
                                          java.util.Locale locale,
                                          boolean shouldRound)

If the given value exceeds the field's length, reduces it's precision to make it fit.

Parameters:

value - value to be checked

df - DecimalFormatSymbols for parsing the value

locale - Locale for parsing and formatting the value

shouldRound - whether the number should be rounded (truncate if false)

Returns:

the re-formatted value

calculateAveragesAndStdDevs

public boolean calculateAveragesAndStdDevs(PlusCMboRemote[] groupPoints,
                                  PlusCMboRemote groupAveragePoint,
                                  java.lang.String fieldName)

Calculates the averages and standard deviations for the given group of repeated calibration points. The results are stored in the averages point.

Parameters:

groupPoints - group of points whose averages and std devs will be calculated

groupAveragePoint - the point where the resulting values will be stored

fieldName - name of the attribute for which the values will be calculated

Returns:

true if all data needed for the calculation was available, false otherwise