Difference between revisions of "HOWTO: Use the OpenEMR DICOM Web Viewer"

From OpenEMR Project Wiki
(added pics.)
 
m (→‎Introduction: corrected link)
 
(One intermediate revision by the same user not shown)
Line 1: Line 1:
'''v7 Update'''
'''v7 Update'''


'''''OK I PROBABLY WILL NOT BE ABLE TO GET THIS CORRECTED BEFORE NEXT WEEK.  iF IT LOOKS BAD, COME BACK IN A FEW DAYS'''''
= Introduction =
= Introduction =


This is an update and expansion of the original docs by the developer which are found at [DICOM_Uploader,_Storage_Engine_and_Viewer].  It shows the viewer, its features and usage as found in OpenEMR version 7.0.2 (1).
This is an update and expansion of the original docs by the developer which are found at [[DICOM_Uploader,_Storage_Engine_and_Viewer]].  It shows the viewer, its features and usage as found in OpenEMR version 7.0.2 (1).




Line 13: Line 12:
* Clicking on compatible files in a patient's Documents tree. Best for simple storage of the files, since network bandwidth limitations can slow down viewing and annotating.
* Clicking on compatible files in a patient's Documents tree. Best for simple storage of the files, since network bandwidth limitations can slow down viewing and annotating.
* Opening the viewer from OpenEMR's main menu at ‘Miscellaneous/ DICOM Viewer’. It uses a DICOM file that resides in the local computer, which makes for faster viewing.
* Opening the viewer from OpenEMR's main menu at ‘Miscellaneous/ DICOM Viewer’. It uses a DICOM file that resides in the local computer, which makes for faster viewing.


= Uploading Files =
= Uploading Files =
Line 54: Line 49:




[[Image:DicomUpdt04.png]]




Line 61: Line 57:




[[Image:DicomUpdt04.png|right]]
:B. 2nd button is to upload a folder that contains a collection of .dcm study files
:B. 2nd button is to upload a folder that contains a collection of .dcm study files
::* all files will be zipped by OpenEMR to conserve space on the server
::* all files will be zipped by OpenEMR to conserve space on the server
Line 80: Line 64:




/OR/ if no name is given it will be named <nowiki>'[date]DicomStudy.zip-[uniqueID]'</nowiki>
<nowiki> /OR/ if no name is given it will be named '[date]DicomStudy.zip-[uniqueID]'</nowiki>


[[Image:DicomUpdt05.png]]
[[Image:DicomUpdt05.png]]




3. Click blue 'Upload' button (image above) and approve it
3. Click blue 'Upload' button (previous image above) and approve it
 
 
 
 
 
 
 
 
 
 
 
 
The uploaded file will appear in the documents tree
 
 
 
 
 


The uploaded file will appear in the documents tree (oval above)




Line 157: Line 124:


4. Click 'Choose Files' and select the file to upload
4. Click 'Choose Files' and select the file to upload


5. Once the image is in the viewer the loading will stop.
5. Once the image is in the viewer the loading will stop.
Line 182: Line 148:
‘Wrench’: with image(s) loaded, shows tools appropriate to the image. In other words, if it is a zip file containing an entire study it has controls for managing multiple images.
‘Wrench’: with image(s) loaded, shows tools appropriate to the image. In other words, if it is a zip file containing an entire study it has controls for managing multiple images.


D11
 
[[Image:DicomUpdt103.png]]
[[Image:DicomUpdt103.png]]
‘DICOM tags’: shows the tags in the study
[[Image:DicomUpdt12.png|left]]




Line 200: Line 168:




[[Image:DicomUpdt12.png|left]]‘DICOM tags’: shows the tags in the study




Line 217: Line 173:


[[Image:DicomUpdt104.png|top]]
[[Image:DicomUpdt104.png|top]]
 
‘Annotations’: if any have been made (none here)
 






[[Image:DicomUpdt105.png|left]]
[[Image:DicomUpdt105.png|left]]
‘Image’: Toggle image visible or not


‘Annotations’: if any have been made




 
[[Image:DicomUpdt106.png|left]]
 
 
 
[[Image:DicomUpdt106.png|left]]‘Image’: Toggle image visible or not
 
 
 
 
 
 
[[Image:Image17.png|left]]
 
‘Info’: Toggle image info visible or not
‘Info’: Toggle image info visible or not






[[Image:DicomUpdt13.png]]
[[Image:DicomUpdt107.png|left]]
 
'?': The developer's help resources
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 


[[Image:DicomUpdt15.png]]




Line 272: Line 196:




