com.mmm.cms.homehealth.v4115

Class ClinicalFunctional_ScoringModel_v4115

java.lang.Object

com.mmm.cms.homehealth.v4115.ClinicalFunctional_ScoringModel_v4115

All Implemented Interfaces:

HomeHealthScoringModelIF, Identifiable, Namable

Direct Known Subclasses:

ClinicalFunctional_ScoringModel_v5115, NRS_ScoringModel_v4115

public class ClinicalFunctional_ScoringModel_v4115
extends java.lang.Object
implements HomeHealthScoringModelIF

This Model provides scoring for the 4 clinical and functional equations

Author:

3M Health Information Systems for CMS Home Health

Field Summary

Fields

Modifier and Type	Field and Description
protected HomeHealthGrouperIF	grouper
protected DataManagerIF	grouperDataManager

Constructor Summary

Constructors

Constructor and Description
ClinicalFunctional_ScoringModel_v4115(HomeHealthGrouperIF grouper, DataManagerIF grouperDataManager, int equationId) Constructor with references to the Grouper, the Data manager, and the equation id
ClinicalFunctional_ScoringModel_v4115(HomeHealthGrouperIF grouper, DataManagerIF grouperDataManager, int equationId, java.lang.String shortName)

Method Summary

Methods

Modifier and Type	Method and Description
protected DiagnosisCodeIF	getDiagnosisCode(java.lang.String codeValue)
HomeHealthGrouperIF	getGrouper() gets a reference to the Grouper which created this model
int	getId() the id of the object
java.lang.String	getName() The run-time name
java.lang.String	getShortName()
boolean	isUseOptionalLogic()
void	populateCodes(HomeHealthRecordIF record) This populates the record with all Diagnosis codes that are valid for this grouper version that are listed on the record.
void	preprocessRecord(HomeHealthRecordIF record, HomeHealthRecordValidatorIF validator) Deprecated.
void	preprocessRecord(HomeHealthRecordIF record, HomeHealthRecordValidatorIF validator, java.util.Collection<HomeHealthEventListenerIF> listeners) There is no preprocessing of the HomeHealth Record for this model, and this does nothing.
ScoringPointsIF	score(HomeHealthRecordIF record, HomeHealthRecordValidatorIF validator) Deprecated.
ScoringPointsIF	score(HomeHealthRecordIF record, HomeHealthRecordValidatorIF validator, int[][] scoreOrder) Calls score() with listeners being null
ScoringPointsIF	score(HomeHealthRecordIF record, HomeHealthRecordValidatorIF validator, int[][] scoreOrder, java.util.Collection<HomeHealthEventListenerIF> listeners) This is the overall scoring routine.
void	scoreAny(HomeHealthRecordIF record, DiagnosisCodeIF diagCode, HomeHealthRecordValidatorIF validator, int diagIdx, DiagnosisScoringGridIF scoringGrid, java.util.Collection<HomeHealthEventListenerIF> listeners) This section covers scoring of Diagnostic groups and Case Mix Adjustment Rows that do not depend on Primary or Other specific values for the code May 2013: updated to use OASIS-C values
int	scoreClinical(HomeHealthRecordIF record, HomeHealthRecordValidatorIF validator, int[][] scoreOrder, java.util.Collection<HomeHealthEventListenerIF> listeners) September 2012 - Overriding this method in order to added check for payment code pairings prior to scoring related codes.
void	scoreClinicalCode(HomeHealthRecordIF record, DiagnosisCodeIF diagCode, HomeHealthRecordValidatorIF validator, int diagIdx, DiagnosisScoringGridIF scoringGrid, java.util.Collection<HomeHealthEventListenerIF> listeners) This overrides in order to check for primary awarding for Dx in position 2, with the appropriate payment code in position 1
void	scoreClinicalColumn3_4(HomeHealthRecordIF record, HomeHealthRecordValidatorIF validator, int rowIdx, DiagnosisScoringGridIF scoringGrid, int[][] scoreOrder, int currentPass, java.util.Collection<HomeHealthEventListenerIF> listeners) After the first column (historically column 2) has determined that it is an Optional payment code that can have a column 3 & 4, this method will score those codes on the same row, and resolve any manifestation/ etiology contentions.
int	scoreFunctional(HomeHealthRecordIF record, HomeHealthRecordValidatorIF validator, java.util.Collection<HomeHealthEventListenerIF> listeners) Score the functional part of the model, basically things such as CUR_? and dressing.
void	scoreOtherOnly(HomeHealthRecordIF record, DiagnosisCodeIF diagCode, int diagIdx, DiagnosisScoringGridIF scoringGrid, java.util.Collection<HomeHealthEventListenerIF> listeners) Scores only those codes that can not be in the primary position
void	scorePrimaryOnly(HomeHealthRecordIF record, DiagnosisCodeIF diagCode, int diagIdx, DiagnosisScoringGridIF scoringGrid, java.util.Collection<HomeHealthEventListenerIF> listeners) Scores the Primary only code with Primary only CaseMix values.
int	scoreRemainingVariables(HomeHealthRecordIF record, HomeHealthRecordValidatorIF validator, int currentScore, java.util.Collection<HomeHealthEventListenerIF> listeners) This scores the remaining clinical variables.
void	setGrouper(HomeHealthGrouperIF grouper) Sets the Grouper which created this model at run time.
void	setId(int id) Sets the id for the object at run time
void	setName(java.lang.String name) Sets the run-time name associated with the object
void	setUseOptionalLogic(boolean useOptionalLogic)

