anatomic-locations 0.2.1

Anatomic location ontology navigation

anatomic-locations

Python library for anatomic location ontology navigation: hierarchy traversal, laterality variants, and semantic search.

Installation

pip install anatomic-locations

Features

• Hybrid Search: Combined full-text and semantic vector search
• Hierarchy Navigation: Traverse parent/child relationships with tree visualization
• Laterality Variants: Generate left, right, bilateral variants
• Auto-Download: Database downloads automatically on first use
• Flexible Lookup: Use location IDs (RID*) or names/synonyms

Quick Start

The database auto-downloads on first use. No setup required.

from anatomic_locations import AnatomicLocationIndex

with AnatomicLocationIndex() as index:
    location = index.get("RID2772")  # Kidney
    print(location.description)       # "kidney"
    print(location.region.value)      # "Abdomen"

Configuration

Override the default database path via environment variable or constructor:

# Environment variable
export ANATOMIC_DB_PATH=/path/to/custom.duckdb

# Or specify directly
index = AnatomicLocationIndex(db_path="/path/to/custom.duckdb")

CLI

The anatomic-locations CLI provides search, hierarchy navigation, and lookup commands. Use location IDs (e.g., RID2772) or names (e.g., "stomach"):

# Semantic search
anatomic-locations search "posterior cruciate ligament"

# Show full hierarchy tree
anatomic-locations hierarchy stomach

See the full CLI reference for all commands.

Related Packages

• findingmodel-ai: AI-assisted anatomic location discovery
• findingmodel: Core finding model library

Documentation

• Anatomic Locations Guide - Full CLI reference, Python API, and configuration