[[Image:DicomUpdt107.png|left]]
‘?’: The developer's help resources
[[Image:DicomUpdt15.png|top]]


= Conclusion =
= Conclusion =


OpenEMR’s DICOM viewer is a useful tool for viewing DICOM studies and individual files. As mentioned elsewhere, it is not certified for diagnostic use so keep that in mind.
OpenEMR’s DICOM viewer is a useful tool for viewing DICOM studies and individual files. As mentioned elsewhere, it is not certified for diagnostic use so keep that in mind.

Latest revision as of 21:42, 12 September 2024

v7 Update

Introduction

This is an update and expansion of the original docs by the developer which are found at DICOM_Uploader,_Storage_Engine_and_Viewer. It shows the viewer, its features and usage as found in OpenEMR version 7.0.2 (1).


The OpenEMR DICOM Web Viewer (DWV) by Jerry Padgett is a tool with which a user can view and annotate DICOM images. Note: it is not certified for diagnostic use but can be used to determine if further investigation with a certified viewer is indicated.


Users can access DWV with two methods in OpenEMR:

  • Clicking on compatible files in a patient's Documents tree. Best for simple storage of the files, since network bandwidth limitations can slow down viewing and annotating.
  • Opening the viewer from OpenEMR's main menu at ‘Miscellaneous/ DICOM Viewer’. It uses a DICOM file that resides in the local computer, which makes for faster viewing.

Uploading Files

To start: have your DICOM files in a known location on your local computer.


Documents Tree Method

DicomUpdt01.png

1. Click the documents tree folder (here, using ‘Lab Reports’) where the DICOM content is to be stored.






2. Click a ‘Choose Files’ upload button (lettered in images below)


DicomUpdt03.png


A. 1st button is to upload individual .dcm files
  • files will be saved with existing file name



DicomUpdt04.png




B. 2nd button is to upload a folder that contains a collection of .dcm study files
  • all files will be zipped by OpenEMR to conserve space on the server
  • locate and click on the local folder name-- do not open the folder to display the files
  • DWV will gather the files into a zip file which will be named what you enter in the 'Optional Destination or Dicom Study Name' text area per the entry in the txt area


/OR/ if no name is given it will be named '[date]DicomStudy.zip-[uniqueID]'

DicomUpdt05.png


3. Click blue 'Upload' button (previous image above) and approve it

The uploaded file will appear in the documents tree (oval above)


4. To view the file or DICOM study click on the .dcm or the .zip file in the tree displayNotes:

  • the upload can be slow depending on your system bandwidth, and your server may timeout if if it does not allow enough time. In my test environment a folder containing 500 files of 45kb each took appx 1 minute (60 seconds)
  • If viewing zip files larger than a few dozen mb the viewer may be slow or the progress bar could stop. Try downloading the file to the local computer and opening the DWV through the OpenEMR Main Menu (see below).
  • when upload to repository or viewer is complete the progress bar disappears and the upload buttons say '0 file'



OpenEMR Main Menu Method

1. From the Main Menu open the Viewer: ‘Miscellaneous/Dicom Viewer’

DicomUpdt07.png


2. Click the file icon to show the 'file open' control




DicomUpdt08.png



DicomUpdt09.png

3. Select from dropdown either 'File' or 'Folder'

  • 'File'/'Folder' opens similarly to first and second buttons, respectively, in documents tree method described above
  • 'Choose Files ' gives upload dialog to load file(s) same as above
  • 'URL' option is not developed at present
  • 'Download Image Edits' - if available







4. Click 'Choose Files' and select the file to upload

5. Once the image is in the viewer the loading will stop.

Click red X at top right of load dialog (above)


6. Use toolbar at top right to work with DICOM file (see in step 2 above)

Quick summary of tools

** Viewer operation is not described here **


DicomUpdt101.png

‘Page’: toggles file load dialog (shown above)


DicomUpdt102.png

‘Wrench’: with image(s) loaded, shows tools appropriate to the image. In other words, if it is a zip file containing an entire study it has controls for managing multiple images.


DicomUpdt103.png ‘DICOM tags’: shows the tags in the study

DicomUpdt12.png











DicomUpdt104.png ‘Annotations’: if any have been made (none here)


DicomUpdt105.png

‘Image’: Toggle image visible or not


DicomUpdt106.png

‘Info’: Toggle image info visible or not


DicomUpdt107.png

'?': The developer's help resources

DicomUpdt15.png




Conclusion

OpenEMR’s DICOM viewer is a useful tool for viewing DICOM studies and individual files. As mentioned elsewhere, it is not certified for diagnostic use so keep that in mind.