acronym-unpacker

name	acronym-unpacker
description	Disambiguate medical acronyms and abbreviations with context-aware full form lookup. Resolves ambiguous abbreviations (e.g., 'PID' = Pelvic Inflammatory Disease vs. Prolapsed Intervertebral Disc) based on clinical specialty, document context, and usage patterns.
version	1.0.0
category	Utility
tags	["acronyms","medical-terminology","disambiguation","clinical"]
author	AIPOCH
license	MIT
status	Draft
risk_level	Medium
skill_type	Tool/Script
owner	AIPOCH
reviewer
last_updated	2026-02-15

Acronym Unpacker

Intelligent medical abbreviation disambiguation tool that resolves ambiguous acronyms using clinical context, specialty-specific knowledge, and document-level semantic analysis.

Features

• Context-Aware Disambiguation: Uses clinical specialty to rank expansions
• Semantic Analysis: Analyzes surrounding text for contextual clues
• Frequency-Based Ranking: Prioritizes common usage patterns
• Multi-Specialty Support: Covers medicine, nursing, pharmacy, and research
• Batch Processing: Expand acronyms in entire documents
• Learning System: Improves accuracy with usage feedback

Usage

Basic Usage

# Expand single acronym
python scripts/main.py PID

# Expand with context
python scripts/main.py MI --context cardiology

# List known acronyms
python scripts/main.py --list

Parameters

Parameter	Type	Default	Required	Description
acronym	str	None	Yes	Acronym to expand
--context, -c	str	general	No	Clinical context (e.g., cardiology, gynecology)
--list, -l	flag	False	No	List known acronyms

Advanced Usage

# Disambiguate with specific context
python scripts/main.py PID --context gynecology

# Check all available acronyms
python scripts/main.py --list

Supported Acronyms

Acronym	General	Cardiology	Gynecology	Immunology
PID	Pelvic Inflammatory Disease	-	Pelvic Inflammatory Disease (90%)