Differences

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

--- other:dsx:orient3d:orient3d_overview [2024/07/16 17:01] – removed sgranger
+++ other:dsx:orient3d:orient3d_overview [2024/07/17 15:44] (current) – created sgranger
@@ Line 1: / Line 1: @@
+====== Orient3D Overview ======
+Orient3D prepares surface models created by [[Other:DSX:Surface3D:Surface3D_Overview|Surface3D]] (or third-party software such as Mimics and ScanIP) for use in kinematic analyses after they have been tracked in [[Other:DSX:X4D:X4D_Overview|X4D]] or [[Other:DSX:Locate3D:Locate3D_Overview|Locate3D]]. With it you can define a [[Other:DSX:DSX_Definitions#Coordinate_Systems|local coordinate system (LCS)]] for each object, landmarks, such as ligament attachment sites, and [[Other:DSX:DSX_Definitions#Region_of_Interest_(ROI)|regions of interest (ROIs)]], which are used in the calculation of distance maps. The local coordinate system of an object is usually, but not necessarily, its “anatomical” reference frame. When a local coordinate system is defined for an object, it is stored in the subject file as a transform from the frame of the object’s segmented image data to the local coordinate system. To analyze tracking results from [[Other:DSX:X4D:X4D_Overview|X4D]] in [[Visual3D:Visual3D_Overview|Visual3D]], the surface model, landmarks, and regions of interest must be saved in the local coordinate system. Even if you are not exporting your data for kinematic analysis in Visual3D, it is still recommended to define the anatomical coordinate system in Orient3D. X4D's tracking results are output using this coordinate system, and it is easier to manipulate the bone in X4D when an anatomical coordinate system is defined.
+{{:O3D_FullScreen.png}}
+==== Tutorials ====
+== How To: Define the LCS of an Object ==
+== How To: Define Regions of Interest on an Object ==
+== Image and Surface Files ==
+==== Menus ====
+== File Menu ==
+{{:O3D_FileMenu.png}}
+  * **Load Subject (Ctrl + O)** loads a subject file. Note: Only available with a DSX Suite license.
+  * **Save Subject (Ctrl + S)** saves the currently loaded subject to its existing subject file. Note: Only available with a DSX Suite license.
+  * **Save Subject As** saves the currently loaded subject to a new subject file. Note: Only available with a DSX Suite license.
+  * **Load Surface...** loads a single surface model file. If you load a surface with this command, there is no way to save the local coordinate system or any landmarks you may define, because these items are saved in the subject file. Orient3D is able to load the following formats:
+[[https://en.wikipedia.org/wiki/Wavefront_.obj_file|Wavefront<sup>1</sup> (*.obj)]]
+Open Inventor (*.iv)
+After the file is loaded the surface model is automatically triangulated to facilitate additional processing, such as decimation and smoothing. Note: Orient3D currently ignores color and texture definitions from MTL and COL files that sometimes accompany Wavefront OBJ files.
+  * **Save Surface (global frame)** saves the current surface model in the global reference frame as an OBJ file. If a subject file is loaded, it will be updated with the name of the saved surface file. The file dialog contains an option for specifying the units of the vertex coordinates.
+  * **Save Surface (local frame)** saves the current surface model in its local reference frame as an OBJ file. If a subject file is loaded, it will be updated with the name of the saved surface file. The file dialog contains an option for specifying the units of the vertex coordinates. Meters should be chosen if you plan to import the surface model into Visual3D.
+  * **Exit** exits the program. The program can also be closed using the X in the top right corner of the program window.
+== LCS Menu ==
+{{:O3D_LCSMenu.png}}
+  * **Reset to Identity** resets the LCS to the identity matrix (i.e., aligned with the global frame).
+  * **Load from File...** loads a 4x4 transform matrix from a file and assigns it to the LCS. The transform must be specified as 16 comma-separated values defining the row-major transform from the global frame to the local frame.
+  * **Save to Subject Object** saves the current LCS to the subject object in the subject file. It is useful for saving the LCS when you have manually moved it on the surface model in the 3D window. If you use an algorithm to calculate the LCS, or load it from a file, the subject file is automatically updated, so you do not need to use this command.
+== Surface Menu ==
+{{:O3D_SurfaceMenu.png}}
+  * **Erase ROI Polygons (Alt + E)** Toggles in and out of //Erase ROI Polygons// mode. In this mode, the cursor changes to a crosshair with the label //ROI eraser//. If you press and hold the left mouse button and drag the cursor over the surface model, all polygons under the cursor will be removed from any ROIs. This is useful for "cleaning up" an ROI if it projected onto an undesired part of the surface model. Press //Esc// to exit this mode.\\
+Note: There is no undo for this command.
+  * **Align with Cylinder** Aligns and scales the oriented bounding box of the surface model with the "Visual3D cylinder". There is no undo for this command.\\
+Note: This command is not intended to be used in a DSX context.
+  * **Clean Polyhedral Model** Fixes face and vertex normals so that they point outward, and fills in holes in the surface.Note: There is no undo for this command.
+== View Menu ==
+{{:O3D_ViewMenu.png}}
+  * **Display Global Axes (Alt + G)** toggles the display of the global coordinate system in the 3D view.
+  * **Display Local Axes (Alt + L)** toggles the display of the local coordinate system in the 3D view.
+  * **Display Cylinder (Alt + C)** toggles the display of a cylinder to which the surface model can be aligned when preparing the surface for use in Visual3D. The Z-coordinates of the cylinder range between -1.0 and 0.0 and its radius is currently hard-coded to 0.2. Note: This command is not intended to be used in a DSX context.
+  * **Display ROI Annotations (Alt + R)** toggles the display of annotations on the subregions of each ROI.
+  * **Object Configuration (Ctrl + Shift + O)** toggles the appearance of the dockable //Object Configuration// widget. Note: Only available with a DSX Suite license.
+  * **Image/Surface Match (Ctrl + Shift + I)** toggles the appearance of the dockable //Image/Surface Match// widget. Note: Only available with a DSX Suite license.
+  * **Image Data Generator (Ctrl + Shift + G)** toggles the appearance of the dockable //Image Data Generator// widget. Note: Only available with a DSX Suite license.
+  * **Landmarks (Ctrl + Shift + L)** toggles the appearance of the dockable //Landmarks// widget.
+  * **Local Coordinate System (Ctrl + Shift + C)** toggles the appearance of the dockable //Local Coordinate System// widget.
+  * **Regions of Interest (Ctrl + Shift + R)** toggles the appearance of the dockable //Regions of Interest// widget.
+== Options Menu ==
+{{:O3D_OptionsMenu.png}}
+  * **Settings** Opens the Settings dialog.
+== Help Menu ==
+{{:O3D_HelpMenu.png}}
+  * **Help (F1)** opens the Orient3D wiki page in the default browser.
+  * **About...** displays a dialog with information about Orient3D, including the installed version number. It also contains the //Deactivate// button, for deactivating your license.
+==== Widgets ====
+== Object Configuration ==
+== Landmarks ==
+== Local Coordinate System (LCS) ==
+== Regions of Interest (ROIs) ==
+== Image/Surface Match ==
+== Image Data Generator ==
+== 3D View ==
+== Settings ==