Skip to content
Usagi is an application to help create mappings between coding systems and the Vocabulary standard concepts.
Java HTML
Branch: master
Clone or download
Latest commit c192ea9 May 31, 2019

README.md

alt text Usagi

Introduction

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

Features

  • 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).

Screenshot

Usagi

Technology

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.

System Requirements

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

Dependencies

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

Getting Started

  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).

Getting Involved

License

Usagi is licensed under Apache License 2.0.

Development

Usagi is being developed in Eclipse. Contributions are welcome.

Development status

Ready for use.

Acknowledgements

Martijn Schuemie is the author of this application.

You can’t perform that action at this time.