Orthanc Explorer 2 plugin¶

User permissions and web diffusion¶

Check the documentation of the orthanc-auth-service companion web service that provides user permissions and sharing of studies.

Direct access to a selection of studies¶

You may open the OE2 interface directly on a specific study or patient by specifying DICOM Tags directly in the URL. e.g:

http://localhost:8042/ui/app/#/filtered-studies?PatientID="00000169"
http://localhost:8042/ui/app/#/filtered-studies?StudyDate=20220512-20220513&ModalitiesInStudy=CR\DX
http://localhost:8042/ui/app/#/filtered-studies?StudyInstanceUID="1.2.3"
http://localhost:8042/ui/app/#/filtered-studies?StudyInstanceUID="1.2.3"&expand
http://localhost:8042/ui/app/#/filtered-studies?StudyInstanceUID="1.2.3"&expand=study
http://localhost:8042/ui/app/#/filtered-studies?StudyInstanceUID="1.2.3"&expand=series

By default, OE2 will add a wildcard * at the beginning and at the end of the search text. Therefore, searching for PatientID=1234 will actually search for PatientID=*1234*. If you do not want to have these extra wildcards added, you should use " at the beginning and/or at the end of the search text. Therefore, searching for PatientID="1234" will return only the studies whose PatientID is exactly 1234. These " can also be used in the User Interface search fields.

DICOM Modifications¶

Since version 0.6.0, it is possible to edit some of the DICOM Tags directly in the User Interface. DICOM Modification is quite a complex topic that is provided by Orthanc Rest API. The Orthanc Explorer 2 User Interface aims at simplifying its use but is also limiting it to common use cases mainly related to correcting errors in Patient and Study DICOM Tags.

At study level, it is possible to:

• Modify a Study
  • to attach it to another existing patient by providing the PatientID if e.g. the study was acquired for the wrong patient.
  • to edit the patient in all its studies if e.g. the PatientName was misspelled.
  • correct patient or study tags in this study only if e.g. the StudyDescription was incorrect.
• Anonymize a Study and possibly provide the anonymized PatientID or PatientName to e.g. force it to a specific identifier for a clinical study.

At series level, it is possible to:

• Modify a Series
  • to move it to another existing study by providing the StudyInstanceUID if e.g. the operator forgot to switch patient in the modality
  • to move it to a new study if e.g. the operator forgot to switch patient in the modality
  • correct series tags in this series only if e.g. the SeriesDescription was incorrect.
• Anonymize a Series and possibly provide the anonymized PatientID or PatientName to e.g. force it to a specific identifier for a clinical study.

Each time you modify a study, the user interface might propose you 3 modification modes related to the handling of the DICOM identifiers .

• You may modify the original study and have Orthanc generates new StudyInstanceUID, SeriesInstanceUID and SOPInstanceUID DICOM Tags. This means the that orthanc identifiers will change and the source study will be deleted.
• You may keep the original StudyInstanceUID, SeriesInstanceUID and SOPInstanceUID DICOM Tags. This means the that orthanc identifiers will not change (unless you also change the PatientID and the study will be modified “in place”).
• You may keep the original study and create a modified copy. In this case, of course, the new modified copy will have a different orthanc identifiers.

There are many options related to DICOM Modification in the plugin default configuration file. Check the Modifications section and the PatientMainTags, StudyMainTags, SeriesMainTags, EnableAnonymization and EnableModification configurations.

Retrieve a study from a distant modality and open the viewer¶

If you want to open e.g. the Stone Web viewer:: on a study that is not yet stored in Orthanc but that you know that it is stored in a remote modality, you may use this endpoint:

http://localhost:8042/ui/app/retrieve-and-view.html?StudyInstanceUID=1.2.3....&modality=pacs&viewer=stone-viewer

This will first check if the study is already in Orthanc, if not, it will retrieve it from the modality and, once the transfer is complete, open the viewer.

This feature has been introduced in v 0.7.0.