Methods inherited from class java.lang.Object

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

Field Detail

grouperDataManager

protected DataManagerIF grouperDataManager

grouper

protected HomeHealthGrouperIF grouper

Constructor Detail

ClinicalFunctional_ScoringModel_v4115

public ClinicalFunctional_ScoringModel_v4115(HomeHealthGrouperIF grouper,
                                     DataManagerIF grouperDataManager,
                                     int equationId)

Constructor with references to the Grouper, the Data manager, and the equation id

Parameters:

grouper -

grouperDataManager -

equationId -

ClinicalFunctional_ScoringModel_v4115

public ClinicalFunctional_ScoringModel_v4115(HomeHealthGrouperIF grouper,
                                     DataManagerIF grouperDataManager,
                                     int equationId,
                                     java.lang.String shortName)

Parameters:

grouper -

grouperDataManager -

equationId -

shortName -

Method Detail

isUseOptionalLogic

public boolean isUseOptionalLogic()

setUseOptionalLogic

public void setUseOptionalLogic(boolean useOptionalLogic)

getGrouper

public HomeHealthGrouperIF getGrouper()

Description copied from interface: HomeHealthScoringModelIF

gets a reference to the Grouper which created this model

Specified by:

getGrouper in interface HomeHealthScoringModelIF

Returns:

A reference to Grouper which created this model at runtime

getName

public java.lang.String getName()

Description copied from interface: Namable

The run-time name

Specified by:

getName in interface Namable

Returns:

The run-time name associated with the object

getShortName

public java.lang.String getShortName()

getDiagnosisCode

protected DiagnosisCodeIF getDiagnosisCode(java.lang.String codeValue)

Parameters:

codeValue -

Returns:

the Code with its value being codeValue. If the code is not valid (found for this version), then the Invalid flag will be set to true and all other information about the code will be meaningless. This method should never return null.

populateCodes

public void populateCodes(HomeHealthRecordIF record)

This populates the record with all Diagnosis codes that are valid for this grouper version that are listed on the record. Codes that are found are marked as Valid, otherwise the code is mark as not Valid, and not Valid for scoring. This method should be called prior to scoring the

Specified by:

populateCodes in interface HomeHealthScoringModelIF

Parameters:

record -

score

public ScoringPointsIF score(HomeHealthRecordIF record,
                    HomeHealthRecordValidatorIF validator)

Deprecated.

Description copied from interface: HomeHealthScoringModelIF

This is the overall scoring routine. All scoring should be summed here in order to return a single value.

Specified by:

score in interface HomeHealthScoringModelIF

Parameters:

record -

validator -

Returns:

preprocessRecord

public void preprocessRecord(HomeHealthRecordIF record,
                    HomeHealthRecordValidatorIF validator)

Deprecated.

No longer used

Specified by:

preprocessRecord in interface HomeHealthScoringModelIF

Parameters:

record -

validator -

See Also:

HomeHealthScoringModelIF.preprocessRecord(HomeHealthRecordIF record, HomeHealthRecordValidatorIF validator, Collection listeners)

preprocessRecord

public void preprocessRecord(HomeHealthRecordIF record,
                    HomeHealthRecordValidatorIF validator,
                    java.util.Collection<HomeHealthEventListenerIF> listeners)

There is no preprocessing of the HomeHealth Record for this model, and this does nothing.

Specified by:

preprocessRecord in interface HomeHealthScoringModelIF

Parameters:

record -

validator -

listeners - - can be null, otherwise list of listeners for notified of events

score

public ScoringPointsIF score(HomeHealthRecordIF record,
                    HomeHealthRecordValidatorIF validator,
                    int[][] scoreOrder,
                    java.util.Collection<HomeHealthEventListenerIF> listeners)

Description copied from interface: HomeHealthScoringModelIF

This is the overall scoring routine. All scoring should be summed here in order to return a single value.

Specified by:

score in interface HomeHealthScoringModelIF

scoreOrder - - array of int[6][3] determining the scoring order of a diagnosis code in the related position.

listeners - - can be null, otherwise list of listeners for notified of events

Returns:

The scoring object which may hold scores per type and equation, but is dependent on the scoring model

score

public ScoringPointsIF score(HomeHealthRecordIF record,
                    HomeHealthRecordValidatorIF validator,
                    int[][] scoreOrder)

Calls score() with listeners being null

Specified by:

score in interface HomeHealthScoringModelIF

Parameters:

record -

validator -

scoreOrder -

Returns:

