Getting started

Introduction

einmind is a Python client library that interfaces with the EinMind servers, where the actual processing of mapping free-text medical terms to ICD-10-CM and SNOMED CT codes occurs. The library facilitates this mapping through its client APIs, which connect to the publicly available Einmind servers. These public APIs are suitable for applications with limited coding needs.

For users with higher processing demands, it is recommended to deploy the Einmind API in their own cloud environments. The Einmind API is available for deployment through the Azure Marketplace, allowing users to manage larger loads and maintain control over their data processing and storage.

Supported Python versions

Python 3.7 and higher

Installation

pip install einmind

ICD-10-CM Term Mapping

from einmind import ICD10CMClient
icd10cm_client = ICD10CMClient()
result = icd10cm_client.code_term(term='headache')
print(result)

SNOMED CT Term Mapping

from einmind import SNOMEDCTClient

# Initialize the SNOMED CT Client
snomed_client = SNOMEDCTClient()

# Code a disease term
result = snomed_client.code_term(term='headache', term_category="PROBLEM")

# Code a procedure term
result = snomed_client.code_term(term='colonoscopy', term_category="PROCEDURE")

Connecting to private instance

from einmind import ICD10CMClient
from einmind import SNOMEDCTClient


# Initialize the ICD10CM Client
icd10cm_client = ICD10CMClient(
    base_url="<base_url>:<port_number>",
    api_key="<api key>",
)

# Initialize the SNOMED CT Client
snomed_client = SNOMEDCTClient(
    base_url="<base_url>:<port_number>",
    api_key="<api key>",
)