Addis Ortho DICOM Viewer

User manual

Version 1.0: the Viewer, Viewer 4GB and Viewer Lite editions. Last updated 15 November 2026. The same manual is inside the program, under Help, User’s Manual.

Read this first. Addis Ortho DICOM Viewer is for image review and surgical planning support. It is not a certified medical device and does not make clinical decisions. Plans, stitched films and 3D bones are drafts: the surgeon checks every one against the patient and the original images.

1. Before you start

Addis Ortho DICOM Viewer opens X-ray, CT, MRI and other DICOM images, and adds orthopaedic tools: X-ray templating, long-leg stitching, 3D bone views, and sending and exporting studies.

EditionWhat it hasFor
Addis Ortho Viewer (Full)Everything in this manualNormal PCs and Macs
Addis Ortho Viewer 4GBEvery feature, with a smaller memory budget (1 GB heap, smaller 3D texture, no smooth segment surfaces)PCs with 4 GB of RAM
Addis Ortho Viewer Lite2D viewing of X-ray and CT, measurements, annotations, DICOM CD loading, image export. No 3D, templating, stitching, receiver, send or query/retrieve, CD burningSimple viewing on small PCs

Sections 7 to 10 and 12 apply to the Full and 4GB editions only. The Lite edition is English only.

2. Install

ComputerFile
Windows PCAddis-Ortho-Viewer-1.0-x86-64.msi
Mac with Intel chipAddis-Ortho-Viewer-1.0-x86-64-unsigned.pkg
Mac with Apple chip (M1 and later)Addis-Ortho-Viewer-1.0-aarch64-unsigned.pkg

The 4GB and Lite editions have the same three files with 4GB or Lite in the name. Installing a new version replaces the old one on that computer.

On a Mac the package is not signed yet, so macOS asks you to approve it: right-click the file and choose Open, or allow it in System Settings, Privacy and Security. Each file has a .sha256 file next to it; compare it with the downloaded file if you want to be sure the download is complete.

3. Open images

  • Studies home. The start screen lists the studies in the library. Open one to see its series. Use the Addis Ortho mark at the top of the toolbar to come back to Studies from any screen.
  • Drag and drop. Drop DICOM files or a folder on the window.
  • A CD or DVD. Choose the disc or its DICOMDIR file. Discs from other systems are read the same way.
  • Several images at once. Open the study, then drag a series into a viewing area.

The two places: Studies and Review

The rail at the left edge of the window has the Addis Ortho mark and two places.

PlaceWhat it is forWhat you see
StudiesFind, import, receive, export and send studies.A light page: the search box, the list of studies (patient, MRN, study date, study, modality, images, where), and the selected study with Open study, Export and Send. Open CD, Import, Receive and More are at the top right.
ReviewLook at the images and work on them.The dark workspace: the toolbar along the top, the explorer with the series of the open patient on the left, the image in the middle, and the tool panels (Display, Image Tools, Draw and Measure, and Bones for a CT) on the right. A green strip above the image names the open patient and study.

Opening a study takes you to Review. The Studies button on the rail, or the Addis Ortho mark, takes you back; the viewer keeps its layout while you are away. The surround of the image stays neutral black and grey on purpose, so that no colour tints how an image looks.

The Review toolbar

ButtonWhat it does
Import, CDOpen files or a folder; open a disc.
Export, CaptureExport the study or its images; save or copy the picture on screen.
Left (and the other mouse buttons)Choose which tool each mouse button holds.
Layout, Sync, ResetSplit the viewing area; link scrolling and zoom between views; return the view to how it opened.
Measure, Draw, DeleteMeasuring tools, drawing tools, and removing what is selected (section 5).
Quick template, Full templateX-ray templating (section 9).
StitchLong-leg stitching (section 10).
Zoom, MagnifierZoom the view; a lens that follows the pointer.
መለያዎችThe DICOM tags of the image.
W/L, LUT, InvertWindow and level presets, colour tables, and inverted grey.
MPR, MIP, 3DFor a CT or MRI series: the three planes, a thick projection, and the 3D view (section 7).

The Lite edition has no Quick template, Full template, Stitch or 3D button.

4. Look at images

  • Scroll through a series with the mouse wheel, Up እና Down, or B and drag. Page Up እና Page Down move 10 images. Space plays the series as a cine.
  • Brightness and contrast (W/L). Press W and drag. 0 returns to the default; CT windows are on the number keys (2 Abdomen, 4 Bone, 5 Brain, 6 Mediastinum, 7 Lung, 8 MIP).
  • Zoom and move. Z zoom, M pan, Ctrl+0 fit, Ctrl+1 actual size.
  • Rotate and flip. Ctrl+[ እና Ctrl+] turn 90 degrees; Ctrl+Shift+[ እና ] flip. Ctrl+Shift+\ resets the view.
  • Invert is F11, full screen is Fእና F12 shows or hides the annotations.

