xManager Overview

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

xManager is the graphical interface to a subject file, which contains all of the information about one DSX subject, including links to all of the data files. After you collect DSX data for a subject, you use xManager to create a new subject file, enter information about the data collection session, and specify paths to the X-ray, CT, and motion capture files. Then the other applications in the DSX Suite read various portions of the file and add additional information to it. For example, CalibrateDSX reads the names of the raw X-ray files from the subject file, corrects the X-ray images, and adds the names of the corrected files to the subject file. X4D can then use the subject file to read the corrected X-rays, track bones in the images, and add the bone pose files to the subject file.

xManager.png

Tutorials

How To: Create a Subject

Menus

     File Menu
     xManLoadSubject.png
The Load Subject command loads a subject file.
This command can also be accessed with the Ctrl + O shortcut.
     xManNewSubject.png
Creates a new, empty subject.
This command can also be accessed with the Ctrl + N shortcut.
     xManSaveSubject.png
The Save Subject command saves the currently loaded subject to its existing subject file.
This command can also be accessed with the Ctrl + S shortcut.
     xManSaveSubjectAs.png
The Save Subject As command saves the currently loaded subject to a new subject file.
     xManShowSettings.png
The Show Settings command opens a dialog with the paths to the executable files in the DSX Suite. If the executable file for any of these programs has been moved, the path can be updated using the browse button 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 xManager screen. Changes to the paths can be saved by clicking on the Done button at the bottom of the dialog.

DSX Settings.jpg

     xManExit.png
The Exit command exits the program and all unsaved data will be lost. The program can also be closed by using the X in the top right corner of the program window.
     Help Menu
     S3DHelpButton.png
The Help command opens the xManager wiki page in the default browser. The F1 shortcut can also be used.
     S3DAboutButton.png
The About option displays a dialog with information about xManager, including the installed version number. It also contains the Deactivate button, for deactivating your xManager license.

Applications

The applications in the DSX Suite can be launched by clicking on the application buttons at the bottom of the xManager window. Whenever one of the applications is launched from xManager it will automatically load the subject file that is open in xManager.

     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.

Subject Data

     Subjects

Subjects

Retrieved from ""