GUI Overview

Essential aspects of the interface

The image below shows the main elements of the Weasis graphical user interface. Click any of the green or blue areas to jump to the dedicated documentation for that element.

The default DICOM workspace has two main areas:

1. The DICOM Explorer on the left (blue) — used to import and export data and to pick the series to display.
2. The main area on the right (green) — hosts the open viewers and players as tabs. The available menus, toolbars, and tools change depending on the viewer currently in focus.
   • In the screenshot above, the active viewer is the DICOM 2D Viewer , which is the default for image series.
   • A tab with a multi-view layout can only display images from a single patient, but the same patient can appear in several tabs.
   • Each tab is a docked panel that can be moved by drag-and-drop, including side-by-side splits — see Docking for the full layout options.
   • For navigating through the Patient / Study / Series / Image hierarchy, see the DICOM Explorer page.

Minimal configuration before starting

A few settings make Weasis noticeably more comfortable the first time you launch it. Open the preferences dialog from the main menu: File > Preferences (Alt + P).

Language and regional settings

In the General tab, pick your preferred language and regional format (dates, numbers). Only languages with at least 30 % translation coverage appear in the list. Dates, numbers, and other locale-sensitive values follow the selected regional format throughout the interface.

➜ See Language and regional settings for the detailed instructions.

Theme and scaling factor

In the Appearance tab:

• Choose a theme that suits your environment and reduces eye strain. The recommended theme is Core Dark — Flat Weasis.
• Set a scaling factor that matches your system display scaling. This is especially recommended for HiDPI screens — Weasis will scale fonts, icons, and every UI component consistently.

➜ See Styles and themes for the detailed instructions.

Other viewers and players in the DICOM workspace

Depending on the SOP Class of the loaded series, Weasis opens one of the following:

• Multi-Planar Reconstruction (MPR) viewer
• Maximum Intensity Projection (MIP) viewer
• DICOM 3D Volume Renderer
• DICOM ECG viewer
• DICOM Structured Report (SR) viewer
• DICOM Audio player
• DICOM PDF viewer — opened with the default system application registered for PDF files.
• DICOM Video player — opened with the default system player registered for MPEG files.

Overlay viewers — applied on top of an image series rather than opened on their own — include DICOM Segmentation (SEG), DICOM RT, and Presentation State (PR / GSPS).

Other workspaces

• Dicomizer — the workspace for converting standard images into DICOM objects.
• Standard image explorer — workspace for non-DICOM images (configured through the non-dicom-explorer.json profile).

DICOM Import

How to import DICOM files

Weasis can ingest DICOM data from many sources:

• Drag and drop files, folders, or DICOM ZIP archives from the system file explorer.
• Double-click a DICOM file in the system file explorer (file association).
• Local Device — browse files, folders, or DICOM ZIP archives from inside Weasis.
• DICOMDIR — load a DICOM CD/DVD or any folder that contains a DICOMDIR index.
• DICOM Query/Retrieve — query a remote PACS over classic DICOM (C-FIND / C-MOVE / C-GET) or DICOMweb (QIDO / WADO-RS) and retrieve selected studies.
• Commands — local or remote commands launching Weasis with a target series (see the Weasis Protocol).

To send data the other way — out of Weasis to a file, a PACS node, or a CD/DVD — see DICOM Export.

From the system file explorer

Drag and drop

Files, folders, or DICOM ZIP archives selected in the system file explorer can be opened by dragging and dropping them into the central area of Weasis. The accepted drop target depends on the central panel state:

• Empty central panel — any file a Weasis viewer can open, including standard images such as TIFF, PNG, and JPEG.
• DICOM Explorer or any DICOM viewer (2D, MPR, 3D, SR, AU…) — only DICOM files and DICOM ZIP archives. Weasis opens each series in the most appropriate viewer.

File association

DICOM files can be opened by double-clicking them from the system file explorer.

From the Weasis menu or toolbar

Two import entry points sit next to each other in the toolbar (and under File > Import in the main menu):

• The first button opens the standard DICOM import dialog described below (File > Import > DICOM).
• The second button is a shortcut for the DICOMDIR / CD-ROM workflow (File > Import > DICOM CD).

Local Device

Since Version4.7.0, DICOM ZIP is also accepted in the local-import workflow:

• Files — browse and select one or more DICOM files or DICOM ZIP archives via the file chooser. If a ZIP archive is password-protected, a password prompt is shown.
• Folders — browse and select one or more folders via the file chooser. Folders containing DICOM ZIP archives are also supported.
• Search recursively — when enabled, the import also descends into subdirectories.

DICOMDIR

Loads a DICOMDIR-based study from a CD/DVD or any folder that already contains a DICOMDIR index file:

• Path — browse to a folder containing a DICOMDIR.
• Detect CD-ROM — try to load a DICOM CD/DVD directly.
• Copy images into the local temporary directory — useful for slow reading devices such as CD-ROM drives.

DICOM Query/Retrieve

Queries a remote PACS and retrieves selected studies into the DICOM Explorer. The dialog has two tabs — DICOM Source and Search Criteria.

DICOM Source tab

• Archive — pick the remote node to query:
  • DICOM nodes — classic DIMSE (C-FIND for the query, plus C-MOVE, C-GET, or WADO-URI for retrieval).
  • DICOMweb nodes — QIDO for the query, WADO-RS for the retrieval (no additional options needed).
• Retrieve (DICOM archives only) — the protocol used to transfer the images:
  • C-MOVE — the classic DIMSE retrieve. Accepts all SOP Classes but is not recommended over the web.
  • C-GET — transfer syntaxes are negotiated per SOP Class through a configuration file.
  • WADO-URI — C-FIND for the query plus WADO-URI retrieve; requires a WADO server.
• Calling Node (DICOM archives only) — pick the calling DICOM node that matches the remote AE.
• More options — opens the preferences so you can add or edit DICOM nodes.

Search Criteria tab

1. Pick a pre-registered search (combo box at the bottom-right of the Search Criteria panel) or fill in your own criteria. Saved criteria can be reused later; since Version4.1.0, the item selected in the combo box is re-applied automatically the next time the window opens (the default is Empty).
2. Adjust the limit — the maximum number of studies returned by the query. Set the limit to 0 to remove the cap. For DICOMweb, the limit is the page size; use the spinner buttons to move between pages.
3. Click Search.
4. Select the studies you want to import.
5. Click Import and close the window.

From commands

Weasis can be started — or asked to load a specific study — through commands launched locally or remotely. See Examples to load images on the Weasis Protocol page.

DICOMweb Configuration

How to configure a DICOMweb node

DICOMweb is the modern, HTTP-based set of DICOM services (QIDO-RS for query, WADO-RS for retrieve, STOW-RS for store, plus the legacy WADO-URI). Once a DICOMweb node is configured in Weasis, it shows up in the DICOM Query/Retrieve dialog and behaves like any other archive.

This page covers manual configuration inside Weasis. If you embed Weasis in a web portal, you can also launch it from a web context so that the DICOMweb parameters are derived automatically from the launch URL — no per-user configuration required.

General Configuration Steps

1. Open File > Preferences (Alt + P).
2. Select DICOM node list in the left sidebar.
3. Click Add new to create a new node, or select an existing one and click Edit.

In the node dialog:

1. Give the node a descriptive name.
2. Pick a service type. The default DICOMweb (all RESTful services) covers query, retrieve, and store at once. To restrict the node to a specific service, pick one of:
   • QIDO-RS — query.
   • STOW-RS — store.
   • WADO-URI (non-RS) — legacy single-object retrieval. Combines a classic C-FIND query with a WADO-URI retrieve (see Query/Retrieve).
   • WADO-RS (Retrieve) — modern retrieve.
3. Enter the service URL of the DICOMweb server.
4. Configure authentication by clicking Manager, then Add:
   • Either pick a template from the list and click Fill to populate some fields, or fill them in manually.
   • In the Provider panel, every field is mandatory.
   • In the Registration panel, every field is optional — except for OAuth2, where the Client ID, Client Secret, and Scope must be filled. Audience is optional, but some providers need it.
   • The Grant Type selector chooses the OAuth2 flow:
     • code (Authorization Code, the default) — interactive login: Weasis opens your browser so you sign in with your account, then receives the token through a loopback redirect. Use this for user-facing access.
     • client_credentials (Client Credentials, RFC 6749 §4.4) — non-interactive, server-to-server: Weasis obtains the token directly from the token endpoint using only the Client ID and Client Secret, with no browser login. Use this for service/headless accounts.
   • Click OK to save the authentication.
5. Optionally, add HTTP headers that should be sent with every request to this service URL (useful for tokens or other custom auth schemes).
6. Click OK to save the node.

Then open the DICOM Import dialog and pick the new node. If OAuth2 is configured with the Authorization Code grant, the first query opens your browser to complete the sign-in; subsequent queries reuse the cached token. With the Client Credentials grant, no browser login is required — Weasis authenticates silently using the configured Client ID and Secret.

Supported DICOMweb Providers (non-exhaustive list)

• Google Cloud Healthcare API
• Orthanc WEB Server
• dcm4chee-arc-light
• Amazon HealthLake

Google Cloud Healthcare API

Google Cloud provides a comprehensive DICOMweb implementation through the Healthcare API.

Configuration (see also the general steps above):

1. Create a new DICOMweb node with a descriptive name.
2. Pick DICOMweb (all RESTful services).
3. Enter the Google repository URL (must end with /dicomWeb).
4. Configure authentication by clicking Manager, then Add:
   1. Pick the Google Cloud Healthcare template.
   2. Click Fill.
   3. Enter your Client ID and Client Secret.
   4. Click OK to save the authentication.
5. Optionally, add HTTP headers for the Google API.
6. Click OK to save the node.

Orthanc WEB Server

Orthanc is a lightweight DICOM server with DICOMweb capabilities.

The screenshot below is configured for the public demo server, which requires no authentication. For your own Orthanc instance, replace the URL and configure the authentication method as described in the general steps.

https://demo.orthanc-server.com/dicom-web

dcm4chee-arc-light

dcm4chee-arc-light is a robust open-source PACS that exposes DICOMweb services out of the box.

To configure a dcm4chee-arc-light node (see also the general steps):