On a Mac, Cmd works wherever this manual says Ctrl. F11 እና F12 need the Fn key, and macOS may use F11 for Show Desktop until you change it.

5. Measure and mark

Choose a tool from the toolbar or press its key, then draw on the image. Esc deselects or stops the tool, and ሰርዝ removes what is selected.

KeyToolKeyTool
LLengthEEllipse
AAngleGClosed polygon
CCobb angleOOpen polygon
TAnnotation (text)

Lengths are only as good as the image’s pixel spacing. If an image has no scale, or the scale comes from the detector rather than the patient, check a known object (a calibration marker) before you rely on a number.

Saved marks

Press Ctrl+S to save the marks you drew with the study, and D to show or hide them. Each save is kept as a new version of the marks; nothing is written over. Export and Send carry only the newest saved marks of each image, so a mark you deleted later does not travel in an older version. The older versions stay in the tree and can be ticked by hand.

6. Keys

One set of keys works in the 2D viewer, the 3D view and both templating pages (Full and Quick). A dash means the tool is not there. On a Mac, Cmd works wherever this list says Ctrl.

KeyAction2D viewer3D viewFull pageQuick page
WW/L (window and level: brightness and contrast)yesyesyesyes
MPanyesyesyesyes
ZZoomyesyesyesyes
BScroll through a seriesyes–––
LLengthyesyesyesyes
AAngleyes–yes–
CCobb angleyes––copy to the other side
EEllipseyes–––
GClosed polygonyes–––
OOpen polygonyes–––
TAnnotation (text)yesroll tool––
0Default W/L (1 in the viewer: full dynamic)yesyesyesyes
FFull screenyesyesyesyes
F11Invertyesyesyesyes
F12Annotations (reference lines on the Full page)yesyesyes–
Ctrl+0Fityesyesyesyes
Ctrl+1Actual sizeyes–yesyes
Ctrl እና + or -Zoom in and outyesyesyesyes
Ctrl+arrowsMove the imageyesyes–yes
Ctrl+[ እና Ctrl+]Rotate 90 degreesyes–––
Ctrl+Shift+[ እና ]Flip horizontal, flip verticalyes–––
Ctrl+Shift+\Reset the viewyesyesyesyes
EscDeselect, or stop what is armedyesyesyesyes
ሰርዝDelete what is selectedyescuts the scalpel areayesyes
Ctrl+ZUndo–yesyesyes
Ctrl+EExport the viewyesyes––
Ctrl+PPrintyes–––
Ctrl+SSave the marks with the studyyes–––
DShow or hide the marksyes–––
Up እና DownPrevious and next imageyesturnsizesize
Page Up እና Page Down10 images back and forwardyes–sizesize
Left እና RightPrevious and next seriesyesturn––
ዋና ገፅ እና EndFirst and last seriesyes–––
SpaceCineyes–––

More keys in the 2D viewer

  • CT windows on the number keys: 2 Abdomen, 4 Bone, 5 Brain, 6 Mediastinum, 7 Lung, 8 MIP. A film with a second DICOM window uses 2 for that window.
  • Moving between studies: Alt+Left እና Right change the study, Alt+Up እና Down the patient, and Shift+ዋና ገፅ እና End go to the first and last image.
  • Other tools: R rotate, H crosshair, K key object, Q the context menu.
  • ሰርዝ እና Esc work once a Measure or Draw tool has been chosen on a mouse button.

More keys on the templating pages

On both pages: Up እና Down or Page Up እና Page Down change the size, Shift+arrows move 0.5 mm (with Alt too, 2 mm), comma and full stop turn 0.5 degrees (with Shift, 2 degrees), and N is the next implant. The Quick page adds I add an implant, Shift+R እና Shift+L the side, C copy to the other side, X flip the film, V valgus, S sizes, Alt+1, 2, 3 the knee views, / the image command box, and ? the list of keys. Rotating or flipping the film has no key on the Full page on purpose: the page holds the plan’s side and orientation.

On a Mac

F11 እና F12 need the Fn key, and macOS may keep F11 for Show Desktop until you change it in System Settings. Ctrl+arrows belong to macOS, so use Cmd+arrows.

See and change the keys

