Differences

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

--- other:dsx:orient3d:tutorials:define_the_local_coordinate_system_of_an_object [2024/07/17 15:44] – created sgranger
+++ other:dsx:orient3d:tutorials:define_the_local_coordinate_system_of_an_object [2025/05/08 16:41] (current) – wikisysop
@@ Line 1: / Line 1: @@
 ====== Define the Local Coordinate System of an Object ======
-||
+This tutorial demonstrates how to define the [[Other:DSX:DSX_Definitions#Coordinate_systems|local coordinate system]] (LCS) of one of the objects in your subject file.
-To define [[Other:DSX:DSX_Definitions#Coordinate_systems|the local coordinate system (LCS)]] of one of the objects in your subject file, the object should already have a //surface file// specified for it. This file, whose vertices are expressed in the [[Other:DSX:DSX_Definitions#Coordinate_systems|object's CT reference frame]], was probably created by [[Other:DSX:Surface3D:Surface3D_Overview|Surface3D]] or a third-party application. Before tracking an object in [[Other:DSX:X4D:X4D_Overview|X4D]] or [[Other:DSX:Locate3D:Locate3D_Overview|Locate3D]], you should define an LCS for it because the tracking output for each X-ray frame is the transform from the [[Other:DSX:DSX_Definitions#Coordinate_systems|X-ray lab frame]] to the object's LCS.
+===== Before You Begin =====
-Follow these steps for defining an LCS:
+The object should already have a [[other:dsx:image_and_surface_files#surface_file|surface file]] specified for it. This file, whose vertices are expressed in the [[Other:DSX:DSX_Definitions#Coordinate_systems|object's CT reference frame]], was probably created by [[Other:DSX:Surface3D:Surface3D_Overview|Surface3D]] or a third-party application. Before tracking an object in [[Other:DSX:X4D:X4D_Overview|X4D]] or [[Other:DSX:Locate3D:Locate3D_Overview|Locate3D]], you should define an LCS for it because the tracking output for each X-ray frame is the transform from the [[Other:DSX:DSX_Definitions#Coordinate_systems|X-ray lab frame]] to the object's LCS.
+===== Defining a Local Coordinate System =====
+Begin by loading in the necessary files:
   - Load the subject file.
   - Choose the session and object.
   - Turn on the display of the global axes.
   - Turn on the display of the local axes.
-  - You'll see that the global and local axes are coincident (unless an LCS is already defined in the subject file). There are three ways to define the LCS:
-    - Manually: Ctrl-left-click on the local axes in the 3D view to display a trackball. Use the trackball to rotate and translate the local axes to the appropriate location. When you are done, use the menu option //LCS→Save to Subject Object// to save the LCS transform to the subject that is loaded in memory (it does not save the subject file).
+At this point you will see that the global and local axes are coincident (unless an LCS is already defined in the subject file). There are three ways to define the LCS: either manually, from the file, or algorithmically. Choose one of these methods for the purposes of this tutorial.
-    - From File: Select //LCS→Load from File...// and select the data file that contains the 4x4 transform from the global frame to the local frame. The LCS file must contain exactly 16 numbers, separated by commas or white space. The subject file loaded in memory will be automatically updated with the LCS.
-    - Algorithmically: Open the [[Other:DSX:Orient3D:Local_Coordinate_System|//Local Coordinate System//]] widget and click on the appropriate algorithm. Most of the available algorithms use manually placed landmarks to guide the algorithm, though in some cases these landmarks are optional. Consult the [[Other:DSX:Orient3D:Local_Coordinate_System_Algorithms|documentation]] on the chosen algorithm for details on the landmarks and how they are used. Once you are done specifying landmarks, press //Apply// to run the algorithm and calculate the LCS. The subject file loaded in memory will be automatically updated with the LCS.
+==== Manually ====
-  - Select //File→Save Surface (local frame)// to write the //ROI Surface File// for this object. If this file is already specified for this object in the subject file, it will be [over-]written without prompting you for a file name. Otherwise, select the name of a new OBJ file. Select "meters" as the units so the file can be used in Visual3D.
+To define the LCS manually:
+    - Ctrl-left-click on the local axes in the 3D view to display a trackball.
+    - Use the trackball to rotate and translate the local axes to the appropriate location.
+    - When you are done, use the menu option //LCS→Save to Subject Object// to save the LCS transform to the subject that is loaded in memory (it does not save the subject file).
+==== From File ====
+To define the LCS from a file:
+    - Select //LCS→Load from File...// and select the data file that contains the 4x4 transform from the global frame to the local frame. **Note**: The LCS file must contain exactly 16 numbers, separated by commas or white space.
+    - The subject file loaded in memory will be automatically updated with the LCS.
+==== Algorithmically ====
+To define the LCS according to a chosen algorithm:
+    - Open the [[Other:DSX:Orient3D:Local_Coordinate_System|Local Coordinate System]] widget and click on the desired algorithm. Most of the available algorithms use manually placed landmarks to guide the algorithm, though in some cases these landmarks are optional. Consult the [[Other:DSX:Orient3D:Local_Coordinate_System_Algorithms|documentation]] on the chosen algorithm for details on the landmarks and how they are used.
+    - Once you are done specifying landmarks, press //Apply// to run the algorithm and calculate the LCS. The subject file loaded in memory will be automatically updated with the LCS.
+===== Saving the Surface and Subject Files =====
+To complete the process:
+  - Select //File→Save Surface (local frame)// to write the [[other:dsx:image_and_surface_files#roi_surface_file|ROI Surface File]] for this object. If this file is already specified for this object in the subject file, it will be [over-]written without prompting you for a file name. Otherwise, select the name of a new OBJ file. Select "meters" as the units so the file can be used in [[visual3d:visual3d_overview|Visual3D]].
   - Select //File→Save Subject// to save the subject file with the LCS and the link to the //ROI Surface File//. If you later add regions of interest to the surface model and save them to an OBJ file, this //ROI Surface File// will be overwritten. This is by design; if you create a surface model in the LCS with ROIs, the DSX Suite does not also need a surface model in the LCS without the ROIs.
+===== See Also =====
+Go back to the [[other:dsx:orient3d:orient3d_overview|Orient3D Overview]].