codeDx

codeDx (pronounced code-dex) is a codex for medical diagnosis codes — a lookup library for Swedish healthcare datasets. Install as pip install codedx, import as import codedx.

Built for regional datasets where ICD-10-SE (specialist care), KSH97-P (primary care), and rehab function codes coexist across many years and releases.

import codedx

# J440 exists in WHO, ICD-10-CM and ICD-10-SE
codedx.get_name("J440")               # 'Chronic obstructive pulmonary disease...'
codedx.get_name("J440", lang="sv")    # 'Kroniskt obstruktiv lungsjukdom...'
codedx.is_icd10who_code("J440")       # True
codedx.is_icd10cm_code("J440")        # True
codedx.is_icd10se_code("J440")        # True

codedx.get_ancestors("R060")          # ('R060', 'R06', 'R00-R09', '18')

# code_systems maps each system to its name in that system
codedx.code_systems("A00")
# {'icd10who': 'Cholera', 'icd10cm': 'Cholera', 'icd10se': 'Kolera'}
codedx.code_systems("UA3290")         # {'rehab': 'Kommunicera, att vara mottagare...'}

# KSH97-P sometimes uses colloquial names — G258 is 'Restless legs' in primary care
# but 'Andra specificerade basalgangliesjukdomar och rörelserubbningar' in ICD-10-SE
codedx.code_systems("G258")
# {'icd10se': 'Andra specificerade basalgangliesjukdomar och rörelserubbningar',
#  'ksh97p': 'Restless legs'}

Dots are dropped throughout, matching what is typically found in databases: A011 not A01.1.

Installation

pip install codedx

Downloads data at install time. Raw files are not redistributed due to licence restrictions.

Data sources

Classification files come from two Swedish authorities:

Ehälsomyndigheten maintains ICD-10-SE and KSH97-P. Files are downloaded from their Confluence collaboration platform. KSH97-P (primary care classification) is being phased out in favour of ICD-10-SE.

Socialstyrelsen retains responsibility for the NordDRG system and the associated rehab function codes (UA/UB series). These files are downloaded from Socialstyrelsen's website.

WHO ICD-10 (English) and ICD-10-CM are downloaded from WHO and the US CDC respectively.