https://github.com/imsweb/algorithms

Java implementation of cancer-related algorithms (NHIA, NAPIIA, Survival Time, etc...)
https://github.com/imsweb/algorithms

cancer napiia nhia seer survival

Last synced: 16 days ago
JSON representation

Java implementation of cancer-related algorithms (NHIA, NAPIIA, Survival Time, etc...)

• Host: GitHub
• URL: https://github.com/imsweb/algorithms
• Owner: imsweb
• License: other
• Created: 2015-11-30T14:32:56.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2026-05-14T19:00:59.000Z (30 days ago)
• Last Synced: 2026-05-14T21:06:07.041Z (29 days ago)
• Topics: cancer, napiia, nhia, seer, survival
• Language: Java
• Size: 222 MB
• Stars: 7
• Watchers: 9
• Forks: 6
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# SEER Algorithms

[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=imsweb_algorithms&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=imsweb_algorithms)

[![integration](https://github.com/imsweb/algorithms/workflows/integration/badge.svg)](https://github.com/imsweb/algorithms/actions)

[![Maven Central](https://img.shields.io/maven-central/v/com.imsweb/algorithms.svg)](https://central.sonatype.com/artifact/com.imsweb/algorithms)

This library contains the Java implementations of algorithms used in cancer-related data processing.

## Features

The following algorithms are available:

* SEER Site Recode ([SeerSiteRecodeUtils](https://github.com/imsweb/algorithms/tree/master/src/main/java/com/imsweb/algorithms/seersiterecode/SeerSiteRecodeUtils.java))

* SEER International Classification of Childhood Cancer ([IcccRecodeUtils](https://github.com/imsweb/algorithms/tree/master/src/main/java/com/imsweb/algorithms/iccc/IcccRecodeUtils.java))

* SEER SEER Adolescents and Young Adults (AYA) Site Recode ([AyaSiteRecodeUtils](https://github.com/imsweb/algorithms/tree/master/src/main/java/com/imsweb/algorithms/ayasiterecode/AyaSiteRecodeUtils.java))

* SEER Cause-specific Death Classification ([CauseSpecificUtils](https://github.com/imsweb/algorithms/tree/master/src/main/java/com/imsweb/algorithms/causespecific/CauseSpecificUtils.java))

* SEER Survival Time in Months ([SurvivalTimeUtils](https://github.com/imsweb/algorithms/tree/master/src/main/java/com/imsweb/algorithms/survival/SurvivalTimeUtils.java))

* SEER Lymphoid Neoplasm Recode ([LymphoidNeoplasmRecodeUtils ](https://github.com/imsweb/algorithms/blob/master/src/main/java/com/imsweb/algorithms/lymphoma/LymphoidNeoplasmRecodeUtils.java))

* SEER Derived Summary Grade ([DerivedSummaryGradeUtils](https://github.com/imsweb/algorithms/blob/master/src/main/java/com/imsweb/algorithms/derivedgrade/DerivedSummaryGradeUtils.java))

* SEER Behavior Recode ([BehaviorRecodeUtils](https://github.com/imsweb/algorithms/tree/master/src/main/java/com/imsweb/algorithms/behavrecode/BehaviorRecodeUtils.java))

* SEER Brain/CNS Recode ([BrainCnsRecodeUtils](https://github.com/imsweb/algorithms/blob/master/src/main/java/com/imsweb/algorithms/braincnsrecode/BrainCnsRecodeUtils.java))

* SEER Days from Diagnosis to Treatment ([DaysToTreatmentAlgorithm](https://github.com/imsweb/algorithms/blob/master/src/main/java/com/imsweb/algorithms/daystotreatment/DaysToTreatmentAlgorithm.java))

* SEER Tumor Size Over Time ([TumorSizeOverTimeUtils](https://github.com/imsweb/algorithms/blob/master/src/main/java/com/imsweb/algorithms/tumorsizeovertime/TumorSizeOverTimeUtils.java))

* SEER Site-specific Surgery tables ([SiteSpecificSurgeryUtils](https://github.com/imsweb/algorithms/tree/master/src/main/java/com/imsweb/algorithms/surgery/SiteSpecificSurgeryUtils.java))

* SEER ICD Conversions ([IcdUtils](https://github.com/imsweb/algorithms/tree/master/src/main/java/com/imsweb/algorithms/icd/IcdUtils.java))

* NAACCR County at Diagnosis Analysis ([CountyAtDxAnalysisUtils](https://github.com/imsweb/algorithms/tree/master/src/main/java/com/imsweb/algorithms/countyatdiagnosisanalysis/CountyAtDxAnalysisUtils.java))

* NAACCR Asian/Pacific Islander Identification Algorithm ([NapiiaUtils](https://github.com/imsweb/algorithms/tree/master/src/main/java/com/imsweb/algorithms/napiia/NapiiaUtils.java))

* NAACCR Hispanic Identification Algorithm ([NhiaUtils](https://github.com/imsweb/algorithms/tree/master/src/main/java/com/imsweb/algorithms/nhia/NhiaUtils.java))

* NAACCR Poverty Linkage Program ([CensusTractPovertyIndicatorUtils](https://github.com/imsweb/algorithms/tree/master/src/main/java/com/imsweb/algorithms/censustractpovertyindicator/CensusTractPovertyIndicatorUtils.java))

* NAACCR Rural Urban Program (RUCA/URIC/Continuum) ([RuralUrbanUtils](https://github.com/imsweb/algorithms/tree/master/src/main/java/com/imsweb/algorithms/ruralurban/RuralUrbanUtils.java))

* NAACCR Yost Quintile & Area-Based Social Measures Linkage Program ([YostAcsPovertyUtils](https://github.com/imsweb/algorithms/tree/master/src/main/java/com/imsweb/algorithms/yostacspoverty/YostAcsPovertyUtils.java))

* NAACCR Cancer Reporting Zones ([CancerReportingZoneUtils](https://github.com/imsweb/algorithms/blob/master/src/main/java/com/imsweb/algorithms/cancerreportingzone/CancerReportingZoneUtils.java))

* NAACCR Tract-Estimated Congressional Districts ([TractEstCongressDistUtils](https://github.com/imsweb/algorithms/blob/master/src/main/java/com/imsweb/algorithms/tractestcongressdist/TractEstCongressDistUtils.java))

* NPCR PRCDA Linkage Program ([PrcdaUtils](https://github.com/imsweb/algorithms/blob/master/src/main/java/com/imsweb/algorithms/prcda/PrcdaUtils.java))

* NPCR UIHO Linkage Program ([UihoUtils](https://github.com/imsweb/algorithms/blob/master/src/main/java/com/imsweb/algorithms/uiho/UihoUtils.java))

* NPCR EPHT SubCounty ([EphtSubCountyUtils](https://github.com/imsweb/algorithms/blob/master/src/main/java/com/imsweb/algorithms/ephtsubcounty/EphtSubCountyUtils.java))

* CDC/ATSDR Social Vulnerability Index ([SocialVulnerabilityIndexUtils](https://github.com/imsweb/algorithms/blob/master/src/main/java/com/imsweb/algorithms/svi/SocialVulnerabilityIndexUtils.java))

* IARC Multiple Primary Algorithm ([IarcUtils](https://github.com/imsweb/algorithms/tree/master/src/main/java/com/imsweb/algorithms/iarc/IarcUtils.java))

* Persistent Poverty ([PersistentPovertyAlgorithm](https://github.com/imsweb/algorithms/blob/master/src/main/java/com/imsweb/algorithms/persistentpoverty/PersistentPovertyAlgorithm.java))

## Download

The library is available on [Maven Central](http://search.maven.org/#search%7Cga%7C1%7Cg%3A%22com.imsweb%22%20AND%20a%3A%22algorithms%22).

To include it to your Maven or Gradle project, use the group ID `com.imsweb` and the artifact ID `algorithms`.

You can check out the [release page](https://github.com/imsweb/algorithms/releases) for a list of the releases and their changes.

## Algorithm versions

To know the version of a specific algorithm, click the link to the corresponding utility class and check the static variables defined on the top of the class.

Not all algorithms support a version.

This library does not support several versions of a given algorithm; it only contains the latest version available.

## Usage

There two ways to use this library: 

1. Every algorithm has a utility class that exposes one or several computation methods; those methods can be called directly.

2. Every algorithm also has an implementation of the Algorithm class which exposes a unified execute method.

The Algorithms class acts as a repository of all the algorithms and their input/output fields.

## About SEER

This library was developed through the [SEER](https://seer.cancer.gov/) program.

The Surveillance, Epidemiology and End Results program is a premier source for cancer statistics in the United States.

The SEER program collects information on incidence, prevalence and survival from specific geographic areas representing

a large portion of the US population and reports on all these data plus cancer mortality data for the entire country.