Usagi is an application to help create mappings between coding systems and the Vocabulary standard concepts.

• Automatically creates an initial full mapping based on term similarity.
• Uses concept names and synonyms to find potential matches.
• Optionally use names and synonyms of source concepts to find potential matches.
• Allows filtering the search results based on target vocabulary, domain, concept class, as well as user-defined subsets of concepts.
• Interactive review and correction of the initial mapping.
• Inspect information about target concepts, such as their parents, children, and source concepts.
• Export to source_to_concept_map format.
• Apply an old mapping to an updated set of source codes. Useful for when the vocab or the set of source codes has updated (or both).

Usagi is a pure Java application. It makes use of Apache's Lucene Java library for term matching, Apache's POI Java libraries to read Excel files, and Oracle's Berkeley DB to store concept information.

Requires Java 1.8 or higher. Java can be downloaded from http://www.java.com.

• Vocabulary version 5 files. These can be obtained from Athena.

1. Get the latest version of the vocabulary from Athena.
2. Under the Releases tab, download Usagi*.jar.
3. Click on Usagi_vx.x.x.jar to start Usagi.
4. Usagi will prompt you to specify the location of the Vocabulary files to create the index (needs to be done only once).

The creation of the vocabulary index is a computationally expensive process and can take hours to complete. It has to be done only once and the resulting index files can be copied over to a new version of Usagi.

If the index creation does not finish within a few hours and seems to be stuck, please try to run the Usagi jar from the command line instead of clicking the jar (java -jar Usagi_vx.x.x.jar). Although this solution is not thoroughly tested, users have reported that this might help (issue #64).

• User guide and Help: Usagi Wiki
• Developer questions/comments/feedback: OHDSI Forum
• We use the GitHub issue tracker for all bugs/issues/enhancements

Usagi is licensed under Apache License 2.0.

Usagi is being developed in Eclipse. Contributions are welcome.

Ready for use.

Martijn Schuemie is the author of this application.