com.mmm.cms.homehealth.v3414

Class GrouperVersion_v3414

java.lang.Object

com.mmm.cms.homehealth.AbstractGrouper

com.mmm.cms.homehealth.AbstractGrouper_2

com.mmm.cms.homehealth.v3414.GrouperVersion_v3414

All Implemented Interfaces:

HomeHealthEventNotifierIF, HomeHealthGrouperIF, Describable, Initializable, Namable, java.io.Serializable

Direct Known Subclasses:

GrouperVersion_v3514

public class GrouperVersion_v3414
extends AbstractGrouper_2
implements HomeHealthGrouperIF

This version is valid from January 1, 2014 to September 30, 2014. There is not grace period and no start window. In previous versions, the OASIS-C record was mapped back to the OASIS-B record after validation but prior to scoring. This version removes this mapping and scores directly on the OASIS-C record.

Author:

3M Health Information Systems for CMS Home Health

See Also:

Serialized Form

Field Summary

Fields inherited from class com.mmm.cms.homehealth.AbstractGrouper

clinicalModel_1, clinicalModel_2, clinicalModel_3, clinicalModel_4, dataManager, effectiveDateStart, effectiveDateStartWindow, effectiveDateThru, nrsScoringModel, version

Fields inherited from interface com.mmm.cms.homehealth.proto.HomeHealthGrouperIF

DEFAULT_BLANK_VALUE

Constructor Summary

Constructors

Constructor and Description
GrouperVersion_v3414() Constructor that sets the effective start and thru date to January 1,
GrouperVersion_v3414(java.util.Calendar start, java.util.Calendar thru, java.util.Calendar window, java.lang.String versionName) Constructor that sets the effective start, thru, and window date to the supplied dates.

Method Summary

Methods

Modifier and Type	Method and Description
void	addEventListener(HomeHealthEventListenerIF listener) This method adds a HomeHealthEventListenerIF to the list of listeners.
void	copyCodes(HomeHealthRecordIF recordSrc, HomeHealthRecordIF recordDest) This copies codes from one record to another without any cloning.
java.lang.Class	getAcceptableRecordClass() Each version has an acceptable record type that can be processed, and this returns that class allowing the isValidForVersion() to more appropriately check the validity of processing a specific record.
java.util.List<CaseMixAdjustmentItemIF>	getCaseMixAdjustments() gets the Standard services case mix adjustment table
java.util.List<DiagnosisCodeIF>	getClinicalCodes() Provides the list of Clinical/Functional codes associated with this version and used for scoring.
HomeHealthRecordValidatorIF	getClinicalValidator() Provides the validator for the Clinical portion of the scoring
java.util.List<DiagnosticGroupIF>	getDiagnosticGroups() gets the list of diagnostic Groups associated with the Clinical/Functional diagnosis
java.util.List<DiagnosticGroupIF>	getDiagnosticGroupsNRS() gets the list of diagnostic Groups associated with the Non-Routine Supplies (NRS) diagnosis
java.util.Iterator<HomeHealthEventListenerIF>	getEventListeners() this method returns an enumerated list of HomeHealthEventListenerIF objects
java.util.List<HomeHealthEventListenerIF>	getEventListenersList() gets the underlying list of listeners; a little more dangerous than using the getEventListeners() that returns the Iterator
int	getListenerCount() gets the number listeners
java.lang.String	getName() Get the name of this version
java.util.List<DiagnosisCodeIF>	getNonRoutineCodes() gets a list of Diagnosis Codes for Non-routine Services
java.util.List<CaseMixAdjustmentItemIF>	getNRSCaseMixAdjustments() gets the Non-Routine services case mix adjustment table
HomeHealthRecordValidatorIF	getNRSValidator() Provides the validator for the Non-Routine Supplies portion of the scoring
void	init(java.util.Properties props) Sets up this version by loading the related Diagnosis code / Group data, and initializing the scoring models: 4 clinical/functional models (one for each equation), and one Non-Routine Supplies model
boolean	isValidDiagnosisCode(HomeHealthRecordIF record, DiagnosisCodeIF code) Determines if the Diagnosis code is valid for this grouper
void	notifyEventListeners(HomeHealthEventIF event) Sends a event to the listeners.
HomeHealthRecordValidatorIF	populateValidateClinicalCodes(HomeHealthRecordIF record) This method is not very efficient for scoring a record, since it populates the codes into the record each time, prior to validating them.
void	removeEventListener(HomeHealthEventListenerIF listener) Removes a single event listener from the list
void	removeEventListeners() Removes all the listeners from the list
ScoringResultsIF	score(HomeHealthRecordIF recordOasisC, boolean validateDates) When scoring a recordOasisC, the data can either come from a OASIS-B or an OASIS-C source.
ScoringResultsIF	score(HomeHealthRecordIF record, boolean validateDates, CollectionValidationEditsIF validationEdits, java.util.Collection<HomeHealthEventListenerIF> listeners) Scores the record using the supplied validation information (if non-null) instead of using the built in validation capabilities.

Methods inherited from class com.mmm.cms.homehealth.AbstractGrouper_2

