Ariadne

Ariadne is a Python toolkit for mapping source terminologies to standard concepts in the OHDSI Vocabulary.

Features

• Verbatim term mapping: maps terms that (almost) exactly match standard concepts. Using term normalization techniques like lowercasing, punctuation removal, and word stemming.
• Embedding vector search: leverages embedding language models to find semantically similar standard concepts for source terms.
• Exact term mapping: using reasoning LLMs to find exact matches in the vocabulary.
• Evaluation: uses golden standard mappings to evaluate mapping performance.

Documentation

Comprehensive documentation is available on the Ariadne Documentation Site.

Installation

Prerequisites

• Python 3.12 or higher.

Install from Source

git clone [https://github.com/OHDSI/ariadne.git](https://github.com/OHDSI/ariadne.git)
cd ariadne

pip install -e .

Configuration

Ariadne uses environment variables for database connections and API keys.

1. Copy the example configuration:

   cp .env.example .env

2. Edit the .env file to set your database connection details and API keys. Do not commit this file to version control. We recommend moving it to a secure location outside the project directory.

License

This project is licensed under the Apache 2.0 License. See the LICENSE file for details.