HAS-Motion Software Documentation

User Tools

Site Tools

You are here: Main Page » other » dsx » locate3d » Locate3D Overview
other:dsx:locate3d:locate3d_overview

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision		Previous revision
other:dsx:locate3d:locate3d_overview [2024/07/12 13:55] – created sgrangerother:dsx:locate3d:locate3d_overview [2025/05/05 14:11] (current) – Cleaned up page and added links. wikisysop
Line 1: Line 1:
-====== Locate3D_Overview ======+====== Locate3D Overview ====== 
 + 
 +Locate3D is part of the [[other:dsx:dsx_overview|DSX Suite]] of applications for dynamic stereo x-ray (DSX).
  
 Locate3D tracks radiopaque beads in X-ray trials. It is most often used to track objects (e.g., bones and implants) with implanted beads. If the object contains three or more beads in fixed locations, and these 3D locations are known relative to the [[Other:DSX:DSX_Definitions#Coordinate_systems|object's CT coordinate system]], then the beads' 2D locations in the X-ray images can be used to calculate the object's 3D pose in the [[Other:DSX:DSX_Definitions#Coordinate_systems|X-ray lab frame]]. Locate3D is thus similar to X4D, except that it uses multiple beads to determine the pose of an object, instead of the contours of the object itself. Locate3D requires that the configuration of the X-ray equipment has been calculated (with [[Other:DSX:CalibrateDSX:CalibrateDSX_Overview|CalibrateDSX]]), and that the locations of the beads in the object's local frame have been determined (with [[Other:DSX:Surface3D:Surface3D_Overview|Surface3D]]). Locate3D tracks radiopaque beads in X-ray trials. It is most often used to track objects (e.g., bones and implants) with implanted beads. If the object contains three or more beads in fixed locations, and these 3D locations are known relative to the [[Other:DSX:DSX_Definitions#Coordinate_systems|object's CT coordinate system]], then the beads' 2D locations in the X-ray images can be used to calculate the object's 3D pose in the [[Other:DSX:DSX_Definitions#Coordinate_systems|X-ray lab frame]]. Locate3D is thus similar to X4D, except that it uses multiple beads to determine the pose of an object, instead of the contours of the object itself. Locate3D requires that the configuration of the X-ray equipment has been calculated (with [[Other:DSX:CalibrateDSX:CalibrateDSX_Overview|CalibrateDSX]]), and that the locations of the beads in the object's local frame have been determined (with [[Other:DSX:Surface3D:Surface3D_Overview|Surface3D]]).
  
-{{L3D_Full.png}}+{{:L3D_Full.png?800}}
  
-==== Tutorials ====+===== Tutorials =====
  
-== How To: Digitize Points of Interest ==+Follow these tutorials to learn how to use Locate3D as part of the DSX Suite: 
 +  - [[other:dsx:locate3d:digitize_points_of_interet|How To: Digitize Points of Interest]] 
 +  - [[other:dsx:locate3d:tutorials:track_objects_using_points_of_interest|How To: Track Objects Using Points of Interest]]
  
-== How To: Track Objects Using Points of Interest ==+===== Menus =====
  
-==== Menus ====+==== File Menu ====
  
-== File Menu == +{{:L3D_FileMenu.png}}
- +
-{{L3D_FileMenu.png}}+
  
   * **Open Subject... (Ctrl + O)** This command loads a subject file.   * **Open Subject... (Ctrl + O)** This command loads a subject file.
Line 43: Line 45:
  
  
-== View Menu ==+==== View Menu ====
  
-{{L3D_ViewMenu.png}}+{{:L3D_ViewMenu.png}}
  
   * **Show All POIs (Ctrl + A)** toggles the display of all of the POIs for all objects in the current trial.   * **Show All POIs (Ctrl + A)** toggles the display of all of the POIs for all objects in the current trial.
Line 62: Line 64:
  
  
-== Tools Menu ==+==== Tools Menu ====
  
-{{L3D_ToolsMenu.png}}+{{:L3D_ToolsMenu.png}}
  
   * **Propagate POIs (Ctrl + P)** This command propagates all POIs in the current object through all of the frames selected in the //Propagate Range// slider. For each POI, Locate3D fits a GCV spline to the poses in that POI's pose map (as shown in the //POI Graphs// widget). For each reporting time in the range, if the POI does not already have a pose at that time, Locate3D interpolates the X, Y, and Z splines to calculate the expected location of the POI in each X-ray view. A region of the X-ray image around this point is then searched for a suitable location of the POI center. The size of this region is determined by the //Propagation Search Factor// parameter. If the POI moves a lot from frame to frame and this movement is not adequately predicted by the splines, you make need to increase the //Propagation Search Factor//. However, if this parameter is too large, or if several POIs are close to each other, Locate3D may misidentify POIs during propagation.   * **Propagate POIs (Ctrl + P)** This command propagates all POIs in the current object through all of the frames selected in the //Propagate Range// slider. For each POI, Locate3D fits a GCV spline to the poses in that POI's pose map (as shown in the //POI Graphs// widget). For each reporting time in the range, if the POI does not already have a pose at that time, Locate3D interpolates the X, Y, and Z splines to calculate the expected location of the POI in each X-ray view. A region of the X-ray image around this point is then searched for a suitable location of the POI center. The size of this region is determined by the //Propagation Search Factor// parameter. If the POI moves a lot from frame to frame and this movement is not adequately predicted by the splines, you make need to increase the //Propagation Search Factor//. However, if this parameter is too large, or if several POIs are close to each other, Locate3D may misidentify POIs during propagation.
Line 73: Line 75:
  
  
-== Options Menu ==+==== Options Menu ====
  
-{{L3D_OptionsMenu.png}}+{{:L3D_OptionsMenu.png}}
  
   * **Settings** opens the Settings dialog   * **Settings** opens the Settings dialog
  
  
-== Help Menu ==+==== Help Menu ====
  
-{{L3D_HelpMenu.png}}+{{:L3D_HelpMenu.png}}
  
   * **Help (F1)** opens the Locate3D wiki page in the default browser.   * **Help (F1)** opens the Locate3D wiki page in the default browser.
Line 89: Line 91:
  
  
-==== Widgets ==== +===== Widgets =====
- +
-== DSX Configuration == +
- +
-== Points of Interest == +
- +
-== POI Parameters == +
- +
-== POI Graphs == +
- +
-== X-ray Windows == +
- +
-== Settings == +
  
 +Locate3D contains 6 different widgets, which are each documented on their dedicated pages:
 +  - [[other:dsx:locate3d:dsx_configuration|DSX Configuration]]
 +  - [[other:dsx:locate3d:points_of_interest|Points of Interest]]
 +  - [[other:dsx:locate3d:poi_parameters|POI Parameters]]
 +  - [[other:dsx:locate3d:poi_graphs|POI Graphs]]
 +  - [[other:dsx:locate3d:x-ray_windows|X-Ray Windows]]
 +  - [[other:dsx:locate3d:locate3d_settings|Settings]]
  
other/dsx/locate3d/locate3d_overview.1720792536.txt.gz · Last modified: 2024/07/12 13:55 by sgranger