com.imsweb.algorithms.cancerreportingzone.CancerReportingZoneUtils Maven / Gradle / Ivy

Go to download
/*
 * Copyright (C) 2021 Information Management Services, Inc.
 */
package com.imsweb.algorithms.cancerreportingzone;

public class CancerReportingZoneUtils {

    public static final String ALG_NAME = "Cancer Reporting Zones";
    public static final String ALG_VERSION = "1.0";
    public static final String ALG_INFO = "Cancer Reporting Zones version 1.0 released in August 2021";

    //Unknown values for each code
    public static final String CANCER_REPORTING_ZONE_UNK_A = "A";
    public static final String CANCER_REPORTING_ZONE_UNK_C = "C";
    public static final String CANCER_REPORTING_ZONE_UNK_D = "D";

    // data provider
    private static CancerReportingZoneDataProvider _PROVIDER;

    /**
     * Calculates the Cancer Reporting Zone for the provided input DTO
     * 


     * The provided input dto has the following parameters used in the calculation:
     * 
     * addressAtDxState (#80)
     * countyAtDxAnalysis (#89)
     * censusTract2010 (#135)
     * 
     * All those properties are defined as constants in this class.
     * 


     * The returned Cancer Reporting Zone will be a 5-digit or 7-digit alphanumeric code or it can be one of the unknown values listed below :
     * 
     * A = State, county, or tract are invalid
     * B = State and tract are valid, but county was not reported
     * C = State + county + tract combination was not found
     * D = State, county, or tract are blank or unknown/li>
     * 
     * 


     * @param input a CancerReportingZoneInputDto input object
     * @return the computed Cancer Reporting Zone value
     */
    public static CancerReportingZoneOutputDto computeCancerReportingZone(CancerReportingZoneInputDto input) {
        CancerReportingZoneOutputDto result = new CancerReportingZoneOutputDto();
        input.applyRecodes();

        if (!input.isStateValidOrMissingOrUnknown() || !input.isCountyValidOrMissingOrUnknown() || !input.isCensusTract2010ValidOrMissingOrUnknown())
            result.setCancerReportingZone(CANCER_REPORTING_ZONE_UNK_A);
        else if (input.isStateMissingOrUnknown() || input.isCountyMissingOrUnknown() || input.isCensusTract2010MissingOrUnknown())
            result.setCancerReportingZone(CANCER_REPORTING_ZONE_UNK_D);
        else if ("000".equals(input.getCountyAtDxAnalysis()))
            result.setCancerReportingZone("B");
        else {
            if (_PROVIDER == null)
                initializeInternalDataProvider();
            result.setCancerReportingZone(_PROVIDER.getCancerReportingZone(input.getAddressAtDxState(), input.getCountyAtDxAnalysis(), input.getCensusTract2010()));
        }
        if (result.getCancerReportingZone() == null)
            result.setCancerReportingZone(CANCER_REPORTING_ZONE_UNK_C);

        return result;
    }

    /**
     * Use this method to register your own data provider instead of using the internal one that is entirely in memory.
     * 


     * This has to be done before the first call to the compute method, or the internal one will be registered by default.
     * 


     * Once a provider has been set, this method cannot be called (it will throw an exception).
     * @param provider the CancerReportingZoneDataProvider to set
     */
    public static synchronized void setDataProvider(CancerReportingZoneDataProvider provider) {
        if (_PROVIDER != null)
            throw new RuntimeException("The data provider has already been set!");
        _PROVIDER = provider;
    }

    private static synchronized void initializeInternalDataProvider() {
        if (_PROVIDER != null)
            return;
        _PROVIDER = new CancerReportingZoneCsvData();
    }
}