createHippsCode, createHippsCode, determineScoreOrder

Methods inherited from class com.mmm.cms.homehealth.AbstractGrouper

getClinicalModel_1, getClinicalModel_2, getClinicalModel_3, getClinicalModel_4, getDescription, getEffectiveDateStart, getEffectiveDateStartWindow, getEffectiveDateThru, getGrouperDataManager, getNrsScoringModel, getVersion, isValidForVersion, reportNonScoringDiagnosis, setClinicalModel_1, setClinicalModel_2, setClinicalModel_3, setClinicalModel_4, setDescription, setEffectiveDateStart, setEffectiveDateStartWindow, setEffectiveDateThru, setGrouperDataManager, setName, setNrsScoringModel, setVersion

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.mmm.cms.homehealth.proto.HomeHealthGrouperIF

determineScoreOrder, getEffectiveDateStart, getEffectiveDateStartWindow, getEffectiveDateThru, getGrouperDataManager, getVersion, isValidForVersion, setEffectiveDateStart, setEffectiveDateStartWindow, setEffectiveDateThru, setVersion

Methods inherited from interface com.mmm.cms.util.Namable

setName

Methods inherited from interface com.mmm.cms.util.Describable

getDescription, setDescription

Constructor Detail

GrouperVersion_v3414

public GrouperVersion_v3414()

Constructor that sets the effective start and thru date to January 1,

GrouperVersion_v3414

public GrouperVersion_v3414(java.util.Calendar start,
                    java.util.Calendar thru,
                    java.util.Calendar window,
                    java.lang.String versionName)

Constructor that sets the effective start, thru, and window date to the supplied dates. The start and thru dates can not be null but the window can be.

Parameters:

start - - the effective start date

thru - - the effective thru date, inclusive

window - - the start of the overlap window. May be null

versionName - - 5 character string. Can not be null.

Method Detail

copyCodes

public void copyCodes(HomeHealthRecordIF recordSrc,
             HomeHealthRecordIF recordDest)

This copies codes from one record to another without any cloning.

Overrides:

copyCodes in class AbstractGrouper

Parameters:

recordDest -

getDiagnosticGroups

public java.util.List<DiagnosticGroupIF> getDiagnosticGroups()

gets the list of diagnostic Groups associated with the Clinical/Functional diagnosis

Specified by:

getDiagnosticGroups in interface HomeHealthGrouperIF

Overrides:

getDiagnosticGroups in class AbstractGrouper

Returns:

non-null List of Diagnostic Group items. If there was an error during initialization, the list may be empty

getDiagnosticGroupsNRS

public java.util.List<DiagnosticGroupIF> getDiagnosticGroupsNRS()

gets the list of diagnostic Groups associated with the Non-Routine Supplies (NRS) diagnosis

Specified by:

getDiagnosticGroupsNRS in interface HomeHealthGrouperIF

Overrides:

getDiagnosticGroupsNRS in class AbstractGrouper

Returns:

non-null List of Diagnostic Group items. If there was an error during initialization, the list may be empty

getCaseMixAdjustments

public java.util.List<CaseMixAdjustmentItemIF> getCaseMixAdjustments()

gets the Standard services case mix adjustment table

Specified by:

getCaseMixAdjustments in interface HomeHealthGrouperIF

Overrides:

getCaseMixAdjustments in class AbstractGrouper

Returns:

non-null List of CaseMixAdjustment items. If there was an error during initialization, the list may be empty

getClinicalValidator

public HomeHealthRecordValidatorIF getClinicalValidator()

Provides the validator for the Clinical portion of the scoring

Specified by:

getClinicalValidator in interface HomeHealthGrouperIF

Returns:

HomeHealthRecordValidatorIF

getAcceptableRecordClass

public java.lang.Class getAcceptableRecordClass()

Description copied from class: AbstractGrouper

Each version has an acceptable record type that can be processed, and this returns that class allowing the isValidForVersion() to more appropriately check the validity of processing a specific record.

Specified by:

getAcceptableRecordClass in interface HomeHealthGrouperIF

Specified by:

getAcceptableRecordClass in class AbstractGrouper

Returns:

non-null Class

getClinicalCodes

public java.util.List<DiagnosisCodeIF> getClinicalCodes()

Provides the list of Clinical/Functional codes associated with this version and used for scoring.

Specified by:

getClinicalCodes in interface HomeHealthGrouperIF

Overrides:

getClinicalCodes in class AbstractGrouper

Returns:

a non-null List of DiagnosisCodeIF

getName

public java.lang.String getName()

Get the name of this version

Specified by:

getName in interface Namable

Overrides:

getName in class AbstractGrouper

Returns:

the name of this version

getNRSCaseMixAdjustments

public java.util.List<CaseMixAdjustmentItemIF> getNRSCaseMixAdjustments()

gets the Non-Routine services case mix adjustment table

Specified by:

getNRSCaseMixAdjustments in interface HomeHealthGrouperIF

Overrides:

getNRSCaseMixAdjustments in class AbstractGrouper

Returns:

non-null List of CaseMixAdjustment items. If there was an error during initialization, the list may be empty

getNRSValidator