Help, Keyboard Shortcuts opens a page with every key as it is set on this computer; a key you changed is shown filled. To change a key, open Preferences, General, Keyboard Shortcuts. A key you have changed stays as you set it when the viewer is updated.

7. 3D view (Full and 4GB)

Open a CT and choose the 3D view. A CT opens as isolated bone: the table, pad, plaster cast and soft tissue are removed, and the cut can be undone with Ctrl+Z. Low-density (osteopenic) bone is kept, and the AO Bone preset draws it filled and lighter.

Move and cut

  • Rotate, roll (T), pan (M), zoom (Z), window/level (W) and length (L) are mouse tools. The keys 1 to 6 give the six standard orientations; Ctrl+0 fits and Ctrl+R resets the scene.
  • Scalpel (S, or hold Alt and drag): draw a closed area, then ሰርዝ cuts what is inside and Enter what is outside, through the whole depth. Ctrl+Z እና Ctrl+Y undo and redo; Ctrl+Alt+0 restores the whole volume.
  • Keep only this እና Remove this pick the structure under a click.
  • A crop box limits the volume; Isolate bone in the crop panel runs the isolation again on request.

Every cut and crop can be undone with Ctrl+Z. Saving the 3D picture to the study and copying it are in the 3D toolbar; the picture carries the Addis Ortho footer unless you turn it off in Preferences, General.

To find, name, hide or separate individual bones, see section 8, Segmentation of bones.

8. Segmentation of bones (Full and 4GB)

Segmentation divides a CT into separate bones, so that each bone has its own colour and name and can be hidden, shown alone, joined to another, split, or exported. It works in the 3D view and from clicks on MPR and 2D slices. It is on the Bones panel beside the 3D view.

8.1 What a segmentation is

  • Each bone is one segment. The segments are saved with the study as a DICOM segmentation (SEG) series, with the name and colour of each bone, so they come back when you reopen the study.
  • Hiding, showing and selecting a bone change only how it is drawn. They do not cut the CT or rewrite the segmentation.
  • The segmentation is written in the background only when voxels, names or colours change.
  • It is a draft made by the program from brightness. It is not reviewed and is not a measurement.

8.2 Find the bones

  1. Open the CT in the 3D view. It opens as the isolated bone (section 7).
  2. In the Bones panel press Find the bones (it reads Show the bones once they have been found). The bones are found all at once and each gets a colour; neighbouring bones do not share a colour.
  3. The 3D view shows the bones in colour: the CT itself, only inside the visible bones, tinted with each bone’s colour.

How it decides (so you can judge the result):

  • Bone is voxels at about 200 HU or more, with the marrow filled in; dense bone is 300 HU or more.
  • Two parts are kept apart only where the neck between them is narrow, compared with the thinner part. A neck deeper than that is treated as one bone.
  • Pieces under 1 cm3 join the bone they touch most, or the bone within 10 mm of them.
  • Small joints. The joint lines of the wrist, foot and fingers are narrower than the scanner can show and can read as bright as bone. The program opens these joint lines first, so carpal, tarsal and finger bones separate. The joint line goes to one bone or the other; no voxel is lost.
  • A very large CT is worked on a coarser grid, and a CT with thick slices keeps its slices when the grid is made coarser.

8.3 Select bones

  • Click a bone in 3D, on an MPR or on a plain 2D slice, or click its name in the list. The click on a slice uses that slice’s own position, as the cross-hair does.
  • Shift, Ctrl or Cmd adds another bone to the selection.
  • The selected bone is drawn highlighted; hidden bones are drawn hidden.

8.4 Work on the selection

ButtonWhat it does
HideHides the selected bones.
Show onlyShows the selected bones and hides all the others.
Show allShows every bone again.
JoinMakes the selected bones one bone, for example a fragment that belongs to its bone.
SplitSeparates one bone into two. See 8.5.
NameNames the bone (region, bone and side). The name is saved with the study and used when you export.
ሰርዝRemoves the selected bones from the segmentation.

Natural look (a switch in the Bones panel) draws the bones as the CT shows bone, with hidden bones still hidden. Untick it for the colours.

8.5 Separate two bones (Split)

  1. Choose Split.
  2. Click once in each of the two parts, on one bone. You can click in 3D or on a slice, and the cut can be drawn up to 12 mm into each bone.
  3. The program grows both parts from your clicks, brightest first, so the cut follows the darkest surface between them: the fracture line or the joint space, even where the parts press together over a wide face.
  4. A result that would leave either bone under 30 % of its own size is refused and the bones stay as they were.

