xManager Overview

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

xManager is the central DSX application that manages the subject information, data files and analysis parameters.

The application is launched with an empty workspace.

When a subject is loaded or created, the workspace contains all information related to a subject (including all sessions).

XManager Empty.jpg

     File Menu

XManager File Menu.jpg

Loads an existing subject XML file.
This option can also be accessed with the Alt+L shortcut.
When a subject file has been loaded or a new one has been created, xManager displays its contents in a tree in the left panel.
Selecting an item with a Right Mouse Click will display a pop-up menu appropriate to the currently selected item.
This menu enables the user to add or remove items.

DSX Add Session.jpg

Selecting an item with a Left Mouse Click will populate the right panel.

DSX Session.jpg

By selecting an item in the left-hand field the right hand field becomes populated.
Many of the objects have additional information that can be viewed by expanding other sections.
For example, in the example below there are four sections that can be expanded by selecting the check box next to their title; they are: File Data, Reference Frame, Landmarks, and Points of Interest.
Any changes made to the contents of the right-hand field will be saved in a temporary subject file until the changes are saved to a permanent file using either the Save Subject or Save Subject As option.


Creates a new, empty subject.
This option can also be accessed with the Alt+N shortcut.

DSX New Subject.jpg

With the subject ID selected, the subject information can be entered.

DSX John Doe.jpg

Selecting Sessions item with a right mouse click, provides an option to Add A Data Collection Session to the subject.

DSX Add Session.jpg

Data for the new session is added.

DSX New Session.jpg

DSX Session.jpg

CMO File Name refers to the Visual3D CMZ file that contains the Motion Capture Data collected synchronously with the X-ray data.
A new Object can be added.

DSX Add Object.jpg

Populate the New Object.

DSX Right Thigh.jpg

The options for the Type of Object are:

DSX Type Combo.jpg

File data refers to
the Folder Path containing the X-ray image sequences
The surface file associated with this object
The name of the Region of Interest surface.

DSX File Data.jpg

The locations of the beads in the reference object used by CalibrateDSX_Overview

DSX Reference Frame.jpg

The properties of Anatomical Landmarks defined relative to the object Orient3D_Overview

DSX Landmarks.jpg

Vertices used for describing regions of interest on the object.

DSX Points of Interest.jpg

DSX Add Configuration.jpg

Transformation Matrix from the Laboratory Reference Frame to the MoCap Reference Frame

DSX Configuration.jpg

The extrinsic parameters for the X-ray source and image intensifier.

DSX View1.jpg

Distances from source to X-ray

DSX Calibration.jpg

Trial collected for Uniformity of the X-ray image

DSX Uniformity.jpg

Trial collect for computing the Distortion of the X-ray image

DSX Distortion.jpg

Information related to the 3D Mocap Data

DSX 3D Trials.jpg

Saves the currently loaded subject to the existing XML file.
This option can also be accessed with the Alt+S shortcut.


Saves the currently loaded subject to a new XML file.
This option can also be accessed with the Alt+A shortcut.


Opens a dialog to change the paths to the DSX suite executables.
This option can also be accessed with the Alt+H shortcut.
Once the Show Settings control is used to Show Settings dialogue, shown on the left, will be opened.
It contains the Executable path for PlanDSX, Surface3D, Orient3D, CalibrateDSX, Locate3D and X4D.
If the executable file for any of these programs has been moved the executable path can be updated using the Browse buttons to the right of the file path.
If an executable path is incorrect you will not be able to open the associated program by clicking on the program button at the bottom of the screen.
Changes to the executable path can be saved by clicking on the Done button at the bottom right hand side of the screen.

DSX Settings.jpg

Exit the program.
This option can also be accessed with the Alt+E shortcut.
     Help Menu

DSX Help Menu.jpg

Opens the application's wiki documentation in the default browser.

DSX About XManager.jpg

The About dialog contains basic information about the particular application.
This includes the version number, the release date, the copyright details, the C-Motion support desk e-mail (support@c-motion.com), the version number for the C-Motion Library the application is developed with, and the licensing key.
Clicking the OK button or the x in the top right corner will close the About dialog.
The About dialog also has the Deactivate button which is used to deactivate the application.
This does not uninstall the application, however it does render it unusable by removing the license key.
This is useful if you want to move your program from one computer to another instead of purchasing another license key.
Please only use this button if you wish to completely deactivate the application on the computer you are working on.
You will be presented with a dialog confirming that you wish to deactivate.
Once the license key is deactivated you can use it on a different computer.

The Applications that belong to the DSX Suite can be accessed by clicking on the application buttons that are listed at the bottom of the DSX Manager screen.

Whenever one of the applications is opened from the DSX Manager it will be automatically loaded with the subject file that is open in the DSX Manager.

     CalibrateDSX calibrates the system.

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.

The primary purpose of the CalibrateDSX program is to correct the uniformity, correct any distortions, and resize the x-ray images. CalibrateDSX also allows the following functions:

  • Digitizing the beads in the calibration cube,
  • Calculating the 3D configuration parameters for each view, and
  • Calculating the transformation matrix between the x-ray frame defined by the calibration cube and the motion capture reference frame.

Note: The transform matrix between the x-ray frame and the motion capture reference frame is needed if you want to use motion capture data to seed the pose optimization in X4D.

     Surface3D creates tracking bones and surface models.

Surface3D creates tracking bones (RAW files or stacked TIFFs) and surface models (OBJs) from CT and MRI data. Surface3D (S3D) is used to create triangulated surface models from 3D image data using the Marching Cubes algorithm. Currently, Surface3D can only use CT data. Surface3D can also export CT data that has been cropped to an individual object of interest. This cropping is required to enable the creation of Digitally Reconstructed Radiographs (DRRs) for each individual object. This in turn enables the optimization of the 3D position and orientation for each object individually.

     Orient3D works with the surface models created
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.

Locate3D tracks beads in x-ray trials.

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

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.

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

Retrieved from ""