Registry / data / icd-mappings

icd-mappings

library0.6.2pypypi✓ verified 79d ago

Python tool for mapping ICD diagnostic codes across classifications (e.g., ICD-10 to CCS, CCI, CCC, ICD-9, chapters, blocks). Current version 0.6.2, supports Python 3.8-3.14. Active development with monthly releases.

data serialization

pip install icd-mappings

github ↗package ↗

INSTALL

IMPORT

SIG · ICD-MAPPINGS

icd-mappings

datapythonv0.6.2

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Mapper

✓ from icdmappings import Mapper

✗ from icd_mappings.mappers import Icd10Mapper

Initialize a mapper and convert ICD-10 codes to chapters or blocks.

from icd_mappings.mappers import Icd10Mapper mapper = Icd10Mapper() # Map single code print(mapper.map('J45.0', target='chapter')) # '10 - Diseases of the respiratory system' # Map multiple codes codes = ['J45.0', 'E11.9'] results = {code: mapper.map(code, target='blocks') for code in codes} print(results)

icdm --version

Debug

Known issues

breakingIn v0.3.0, mappers no longer raise errors for unmappable codes; they return None. Code that relied on exceptions will break.

fix

Update code to handle None returns instead of catching exceptions.

affects: <0.3.0

deprecatedTop-level imports like `from icd_mappings import Icd10Mapper` were removed in v0.3.0.

fix

Use `from icd_mappings.mappers import Icd10Mapper`.

affects: <0.3.0

gotchaInput codes work with or without dots (normalized automatically). However, be aware that normalization removes dots before validation, so 'J450' and 'J45.0' are treated identically.

fix

No fix needed; rely on consistency.

affects: >=0.5.0

gotchaMapper data is downloaded on first use; ensure internet connectivity or preload data.

fix

Use `mapper = Icd10Mapper(use_cache=True)` to cache data locally.

affects: all

Upgrade

Version history

0.6.2latest on PyPI · released Apr 27, 2026

Audit

Dependencies

pandasrequiredUsed for data handling and mapping tables.

requestsrequiredDownloading mapping data files.

Agent activity

9 hits · last 30 days

node

Resources

githubhttps://github.com/snovaisg/ICDMappings ↗

packagehttps://pypi.org/project/icd-mappings/ ↗