Skip to content

mi-erasmusmc/ets-rosetta-stone

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

34 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

eTransafe Rosetta Stone

The eTransafe Rosetta Stone is a Spring Boot application that exposes API endpoints for the translation between clinical and preclinical terminologies, normalization and lookup of terms, as well as hierarchical expansions of concepts. It was developed at the Erasmus Medical Centre department of Medical Informatics as part of the eTransafe project.

  • An online version of the eTransafe Rosetta Stone can be accessed here
  • API documentation is available here

REQUIREMENTS

  • The eTransafe Rosetta Stone database, it can be created with this code
  • Java 21+
  • Maven 3.9

HOW TO USE

  • Make sure you have the eTransafe Rosetta Stone database up and running
  • Configure your database settings in the application.yml in the ./src/main/resources folder under spring.datasource or set the relevant properties as environment variables
  • Run mvn spring-boot:run
  • When the app is running the API docs are exposed at http://localhost:8081/v2/swagger-ui/index.html#/

Note: The eTransafe Rosetta Stone has been developed with macOS and has been used extensively running in an Alpine container on Kubernetes. No testing has been done on any other operating systems.

ADDITIONAL OPTIONS

Authentication

It is possible to use the eTransafe Rosetta Stone in combination with Keycloak. To enable this set the environment variables auth.enabled = true and configure the toxhub.auth.url variable to provide the keycloak url

Caching

If you are planning heavy lifting with the eTransafe Rosetta Stone it is recommended you enable caching. At the present the caching has been optimized for use by the Sirona app which requests 1000s of translations at a time. You may find you need to be caching elsewhere for your specific usage. To enable caching you need to have a Redis instance that the app can connect to. You can for example run one in a docker container locally with docker run -d -p 6379:6379 redis:7. In addition, you need to remove spring.cache.type=NONE or set it to REDIS in the application.yml (or set it as environment variable)

UI

There is a UI available for end users to view translation between terminologies here

Docker

The Dockerfile in this repo runs the eTransafe Rosetta Stone in an Alpine container.

PUBLICATION

We are in the final stages of completing a publication about the eTransafe Rosetta Stone detailing its workings.

CONTRIBUTIONS

Contributions are welcome, please get in touch.

About

eTransafe Rosetta Stone is a terminology translation tool

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published