1. Add a new DICOMweb node.
2. Enter a description (e.g. DCM4CHEE Archive).
3. Pick the DICOMweb service.
4. Enter the URL of your dcm4chee-arc-light server. The default endpoint follows this pattern:

   http(s)://[server-address]:[8080|8443]/dcm4chee-arc/aets/[AE_TITLE]/rs
   (e.g. http://localhost:8080/dcm4chee-arc/aets/DCM4CHEE/rs)

If the dcm4chee-arc-light server requires authentication, configure it on both sides:

In Weasis

1. Click Manager, then Add to create a new authentication.
2. Pick the Default Keycloak template and fill in:
   • Name — dcm4chee-arc-light
   • Base URL — https://[server-address]:8843
   • Realm — dcm4che
   • Client ID — weasis
   • Client Secret — the secret you copy from Keycloak (see below).
   • Scope — openid
   • Audience — leave empty.

In Keycloak — register the Weasis client for DICOMweb access:

1. Sign in to the Keycloak Admin Console (typically https://[server-address]:8843/admin/dcm4che/console for the secure URL).
2. In the left menu, click Clients > Create.
3. General settings:
   • Client Type — OpenID Connect
   • Client ID — weasis
4. Capability config:
   • Client authentication — ON
   • Standard flow — ON
   • Direct access grants — ON
5. Login settings:
   • Root URL — leave empty.
   • Valid Redirect URIs — add http://127.0.0.1*.
   • Web Origins — add + to allow any origin that matches a Valid Redirect URI.
   • Click Save.
   • Copy the Client Secret from the Credentials tab and paste it into the Weasis authentication form above.

Amazon HealthLake

Amazon HealthLake is a fully managed service for storing, transforming, querying, and analyzing healthcare data at scale.

Imaging data is exposed through the AHI DICOMweb Proxy. To consume it from Weasis, create a DICOMweb node with this URL:

http://[EC2 instance IP or EC2/ALB DNS]:8080/aetitle

The complete Weasis configuration is documented at the end of the AHI DICOMweb Proxy README.

Docking

Organizing the Interface with Docking

Almost every panel and viewer tab in Weasis can be moved, split, pinned, or hidden by dragging it with the mouse. This lets you arrange the workspace around the task at hand — for instance comparing two series side by side, putting the MPR viewer and the 3D Volume Renderer next to each other for crosshair-driven volume cutting, or maximizing a single view for a focused read — without leaving the application.

Central View

The central area is where viewers and players are displayed as tabs. It supports two main layout operations.

Splitting tabs

Reorganize tabs by dragging and dropping them:

• Drag a tab toward an edge (top, bottom, left, or right) of the central area to split the space and display two tabs side by side or stacked.
• Drop a tab onto another tab group to merge it back into a single area.

This makes it possible, for example, to compare two series simultaneously in a split-screen layout, or to keep an MPR tab next to a 3D rendering of the same volume.

Maximize a tab

A tab can be maximized to occupy the entire application window, including the space normally taken by the tool panels on either side — giving the largest possible viewing area for a single viewer.

• Maximize — click the maximize button in the tab header, or double-click the tab.
• Restore — click the normalize button, or double-click the tab again.

Tool Panels

The strips on the right side of the central area host the tools attached to the active viewer (measurements, image adjustments, display options, segmentation, …). Each tool panel can be managed independently with one of three display modes.

Docked

The default mode: the tool panel is docked in the vertical strip next to the central view. In this mode it is always visible and takes up a fixed portion of the screen.

Pinned as overlay

The tool panel floats on top of the central view without reducing the viewer’s size. Useful when you want the maximum viewing area while keeping quick access to the tools.

• Click the pin icon in the tool panel header to switch to overlay mode.
• The overlay can be repositioned by dragging its title bar.

Minimized (vertical button)

The tool panel collapses to a small vertical button on the side of the interface. Clicking the button temporarily reveals the panel without permanently giving up screen space.

• Click the minimize icon in the tool panel header to collapse it to a button.
• Click the button again to restore the panel.

Rearranging tool panels

Inside the vertical strip, individual tool panels can be split and re-docked relative to each other:

• Drag a tool panel header and drop it above, below, or beside another tool panel to split the tool area and display several tools at once.
• Drop a tool panel onto another tool panel’s tab bar to group them as tabs within the same slot.

This lets you arrange the most-used tools exactly where you want them for a given reading workflow.

DICOM Export

How to export DICOM files

Weasis offers two complementary export workflows:

• Export the selected view — produces a raster image (PNG, TIFF, JPG, JPEG 2000) or a clipboard copy of what is currently shown on screen. Useful for slides, reports, e-mails, screenshots of measurements, and other non-DICOM consumers.
• DICOM Export — produces DICOM-format output (a directory tree, an ISO image, or a network transfer to a remote node). Use this to share studies with another DICOM-capable system without losing pixel fidelity or metadata.

Exporting the selected view

Open the export-view dialog from the toolbar icon or from the main menu File > Export > Exporting view. The output can be sent to the clipboard or saved to an image file in PNG, TIFF, JPG, or JPEG 2000 format.

Current view

Exports the view exactly as it appears on screen, at its current size and with every overlay (annotations, measurements, DICOM annotations, rulers…) visible.

Anonymize — removes identifying information from the overlay, in line with the Anonymize option of the 2D viewer.

Original Image

Exports the underlying image — without on-screen overlays — with a few rendering options.

• Size — scale the exported image (percentage of the original dimensions).
• Preserve 16-bit per channel — keep the original pixel depth (16-bit in PNG / JPEG 2000 / JPEG-XL / TIFF, double values in TIFF). When checked, the exported pixel values match the Modality LUT values (e.g. Hounsfield units for CT). JPEG Lossy is only available with this option unchecked, since the format requires an 8-bit image.
• DICOM Pixel Padding — apply the DICOM pixel padding when checked.
• DICOM Shutter — apply the DICOM shutters when checked.
• DICOM Overlay — apply the DICOM overlays when checked.

DICOM Export

Open the DICOM Export window from the toolbar icon or from the main menu File > Export > DICOM. Three destinations are available in the left panel — Local Device, DICOM Send, and CD/DVD Image — each with its own set of options.

Local Device

1. Select Local Device.
2. Choose the export options:
   
   • Transcoding — change the DICOM transfer syntax (compression / encoding) of the exported files. Leave the default unless you specifically need a different syntax.
   • Generate new unique identifiers — replace the Study / Series / SOP Instance UIDs with newly generated ones. Cross-references between UIDs are kept consistent within this export session only — running the export a second time produces a different set of UIDs that no longer matches the first.
   • Include DICOMDIR — write a DICOMDIR index file alongside the exported objects.
   • DICOM CD folders — wrap the exported tree in the standard DICOMDIR-compliant folder layout used on DICOM CDs.
   • Keep directory names — preserve human-readable folder names in the exported hierarchy (incompatible with the strict DICOMDIR layout).
3. Pick the patient(s), study (or studies), series, or individual instances to export. Series created inside Weasis (such as Key Object / Presentation State objects) are marked with a NEW flag.
4. Click Export to write the files, then close the window.

DICOM Send

Sends the selected objects directly to a remote DICOM or DICOMweb node over the network — the same protocols used by PACS systems for inter-institutional transfer.

1. Select DICOM Send.
2. Choose the destination node — a classic DICOM node (C-STORE) or a DICOMweb node (STOW-RS).
3. Pick the patient(s) / study / series / instances to send. Series created inside Weasis are marked with a NEW flag.
4. Click Send to transfer, then close the window.

CD/DVD Image

Produces a burnable ISO image that follows the DICOMDIR layout expected by most CD/DVD-based DICOM media.

1. Select CD/DVD Image.
2. Choose the export options:
   • Transcoding — change the DICOM transfer syntax of the exported files. Leave the default unless you specifically need a different syntax.
   • Generate new unique identifiers — replace the Study / Series / SOP Instance UIDs with newly generated ones. Cross-references between UIDs are kept consistent within this export session only — running the export a second time produces a different set of UIDs that no longer matches the first.
3. Add JPEG images — also extract every image and every encapsulated payload (video, audio, PDF) into a separate JPEG folder for easy preview on systems without a DICOM viewer.
4. Add Weasis — embed the Weasis viewer directly into the ISO so the recipient can launch it from the media. Currently supported only on Windows x86-64 (both for producing and for running the embedded copy). Running Weasis straight off a CD/DVD is slow; for a better experience, write the ISO to a USB stick or open the disc with a locally installed copy of Weasis as described in the README.html on the disc.
5. Pick the patient(s) / study / series / instances to export.
6. Click Export to write the ISO, then close the window.

DICOM Explorer

Structure and display of Patients/Studies/Series

DICOM Explorer

The DICOM Explorer is the panel on the left side of the application. It displays everything you have loaded into Weasis as the Patient / Study / Series / Image hierarchy defined by the DICOM standard, and is the starting point for opening a viewer on any series.

Data can be added to the Explorer in several different ways — drag-and-drop, the import dialog, a PACS query, or the Weasis Protocol.

Patient Level

• Weasis can display several patients at the same time. By default, when images are imported, a tab with the patient’s name opens in the main area.
• A tab containing a multi-view layout can only display images from a single patient.
• You can switch between patients either through the first combobox in the DICOM Explorer (see image above) or by selecting a tab in the main area.
• In the combobox, patients are sorted alphabetically — case-insensitive, and according to the active regional setting.
• Studies and series are grouped under the same patient when their Patient Name and Patient ID both match. Otherwise, a new patient entry is created.

Study Level

• A study contains one or more series (thumbnails) that belong to a single patient. A surrounding line groups the series of one study (see the image above).
• Studies are sorted in reverse chronological order by default. Since Version4.1.0 the sort order can be changed in File > Preferences > DICOM > DICOM Explorer under Study data sorting. If a study has no study date, it is sorted alphabetically by Study Description.
• All studies are shown by default; the study combobox can restrict the view to a single one.

Series Level

• A series is represented by a thumbnail with the image count shown in the bottom-left corner.
• According to predefined rules, some series are split into sub-series — also represented as thumbnails, identified by a # number in the upper-right corner. Splitting is needed for the consistency of tools such as the MPR viewer, MIP, the 3D cursor (cross-lines) and view synchronization. When the split is not desired, sub-series can be re-merged from the context menu.

4D Series Sub-Series Splitting

When a DICOM series is loaded, Weasis automatically analyzes it to detect multi-phase acquisitions (e.g. cardiac phases, contrast phases, 4D volumes). If multiple phases are detected, the series is split — automatically or with a confirmation step — into separate sub-series, one per phase. Each sub-series can then be used independently in the MPR, MIP, or 3D Volume Renderer.

Splitting behavior by number of detected phases

Manual split confirmation dialog (≥ 8 phases)

When 8 or more phases are detected, a dialog asks you to confirm the split. Once confirmed, the series is divided exactly as in the automatic case. Canceling leaves the series intact as a single entry in the DICOM Explorer.

Sub-series structure after splitting

After splitting, each phase becomes a separate thumbnail in the DICOM Explorer. The first sub-series reuses the original series entry; the additional sub-series are added to the study tree, identified by a # number in the upper-right corner of the thumbnail.

If the split is not needed, or was triggered unintentionally, the sub-series can be merged back. Select the thumbnails you want to merge (all or a subset) and choose Merge Selected Series from the context menu — the selected sub-series are recombined into a single series entry.

Series Display and Opening

• By default, series are sorted by series number; if that is missing, they are sorted chronologically by series date or another available date.
• To open a series:
  • Drag and drop a thumbnail into the main area. If the drop lands in a view of the same patient, that view’s series is replaced; otherwise, a new tab is created.
  • Double-click a thumbnail (or navigate with the Up / Down arrows and press Return). If a view of the same patient already exists, the series in the focused view (orange border) is replaced.
  • Select one or more thumbnails and pick an action from the 2D DICOM Viewer context menu:
    • Open — opens the series in the most appropriate layout (replaces the series if a patient tab already exists).
    • Open in new tab — same, but always in a new tab.
    • Open in screen — same, but on a specific screen.
    • Add — appends the series to the current patient’s layout, if one exists.

Preferences

From the main menu File > Preferences > DICOM > DICOM Explorer:

• Thumbnail size — width of the thumbnails; the panel adjusts accordingly. Default: 144. Restart the application after changing this value.
• Study data sorting — sorts studies in reverse chronological order (default) or chronological order. Since Version4.1.0.
• Download all series immediately — when checked, series start downloading as soon as they are queued via WADO or WADO-RS. When unchecked, you must click the play button on each series, or the global play button at the bottom of the thumbnail list. Default: checked.

DICOM 2D Viewer

Displaying DICOM images

The 2D viewer is the default viewer for any DICOM series that contains images — CT, MR, US, CR / DX, mammography, color photographs, and so on. It handles both single images and stacks (volumetric series), and is the entry point for the more specialized viewers such as MPR, the 3D Volume Renderer, and the MIP projection.

Open the 2D viewer

The viewer can be opened with in the toolbar, or by double-clicking a thumbnail (or right-clicking it and choosing 2D Viewer > Open) in the DICOM Explorer.

The rulers K display a real-world size whenever Weasis can derive one from the DICOM file. When a small label M is shown above the calibration, it indicates how that calibration was obtained:

• At detector: projection radiography calibration taken at the detector plane.
• Magnified: projection radiography calibration corrected by the magnification factor (e.g. mammography, as in the screenshot above).
• Used fiducials: calibration derived from fiducials (e.g. a manually placed ruler in the image).
• At scanner: calibration taken from a digitized medium (e.g. film digitizer).

Toolbars A

Viewer Main Bar

Choose the action assigned to each of the three mouse buttons and the mouse wheel. Defaults are:

• Left button — Window / Level. Can also be changed from the context menu F or the keyboard shortcuts.
• Right button — Context Menu.
• Wheel — Series Scroll.
• Middle button — Pan.

Available actions:

• Pan — move the image position. T key to select. Alt + Arrows to pan while another action is selected.
• Window / Level — change image contrast. W key to select.
• Series Scroll — navigate through the images of the current series. S key to select.
• Zoom — zoom in / out. Z key to select.
• Rotation — rotate the image by a free angle. R key to select.
• Measure — draw a graphic to measure something. M key to select.
• Draw — draw a graphic to annotate. G key to select.
• Context Menu — open the context menu. Q key to select.
• Crosshair — 3D cursor. H key to select. Ctrl + click or Ctrl + Shift + click adjusts Window / Level without leaving crosshair mode.
• No Action — do nothing. N key to select.

• Default layout — change the layout of the view. DICOM Information and Histogram are special layouts that update automatically as you scroll through the series.
• Synchronize — apply the same settings (window/level, scroll, zoom, …) to multiple views simultaneously. Two modes are available: Default Stack (the default — couples series sharing the same Frame of Reference UID) and Default Tile (mosaic display of a single series). A master Synchronize checkbox at the top of the drop-down turns synchronization on or off globally without changing the active mode. Each 2D view also exposes its own auto-sync and manual-sync overlay buttons in its bottom-right corner. See View Synchronization for the full mechanics, the per-view controls, and the FoR color-chip system.
• Reset — restore the default image rendering (see Reset). Escape key to select.

Toolbars available in the DICOM 2D viewer

• DICOM Import
• DICOM Export
• Screenshot
• Viewer Main Bar (see above)
• Measurement
• Zoom
• Rotation — rotate the image by 90° clockwise or flip it horizontally. Not visible by default.
• DICOM Header
• Lookup Table
• Basic 3D — MPR and MIP (disabled when the series has fewer than 5 images).
• 3D Viewer (disabled when the series has fewer than 5 images).
• Cine
• Key Object Selection

Viewer tools

The right-side panel groups all the tools tied to the 2D viewer.

The mini-tool is always visible; the other panels open by clicking the corresponding vertical button. The normalize button docks a panel into the main layout — otherwise it opens as a pop-up that can be kept in front with the pin button (not recommended, as a pinned pop-up hides other panels).

Mini-tool B

By default the mini-tool scrolls through the images of the selected series (the one surrounded by the orange focus border). The combobox at the top can switch it to control zoom or rotation instead.

Display C

Controls how the image and graphic objects are displayed in the view.

The Apply to all views option propagates the chosen display settings to every view in the selected tab. When unchecked, settings apply only to the focused view (orange border).

Image

Display options for the image itself. Unchecking Image hides the image and leaves only the annotations and graphic objects visible. The other options expose DICOM-specific behavior:

• DICOM Image Overlay — apply the DICOM overlays when checked. The overlay color is configurable.
• Shutter — apply the DICOM shutters when checked.
• Pixel Padding — apply the DICOM pixel padding when checked.

DICOM Annotations

Display transformation values and DICOM information directly on the image.

• Annotations — DICOM information shown in the image corners:
  • G Top left — patient information.
  • H Top right — study information.
  • I Bottom right — series information (depends on the modality).
  • J Bottom left — image information and the position of the image in the series.
• Minimal Annotations — reduce the number of annotations shown. Press Space or I to cycle through the three states (minimal, none, all).
• Anonymize — hide identifying information only inside the views (not in other parts of the GUI such as the tab title). Combine with the screenshot tool when exporting an image.
• Scale — display the rulers on the left and bottom of the image K.
• Lookup Table — display the LUT on the image L.
• Orientation — display the orientation of the image N.
• Window / Level — display the window and level values J.
• Zoom — display the zoom value J.
• Rotation — display the rotation value J.
• Frame Value — display the frame number J.
• Pixel (Value / Position) — display the pixel value and the cursor position J.

Drawings

Check / uncheck to show or hide the graphic objects (see Draw & Measure).

Image Tools D

Image Tools groups every control that affects how the image is rendered.

Windowing and Rendering

Transform

Zoom, rotate, and flip the image. Zoom and rotation can also be driven from the mini-tool or the mouse actions.

Cine

The Cine start button plays the series at a fixed speed (frames per second). The default speed is taken from the DICOM file when present. Cine options are also accessible from the context menu.

• Click Cine stop to end the animation.
• Click the Loop / Sweep toggle to switch between looping and sweeping playback.

Reset

Returns the image to its default rendering, either for every parameter or for a specific one. Also available from the toolbar button and from the context menu.

Draw & Measure E

Other specific tools

• DICOM RT tools — for radiotherapy studies (RTSTRUCT, RTPLAN, RTDOSE).
• DICOM Segmentation — for pixel-based SEG overlays (binary, fractional, label-map).

Preferences

From the menu File > Preferences > Viewer > 2D Viewer.

Mouse Action Sensitivity

Adjust how strongly a mouse drag translates into action for: Window, Level, Zoom, Rotation, and Series Scroll.

Zoom

Zoom interpolation controls how new pixels are computed when the image is zoomed in or out:

• Nearest neighbor — the simplest method: extends the nearest pixel value as-is.
• Bilinear — averages the four neighboring pixels. Slightly sharper than nearest neighbor, slightly slower.
• Bicubic — uses a 16-point kernel. Sharper than bilinear, but the slowest of the four.
• Lanczos — uses a sinc kernel; produces the sharpest results, with performance between bilinear and bicubic.

The default is Bilinear. Nearest neighbor is the fastest option but produces aliasing artifacts.

Other

• Apply Window / Level on color images — when checked, the window / level is applied to the RGB channels. Unchecked, window / level has no effect on color images.
• Inverse level direction — when checked, the level direction with mouse drag is inverted (dragging down increases brightness), matching the Basic Image Review profile. Unchecked, dragging down decreases brightness.
• Apply by default the most recent Presentation State — when checked, the most recent Presentation State object is applied automatically. Otherwise it has to be selected manually via .
• Overlay color — color and opacity of the DICOM overlay. The default is white; the opacity is the transparency / alpha slider of the color picker.

View Synchronization

Synchronizing Views

View synchronization propagates the same actions (scroll, zoom, window / level, …) across several views at once. Weasis offers two synchronization modes — an automatic mode driven by shared DICOM geometry (the Frame of Reference UID, abbreviated FoR throughout this page) and a manual mode to bridge views that the automatic mode cannot connect (only for scrolling).

Frame of Reference: the shared coordinate system

Two series carry the same Frame of Reference UID (DICOM tag 0020,0052) when they were acquired in the same 3D coordinate system. In practice, sharing the same Frame of Reference means sharing the same 3D coordinate system: every voxel in those series is positioned against the same origin and the same axes, so the point at coordinates (x, y, z) refers to the exact same physical location in all of them.

Acquisitions performed in the same session without moving the patient typically share a Frame of Reference, for example:

• the CT and the PET produced together by a hybrid PET / CT scanner,
• all the slices of a single MR sequence,
• a planning CT and the RTSTRUCT / RTPLAN / RTDOSE objects derived from it.

This shared geometry is what makes automatic synchronization possible: when Weasis sees the same FoR on two views, it can align them in 3D without any manual configuration. Series acquired in separate sessions, on different scanners, or after the patient has moved typically have different Frames of Reference and must be coupled with manual sync instead.

The Frame of Reference is the linking concept used by:

• Auto-synchronization (see Default Stack Mode below) — propagates scroll, zoom, window/level, … between views sharing a FoR.
• The 3D cursor (crosshair) — clicks on one view jump to the same anatomical point in every other view sharing the same FoR.
• The MPR viewer — the three reconstruction planes are always FoR-coupled by the crosshair.

Synchronization Modes

The synchronization mode is controlled by the drop-down button next to the layout button in the toolbar.

The drop-down popup also contains:

• A non-interactive series-name header at the top of the popup, identifying the currently selected view. It makes explicit that the per-action toggles and the Apply to all views entry below reflect this specific view’s synchronization options.
• A master Synchronize checkbox — a global switch that turns synchronization on or off for the whole synchronization session (every participating view, including auto-synced views in other linked containers) without changing the active mode. This is broader than the per-view button, which toggles only the single view it sits on. Unchecking it makes every view fully independent. See Synchronization scope for how the scopes interact.
• Per-action toggles (Scroll, Pan, Zoom, Rotation, Flip, Window / Level, Spatial unit) mirroring the selected view’s configuration.
• An Apply to all views entry — decorated with the selected view’s FoR color chip — that propagates the configuration to every other sync-active view in the container, regardless of FoR (broader than the same-named entry in the per-view popup, which is restricted to the selected view’s FoR group). See Per-view sync controls for the per-action semantics and the color-chip system.

dcmview2d:synch VALUE

Synchronization Scope

Synchronization operates at three different scopes. Knowing which is which avoids surprises when more than one viewer window is open:

• Global (whole session) — the master Synchronize checkbox in the toolbar drop-down is a global switch: it enables or disables synchronization for every participating view at once, not just the selected view.
• Across containers (auto-sync) — Default Stack auto-synchronization is not limited to a single container. Views in any other visible container that belongs to the same group (the windows opened together from one patient/study group) and is also in Stack mode are kept in sync as well. Open the same study in two windows and scroll, Window / Level, etc. stay coupled across both.
• Within one container (manual sync) — manual sync only links views that live in the same container window; you cannot manually link a view to one in another container. In addition, only one manual-sync session can be active at a time across the whole application — starting manual sync on another eligible view joins the existing session rather than creating a second, independent group.

Default Stack Mode (Auto Synchronization)

Default Stack is the most common synchronization mode. When two or more series share the same Frame of Reference UID, Weasis can synchronize their views automatically.

By default, only Scroll is propagated — navigating to a slice in one view moves the other views to the closest matching anatomical position. Every other action (Pan, Zoom, Rotation, Flip, Window / Level, Spatial unit) starts disabled, and you opt them in explicitly through the per-action toggles in either:

• the toolbar drop-down popup (applies to the selected view; use Apply to all views to propagate the change to its FoR group), or
• the per-view auto-sync popup opened from the button on the view itself.

See Per-view sync controls for the full list of toggles and the FoR color-chip system.

Typical use case: display a CT series and its corresponding PET series side by side. Because both series share the same Frame of Reference UID, scrolling through slices in the CT view automatically scrolls the PET view to the matching anatomical level. To couple Window / Level or Zoom too, enable the action on every view in the group (an action is synced only between views that both have it enabled) — toggle it on one view and use Apply to all views.

The screenshot illustrates how Weasis advertises synchronization groups visually inside a single layout:

• The two views in the left column carry no Frame of Reference UID. Because they are not eligible for auto-sync, the auto-sync button is not shown on them at all — only the manual-sync button is available.
• The four views on the right form two pairs sharing a Frame of Reference UID, each pair tagged with its own auto-sync color chip: yellow for the top pair, blue for the bottom pair. Auto-sync is propagated only within a same-colored group.
• A manual-sync link (hand icon, in green when active) couples one of the FoR-less left views to two peers at once — the other FoR-less view and a view that belongs to one of the FoR pairs — illustrating that manual sync is the fallback to bridge views that auto-sync cannot connect, regardless of whether the peer has a FoR or not.
  

Per-view Sync Controls

In addition to the global toolbar drop-down, each 2D view carries small overlay buttons in the bottom-right corner that drive its sync behavior independently. They appear whenever the view has at least one eligible peer for synchronization.

Auto-sync button

The button toggles Default Stack auto-synchronization for this view only. Its appearance encodes two pieces of information:

• Outer tint — red when auto-sync is OFF for the view, green when ON.
• Center color chip — a small colored square shown when the container holds two or more views with different Frame of Reference UIDs. The color identifies the FoR group; views sharing the same UID share the same chip color, so groupings are visible at a glance. When the container has only one FoR (nothing to disambiguate), the chip is hidden.

Clicking the button opens a per-view sync popup with:

• Synchronize this view — master on/off toggle for auto-sync on this view (closes the popup on click).
• Per-action toggles — independent checkboxes for Scroll, Pan, Zoom, Rotation, Flip, Window / Level, and Spatial unit. The popup stays open while you flip several options, so you can configure the whole set in one pass.
• Apply to all views — copies this view’s effective sync options to every other view sharing the same Frame of Reference UID. The item is decorated with the view’s FoR color chip, matching the chip drawn on the auto-sync button so you can confirm at a glance which group will be affected.
• Close — explicit dismiss (the per-action toggles do not auto-close on click; Esc and clicks outside also dismiss the popup as usual).

Manual sync button

Some series cannot be auto-synced because they have no — or a different — Frame of Reference UID (typical for unrelated CT scans, or legacy series with missing DICOM geometry). The manual-sync button (same bottom-right corner) lets you link such a view to a peer by relative slice index instead of 3D position.

A view is an eligible candidate for manual sync with the current view when it lives in the same container, has the same orientation, and a different (or absent) FoR — manual sync never crosses containers, and only one manual-sync session can be active across the whole application (see Synchronization scope). Clicking the button on a view that is currently OFF picks the link target according to how many candidates exist:

• A manual-sync group already exists in the container — the new view joins it directly (bidirectional links are added to every member). No picker is shown.
• Exactly one candidate — the link is established immediately, no picker.
• Multiple candidates and no existing group — a multi-select picker opens so you can pick the views to sync with.

Once active:

• Scroll propagation is forced on and locked in the per-view sync popup — manual sync is built on top of scroll. All other per-action toggles (Pan, Zoom, W / L, …) remain freely configurable.
• The manual-sync button turns green to indicate that a manual link is established. Clicking it again removes this view from the group.

Default Tile Mode

Default Tile mode fills all views in the current layout with consecutive images from the same series. It is useful for reviewing a series at a glance, comparing adjacent slices, or preparing a print layout with multiple images per page.

When this mode is active:

• Each view shows a different image of the same series (n, n+1, n+2, …).
• Scroll advances the entire tile group by one image at a time.
• Every other per-action setting is enabled by default, both user-toggleable (Pan, Zoom, Rotation, Flip, Window / Level, Spatial unit) and always-on internal (Preset, LUT, LUT shape, Invert LUT, Filter, Inverse stack, Sort stack), so the tile group behaves as a single coherent display.

Use the per-action toggles to disable any user-toggleable setting if you want tiles to diverge (e.g. independent zoom for cropped previews).

Typical use case: print or export a multi-image layout where each cell shows a different slice of the same series. See Print for more details.

3D Cursor Synchronization

The 3D cursor (crosshair) is a dedicated synchronization mechanism that links the cursor position in 3D space across views that share the same Frame of Reference UID.

Unlike stack mode, which only aligns views near the same anatomical depth, the crosshair lets you click precisely in one view and see that exact 3D point highlighted in every other view simultaneously — regardless of slice or plane orientation.

See the 3D cursor tutorial for full details.

MPR Synchronization

Two distinct couplings are at play in the MPR viewer:

Internal — between the three MPR planes (axial, coronal, sagittal): these are always cross-synchronized by the crosshair. Beyond that structural coupling, the MPR viewer uses different per-action defaults from the 2D viewer: Scroll, Zoom, and Window / Level are ON by default. The remaining per-action propagations (Pan, Rotation, Flip, Spatial unit) are off by default and can be enabled explicitly.

External — between MPR and other 2D views sharing the same Frame of Reference: the standard Default Stack rules apply (Scroll on by default; every other action opt-in via the per-view toggles described below).

In both cases, the per-view toggles are reached through the Synchronize submenu of each MPR view’s settings popup (see below) — the crosshair coupling itself cannot be disabled.

Per-view sync options in the MPR

MPR views do not show the auto-sync / manual-sync overlay buttons described in Per-view sync controls — synchronization between MPR planes is structural (driven by the crosshair) and cannot be turned off per view. Instead, the per-view sync configuration is reached through a Synchronize submenu in the MPR configuration popup (settings icon in the top-right corner of the view — listed alongside the other MPR settings).

The submenu is the same as the one opened by the auto-sync button on a regular 2D view, minus the master “Synchronize” toggle (you cannot disable synchronization for a single MPR plane — see above). It contains:

• Per-action toggles for Scroll, Pan, Zoom, Rotation, Flip, Window / Level, and Spatial unit. The submenu stays open while you flip several options.
• Apply to all views — propagates the current selection to every other view sharing the same Frame of Reference UID. Decorated with the FoR color chip identifying the target group.
• Close — closes the popup.

Cine and Synchronization

When the cine animation is active on a series, every series currently synchronized with it (via Default Stack or Default Tile) is animated as well. Cine remains active across series until the Cine stop button is clicked.

3D Cursor

3D cursor (crosshair)

The 3D cursor — also called the crosshair — lets you click a point on one image and instantly see the same anatomical point in every other view that shares the same 3D coordinate system. Use it to:

• Localize a finding on one modality (for example a CT lesion) on the matching PET, MR, or follow-up acquisition.
• Cross-check structures between axial, coronal, sagittal and oblique planes.
• Compare the same anatomical level on prior and current studies opened side by side.

Two views are linked by the crosshair when they share the same Frame of Reference UID — DICOM’s way of declaring that those series live in the same 3D coordinate system. See Frame of Reference: the shared coordinate system for the full explanation and the typical cases where it applies. Weasis discovers the link automatically from the DICOM metadata — no manual configuration is needed.

Opening related series together

The fastest way to load several series that share a coordinate system:

1. In the DICOM Explorer, right-click a series and choose Select related Series. Weasis selects every series in the study that shares the same Frame of Reference UID.
2. Right-click the selection again and choose 2D Viewer > Open to display them side by side.

Activating the crosshair

Select the crosshair as the active mouse-button action either from the toolbar mouse-button menus or from any view’s right-click context menu. Once active, left-click anywhere in a view and the marker jumps to the matching 3D point in every linked view simultaneously.

Try it on a multi-series sample Launch

Preferences

The 3D cursor shares two display preferences with the MPR viewer:

• Auto-center axes — recenter the views on the clicked point.
• Crosshair gap at the center — width of the blank gap around the click point, so the marker does not occlude the structure being inspected.

Both are configured in the MPR preferences.

MPR Viewer

Multi-planar reconstruction (MPR)

The MPR viewer reconstructs the two complementary anatomical planes from a volumetric acquisition: starting from the original plane (typically axial), Weasis computes the corresponding coronal and sagittal views, all kept in sync through a shared 3D crosshair. Oblique planes are also supported, since Version4.6.0.

The MPR view inherits most of the properties and actions of the DICOM 2D viewer, with one structural difference: the crosshair tool stays active regardless of which mouse action is selected. Open the MPR viewer from the icon in the toolbar, or by right-clicking a thumbnail in the DICOM Explorer.

Crosshair actions

The crosshair stays synchronized across the three MPR planes (and with any other FoR-coupled view). Three actions are available on its handles:

• Move — translate the cursor in 3D space by dragging the center of the crosshair.
• Move axis — slide the crosshair along one axis by selecting and dragging that line.
• Rotate — rotate the crosshair around its center by dragging one of the end points along the axes.

Synchronization between MPR planes

The MPR viewer uses different sync defaults from the 2D viewer: in addition to the structural crosshair coupling, Scroll, Zoom, and Window / Level are ON by default between the three planes. The remaining per-action propagations (Pan, Rotation, Flip, Spatial unit) are off by default and can be enabled explicitly. The options live in two places:

• The global Synchronize drop-down popup (next to the layout button) — master on/off plus per-action toggles for the whole container.
• The Synchronize submenu in each MPR view’s settings popup — for per-view fine-tuning.

See View Synchronization in MPR for the full mechanics.

The MPR views can be reorganized into different layouts via the layout button.

View settings

Open the per-view settings popup with the icon in the top-right corner of any MPR view:

• Center — recenter the crosshair in the view.
• Show Center of Crosshair — show or hide the center point.
• Show Crosshair — show or hide the crosshair lines. When hidden, the crosshair actions are inactive.
• MIP Thickness — slab thickness for the active MIP projection, expressed in slices in the cross-axis direction. Can also be adjusted with Alt + mouse scroll on an axis. Note: the projection may take a moment to refresh, since MIP in MPR is computed in the background and does not use 3D acceleration.
• MIP Type — projection mode applied to the slab:
  • None — no MIP applied.
  • Min — Minimum intensity projection.
  • Mean — Mean intensity projection.
  • Max — Maximum intensity projection.
• Build a new series from the current view / Build three series from MPR views — save the reconstructed MPR slices back as new DICOM series (since Version4.7.0). The first option exports the current plane only; the second (in the All views submenu) exports the three planes, each as a separate series. Background borders are cropped uniformly across every slice so the exported series keeps a constant image size. The crosshair is restored to its initial position when the build completes.
• Synchronize — per-view sync options: independent toggles for Scroll, Pan, Zoom, Rotation, Flip, Window / Level, Spatial unit, plus an Apply to all views entry that propagates the current selection to every other MPR view (see View Synchronization in MPR).

Try it on a volume dataset Launch

Crosshair line colors

Each crosshair line represents the intersection of one of the other two planes with the current view. The line color identifies which plane it belongs to:

For oblique planes, line colors blend proportionally based on the contribution of the primary axes.

Orientation axes

The patient orientation axes are drawn in the top-left corner of each MPR view, indicating how the current slice is oriented in 3D space:

See Orientation in multiplanar reconstruction (MPR) for the wider orientation-labeling conventions.

The same axes widget is also drawn in the 3D viewer since Version4.7.0.

Volume geometry handling

Since Version4.7.0, when Weasis detects that a volume cannot be reconstructed as a perfect rectilinear grid, a confirmation dialog appears before the MPR views are built. The conditions are evaluated in this priority order — only the first match triggers the dialog:

In each case the message ends with:

The images may be displayed incorrectly. Do you want to rectify the images anyway?

Dialog choices

• Yes — Rectify geometry — re-slices the volume to align it with the patient’s anatomical orientation. Ensures correct spatial proportions for measurements and ratios across planes, at the cost of one interpolation pass that may slightly soften the image.
• No — Stack images — stacks the original images directly, with no geometric correction. Preserves the full original image quality and avoids interpolation, but distances, ratios, and measurements may not reflect true anatomical values.

Status indicator

A persistent red label is then shown in the bottom-left corner of every MPR view to indicate the active mode:

Preferences

From the main menu File > Preferences > Viewer > MPR (since Version4.1.0):

• Auto center axes — how the crosshair is recentered when it moves out of the visible area. Always recenters after every move; the default option only recenters when the position is almost no longer visible.
• Crosshair gap at the center — size of the empty space drawn around the cursor point, so the marker does not occlude the structure being inspected.
• Default layout — preferred layout used when opening the MPR viewer.

MIP Viewer

Maximum Intensity Projection (MIP)

MIP collapses a small stack of contiguous slices — a slab — into a single image by keeping the brightest voxel encountered along each ray through the slab. The technique is widely used to display high-intensity structures that would otherwise be split across many slices, such as contrast-enhanced vessels (CT/MR angiography), bones, or bright pulmonary nodules. MinIP (minimum) and Mean IP (average) projections are also available — useful for airways, low-attenuation lesions, or smoother integrated views.

Since Version4.7.0, MIP is no longer a standalone window. It is integrated directly into the DICOM 2D viewer, with full synchronization and a slab-geometry overlay shared with linked views.

MIP is also available in the other 3D-capable viewers, each with its own configuration:

• MPR viewer — MIP can be enabled per view via the view configuration button, so the slab projection works on any reconstruction plane (axial / coronal / sagittal / oblique).
• 3D Volume Renderer — offers MIP as a volume rendering type.

Activating MIP in the 2D viewer

Enable the projection from in the Basic 3D toolbar of the DICOM 2D viewer.

Once active, MIP in the 2D viewer provides:

• Full synchronization — the slab stays aligned with the current slice position and follows any view synchronization you have configured.
• Slab cross-lines — when another loaded series shares the same Frame of Reference and is shown in a different orientation, the standard cross-lines on that series are extended to show both edges of the slab instead of just the current slice position. The slab extent is therefore visible at a glance from a complementary plane.
• Per-view indicator — once MIP is active on a view, the icon appears in the top-right corner of that view. Clicking it opens the same MIP options as the toolbar button, so you can tweak settings per view without leaving the layout.

MIP options

The MIP options panel can be opened from either of two places:

• The button in the Basic 3D toolbar — applies to the currently selected view.
• The indicator in the top-right corner of any view that already has MIP active.

Projection

The projection type controls how each pixel of the output is computed across the slab:

• None — no projection; display the original image.
• Min — Minimum Intensity Projection.
• Mean — Mean Intensity Projection.
• Max — Maximum Intensity Projection.

Switching from None to any of the projection types initializes the slab thickness to 2 slices (2 slices before and 2 slices after the current one).

MIP thickness

Defines the extent of the slab used for the projection — expressed as a number of slices before and after the current one (e.g. a value of 3 means 3 slices on each side of the current slice, 7 slices total in the slab).

The dropdown shows suggested values, with the corresponding physical thickness in millimeters shown in parentheses when the series is spatially calibrated (e.g. 5 (3.5 mm)). The last entry, Custom thickness, lets you type any value manually.

Build a new series

Builds a new MIP series from the current options — every slice of the source series is reprojected with the chosen projection type and slab thickness, and the result is stored as a standalone series. The new series is added to the DICOM Explorer and can be exported like any other series. Annotations drawn on the new series are persistent since they are no longer tied to a live slab calculation.

DICOM 3D Viewer

Displaying volume data

The 3D viewer reconstructs a CT, MR, PET, or other volumetric series into an interactive volume rendering that can be rotated, sliced, recolored, and lit in real time. Typical uses include reviewing CT angiography, inspecting bone or vascular anatomy, surgical-planning views, and quickly conveying findings to colleagues or patients. Available since Version4.1.0, with major rendering and synchronization improvements in Version4.7.0.

Internally, the volume is rendered on the graphics card using a ray-casting algorithm implemented in GLSL shaders, so a modern GPU is required (see Requirements) but no extra installation step is necessary.

Requirements

The graphics-card capabilities used by Weasis are reported under OpenGL Support in File > Preferences > Viewer > 3D Viewer:

• Driver version — requires OpenGL 3.3+ since Version4.7.0. Two rendering backends are used depending on the available OpenGL version:
  • OpenGL 4.3+ — uses a Compute Shader for optimal performance.
  • OpenGL 3.3 – 4.2 — uses an FBO-based Fragment Shader fallback (fully functional, but may be less performant than the Compute Shader path). macOS is capped at OpenGL 4.1 and therefore always uses this path.
• Max 3D texture dimension length — the upper limit, in voxels, of any X / Y / Z dimension of the volume.
• Any other entry shown in red indicates a non-optimal configuration. The viewer often still works — see how to limit the size of 3D textures if performance becomes an issue.

Open the 3D viewer

Open the viewer by clicking in the toolbar of a series view, by double-clicking the series thumbnail, or by right-clicking the thumbnail in the DICOM Explorer and choosing the 3D viewer.

Try it on a volume dataset (Medical Demos from data.kitware.com) Launch

The same patient orientation axes as the MPR views are drawn in the 3D view since Version4.7.0.

Toolbar A

Actions in the toolbar:

• Reload volume — fully reloads the volume from the source series.
• Orthographic / Perspective projection — toggles between orthographic projection (parallel lines preserved, no foreshortening — useful for measurements) and perspective projection (depth cues, more natural-looking view). Perspective is the default.
• MPR Crosshair Cut — opens the cut mode to interactively clip the rendered volume along the anatomical planes defined by the MPR crosshair.
• 3D preferences — opens the Preferences.

Other toolbar buttons (LUT, reset, layout, synchronize…) are documented in the sections below.

MPR Crosshair Cut Mode

Since Version4.7.0 the 3D viewer can display an MPR crosshair overlay synchronized with the MPR viewer, allowing you to clip the rendered volume along the anatomical planes defined by the crosshair position and orientation. The crosshair position and rotation stay synchronized in real time between the 2D MPR planes and the 3D rendering.

Recommended workflow

1. Open the MPR viewer from a series view.
2. In the MPR toolbar, click — this splits the current tab into a side-by-side layout with the MPR views on one side and the 3D volume rendering on the other.
3. In the 3D view, activate a cut mode using the toolbar button or by right-clicking and selecting MPR Crosshair Cut.

Alternative workflow

Open the 3D viewer first, then activate a cut mode from the toolbar or the right-click menu. The MPR viewer opens automatically for the same series, but in a separate tab. To obtain the side-by-side layout, drag the MPR tab and dock it next to the 3D view using the docking handles.

Cut modes

• No cut — no clipping; the full volume is rendered.
• 18 directional modes — clip the volume in halves, quarters, or eighths relative to the MPR crosshair position, along each anatomical axis (Left / Right, Anterior / Posterior, Superior / Inferior).

The crosshair overlay uses the same LPS axis color coding as the MPR viewer.

3D View Synchronization

Since Version4.7.0 the 3D viewer can host multiple side-by-side views of the same volume and keep them coordinated. Because every 3D view in the container shows the same volume, the auto-sync button is always visible. A single synchronization profile bundles a per-action toggle list with camera-level actions enabled by default and photometric / rendering actions left opt-in.

Toolbar “Synchronize” checkbox

The Synchronize checkbox in the toolbar drives the global on/off state for the 3D container. It defaults to ON. Toggling it propagates the new state to every per-view auto-sync button on the next refresh.

Per-view auto-sync button

When the layout has two or more views, a small auto-sync button appears in the bottom-right corner of each view. Its tint reflects the per-view state — red when sync is OFF for the view, green when ON. Clicking the button opens a popup with:

• Synchronize this view — master on/off toggle for auto-sync on this view (also mirrored into the toolbar Synchronize checkbox so the toolbar state always reflects the active view).
• Per-action toggles — independent checkboxes that decide which actions this view propagates to (and receives from) the other 3D views. The popup stays open while you flip several options.
• Apply to all views — copies this view’s effective per-action map to every other 3D view in the container. Unlike the 2D variant of this entry, no FoR filtering is applied because all 3D views share the same volume.

Right-click “Synchronize” submenu

The view’s right-click context menu also exposes a Synchronize submenu with the same per-action toggles and the same Apply to all views entry, useful when you want to adjust the sync map without first enabling/disabling the master toggle.

Per-action defaults

Camera-level actions are on by default because keeping multiple 3D views framed identically is the common workflow when comparing rendering types or LUT presets side by side. Photometric and rendering actions are opt-in because the typical reason to open a second 3D view is to diverge on those settings (e.g. one view in Composite with a soft-tissue LUT, the other in MIP).

3D Rendering Tools

This tab groups every control that affects how the volume is rendered. To return to the original settings, click the toolbar button or pick Reset from the context menu.

Windowing and Rendering B

Some of the options below are also accessible from the toolbar and the right-click menu.

• Window — width of the voxel-value range mapped to the displayed value range.
• Level — center of the range defined by Window.
• LUT Shape — transfer function applied between input and display values: linear, sigmoid, or logarithmic. Default is linear.
• LUT — a 3D Lookup Table that maps grayscale voxel values to color, opacity, and lighting for visualization. Picking a LUT from the toolbar or the right-click menu is usually easier: LUTs there are ordered by modality and shown with a preview.
• Invert LUT — flips the LUT direction.

Volume Rendering C

Controls for the rendering algorithm, quality, transparency, lighting, and shading.

• Type — defines the rendering algorithm applied to the volume:
  • Composite — classic volume rendering. Each voxel contributes color and opacity along the ray, blended front-to-back to produce the final image.
  • MIP Max — Maximum Intensity Projection. Keeps the highest-intensity voxel encountered along each ray. Useful for highlighting bright structures such as contrast-enhanced vessels or bones.
  • MinIP — Minimum Intensity Projection. Keeps the lowest-intensity voxel along each ray. Useful for visualizing air-filled structures such as airways.
  • MIP Mean — Mean Intensity Projection. Averages intensities along each ray, producing a smoother representation of the volume.
  • Iso Surface — renders a 3D surface at a given intensity threshold, representing structures of a uniform density (e.g. bone segmentation).
• Z-axis sampling — distance between successive samples along each ray. Smaller values capture more detail at the cost of compute time; the default is derived from the volume size.
• Opacity — global opacity factor for the voxels. Can be pushed above 100 % to compensate for the lower-than-100 % values defined by some Volume LUTs.
• Shading — enables shading on the rendered surface. The default is taken from the Volume LUT; the additional options let you override the inherited lighting settings.

Transform D

Zoom the volume and rotate it around the three patient axes:

• Zoom slider — scales the rendering.
• Rotation sliders — rotate around the Left / Right, Anterior / Posterior, and Superior / Inferior axes (LPS coordinate system).

Preferences

From the menu File > Preferences > Viewer > 3D Viewer.

OpenGL Support

Information about the graphics card and OpenGL capabilities, see Requirements.

3D Viewer

• Default layout — preferred layout used when opening the 3D viewer. Available layouts: 1×1 (single view, default), 1×2, 2×1, 1×3, 2×2.
• Max 3D texture size — maximum volume dimensions, both in X / Y (image width and height) and in Z (number of images in the stack composing the volume).

Volume Rendering

• Dynamic quality — reduces the rendering quality along the Z axis while you rotate or modify the view, for a smoother interaction. At the maximum slider position there is no quality reduction.
• Default orientation — preferred starting orientation. Default: anterior view rotated 15° to the right and 15° downward.
• Background color — background color of the rendered scene.
• Light color — color of the light used to illuminate the rendering.

Video tutorials

Display an MR angiography series as a volume rendering, then switch to a MIP projection or pick a 3D LUT and adjust the window / level values:

DICOM ECG Viewer

Displaying electrocardiography data

The ECG viewer displays and analyzes electrocardiogram waveforms stored as DICOM Waveform objects — resting and stress 12-lead ECGs, ambulatory recordings, and rhythm strips. It also provides simple on-screen calipers for measuring intervals and amplitudes, with support for the common lead layouts (12-lead, 3-lead, rhythm strip).

Try to open an ECG sample Launch

Toolbar A

Actions in the toolbar are:

• Print the ECG as displayed, with basic patient and study identification.
• Show DICOM metadata of the waveform object — opens the full DICOM attributes.
• Clear all measurements (the yellow caliper bands in the image above), see Markers.

Zoom and Display Format B

Three controls govern how the traces are drawn:

• Time scale (X-axis) — millimeters per second; defaults to auto mm/s, which fits the recording to the available width.
• Voltage scale (Y-axis) — millimeters per millivolt; defaults to auto mm/mV, which fits the dynamic range vertically.
• Aspect-preserving zoom slider — scales both axes together so the visual aspect ratio is preserved.

The Display Format menu chooses the lead layout (e.g. 12 × 1, 6 × 2, 3 × 4 + rhythm strip), independent of the zoom.

Lead and Cursor information C

Moving the cursor over the traces updates two readouts:

• Lead label — minimum and maximum voltage observed on that lead across the whole recording.
• Cursor readout — time and voltage at the cursor position.

Markers D

Markers are on-screen calipers (yellow bands above) defined by a start and an end point on the same lead. Each marker reports:

Mouse actions:

• Add a start point — click
• Add an end point — Ctrl + click, or right-click
• Delete the measurement on a lead — middle-click, or Shift + click
• Delete every measurement — the toolbar button above

Annotations E

The annotations panel surfaces two related groups of DICOM metadata stored with the waveform:

• Acquisition Context — conditions present during recording (patient state, electrode placement, device settings, etc.).
• Waveform Annotations — measurements, classifications, regions of interest, or events that may affect interpretation (for example, the timestamp at which the subject coughed or moved).

DICOM SR Viewer

Displaying DICOM Structured Report

A DICOM Structured Report (SR) carries structured findings — measurements, observations, classifications, and references back to the images they were derived from — as a hierarchical tree of content items rather than free-form text. SRs are produced by radiology reporting systems, ultrasound machines, CAD applications, and increasingly by AI inference frameworks that need to expose machine-readable results.

Weasis renders the SR tree on the right and the image referenced by the currently selected item on the left, so you can read a finding and inspect the underlying image at the same time.

Try to open sample SR files Launch

Toolbar A

Actions in the toolbar:

• Print — print the rendered SR.
• Show DICOM metadata — open the full DICOM attributes of the SR object.

Display SR Header B

The SR header is displayed as a three-column table summarizing the patient identification, the study context, and the report status (e.g. Partial, Complete, Verified, Cancelled).

DICOM SR Tree C

The content of the SR is displayed as a hierarchical tree. Each node is a content item with its own number, a concept name (what the item describes — e.g. Finding Site, Length, CAD Output) and a value (text, code, numeric measurement, date/time, image reference, or composite reference). The hierarchy and the inter-item links mirror the relationships defined in the SR object — typically following one of the standard DICOM templates (TIDs) used in radiology, ultrasound, or AI reporting.

Some items also carry a link to a referenced image or region. Clicking such a link opens the corresponding image in the 2D viewer and, when the SR contains coordinate data, draws the referenced geometry on top of it (for example, clicking the POLYLINE node in the screenshot above opens the source image and displays the polyline measurement at its recorded position).

Weasis renders the standard SR graphic types — POINT, MULTIPOINT, POLYLINE, CIRCLE, ELLIPSE — and, since v4.7.0, a subset of the SR compound graphic types — MULTILINE, RULER, ARROW, RECTANGLE — for richer overlays carried by the SR Compound Graphic module.

DICOM Audio Player

Playing DICOM AU data

The DICOM Audio SOP Class (commonly referred to as DICOM AU) stores waveform audio inside a DICOM object. It is most often used for voice annotations dictated by the technologist or radiologist, Doppler ultrasound audio, phonocardiography, and other acoustic signals captured alongside an imaging study.

Weasis opens these objects in a dedicated player launched by double-clicking the audio thumbnail in the DICOM Explorer.

Try to open a DICOM AU sample Launch

Toolbar A

• Show DICOM metadata — opens the DICOM attributes of the audio object.

Play B

The Play button toggles between playback and pause. The slider lets you scrub through the recording; the current position is displayed in seconds.

Volume C

Adjusts playback volume independently of the system mixer.

Export Audio File D

Saves the embedded waveform to disk as either:

• AU — the format used by the DICOM payload itself, preserved as-is.
• WAVE (.wav) — re-encoded for broad compatibility with consumer audio players and editors.

Draw & Measure

How to draw and measure on images

The Draw & Measure panel lets you annotate and measure on DICOM and standard images — distances, angles, areas, regions of interest, free-hand shapes, and text labels. Measurement values are computed from the image’s spatial calibration when available, and from pixel statistics when the shape is closed.

Where the results are persisted depends on the image type:

• For DICOM images — saved into a DICOM Presentation State (GSPS) object that travels with the study.
• For standard images — saved into an XML file in the same directory as the image (when the image is exported in a non-DICOM format). The XML file is loaded automatically the next time the image is opened in the 2D viewer.

Draw & Measure Panel

Click on the vertical button to dock the panel on the right side of the viewer. The panel is divided into four parts:

• Measurement tools A
• Drawings B
• Graphic Options C
• Selected Measurement D

Measurement tools A

Click a measurement tool and then draw on the image. Picking a tool here also becomes the active action on the left mouse button.

The first button is the selection tool — used to select, resize, and move existing graphic objects.

Once one or more graphics are selected, you can change their properties (color, line width…) or copy/paste them through the right-click menu. The selection can be removed with the Delete key or . See the full list of graphic shortcuts.

Drawings B

The drawing buttons add text and graphic annotations. These objects are purely decorative — they do not display measurement values and do not appear in the Selected Measurement table.

Graphic Options C

• Line color — default color for new graphics (default: yellow). The transparency / alpha slider in the color picker controls opacity.
• Line width — default line width.
• Draw only once — when checked, the tool reverts to the selection mode after each draw. Uncheck to keep the same tool active for successive draws.
• Pixel statistics — compute and display statistics of the pixel values inside the shape. Only meaningful for closed shapes (rectangle, ellipse, polygon).
• Unit — unit of the image’s spatial calibration. When the image has no calibration, the unit falls back to pixels. See How to change the spatial calibration.
• More options — opens the Draw & Measure preferences for the deeper display options.

Selected Measurement D

The graphic E currently selected on the image is summarized in this table. The reported properties depend on the measurement type, with units shown in square brackets when present (see the calibration type at M).

When Pixel statistics is checked, the table also reports descriptors computed from the pixels enclosed by the (closed) shape:

• Pixels — number of pixels inside the shape.
• Min — minimum modality value.
• Max — maximum modality value.
• Median — median modality value.
• Mean — mean modality value.
• StDev — standard deviation; a measure of how dispersed the values are.
• Skewness — asymmetry of the value distribution.
• Kurtosis — “tailedness” of the value distribution.

Preferences

From the main menu File > Preferences > Draw & Measure.

Drawings

Default graphic properties applied when drawing new objects — since Version4.3.0.

• Line color — default color (default: yellow). The transparency / alpha slider in the color picker controls opacity.
• Line width — default line width.
• Fill shape — when checked, the interior of the shape is filled with the line color.
• Fill opacity — opacity of the interior, relative to the line color’s opacity. Default: 100 %. Example: line opacity 80 % × fill opacity 20 % → perceived interior opacity 16 %.

Labels on image

Display options for the labels attached to measurement graphics.

• Font type — default font size for the on-image labels (default: Small semibold). The size is not absolute — it adjusts automatically with the interface scale factor.
• Geometric measurement — which geometric measurements are displayed on the image for each graphic type.
• Pixel statistics — which pixel statistics are displayed on the image for closed shapes (rectangle, ellipse, polygon).

DICOM RT Tools

Displaying radiotherapy information

Radiotherapy treatment data is distributed across three companion DICOM objects:

• RTSTRUCT — contoured structures (target volumes, organs at risk, body outline) referenced to a planning CT.
• RTPLAN — prescribed dose, fractionation, beam geometry, and machine setup.
• RTDOSE — the computed dose distribution as a 3D pixel grid, with optional pre-computed DVH histograms.

When a CT series is loaded together with its associated RTSTRUCT, RTPLAN, and RTDOSE files, Weasis automatically links them and the RT Tool appears in the right panel.

How to display structures

1. Click Load RT to load the linked DICOM STRUCT, PLAN, and DOSE objects. The button becomes inactive once loading completes.
2. InfoOptional Select a structure set if more than one is available.
3. InfoOptional Select a plan if more than one is available.

Try to open an RT sample Launch

How to display isodoses

1. Switch to the Isodoses tab.
2. Check the Isodoses root node — it is unchecked by default.
3. InfoOptional Adjust the graphic opacity (default: 50 %).

How to display the DVH chart

The Dose-Volume Histogram (DVH) summarizes, for each selected structure, the fraction of its volume that receives at least a given dose level — the standard way to compare plans and check organ-at-risk constraints.

• Select one or several structures (the Structures root node must also be selected).
• Click Display DVH chart.
• Right-click on the chart to print or save as PNG, or as a vector file (SVG, EPS).

DICOM Attributes

How to display DICOM attributes

Every DICOM object carries a set of attributes (also called tags or metadata) that describe the patient, the study, the acquisition device, the imaging parameters, and so on. Weasis can display these attributes in two ways — a dynamic in-layout view that follows the current image, or a detached window snapshot of a single instance.

Opening the DICOM attributes

Open the DICOM attributes either by:

• selecting the DICOM Information layout from the layouts dropdown A, or
• clicking the DICOM Information button in the toolbar to open a detached window B.

When Weasis opens certain DICOM payloads with an external application (e.g. encapsulated PDF or video), the attributes can still be inspected from the thumbnail right-click menu.

How to find a specific DICOM attribute or value

The DICOM Information window has two tabs:

• Limited DICOM attributes — the main attributes grouped by category (a curated subset for everyday use).
• All DICOM attributes — every attribute present in the file. Each data element is shown in four columns: Tag ID, VR, Tag Name, Value.

The example above searches for the word date. The procedure is:

1. Switch to the All DICOM attributes tab so every attribute is searchable.
2. Type the search term in the search field.
3. Use the navigation arrows to jump between highlighted matches. The rightmost button filters the list to only the matching rows (instead of just highlighting them inside the full list).

Using in the toolbar applies a persistent filter on the attribute list — useful when you want to keep the focus on a specific set of attributes while scrolling through a stack of images (in-layout view A) only).

Lookup Tables (LUT)

How to handle Color and DICOM LUTs

A Lookup Table (LUT) maps each input pixel value to an output value used somewhere along the rendering pipeline — turning raw acquisition numbers into the contrast, the color, and the brightness you actually see on screen. The DICOM rendering pipeline chains four kinds of LUT, each applied at a different stage:

1. Modality LUT — converts raw pixel values into physical modality values (e.g. Hounsfield units for CT).
2. Values of Interest (VOI) LUT — maps the modality values into a visible intensity range, enhancing specific anatomical structures or pathological conditions (this is what the Window / Level controls).
3. Presentation LUT — converts the intensity values into P-Values: device-independent values calibrated to human perception (used to render consistently across monitors).
4. Palette Color LUT — replaces grayscale intensity values with colors, producing a pseudo-color rendering.

Windowing and Rendering

Windowing and Rendering is a panel in Image Tools of the 2D viewer, exposing the user-controllable parts of the LUT pipeline. The same controls are also accessible from the Lookup Table toolbar, the main menu, and the right-click menu.

• Window — width of the input range mapped to the displayed values. Change it via the slider, or by selecting Window / Level in the mouse actions.
• Level — center of the range defined by Window. Same input options as above.
• Preset — picks a predefined Window / Level pair. The dropdown is ordered as:
  • An empty entry, shown while Window and Level are being adjusted manually (slider or mouse drag).
  • Window / Level pairs or VOI LUT data carried by the DICOM file (suffixed with [DICOM]). The default selection is the first [DICOM] entry when present, otherwise Auto Level [Image].
  • Auto Level [Image] (always shown) — Window and Level computed from the full pixel-value range of the current image.
  • Modality-specific presets (e.g. Lung, Bone, Soft Tissue for CT).
• LUT Shape — the transfer function used between input and display: linear (default), sigmoid, or logarithmic.
• LUT — pseudo-color LUT applied on top of the grayscale image. Default (image) keeps the original image color model. Picking a LUT from the toolbar or the menus is usually easier because each entry is shown with a preview.
• Invert LUT — flips the LUT direction (dark↔bright, or reversed color mapping).
• Filter — 2D image filter applied before the LUT, useful for enhancing image quality or highlighting specific structures. Default: None.

Build DICOM KO and PR

How to build and export DICOM KO and PR

Weasis can author two standard DICOM annotation objects directly from the viewer:

• Key Object Selection (KO) — a list of “key images” inside a series. Use it to flag the slices that matter for a finding so a reader can scroll only through those.
• Presentation State (PR / GSPS) — drawings, measurements, and other graphic overlays that reference the source images. Use it to share findings across systems without baking annotations into the pixels.

Both objects can be saved as proper DICOM files and sent to a PACS through the standard DICOM Export workflow, so they travel with the study and can be re-applied by any DICOM-compatible viewer.

Key Object Selection (KO)

To make the KO controls visible, enable the Key Object Selection toolbar from View > Toolbars > Key Object Selection Toolbar in the main menu.

When a DICOM KO is loaded with the series, it appears in the explorer menu (1) and can also be picked from the icon on the right side of the view (6). KO objects created in Weasis behave the same way.

Actions available in the KO toolbar:

• Apply a KO (2) — select which KO drives the current view.
• Mark / unmark a key image (3) — click the star icon, or press K (default — customizable since v4.7.0 in Keyboard Shortcuts) to add the current image to the active KO, or create a new one if none exists yet.
• Filter to key images only (4) — when active, scrolling skips every image that is not part of the selected KO, so you see only the flagged slices.
• Create / delete a KO (5) — start a new KO (optionally seeded from an existing one) or delete a KO. Only KOs created by Weasis can be deleted.

Presentation State (PR or GSPS)

• Apply a PR loaded from a DICOM file (1) — since Version2.6.0, PRs are not applied automatically; click the dedicated icon (2) above the image to apply one. To have the most recent PR applied by default, enable Apply by default the most recent Presentation State under File > Preferences (Alt + P) (also configurable through the default preferences).
• Create a new PR — any drawing or measurement (see Draw & Measure) can be exported into a DICOM Presentation State. Image-rendering parameters (zoom, calibration, window/level, LUT…) are not yet included in the exported PR.

Exporting Key Object Selection or Presentation State

Newly created KO and PR objects are exported through the standard DICOM Export dialog — open it from the toolbar icon or from File > Export > DICOM.

1. Pick the export destination — Local Device, DICOM Send, or CD/DVD Image (see DICOM Export for the per-destination options).
2. Choose the export options. Series created inside Weasis (including new KO and PR objects) are flagged NEW in the selection tree.
3. Select the patient(s), study, series, or individual instances to export.
4. Click Export to write or transfer the files, then close the window.

DICOM SEG

Displaying DICOM Segmentation

DICOM Segmentation (SEG) stores pixel-based labels — anatomical structures, lesions, organs at risk — as a separate object that references a source image series. It is the standard delivery format for AI segmentation frameworks, but also for manual or semi-automatic contouring tools.

Weasis displays SEG regions as a colored overlay on the source images, with independent visibility and opacity control per region. Available since Version4.3.0; significantly extended in Version4.7.0 with:

• Overlays in MPR and 3D Volume Renderer views, in addition to the standard 2D viewer.
• Simultaneous display of all SEG files linked to the current series, each toggleable independently.
• Support for the FRACTIONAL (probability / occupancy maps) and LABELMAP (multi-segment files used by tools like highdicom) segmentation types produced by modern AI frameworks.
• The same smooth fractional overlay reused for RT Dose isodose rendering — see the RT tutorial.

How to display DICOM SEG in the 2D viewer

To display the SEG regions as an overlay on the image, follow these steps (see the image below):

1. Open a DICOM series that has a linked SEG object. The link is indicated by the segmentation icon in the lower-right corner of the thumbnail.
2. Once the image is displayed, click on the vertical button to open the Segmentation panel on the right side of the viewer.
3. Every SEG file linked to the current series appears as a top-level node in the tree. Expand a SEG node to reveal its regions and tick the ones you want to display. Regions that share a common name prefix are grouped under a parent node — the parent must be checked for any of its children to be visible.
4. InfoOptional Adjust the global graphic opacity (border and interior fill) with the slider.
5. InfoOptional Use tooltips to see the region description, voxel count and estimated volume for each region. For FRACTIONAL regions a color-gradient bar is also displayed to help interpret the probability ramp.

Try to open a SEG sample Launch

Supported segmentation types

Weasis supports all three DICOM SEG segmentation types:

Segmentation overlay in MPR

When a DICOM SEG is linked to the current series, the overlay is automatically available in the Multi-Planar Reconstruction (MPR) view. The same Segmentation panel controls visibility and opacity for all three planes (axial, coronal, sagittal — plus any oblique cut) at once.

For MPR, Weasis additionally has to reslice the SEG along the new planes. This extra step runs in the background; the overlay appears on every plane as soon as it completes.

Segmentation overlay in the 3D Volume Renderer

The 3D Volume Renderer offers three segmentation modes, selectable from the Segmentation panel:

A few things to keep in mind when working with the 3D overlay:

• Toggling a segment is instant. Visibility, color and opacity changes update the 3D view immediately, even on very large volumes — Weasis only refreshes the color table, not the segmentation itself.
• Overlapping segments are handled cleanly. When two segments share the same area, their colors are blended automatically; you do not have to pick which one wins.
• 2D, MPR and 3D stay in sync. Showing or hiding a segment in the panel updates all three views simultaneously.

AI DICOM Objects

DICOM objects generated by artificial intelligence

AI inference rarely defines its own file formats — instead, results are packaged as standard DICOM objects so any compliant PACS or viewer can ingest them. The same SOP Classes used for human-authored content (segmentations, structured reports, presentation states…) are reused to carry model outputs.

This page maps the AI-produced object types you are most likely to encounter to how Weasis displays them.

Image outputs

These objects carry their own pixel data and are viewed as standalone images.

DICOM Secondary Capture (SC)

Pre-rendered images where the AI has burned its output directly into the pixels — typically annotations, heatmaps, or side-by-side comparisons. Convenient for legacy viewers, but the overlay cannot be toggled off or recomputed.

DICOM Enhanced Objects

Reconstructed or post-processed images — for example denoised CTs, super-resolved MRs, or motion-corrected series. The output replaces or complements the original acquisition rather than annotating it.

DICOM Parametric Map (PMAP)

Single- or multi-frame images whose pixel values represent a derived quantity rather than an acquisition signal — common carriers for AI probability maps, class-activation heatmaps, perfusion (rCBF, rCBV, MTT), diffusion (ADC), and PET-derived metrics.

Image overlays

These objects do not contain a viewable image of their own; they reference a source series and are drawn on top of it.

DICOM Segmentation (SEG)

Pixel-based labels produced by segmentation models — anatomical structures, lesions, organs at risk, etc. Each segment is stored as a binary or fractional mask and is independently toggleable in the viewer.

DICOM RTSTRUCT

Originally designed to describe contours for radiotherapy planning, RTSTRUCT is also used by AI tools that output vector geometry instead of pixel masks. Lighter to store than SEG, but inherently 2D per slice.

TotalSegmentator is a good example: starting from version 2, its automatic segmentation of 100+ anatomical structures on CT can be exported as DICOM RTSTRUCT — and, in recent releases, as DICOM SEG as well — both of which load directly in Weasis without any extra configuration.

DICOM Presentation States (GSPS)

Grayscale Softcopy Presentation States store the display intent for an image — window/level, zoom, rotation — together with vector annotations and measurements. AI tools use them to ship findings as toggleable overlays on the original images rather than baking them into pixels.

Reports & documents

These objects carry structured or document content rather than imagery.

DICOM Structured Report (SR)

Tree-structured findings: measurements, classifications, observations, and references back to the images they describe. The standard delivery format for AI tools that need to expose interpretable, machine-readable results.

DICOM Encapsulated Documents

Wrappers for non-image content (PDF, STL, MPEG, plain text…). Useful when an AI pipeline produces a full report or auxiliary artifact that would otherwise live outside the imaging study.

Zoom

Zoom Tool

The zoom tool changes how much of the image fits into the view. Beyond the standard “fit to screen” / “fit to pixel” magnifications, Weasis offers a Real-world Size mode that displays images at their actual physical dimensions on a calibrated monitor — useful for visual size estimation, surgical planning, or prosthesis sizing.

Basic zoom controls

There are several ways to adjust magnification:

• Mouse drag — drag with the configured mouse button (middle mouse button by default; see the 2D viewer mouse actions to remap it).
• Mouse wheel — when enabled in the preferences.
• Toolbar dropdown — pick a preset zoom level.
• Context menu — right-click → Zoom.
• Image Tool panel — drag the zoom slider.
• Keyboard shortcuts — zoom in, zoom out, and reset zoom.

Zoom presets

The toolbar and context menu expose three presets:

• Actual Pixels — 1:1 display: one image pixel maps to one screen pixel.
• Real-world Size — physical-size display (requires a calibrated monitor).
• Best Fit — scale the image to fit the view area (default).

Real-world Size Display

Real-world size means 1 mm on the image equals 1 mm on the screen, so anatomical structures appear at their true physical dimensions. This is essential for visual size estimation, surgical planning, prosthesis sizing, or any clinical comparison done directly on the monitor.

For Weasis to compute this accurately, it needs two things:

1. The DICOM Pixel Spacing of the image (already stored by the modality — see the image-level Spatial Calibration page when it’s missing).
2. The physical size of one screen pixel for each monitor — this is what the Spatial Calibration step below provides.

Without monitor calibration, the Real-world Size preset falls back to the operating system’s DPI value, which is rarely accurate.

What you need

• A precise ruler — ideally a caliper (mm or 1/10 mm graduations).
• The monitor in its final position and resolution (do not change the OS scaling factor after calibrating).

Step-by-step monitor calibration

1. Open File > Preferences (Alt + P) > Monitors.
2. The list shows every detected monitor with its pixel resolution; once calibrated, the real width × height in mm is appended in parentheses.
3. Click Spatial calibration next to the monitor you want to calibrate. A fullscreen window opens on that monitor and draws a black background with a white horizontal line and a white vertical line.
4. Physically measure one of the three references on the screen surface:
   • the horizontal line,
   • the vertical line, or
   • the screen diagonal (corner to corner of the visible glass).
5. At the bottom of the dialog, pick the matching reference in the first dropdown (Horizontal line / Vertical line / Screen size), type the measured value, and pick its unit (mm, cm, 1/1000 in, in).
6. Click Apply. The dialog redraws each line with its computed real length next to it — cross-check that the displayed value matches what you measured (within ±0.5 mm). Re-measure and re-apply if needed.
7. Close the calibration window. The Monitors page now shows the screen’s real size, and the value is persisted (per monitor) for the next sessions.
8. Activate the result in any 2D viewer with the Real-world Size preset (toolbar dropdown, context menu Zoom, or the image tool panel).

Verifying the result

Open any image whose dimensions you know — a calibration phantom, a CR/DX study with a visible ruler, or a printed test pattern displayed full screen — and switch to Real-world Size. Use the length measurement tool and compare with the physical ruler — the values should match within a fraction of a millimeter.

Magnifying Lens

The magnifying lens is a movable, resizable overlay that displays a zoomed-in view of a small area without affecting the underlying image. Useful for inspecting fine detail (small lesions, calcifications, fine vascular structures) without changing the global zoom level, or for comparing two rendering parameters side-by-side using the freeze options.

Enable / disable the lens with its toggle button in the zoom toolbar.

Key features

• Magnify a specific region without modifying the main view.
• Hide overlays inside the lens (Show Drawings toggle).
• Compare different Window / Level settings side-by-side (Freeze parameters).
• Compare different images of the same series side-by-side (Freeze image).

Lens controls

• Mouse wheel — adjust the lens zoom factor.
• Double-click — match the lens zoom to the main image zoom.
• Right-click menu options:
  • Hide Lens — disables the lens.
  • Synchronize to parent zoom — matches the lens zoom to the main image.
  • Show Drawings — toggles overlay visibility inside the lens.
  • Magnify — pick the lens zoom level from a preset list.
  • Image — control image and parameter freezing:
    • Freeze Parameters — keeps the current image processing settings (Window / Level, LUT, filters) frozen inside the lens while you scroll through the series elsewhere. Useful for comparing the same anatomical area with different rendering settings.
    • Freeze Image — captures both the image and its processing parameters, so the lens keeps showing the frozen image while the main view moves on. Useful when comparing different slices or time points of a study.
    • Reset Freeze — clears the frozen state; the lens reverts to following the current image and its processing settings.

Histogram

Displaying Histogram

The Histogram view plots the distribution of pixel values in an image (or in a selected region), so you can see what intensity ranges are actually present and how they are spread across the available scale. It is also a quick way to gauge the effect of any change made in the windowing and rendering panel: as you move the window / level sliders or pick a different LUT, the histogram visually reflects how the input values are being mapped to the output.

To open the histogram, pick the Histogram layout from the layouts dropdown in the toolbar (see screenshot below).

General histogram parameters

• Channel — for grayscale images, only the Luminance channel is available. For color images, pick one of the RGB, HSV, or HLS color models — each channel of the chosen model gets its own histogram.
• Bins — width of the value intervals grouped together in each bar. The default is computed as max − min of the pixel values, capped at 512; you can override it with any value between 64 and 4096.
• Statistics — show pixel statistics next to the histogram, useful for analyzing and comparing images or regions quantitatively. For the definition of each statistic, see Pixel Statistics.

Display parameters

• − / + — shrink or stretch the Y-axis scale (the number of occurrences).
• Accumulate — display a cumulative histogram.
• Logarithmic — show the Y axis on a logarithmic scale (useful when a few dominant bins crush everything else into invisibility).
• Show intensity color — color each bin with the active LUT; otherwise the bars are drawn in black.
• Reset — restore the default display parameters.

Print

Printing images

Weasis can print images two ways:

• Standard printer — sends a regular page to any printer configured on your operating system (laser, inkjet, PDF writer, …). Used for paper reports, slide handouts, or PDF export.
• DICOM Print — sends the images directly to a DICOM film printer over the network, using the DICOM Print Management protocol. Used in radiology departments that still print films for clinical use.

Both modes operate on the current layout — the page is built from the views currently visible in the active tab. The first step is therefore to prepare the layout exactly the way you want it on paper or film.

Preparing the image selection

If you need more than one image per page, pick a layout from the layouts dropdown in the toolbar (1).

To fill the layout with images, choose a synchronization mode (2):

• Default Tile — every view is filled automatically with consecutive images of the same series (the first view shows image n, the next shows n+1, and so on).
• Default Stack — drag and drop a series into each view independently, then scroll each view to the image you want printed.

Choosing a print mode

Standard Printer

Open File > Print > Print 2D viewer layout (P) from the main menu.

Print options:

• Image position — where each image is placed inside its page cell (centered, fit, etc.).
• Image DPI — print resolution in dots per inch (default: 150). Higher DPI means finer detail and a larger file sent to the printer.
• Print image with annotations — when checked, the annotations and graphic objects defined in the Display panel are printed on top of the image.
• Print only the selected view — when checked, only the view with the orange focus border is printed. When unchecked, every view of the current layout is printed.

DICOM Print

Open File > Print > DICOM Print from the main menu.

The DICOM Print dialog lets you manage several DICOM printer configurations (each carrying its own AE title, host, port, and film parameters). The print parameters mirror the Standard Printer ones above — for the protocol-level specifics, see the DICOM Print Management Service chapter of the standard.

Image orientation

Interpretation of the orientation

DICOM image viewers indicate which anatomical direction lies outside each edge of the image using one or more uppercase letters drawn at the top-center and left-center of the view. They let you recognize the patient’s left vs. right (or dorsal vs. ventral, etc.) at a glance, without having to scroll the metadata.

The exact set of letters depends on the Anatomical Orientation Type (0010,2210) attribute of the study — Weasis supports both the standard BIPED scheme used for human imaging and the QUADRUPED scheme used in veterinary imaging.

BIPED (human imaging)

Used when the Anatomical Orientation Type attribute is absent or set to BIPED:

QUADRUPED (veterinary imaging)

Used when the Anatomical Orientation Type attribute is set to QUADRUPED (supported since Version4.1.0). The scheme uses two-letter codes for left and right (LE / RT) to avoid collisions with single-letter codes that mean something different in this scheme:

Orientation in multiplanar reconstruction (MPR)

In the MPR viewer, the same letter convention is applied to each of the three reformatted planes. The uppercase letter at the left or the top names the anatomical direction; the plane type (axial, coronal, or sagittal) is labeled at the bottom of the view.

Third-party Launcher

Launching a third-party application

Third-party launchers let Weasis hand off to another application — a different DICOM viewer, a post-processing tool, a custom report system, a web URL — and pass it information from the current Weasis session as command-line parameters, environment variables, or URI query parameters. Typical uses include opening the current study in a secondary viewer, sending the downloaded DICOM folder to a dedicated post-processing software (cardiac analysis, vessel quantification, radiotherapy planning…), calling a clinical report system pre-filled with the patient’s accession number, or launching a vendor tool against the DICOM folder Weasis just downloaded.

Configured launchers appear in the File > Launcher menu and, optionally, as a button in the toolbar.

In the screenshot above, a launcher is configured to open the Horos viewer on macOS against the folder where Weasis downloaded the current DICOM files.

How to create the launcher

1. From the main menu, open File > Preferences (Alt + P) and select the Launcher item.
2. Click Add New to create a new launcher.
3. Fill in the general fields of the DICOM Launcher dialog:
   • Name — display name of the launcher.
   • Icon path — icon shown in the menu and toolbar. Absolute path, or relative to the Weasis resources folder. The default icon is used if the file is not found.
   • Enable — show the launcher in the menu and toolbar.
   • Button — also show it as a toolbar button.
4. Click Configure to specify what the launcher actually does.
5. Pick the Launcher Type and fill in its options:
   • URI — open a web page or a file at a given URI. The URI may contain dynamic variables below.
   • Application — run a local application with parameters. Both Parameters and Environment Variables can contain dynamic variables.
     • Binary Path — the executable to run.
     • Working Directory — working directory for the process (optional).
     • Parameters — command-line parameters, one per line.
     • Environment Variables — environment variables, one per line.
     • Compatibility — restrict the launcher to specific platforms. Useful when the launcher configuration is pushed from a central server to heterogeneous workstations.
6. Click Save in the Launcher Type dialog to persist the launch configuration.
7. Click Save in the DICOM Launcher dialog to persist the general settings.

Dynamic variables

The placeholders below are expanded at launch time and can appear in URI, Parameters, or Environment Variables:

How to run the launcher

• From the main menu, open File > Launcher and pick the launcher.
• From the toolbar, click the launcher button.

Spatial Calibration

How to change the spatial calibration

Spatial calibration is the link between a pixel and a real-world length. With a valid calibration, every measurement (distance, area, angle) reflects actual millimeters or centimeters, and the real-world zoom can display images at the same size as the original objects.

For DICOM images, the calibration is normally derived from the standard attributes (Pixel Spacing for cross-sectional acquisitions, Imager Pixel Spacing for projection radiography). The 2D viewer indicates how the calibration was obtained — see the calibration type label shown above the ruler.

When no calibration is available — or when you want to override an existing one — you can apply a manual calibration as long as the image contains a reference object of known size (a ruler, a fiducial, a calibration phantom, or any landmark whose physical length you know).

Manual calibration procedure

1. Pick the Line tool from the Measurement tools.
2. Draw a line along an object whose real-world length you know.
3. Right-click the line and choose Manual Calibration.
4. Enter the known distance (with its unit) in the dialog and confirm.

Changing spatial calibration with Weasis 1.1.3

The procedure shown below was recorded on an older version of Weasis; the underlying workflow is unchanged.

Styles and themes

Change the appearance of the user interface

The Appearance preferences let you tailor Weasis to your environment: pick a light or dark theme to match your reading conditions, adjust the interface scaling to fit your monitor’s pixel density, and toggle a few platform-specific UI behaviors. Open the settings from File > Preferences (Alt + P) > Appearance.

How to apply another theme

Use the theme dropdown A to browse the bundled themes, then click Show to see a partial preview before applying. The recommended theme for clinical reading is Core Dark — Flat Weasis, which keeps the surrounding UI low-luminance to avoid distracting from the images.

How to scale the user interface

The scaling factor B controls the size of every UI element (fonts, icons, graphic components, …). It is recommended to match the operating system’s scaling factor so Weasis looks consistent with the rest of your desktop on HiDPI displays:

• Windows — the Display Scaling preference (Settings > System > Display).
• macOS — automatically aligned with the system Retina scaling.
• Linux — either the display scaling factor or the text scaling factor, depending on the desktop environment.

You can also increase (or decrease) the scaling factor independently of the system — useful for reading from a distance, or when the system value is too aggressive for the application.

How to integrate the main menu in the window bar

Option C forces the main menu to be integrated into the window’s title bar (disabled by default). It is shown only on Linux, where the wide variety of window managers makes integration unreliable without an explicit opt-in.

System File Chooser

Option D swaps the Java default file dialog for the system-native file chooser, providing a more familiar file-browsing experience on each platform.

Changing the default theme or scale factor

When deploying Weasis to several workstations, the default appearance settings can be set centrally instead of being chosen per user. See the Weasis Preferences page for the lookup order Weasis uses when resolving a preference.

Language & Regional Settings

How to change the language and regional settings

Weasis separates two locale-related choices:

• Language — the language of the user interface (menus, tooltips, dialogs).
• Regional format — the rules used to display dates, times, and numbers (decimal separator, thousands separator, calendar conventions…). These also drive how patient lists are sorted, see the DICOM Explorer.

The two are independent, so you can run the UI in English while keeping the regional format you prefer.

Switching from the user interface

From the main menu, open File > Preferences (Alt + P) and pick the desired Language and Regional format in the General tab.

Changing the default locale at deployment

When deploying Weasis to multiple workstations, the default language and regional format can be set centrally via the property files instead of being chosen per user. See the preferences overview for the lookup order Weasis uses when resolving a preference.

Logging

Configure and View Log Files

Weasis writes log files that are invaluable when something goes wrong — a series fails to load, a query times out, a third-party integration misbehaves, or the application crashes at startup. The same files are also what to attach when opening a bug report so a developer can reproduce the problem.

Accessing the log folder

Open the log folder directly from the menu: Help > Open the logging folder (available since Version4.1.0).

Types of log files

Weasis writes two kinds of log files into the log folder.

Boot log (boot.log)

The boot log (available since Version3.5.0) captures the application startup sequence and is always written, regardless of the rolling-log configuration. It is the right place to look for:

• whether Weasis started with the expected parameters,
• startup failures or crashes,
• configuration issues raised during launch.

Rolling log (default.log)

The rolling log captures runtime application activity — viewer events, network calls, errors during use — and must be enabled in the preferences (see Configuring the rolling log below).

Once a rolling log reaches its maximum size, it is rotated and the previous file is automatically compressed into a ZIP archive (since Version4.4.0).

Configuring the rolling log

1. Open File > Preferences > General from the main menu.
2. Enable Rolling log to activate file logging.
3. Adjust the settings as needed:

Understanding log levels

Pick the lowest log level you actually need:

• ERROR — only critical errors.
• WARN — warnings and errors.
• INFO (default) — general progress information, plus warnings and errors.
• DEBUG — detailed debugging information.
• TRACE — the most verbose level, used for in-depth troubleshooting.

Each level includes everything from the levels above it.

Proxy server

How to configure a proxy server

If Weasis must reach the outside world through a corporate proxy — for example to pull updates, fetch a study from a remote DICOMweb server, or use a third-party launcher — you can either configure the proxy from the user interface or pass standard JVM proxy properties at launch.

From the user interface

1. Open File > Preferences (Alt + P) in the main menu.
2. Select Proxy Server from the left panel.
3. The default is Direct connection (no proxy). Switch to Manual proxy configuration to define a custom proxy (the screenshot below shows a local Squid instance).

For the meaning of each field, see the Java networking properties reference — the dialog mirrors the standard JVM proxy properties one-for-one.

From the launch parameters

To pass proxy settings as JVM options at launch, the UI selection must be set to Direct connection (no proxy) or configuration at launch so that the manual UI values do not override the command-line ones.

Common examples:

• Use the operating system’s default proxy:

  -Djava.net.useSystemProxies=true

• Point to a local proxy (e.g. a Squid running on 127.0.0.1:3128):

  -Dhttps.proxyHost=127.0.0.1 -Dhttps.proxyPort=3128

• Use a corporate proxy with authentication and a no-proxy list:

  -Dhttps.proxyHost="proxy.mydomain.com"
  -Dhttps.proxyPort="8080"
  -Dhttp.proxyHost="proxy.mydomain.com"
  -Dhttp.proxyPort="8080"
  -Dhttp.nonProxyHosts="\*.mydomain.com|localhost"
  -Dhttp.proxyUser="user"
  -Dhttp.proxyPassword="password"

http://localhost:8080/weasis-pacs-connector/weasis?patientID=9702672&pro="https.proxyHost%20127.0.0.1"&pro="https.proxyPort%203128"

Dicomizer

How to convert images into DICOM files

The Dicomizer converts standard files — photos, scanned reports, videos, 3D models — into DICOM objects so they can be archived in a PACS alongside acquisitions from imaging modalities. Typical use cases include adding dermatology or wound-care photos to a study, attaching a PDF report or consent form, archiving endoscopic or surgical videos, and packaging STL files used for 3D printing.

Beyond the file conversion itself, the Dicomizer also helps you set the DICOM tags at the patient, study, and image levels so the resulting objects are consistent, searchable in the archive, and recognized by every DICOM viewer.

The sections below describe the day-to-day use of the Dicomizer. Administrators deploying the tool in a clinical workflow should also read Integrating the Dicomizer at the end of this page.

How to Launch Dicomizer

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

On macOS, run the Dicomizer command from the terminal:

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

If you use the Dicomizer frequently on macOS, use Automator to create a Dicomizer.app with a Run Shell Script action containing the command above.

Import Media Files

The Dicomizer can encapsulate the following file types into DICOM objects:

• Standard images — TIFF, BMP, GIF, JPEG, PNG, RAS, HDR, PNM. Converted to JPEG lossy to comply with the DICOM standard.
• PDF documents (application/pdf) Version4.6.2 — convenient for archiving reports, forms, or scanned documents.
• STL files (model/stl) Version4.6.2 — for 3D printing and surgical planning.
• MPEG-2 video (video/mpeg) Version4.6.2 — for compatibility with legacy medical imaging systems.
• MPEG-4 video (video/mp4) Version4.6.2 — modern format for endoscopy, ultrasound, surgical recordings, and other high-quality medical videos.

Importing files

1. In the left panel, navigate through the file system to locate the files to convert. The button next to the combo box on the right opens a folder chooser to pick the directory containing the eligible media.
2. To organize files into separate series, select the thumbnails in the left panel and click Import. The dialog offers three grouping options:
   • Do not group — all images are imported into a single series (same as drag-and-drop).
   • Group by date — images are split into series based on their acquisition date. A second field controls the maximum time gap that still keeps two images in the same series.
   • Group by name — all images are imported into a single series with a custom name.
3. Alternatively, drag and drop files from the system file explorer into the central panel. The files are either added to the current series, or assigned to a default series based on their media type.

Edit DICOM Tags

The Album panel manages DICOM tags at the patient, study, series, and image levels:

• The left panel lists the groups, each representing a DICOM series.
• The central panel shows the thumbnails of the imported media. Select one or more thumbnails to edit their DICOM tags; double-click a thumbnail to open the image in the Photo Editor.
• The bottom panel displays the DICOM tags of the selected images. Image-level tags are only visible when a single image is selected.

Tags in the bottom panel are organized into a categorized tree:

• Global tags — applied to the patient and study levels.
• Series level — applied to the series level.
• Image level — applied to the individual image level.

Edit the Images

The Photo Editor offers basic tools to crop, rotate, and adjust contrast on an imported image. You can also add annotations to highlight specific areas, and use measurement tools to indicate distances, angles, or areas. The image can be calibrated against a known distance so that the measurements reflect real-world dimensions.

Publish DICOM Files

Click Publish to send the DICOM files to a remote DICOM archive, or Export locally to save them on the local file system. The Publication panel offers:

• Selection — choose which DICOM items to publish (everything selected by default).
• Resolution — downscale high-resolution images before sending.
• Destination — pick the target node from the list of configured remote DICOM nodes.
• Calling AE Title — pick the calling node, if your archive enforces specific sender AE titles.

Integrating the Dicomizer

This section is intended for administrators integrating the Dicomizer into a clinical workflow. It covers launching the Dicomizer from a web context and — most importantly — populating the DICOM metadata automatically so that operators do not have to enter it manually.

Launch from a Web Context

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

Try launching the Weasis Dicomizer Launch with the following parameters:

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

Automatically Fill in the Metadata

Instead of being entered by hand in the Album panel, the Global tags (patient and study levels) can be populated automatically:

• From a DICOM Worklist — configured with the preference items starting with weasis.acquire.wkl. Example of 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"

• Via the acquire:patient command — pass a DICOM-style XML payload, for example:

  <?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>

Publication Destination

When the Dicomizer destination is fixed in the preferences (items starting with weasis.acquire.dest), the destination is no longer selectable in the Publication panel — DICOM files are sent directly to the configured node.