8.6 More tools

  • New bone grows a bone from a point you click, with a region, bone and side picker for the name, and grow settings.
  • Erase piece removes a loose piece from a bone.
  • Keep only this and Remove this (section 7) are still in the 3D mouse button menus.

8.7 Undo

Every bone step is one step of the 3D view’s history. Ctrl+Z walks back through bone steps, cuts and crops together, and Ctrl+Y goes forward.

8.8 Export a bone

Bone STL exports one bone as a binary STL file, in millimetres, in DICOM patient (LPS) coordinates, for 3D printing or planning software. The file holds the shape only. Keep the file name free of the patient’s name if it will leave the hospital.

8.9 Make 3D bones (where installed)

Where the clinic’s TotalSegmentator pipeline is installed, Make 3D bones runs it on the CT (hip, shoulder and spine) and opens the results in the study. It is a separate program and is not part of the installer.

8.10 What it does not do well

  • The program judges a joint from brightness alone, so a growth plate or a fracture line can look like a joint, and a bone can be split there or two bones left joined.
  • On a CT with thick slices and a soft kernel the bones can still be found in too many pieces. Use Join.
  • Small bones under 1 cm3 next to a larger one can be listed as a fragment of it.
  • A fragment displaced more than 4 mm, or a child’s ossification centre, can be lost in the bone isolation. Undo, or choose Whole volume, brings it back.
  • Plaster casts, contrast and children’s CTs have not been checked.
  • Read density on the slices, not on the 3D picture. Check every bone’s name and outline against the slices before you use it.

9. X-ray templating (Full and 4GB)

  1. Open the X-ray (CR, DX, DR or RG) and press Template in the 2D toolbar. The templating page opens with that image. It works on this computer only and needs no internet.
  2. Set the scale and the side, then choose the implant family, the size and the position. Use the keys in section 6 to size, move and turn the outline.
  3. For a knee, choose the knee type and the sizes; the page suggests sizes and keeps the choices you made by hand.
  4. Save. The plan picture comes back into the X-ray’s study.

The saved picture says “Templated with Addis Ortho Viewer” at the foot of its report column. The page has a switch to leave the patient’s name out of the picture and the file name; use it before anything leaves the hospital. Saved plans are kept in the study library.

A template is a planning aid. The plan is a draft: the surgeon decides the implant and the size.

10. Long-leg stitching (Full and 4GB)

Join two to four overlapping films of one acquisition into one long film.

  1. Select a piece of the study and press Stitch. Tick the two to four CR, DX, DR or RG pieces of one acquisition. Each row shows a small picture; click a row to see it large.
  2. Put the pieces in order, head to foot.
  3. Confirm the acquisition, the projection, the position and the target leg. For a film of both legs, choose whether to match on the whole width or on the left or right half. None of these has a default; you must choose.
  4. Press Line up. Each seam comes out as “check” or “failed”. No seam is ever reported as good.
  5. Press Inspect seam to see the overlap as a checkerboard or a difference. Arrow keys nudge 0.1 mm (Shift 1 mm); [ እና ] turn 0.1 degree. You can pick matching points by hand, or press Automatic match again. A failed seam stays failed when it is only nudged. A seam moved by hand more than 2 mm or 0.3 degrees from the match fails until you refine or match it again.
  6. Press Save to the study. The stitched film is saved as a new series labelled “Long leg stitched (draft, …, not reviewed)”, with seam marks at the edges. It carries a scale only if all pieces had the same scale.

A saved stitch is kept as a project. Edit stitch reopens it, checks every seam again, and saves an edit as a new version; no earlier version or picture is overwritten. Reopening needs every piece open and unchanged.

Check the stitched film’s seams and length against the patient before you measure on it. If every seam is refused, the film can still be saved as unverified, and it says so.

11. Export, send, disc

  • Export a picture. Ctrl+E saves or copies the view. Pictures from the screenshot dialog and 3D pictures carry a thin Addis Ortho footer strip, which you can turn off in Preferences, General.
  • Export or Send a study. Whole studies are ticked by default. Older versions of saved marks are left unticked.
  • Folder and file names. Exports go to a folder named after the patient’s full name. If the folders may leave the hospital, turn the patient name off in the export options first.
  • CD or DVD. The Full edition can burn a disc that opens on any computer. The Lite edition cannot burn a disc but can read one.

12. Receive from a machine (Full and 4GB)

