Hanging Protocols in OmegaAI
Overview
Hanging Protocols help you control how medical images are arranged and displayed in the OmegaAI Image Viewer. By defining layout, sequence, and display behavior based on modality and study attributes, they ensure images are consistently presented the way you need them — every time a study is opened.
OmegaAI automatically adjusts Hanging Protocol layouts based on your monitor setup. On a single monitor, viewports are displayed on one screen. On multiple monitors, the layout expands across available screens for an optimized viewing experience.
This guide covers how to:
- Access Hanging Protocols in the Image Viewer
- Use default and saved protocol configurations
- Create and customize protocols to fit your reading workflow
Hanging Protocol Matching Criteria
When a study is opened, OmegaAI automatically matches and applies the most appropriate Hanging Protocol based on the following study attributes:
- Modality — The imaging modality of the study (e.g., CT, MR, XR).
- Body Part — The body part(s) present in the study.
Note: If multiple protocols match the same criteria, the protocol set as default will be applied automatically.
Accessing Hanging Protocols
There are two ways to quickly access and apply Hanging Protocols directly from the OmegaAI Image Viewer.
Method 1: Quick Access Strip
The Quick Access Strip is a horizontal bar rendered immediately below the main toolbar, spanning the full width of the viewer window. It provides one-click access to all Hanging Protocols available for the active study, without opening any menus or panels.
Each item in the strip displays:
- A miniature layout preview of the protocol's viewport configuration
- The protocol name, truncated if necessary — hover to see the full name in a tooltip
- A stage indicator showing the current and total stages (e.g., 2/3), with up/down chevron arrows to navigate between stages — hover over the arrows to see Page Up / Page Down tooltips. Single-stage protocols display "1" with no arrows.
- A blue background and blue text when the protocol is active
To use the strip:
- Apply a protocol — Click any item to instantly apply it to the active study.
- Switch protocols — Click a different item at any time to switch layouts without reloading the study.
- Navigate stages — Use the up/down chevron arrows to step through multi-stage protocols.
- Scroll through protocols — If the list exceeds the toolbar width, use the chevron arrows (< >) to access additional protocols.
Note: If no protocol is active (e.g., a manual layout is in use), no item will appear highlighted. The strip is automatically filtered to show only protocols relevant to the active study's modality.
Method 2: Quick Access via Layout Panel
The Layout Panel provides a quick way to both select a viewport layout and apply or manage Hanging Protocols from within the viewer.
To open and use the panel:
-
Open the panel — Click the Change Layout (grid icon) in the top toolbar. A layout selector grid will appear.
-
Set a layout — Click the grid cells to define your preferred viewport layout — selected cells are highlighted in blue (e.g., selecting the top two cells sets a 1x2 layout).
-
Expand the panel — Click the Right Arrow (
>) to reveal available protocol tiles alongside the layout selector.
-
Apply a protocol — Click any protocol tile to instantly apply it to the active study.
-
Collapse the panel — Click the Left Arrow (
<) to return to the layout selector view only.
From the expanded panel, you can also:
- Click the + icon to create a new Hanging Protocol from scratch.
- Click the Save icon to save the current viewport layout as a new protocol.
Note: Protocol names are truncated in the panel — hover over a tile to see the full name. The currently active protocol is highlighted in blue.
Hanging Protocol Cycling Shortcuts
OmegaAI supports keyboard shortcuts for navigating between Hanging Protocols without interrupting the reading workflow.
Shortcuts
| Shortcut | Action |
|---|---|
Ctrl + Alt + N | Apply the next hanging protocol |
Ctrl + Alt + B | Apply the previous hanging protocol |
Ctrl + Alt + S | Apply the first (default) hanging protocol |
Behavior
- Cycle order — Protocols cycle in the same order as they appear in the UI, with wrap-around enabled at both ends.
- Instant application — The selected protocol is applied immediately, without requiring a study reload.
- Scoped list — Only protocols visible in the user's Hanging Protocol list for the current study are included in the cycling sequence.
- Index reset — The protocol index resets when a new study is loaded. If a custom layout is active, triggering a cycling shortcut resumes navigation from the last active protocol.
Stage Navigation in the Image Viewer
When working with multi-stage Hanging Protocols in the Image Viewer, use the following keyboard shortcuts to move between stages:
- Page Down — Move to the next stage
- Page Up — Move to the previous stage
Note: In a single-stage protocol, Page Up/Page Down will load the next or previous series instead of switching stages. Empty stages (stages with no matching images) are automatically skipped during navigation.
Hanging Protocol Configuration
The Hanging Protocol configuration screen is divided into two main areas:
- Left panel — Contains the Viewport Setup area where you design the layout, and the View Codes panel below it for assigning image orientations to viewports.
- Right panel — Displays the Saved Protocols and Default Hanging Protocols lists, along with options to manage them.
Accessing Hanging Protocol Configuration via Settings
To manage, edit, or create Hanging Protocols outside of the reading workflow, access them through the Settings menu.
To open the configuration screen:
|
|
Configuration Panel Options
The right panel displays all available protocols organized into two labeled sections — Saved Protocols and Default Hanging Protocols — both visible simultaneously and scrollable within the panel.
-
Saved Protocols — Protocols you or your organization have created and saved. Each protocol is displayed as a tile showing a miniature layout preview and its name.
-
Default Hanging Protocols — Pre-configured system protocols provided by OmegaAI, ready to use without any setup.
The panel also provides the following actions:
- + (Add New) — Click the + next to the panel title to create a new Hanging Protocol from scratch.
- Duplicate icon — Select an existing protocol tile and click the duplicate icon to create a copy. You can then modify and save it under a new name.
- Close (X) — Click to close the panel.
Note: Protocol names are truncated in the tile view — hover over a tile to see the full name.
Learn more about the Configuration Screen Layout
Default Hanging Protocols
Default Hanging Protocols are pre-configured layouts built into OmegaAI, ready to use without any setup. They provide a reliable starting point for new users and a consistent baseline for experienced readers across standard diagnostic workflows.
Default protocols can be duplicated and customized to match individual preferences or institutional requirements.
OmegaAI includes default protocols for the following modalities:
| Modality | Protocols |
|---|---|
| MG (Mammography) | 11 |
| XR (X-ray) | 7 |
| US (Ultrasound) | 2 |
| CT (Computed Tomography) | 7 |
| MR (Magnetic Resonance) | 5 |
Note: The list is automatically filtered to show only protocols relevant to the active study's modality.
Create a Hanging Protocol
Follow the steps below to create a new Hanging Protocol and define the desired image layout and display rules.
Step 1: Open the Configuration Screen
Access Hanging Protocol Configuration via Settings. Once open, click the + next to the panel title to start a new protocol.
Step 2: Select a Layout
-
Right-click inside the Viewport Setup area. An 8x8 layout selector grid will appear.
-
Click a cell to define the number and arrangement of viewports. Selected cells are highlighted in blue.
-
To further subdivide a viewport, right-click inside any selected viewport to define a nested layout within it.
-
Once confirmed, the grid closes and the selected viewports are rendered in the Viewport Setup area, ready for view codes to be assigned.
Note: Click the Reset Viewport icon in the top-right corner of the Viewport Setup area to reset the current viewport layout.
Learn more about Viewport Setup
Step 3: Assign View Codes
-
The View Codes panel below the Viewport Setup area displays available view codes and modifiers organized by modality. Use the search icon in the top-right corner to filter codes quickly.
-
Drag and drop a view code into an active viewport — a "+" indicator appears as you drag to confirm placement.
-
The assigned code defines which image orientation or series type will appear in that viewport.
Learn more about View Codes and Modifiers
Step 4: Configure Hanging Protocol Rules
-
Click a viewport to select it — a blue border indicates it is active. The Hanging Protocol Rules panel on the right will show "SELECTED: Viewport [n]".
-
Click the + button (tooltip: Viewport Configuration) to open a radial menu with the following options:
- Orientation — Flip, rotate, or align images
- Toggles — Enable or disable viewer features
- Scaling — Control image fit or zoom level
- Condition — Set DICOM-based matching rules
- Window Preset — Apply WL/WW values
-
Select a rule type to configure it for the selected viewport.
Learn more about Hanging Protocol Rules
Step 5: Select a Prior Matching Model
This setting controls which study (current or prior) is loaded into the selected viewport based on the assigned view code.
-
Click a viewport to select it — a blue border indicates it is active.
-
At the bottom center of the selected viewport, click the options bar to reveal two icons:
- Grid icon (left) — viewport layout options
- Document icon (right) — study matching options
-
Click the document icon to open the prior matching dropdown and select one of the following — Current is selected by default:
- Current — Loads the active study
- 1st Preceding Prior — The most recent prior matching the view code
- 2nd Preceding Prior — The prior before the 1st matching prior
- 3rd Preceding Prior — The prior before the 2nd matching prior
- Set Matching Model — Advanced prior selection based on criteria such as body part, modality, study date, or procedure code
Learn more about Prior Matching Model Configuration
Step 6: Add Additional Stages
-
A horizontal timeline bar at the bottom of the screen displays all stages, with each stage represented by a dot indicator.
-
Click the "+" circle on the left of the timeline to add a new stage.
-
Each stage can have its own layout and rules, supporting multi-step reading workflows.
-
To delete a stage, click its dot indicator on the timeline — a trash can icon will appear. Click and hold the icon to confirm deletion.
Learn more about Hanging Protocol Stages Management
Step 7: Save the Protocol
-
Click the Star icon to open the Save Protocol dialog.
-
Fill in the following fields:
- Protocol Name (required) — Enter a name for the protocol.
- Organizations (required) — Select one or more organizations this protocol belongs to.
- Modality (optional) — Select a modality from the dropdown.
- Procedure Code (optional) — Search and select a procedure code to narrow matching criteria.
- Body Part (optional) — Select a body part to refine matching.
- Laterality (optional) — Select a laterality (e.g., Right, Left).
- Level (optional) — Select the scope of the protocol (e.g., Site).
-
Enable Set as default for Modality Name if this protocol should apply automatically when matching criteria are met.
-
Click Save to store the protocol, or Cancel to discard.
Learn more about Managing Organizations in Hanging Protocols
For advanced configuration topics, see Mastering Hanging Protocols.