Dicomizer

How to convert images into DICOM files

The Dicomizer tool allows you to convert standard images into DICOM files. This will facilitate the integration of these images into a DICOM archive.

Dicomizer will help you to manage the DICOM tags at the patient, study, and image levels in order to have more consistent data, easily searchable in the archive system, and compliant with DICOM viewers.

How to Launch Dicomizer

As a Standalone Application

When installing Weasis, Dicomizer is available as a standalone application with this shortcut (only on Windows and Linux).

On macOS, you need to run the Dicomizer command from the terminal:

/Applications/Weasis.app/Contents/MacOS/Dicomizer

If you plan to use it frequently, with the Automator application you can create a new application Dicomizer.app with the Run Shell Script action containing the command.

From a WEB Context

The Dicomizer can be launched from a web context with the weasis:// protocol.

An example for launching Weasis Dicomizer Launch with the following parameters:

$weasis:config pro="felix.extended.config.properties file:conf/dicomizer.json" pro="gosh.port 17181"

Import Images

1. Using the left panel, navigate through the file system to locate the images you want to convert. Click the button next to the combo box on the right to choose the folder containing the media files eligible for DICOM conversion.

2. Drag and drop images into the central panel. By default, the images are grouped into a single series. Alternatively, you can split the images into different series by selecting the thumbnails and clicking the Import button. The dialog offers three options:

   • Do not group: All images are imported into a single series (same as drag-and-drop).
   • Group by date: Images are split into different series based on the acquisition date. You can specify the maximum time difference between two images to include them in the same series.
   • Group by name: All images are imported into a single series with a custom name.

Edit DICOM Tags

The Album panel allows you to manage the DICOM tags at the patient, study, and instance levels.

• The left panel shows the group list representing DICOM series.
• The main panel displays the thumbnails of the imported media files and allows you to select the images to edit the DICOM tags or by double click to open the image in the Photo Editor.
• The bottom panel shows the DICOM tags of the selected images. Note that the image level tags are displayed only when a single image is selected.

The bottom panel organizes DICOM tags into categorized tree structures:

• Global tags: Applicable to the patient and study levels.
• Series level: Applicable to the series level.
• Image level: Applicable to the image level.

If you don’t want to fill in the Global tags manually, they can be populated:

• From a work list (configuration by the items starting by weasis.acquire.wkl). Here is an example to modify the configuration at launch:
  

  $weasis:config pro="felix.extended.config.properties file:conf/ext-dicomizer.properties" pro="gosh.port 17181" pro="weasis.acquire.wkl.host localhost" pro="weasis.acquire.wkl.aet DCM4CHEE" pro="weasis.acquire.wkl.port 11112" pro="weasis.acquire.wkl.station.aet WEASIS-MWL"

• By the acquire:patient command containing an XML encoded as a DICOM XML file, e.g.:

  <?xml version="1.0" encoding="UTF-8"?>
  <tags>
  	<PatientID>97032168</PatientID>
  	<PatientName>TEST^TEST</PatientName>
  	<PatientBirthDate>19580703</PatientBirthDate>
  	<PatientSex>M</PatientSex>
  	<OperatorsName>RODUIT^NICOLAS</OperatorsName>
  	<AccessionNumber>000000003712</AccessionNumber>
  	<IssuerOfAccessionNumberSequence>
  		<LocalNamespaceEntityID>411713364</LocalNamespaceEntityID>
  	</IssuerOfAccessionNumberSequence>
  	<StudyID>411713364</StudyID>
  </tags>

Edit the Images

The Photo Editor provides tools to crop, rotate, and adjust the image contrast. You can also add annotations to highlight specific areas and use measurement tools to indicate distances, angles, or areas. Additionally, the image can be calibrated using a known distance for obtaining real-world measurements.

Publish DICOM Files

Click the Publish button to send the DICOM files to a remote DICOM archive. The Publication panel allows you to:

• Select the images to be published (all by default).
• Handle the resolution of the images.
• Specify the destination of the DICOM files from the list of DICOM remote nodes.