public HomeHealthRecordValidatorIF getNRSValidator()

Provides the validator for the Non-Routine Supplies portion of the scoring

Specified by:

getNRSValidator in interface HomeHealthGrouperIF

Returns:

HomeHealthRecordValidatorIF

getNonRoutineCodes

public java.util.List<DiagnosisCodeIF> getNonRoutineCodes()

gets a list of Diagnosis Codes for Non-routine Services

Specified by:

getNonRoutineCodes in interface HomeHealthGrouperIF

Overrides:

getNonRoutineCodes in class AbstractGrouper

Returns:

init

public void init(java.util.Properties props)
          throws java.lang.Exception

Sets up this version by loading the related Diagnosis code / Group data, and initializing the scoring models: 4 clinical/functional models (one for each equation), and one Non-Routine Supplies model

Specified by:

init in interface Initializable

Parameters:

props -

Throws:

java.lang.Exception

isValidDiagnosisCode

public boolean isValidDiagnosisCode(HomeHealthRecordIF record,
                           DiagnosisCodeIF code)

Description copied from interface: HomeHealthGrouperIF

Determines if the Diagnosis code is valid for this grouper

Specified by:

isValidDiagnosisCode in interface HomeHealthGrouperIF

Overrides:

isValidDiagnosisCode in class AbstractGrouper

Returns:

True if the code is valid for the grouper version and the effective data of the code

populateValidateClinicalCodes

public HomeHealthRecordValidatorIF populateValidateClinicalCodes(HomeHealthRecordIF record)

This method is not very efficient for scoring a record, since it populates the codes into the record each time, prior to validating them. However, it should give sufficient information about the which codes were used for scoring.

Specified by:

populateValidateClinicalCodes in interface HomeHealthGrouperIF

Parameters:

record -

Returns:

HomeHealthRecordValidatorIF, this value will never be null.

score

public ScoringResultsIF score(HomeHealthRecordIF record,
                     boolean validateDates,
                     CollectionValidationEditsIF validationEdits,
                     java.util.Collection<HomeHealthEventListenerIF> listeners)

Description copied from interface: HomeHealthGrouperIF

Scores the record using the supplied validation information (if non-null) instead of using the built in validation capabilities.

Specified by:

score in interface HomeHealthGrouperIF

Specified by:

score in class AbstractGrouper_2

validationEdits - - if non-null, then this information is used during scoring as the validation information, otherwise, if null, the built in validation is performed.

Returns:

non-null scoring details which includes the traditional HIPPS, Treatment Authorization, version name, and flags, plus the Validation information (either the one supplied on the method call or the results of the built in validation) and scoring process information (e.g. what item scored what value)

score

public ScoringResultsIF score(HomeHealthRecordIF recordOasisC,
                     boolean validateDates)

When scoring a recordOasisC, the data can either come from a OASIS-B or an OASIS-C source. The OASIS-C source needs to be converted to an OASIS-B prior to scoring. Then the parent scoring can be called.

Specified by:

score in interface HomeHealthGrouperIF

Overrides:

score in class AbstractGrouper_2

Parameters:

recordOasisC -

validateDates -

Returns:

a non-null Scoring Result that contains the scores for clinical / functional, and for NRS as well as the OASIS treatments and flags.

addEventListener

public void addEventListener(HomeHealthEventListenerIF listener)

Description copied from interface: HomeHealthEventNotifierIF

This method adds a HomeHealthEventListenerIF to the list of listeners.

Specified by:

addEventListener in interface HomeHealthEventNotifierIF

getEventListeners

public java.util.Iterator<HomeHealthEventListenerIF> getEventListeners()

Description copied from interface: HomeHealthEventNotifierIF

this method returns an enumerated list of HomeHealthEventListenerIF objects

Specified by:

getEventListeners in interface HomeHealthEventNotifierIF

Returns:

getEventListenersList

public java.util.List<HomeHealthEventListenerIF> getEventListenersList()

Description copied from interface: HomeHealthEventNotifierIF

gets the underlying list of listeners; a little more dangerous than using the getEventListeners() that returns the Iterator

Specified by:

getEventListenersList in interface HomeHealthEventNotifierIF

Returns:

notifyEventListeners

public void notifyEventListeners(HomeHealthEventIF event)

Description copied from interface: HomeHealthEventNotifierIF

Sends a event to the listeners.

Specified by:

notifyEventListeners in interface HomeHealthEventNotifierIF

removeEventListener

public void removeEventListener(HomeHealthEventListenerIF listener)

Description copied from interface: HomeHealthEventNotifierIF

Removes a single event listener from the list

Specified by:

removeEventListener in interface HomeHealthEventNotifierIF

removeEventListeners

public void removeEventListeners()

Description copied from interface: HomeHealthEventNotifierIF

Removes all the listeners from the list

Specified by:

removeEventListeners in interface HomeHealthEventNotifierIF

getListenerCount

public int getListenerCount()

Description copied from interface: HomeHealthEventNotifierIF

gets the number listeners

Specified by:

getListenerCount in interface HomeHealthEventNotifierIF

Returns:

the number of listeners available.