non-null ScoringPointsIF

scoreAny

public void scoreAny(HomeHealthRecordIF record,
            DiagnosisCodeIF diagCode,
            HomeHealthRecordValidatorIF validator,
            int diagIdx,
            DiagnosisScoringGridIF scoringGrid,
            java.util.Collection<HomeHealthEventListenerIF> listeners)
              throws AlreadyScoredException

This section covers scoring of Diagnostic groups and Case Mix Adjustment Rows that do not depend on Primary or Other specific values for the code May 2013: updated to use OASIS-C values

Parameters:

record -

diagCode -

validator - - used to check edits during scoring

diagIdx -

scoringGrid -

listeners - - used to collect/report events

Throws:

AlreadyScoredException

scoreClinical

public int scoreClinical(HomeHealthRecordIF record,
                HomeHealthRecordValidatorIF validator,
                int[][] scoreOrder,
                java.util.Collection<HomeHealthEventListenerIF> listeners)

September 2012 - Overriding this method in order to added check for payment code pairings prior to scoring related codes. Though this "override" duplicates much the super implementation of this method, it is worth looking at the super implementation for more info

Parameters:

record -

validator -

scoreOrder -

listeners -

Returns:

score

See Also:

ClinicalFunctional_ScoringModel_v3312#scoreClinial(HomeHealthRecord_IF record, HomeHealthRecordValidatorIF validator, int scoreOrder[][])

scoreClinicalCode

public void scoreClinicalCode(HomeHealthRecordIF record,
                     DiagnosisCodeIF diagCode,
                     HomeHealthRecordValidatorIF validator,
                     int diagIdx,
                     DiagnosisScoringGridIF scoringGrid,
                     java.util.Collection<HomeHealthEventListenerIF> listeners)

This overrides in order to check for primary awarding for Dx in position 2, with the appropriate payment code in position 1

Parameters:

record -

diagCode -

validator -

diagIdx -

scoringGrid -

listeners -

scoreClinicalColumn3_4

public void scoreClinicalColumn3_4(HomeHealthRecordIF record,
                          HomeHealthRecordValidatorIF validator,
                          int rowIdx,
                          DiagnosisScoringGridIF scoringGrid,
                          int[][] scoreOrder,
                          int currentPass,
                          java.util.Collection<HomeHealthEventListenerIF> listeners)

After the first column (historically column 2) has determined that it is an Optional payment code that can have a column 3 & 4, this method will score those codes on the same row, and resolve any manifestation/ etiology contentions.

Parameters:

record -

validator -

rowIdx -

scoringGrid -

scoreOrder -

currentPass -

listeners -

scoreFunctional

public int scoreFunctional(HomeHealthRecordIF record,
                  HomeHealthRecordValidatorIF validator,
                  java.util.Collection<HomeHealthEventListenerIF> listeners)

Score the functional part of the model, basically things such as CUR_? and dressing. Pseudo code lines: 1492 thru 1517

Parameters:

record -

validator -

listeners -

Returns:

the functional score

scoreOtherOnly

public void scoreOtherOnly(HomeHealthRecordIF record,
                  DiagnosisCodeIF diagCode,
                  int diagIdx,
                  DiagnosisScoringGridIF scoringGrid,
                  java.util.Collection<HomeHealthEventListenerIF> listeners)
                    throws AlreadyScoredException

Scores only those codes that can not be in the primary position

Parameters:

record -

diagCode -

diagIdx -

scoringGrid -

listeners -

Throws:

AlreadyScoredException

scorePrimaryOnly

public void scorePrimaryOnly(HomeHealthRecordIF record,
                    DiagnosisCodeIF diagCode,
                    int diagIdx,
                    DiagnosisScoringGridIF scoringGrid,
                    java.util.Collection<HomeHealthEventListenerIF> listeners)
                      throws AlreadyScoredException

Scores the Primary only code with Primary only CaseMix values.

Parameters:

record -

diagCode -

diagIdx -

scoringGrid -

listeners -

Throws:

AlreadyScoredException

scoreRemainingVariables

public int scoreRemainingVariables(HomeHealthRecordIF record,
                          HomeHealthRecordValidatorIF validator,
                          int currentScore,
                          java.util.Collection<HomeHealthEventListenerIF> listeners)

This scores the remaining clinical variables.

Parameters:

record -

validator -

Returns:

setGrouper

public void setGrouper(HomeHealthGrouperIF grouper)

Description copied from interface: HomeHealthScoringModelIF

Sets the Grouper which created this model at run time.

Specified by:

setGrouper in interface HomeHealthScoringModelIF

setName

public void setName(java.lang.String name)

Description copied from interface: Namable

Sets the run-time name associated with the object

Specified by:

setName in interface Namable

getId

public int getId()

Description copied from interface: Identifiable

the id of the object

Specified by:

getId in interface Identifiable

Returns:

the id of the object at run time

setId

public void setId(int id)

Description copied from interface: Identifiable

Sets the id for the object at run time

Specified by:

setId in interface Identifiable