DSX Overview

From Visual3D Wiki Documentation
Jump to: navigation, search
Language:  English  • français • italiano • português • español 

The DSX Suite

NOTE: This application suite is currently in development and is not available for purchase or evaluation.

The DSX suite of applications tracks 3D objects (bones, implants, etc.) in x-ray images by generating digitally reconstructed radiographs (DRRs) of the objects and matching them to the x-ray images. It calculates the 3D x-ray configuration parameters of the x-ray hardware and distortion-corrects the x-ray images. Tools for analyzing the tracking results are in Visual3D.

There are seven applications in the DSX suite:

XManager is the central program that lets you manage a subject and all of the system configurations, trials, and data files associated with it. It has push buttons for launching six of the data processing programs.

CalibrateDSX calculates the 3D configuration of the x-ray hardware (the pose of the x-ray sources and image planes) from images of the calibration object. It also uniformity-corrects, distortion-corrects, and resizes all x-ray image files.

Surface3D creates tracking bones (RAW files or stacked TIFFs) and surface models (OBJs) from CT and MRI data.

Orient3D works with the surface models created with Surface3D or another 3rd party application (e.g., Mimics). It allows you to define anatomically meaningful reference frames, add landmarks, and define regions of interest, which are used to calculate distance maps.

Locate3D tracks beads in x-ray trials.

X4D tracks bones in x-ray trials, using single-frame or 4D optimization.

PlanDSX can be used to design x-ray configurations when planning a new study.

Visual3D is not a part of the DSX suite of applications but can be used for viewing the kinematic analysis results including: joint animations, distance maps, and ligament lengths. It is also used for defining the kinematic models used to process the motion capture data.


There are instructions for using each of the application that are accessible via the application overview page which can be accessed using the links above or in the side bar. There are also general instruction available which are listed below:

File Types

Subject File

All applications in the DSX suite use a single text file (*.xml) for holding all of the information about one subject (including multiple sessions). This subject file contains information about the subject, x-ray configurations, and links to all of the data files (raw and processed) and results files. Each application loads a subject file to import the information it needs, and updates it with the results of the analyses performed.

Temporary Subject File

All applications in the DSX suite maintain a temporary subject file. This file is always kept up-to-date and can be used in case of a crash. When the user loads a subject file, each application checks whether a temporary version of the file exists and if so, asks the user which of the two files to load. Each application has a file menu which allows for saving the currently loaded subject to the existing file or to a new file. When an application is closed, it checks whether the temporary subject file has changed since the last save, and if so asks the user to save or discard these changes.

Program Parts

Dock Widgets

To enable some flexibility in the DSX graphical interface, most of the applications have widgets that are dockable. These widgets can be made visible through the View menu. They can be dragged across the entire screen as a normal dialog window and also docked in some predefined locations (sides, top, or bottom) in the main window.


Each DSX application has its own app-specific parameters that are displayed and can be edited in a dockable parameter widget. The parameter values are stored in the subject file.


The DSX applications are not installed separately (except Visual3D), but rather are installed as components of the DSX Suite. The instructions for installing the suite of applications can be found on the DSX Suite Installation Page. The suite requires an activation code in order to be used.

Retrieved from ""