Background
The module has been worked on by different groups historically. Please refer to
Radiology Module with dcm4chee (2014)
if you want to know more about the modules origin.
Vision
The OpenMRS radiology module aims at adding capabilities of a Radiology Information System (RIS) onto OpenMRS.
Features
The module can connect OpenMRS to any Picture archiving and communication system (PACS) which accepts radiology order entries via HL7 v2.3.1 ORM messages.
Current set of features:
- place radiology orders from within OpenMRS which are sent to the PACS via HL7 v2.3.1 ORM messages
- configure a set of concept classes to define the orderable imaging procedures at the healthcare facility
- listen to radiology order status updates from imaging modalities (via DICOM MPPS messages) and show their updated status within OpenMRS
- configure a DICOM web viewer like oviyam or weasis to open the ordered radiology studies from within OpenMRS
Limitations
The module has not yet been officially released. We are working very hard on a first release. Please watch https://issues.openmrs.org/browse/RAD for any updates.
The module is currently only tested in conjunction with the open source PACS dcm4che which supports order entries via HL7 v2.3.1 ORM messages.
Installation
The quickest way to setup a virtual machine with the required version of OpenMRS and an instance of the dcm4chee PACS ready for you to deploy the module is to use:
https://github.com/teleivo/puppet-openmrs-radiologydcm4chee
Configuration
To configure the radiology module and the dcm4chee PACS refer to the Install Guide
Please note that the install guide is currently not up to date with the latest state of the codebase, it is however a good starting point. We are working on it
IMPORTANT: since this was source of confusion once you upload the module, you need to go to Administration --> Settings --> Radiology and configure the "Radiology Concept Classes"
You can add a list of comma separated concept class UUIDs. To get these concept class UUIDs go to Administration --> Manage Concept Classes and click on one concept class like for example "Test".
You can then see the UUID in grey at the bottom
Copy paste it into the radiology module setting "Radiology Concept Classes", save and you are ready to add radiology orders!
Requirements
The general requirements for installing and using the module are
OpenMRS Version: 1.11.x
Operating Systems: currently tested on Ubuntu 14.04 64bit.
Browsers: Chrome or Firefox.
Issues
If you find a bug or want to contribute please refer to
https://issues.openmrs.org/browse/RAD
Questions
For any questions on the module please have a look at https://talk.openmrs.org/
Your question might have already been answered. If not just create a new topic and dont forget to tag it with "radiology".
Contributing
Feel free to join development!
Check out issues that are ready to be worked on: https://issues.openmrs.org/browse/RAD
Apply for the Google Summer of Code 2016:
Resources
- Source code: https://github.com/openmrs/openmrs-module-radiology
- Setup of virtual machine with OpenMRS and dcm4chee PACS: https://github.com/teleivo/puppet-openmrs-radiologydcm4chee
- Install Guide
- User Guide
- dcm4chee PACS: http://www.dcm4che.org/
- dcm4chee google group: https://groups.google.com/forum/#!forum/dcm4che