An X-ray machine can send images straight to the viewer over the hospital network. This is off by default, and it is not encrypted: use it only on the hospital’s own network.

  1. Open File, Preferences, Receive from modality.
  2. Note the AE title (default AOVIEWER) and the port (default 11112).
  3. Add the machine to Allowed senders with its own AE title and IP address. With the list empty, every device is refused. Give the machine a fixed IP address.
  4. Switch Receive images on.
  5. On the machine, enter this computer’s IP address, the AE title and the port as a DICOM destination, then press its test connection.

When images arrive a notice shows “N images received” with a Show button; they never open on their own or change the patient you are looking at. Images are stored in AddisOrthoReceived in the home folder. Nothing is deleted automatically, so watch the disk; the Preferences page shows the folder size and lets you Show, Open folder or Delete a study. A refused device shows a notice with the AE title and address it used. On Windows, allow the program through the firewall on private networks when asked.

13. Saved pictures and the patient’s name

The viewer shows and saves the patient’s name and record number where the clinician needs them: for example a templating picture is named by patient name, record number and side, and stored in the patient’s study. Anything you send outside the hospital should leave the name out: use the “leave out the name” options in templating and export.

14. Problems

You seeTry
3D does not start, or says software 3D is missingUpdate the graphics driver. The 4GB edition uses a smaller 3D texture and no smooth segment surfaces; it is slower but complete.
A bone is in too many pieces, or two bones are joinedUse Join and Split (section 8), then read density on the slices.
Stitch says a seam failedCheck the order and the target leg, open Inspect seam, nudge or pick matching points, then Automatic match again.
The machine’s images are refusedCheck Allowed senders (AE title and IP address, both exact), the port, the firewall, and that Receive images is on.
A key does nothing on a MacUse Cmd in place of Ctrl; F11 እና F12 need Fn.
The installer is blocked on a MacThe package is unsigned: right-click and choose Open, or allow it in Privacy and Security.

15. Help and support

The Help menu has User’s Manual (this manual, kept inside the program, so it opens without the internet), Keyboard Shortcuts, Online Help, Download page, and Support (Telegram) where it is set up. Online Help opens the documentation of Weasis, the open-source viewer this program is built on; where the two differ, this manual is the one that describes Addis Ortho DICOM Viewer. The download page for all editions is https://addisortho.com/viewer. The licence and third-party notices are in the installer and under Help, About.

16. Technical reference

16.1 What the program is

  • Addis Ortho DICOM Viewer 1.0 is built on Weasis 4.7.3, with Addis Ortho’s own modules for templating, long-leg stitching, bones, the studies home and the receiver.
  • The installer carries its own Java runtime. Nothing else has to be installed.
  • It works without the internet. The templating pages run on this computer only.

16.2 Memory

EditionMemory the program may use
FullUp to half of the computer’s RAM on Windows, and up to a quarter on a Mac.
4GBA fixed 1 GB, with a 256 MB image cache and a smaller 3D texture.

16.3 Where things are kept

WhatWhere
Settings, the program’s cache and its logsThe folder .weasis in your home folder. Logs are in .weasis/log, and preferences in .weasis/preferences.
Images received from a machineAddisOrthoReceived in your home folder (section 12).
Saved marks, templating plans and stitch versionsWith the study in the study library. Stitch versions are named by the study’s identifiers, never by the patient’s name.

When you ask for support, send the newest file from .weasis/log. Look through it first: remove anything that names a patient before it leaves the hospital.

16.4 The network

  • The program listens on the network only while Receive images is switched on: AE title AOVIEWER, port 11112 unless you changed them, and only for the devices in Allowed senders.
  • DICOM receive and send are not encrypted. Use them on the hospital’s own network.

16.5 The look

  • The theme is the Addis Ortho dark theme: near-black surfaces, selections in the brand green #034537እና #A8FF30 only for small accents such as the selected place on the rail and the accent of a toolbar icon.
  • Buttons, menus and toolbars use the Addis Ortho interface font, which is bundled with the program. The Studies page uses it throughout, with Latin and Ethiopic letters in one font. In Review, names and values that come from the images use the computer’s own font, so that a name in any script is drawn.
  • The Studies page is light; the Review workspace is dark, with a neutral surround for the image.

16.6 Limits to keep in mind

  • Not a certified medical device. Plans, stitched films and 3D bones are drafts for the surgeon to check.
  • A length is only as good as the image’s scale (section 5).
  • The Mac packages are not signed yet (section 2).
  • Bone segmentation has not been checked on plaster casts, contrast studies or children’s CTs (section 8.10).

16.7 Changes to this manual

DateChange
15 Nov 2026Studies and Review described; the full list of keys; the technical reference; the manual is inside the program under Help, User’s Manual.
14 Nov 2026First edition for version 1.0; segmentation of bones given its own section.