####Table of Contents

1. Overview
2. Build
3. Install

• Docker
• Demo data

4. Documentation

• Website
• Developer guides
• Wiki

5. Contributing

• Code
• Translation

6. Issues
7. Limitations
8. Community
9. Support
10. License

OpenMRS module radiology (previously called radiologydcm4chee) is a module adding capabilities of a Radiology Information System (RIS) onto OpenMRS.

You need to have installed

• a Java JDK 8
• the build tool Maven

You need to configure Maven to use the JAVA JDK 8

mvn -version

Should tell you what version Maven is using.

You need to clone this repository:

git clone https://github.com/openmrs/openmrs-module-radiology.git

After you have taken care of the Prerequisites

Execute the following command:

cd openmrs-module-radiology
mvn clean package

This will generate the radiology module in omod/target/radiology-{VERSION}.omod which you will have to deploy into OpenMRS.

The easiest way to install the module is to use Docker.

This module can be baked into a Docker image so you can easily run and test it.

After you have taken care of the Build Prerequisites

Make sure you have Docker installed.

Build the Radiology Module and its Docker image:

cd openmrs-module-radiology
mvn clean package docker:build

To run an instance of the OpenMRS Radiology Module execute (assumes you have created a Docker image):

cd openmrs-module-radiology
mvn docker:start

OpenMRS will be accessible at http://<IP ADDRESS>:8080/openmrs

NOTE: The IP address varies depending on your setup.

If you are using Docker machine refer to its documentation on how to get the IP address. If you are on Linux it will probably be will be localhost.

Please read the corresponding DOCKER.md for more detailed explanations on using Docker with the Radiology Module.

You can import the demo data set demo-data.sql into your database which enables you to try out the modules features or test your changes.

Please read the corresponding DEMO-DATA.md.

For a detailed guide on ways to install and configure this module see

http://teleivo.github.io/docs-openmrs-module-radiology/

Please check out the readme files at docs.

For some more background informations on the module see

https://wiki.openmrs.org/display/docs/Radiology+Module

Contributions are very welcome, we can definitely use your help!

Check out our contributing guidelines, read through the Developer guides.

After you've read up 👓 grab an issue that is Ready For Development.

We use

https://www.transifex.com/openmrs/OpenMRS/radiology-module/

to manage our translations.

The messages.properties file in this repository is our single source of truth. It contains key, value pairs for the English language which is the default.

Transifex fetches updates to this file every night which can then be translated by you and me on transifex website itself. At any time we can pull new translations from transifex back into this repository. Other languages like for ex. Spanish will then be in the messages_es.properties file.

If you would like to know more about transifex from the coding side read

https://wiki.openmrs.org/display/docs/Maintaining+OpenMRS+Module+Translations+via+Transifex

To file new issues or help to fix existing ones please check out

https://issues.openmrs.org/browse/RAD

This module is not yet officially released to the openmrs modules.

The API and UI are not yet stable and subject to frequent changes.

The module depends on OpenMRS Version 2.0.0 so it cannot run on any version lower than that.

The module currently depends on OpenMRS Legacy UI which provides the UI but it is planned to extract the UI into a separate module so this module only provides the Java and REST API without forcing a specific UI onto anyone.

Ask questions on OpenMRS Talk.

MPL 2.0 w/ HD © OpenMRS Inc.