Differences

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

--- other:dsx:calibratedsx:calibration_object [2024/07/12 13:55] – created sgranger
+++ other:dsx:calibratedsx:calibration_object [2025/02/15 05:54] (current) – Cleaned up page and added backlink to overview. wikisysop
@@ Line 1: / Line 1: @@
-====== Calibration_Object ======
+====== Calibration Object ======
-{{CalDSX_CalibrationObjectWidget.png}}
-Calibration Object widget
 The //Calibration Object// widget is for digitizing the points of interest (POIs) on the calibration object, so you can calculate the 3D configuration of the X-ray equipment. When you select a trial in the //DSX Configuration// widget, if it contains a calibration object that object will automatically be selected as well. The table in the //Calibration Object// widget will be filled with the object's POIs.
+{{:CalDSX_CalibrationObjectWidget.png}}
+===== Controls =====
   * **Expand List** When this box is checked, the table of POIs will expand to show all of them. When it is unchecked, the table will display ten POIs at a time.
   * **Auto-advance** When this box is checked, when you have digitized the location of the current POI in both views, the current POI will automatically advance to the next one in the table which has an undefined location in at least one view.
   * **Tracking** This slider controls the range of frames for the //Propagate POIs// command.
-\\
+===== Dropdown Context Menu =====
-{{CalDSX_CalibrationWidgetDropdown.png}}
-Context menu of POI table
+{{:CalDSX_CalibrationWidgetDropdown.png}}
 When you right-click on a POI in the table, a context menu is displayed with the following commands for editing the POIs:
   * **Add POI Before** Adds a POI to the list before the POI that you clicked on.
   * **Add POI After** Adds a POI to the list after the POI that you clicked on.
   * **Rename POI** Lets you change the name of the POI that you clicked on. You can also achieve this by double-clicking on the POI name. If you change the name, you will be asked if you want to change the name of the POI in all the 2D coordinate files in all trials that use the object.
   * **Delete POI** Deletes the POI that you clicked on.
   * **Clear POI Location** Removes the selected POI's location from both views of the current reporting time.
   * **Clear POI Location in All Frames** Removes the selected POI's location from both views for all reporting times.
   * **Disable** Disables the POI that you clicked on, so that it will be skipped over when POIs are being digitized in the X-rays. Once the POI is disabled, this command in the menu changes to //Enable// so that you can re-enable it at a later time.
-\\
+===== POI Digitization =====
+This section contains the parameters that control the digitization of POIs in the X-ray images. When you are digitizing POIs in the images, there are two methods of determining the XY coordinates in the 2D images. The recommended method is to left-click on any portion of the POI in the image and let CalibrateDSX calculate the weighted center of pixels representing the POI. This process is described in detail in //Digitizing POIs//, and is governed by the parameters listed below. For cases in which this process does not correctly locate the POI center (e.g., non-circular POIs), you can use Ctrl-left-click to specify the point. In this case CalibrateDSX will use the exact XY coordinates of where you clicked as the 2D location of the POI in that view.
-|     POI Digitization                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
+^ Parameter ^ Description ^
-|This section contains the parameters that control the digitization of POIs in the X-ray images. When you are digitizing POIs in the images, there are two methods of determining the XY coordinates in the 2D images. The recommended method is to left-click on any portion of the POI in the image and let CalibrateDSX calculate the weighted center of pixels representing the POI. This process is described in detail in //Digitizing POIs//, and is governed by the parameters listed below. For cases in which this process does not correctly locate the POI center (e.g., non-circular POIs), you can use Ctrl-left-click to specify the point. In this case CalibrateDSX will use the exact XY coordinates of where you clicked as the 2D location of the POI in that view.\\ \\ \\ \\ * **POI Scale** Used to calculate the expected radius, in pixels, of the POI in the X-ray images. The expected radius is the physical size of the POI multiplied by the scale factor, divided by the pixel size. The scale factor should increase with the distance between the POI and the image plane. The default value is 1.0.\\ \\ \\ \\ * **Click Search Factor** Used when manually digitizing POIs in the X-ray images. If you click at point X,Y in an image, a region of the image around this point is searched for the best location of a grayscale "blob". This region is a square centered at X,Y with sides equal to two times the expected radius of the POI times the //Click Search Factor//. This factor should be set small enough so that the search region includes only the POI you are currently digitizing. The default value is 1.5.\\ \\ \\ \\ * **Propagation Search Factor** Used when propagating POIs in the X-ray images. In order to propagate a POI with coordinates X,Y in one frame to the next frame, a region of the next frame is searched for the best location of a grayscale "blob". This region is a square centered at X,Y with sides equal to two times the expected radius of the POI times the propagation search factor. This factor should be set large enough so that the search region captures the movement of the POI from one frame to the next, but small enough so that it does not include other POIs. The default value is 1.5.\\ \\ \\ \\ * **Centroid Threshold** The relative threshold for identifying pixels that belong to the POI. Once a grayscale region has been identified as a POI, its centroid is calculated by a weighted average of all the pixels that have an intensity value greater than this percentage (0.0 to 1.0) of the maximum intensity. The default value is 0.5.\\ \\ \\ \\ * **Edge Threshold** The relative threshold for identifying suitable POIs. For a grayscale region in an X-ray image to be considered a POI, the average edge value within the region must be at least at the //Edge Threshold// percentage (0.0 to 1.0) of the maximum edge value. The default value is 0.1.\\ \\ \\ \\ * **Pose Map Cutoff Frequency** The low-pass cutoff frequency for smoothing the cubic splines in the POI pose maps. If the value is set to 0.0 smoothing is turned off. The default value is 20.0.  |
+| **POI Scale** | Used to calculate the expected radius, in pixels, of the POI in the X-ray images. The expected radius is the physical size of the POI multiplied by the scale factor, divided by the pixel size. The scale factor should increase with the distance between the POI and the image plane. The default value is 1.0. |
+| **Click Search Factor** | Used when manually digitizing POIs in the X-ray images. If you click at point X,Y in an image, a region of the image around this point is searched for the best location of a grayscale "blob". This region is a square centered at X,Y with sides equal to two times the expected radius of the POI times the //Click Search Factor//. This factor should be set small enough so that the search region includes only the POI you are currently digitizing. The default value is 1.5. |
+| **Propagation Search Factor** | Used when propagating POIs in the X-ray images. In order to propagate a POI with coordinates X,Y in one frame to the next frame, a region of the next frame is searched for the best location of a grayscale "blob". This region is a square centered at X,Y with sides equal to two times the expected radius of the POI times the propagation search factor. This factor should be set large enough so that the search region captures the movement of the POI from one frame to the next, but small enough so that it does not include other POIs. The default value is 1.5. |
+| **Centroid Threshold** | The relative threshold for identifying pixels that belong to the POI. Once a grayscale region has been identified as a POI, its centroid is calculated by a weighted average of all the pixels that have an intensity value greater than this percentage (0.0 to 1.0) of the maximum intensity. The default value is 0.5. |
+| **Edge Threshold** | The relative threshold for identifying suitable POIs. For a grayscale region in an X-ray image to be considered a POI, the average edge value within the region must be at least at the //Edge Threshold// percentage (0.0 to 1.0) of the maximum edge value. The default value is 0.1. |
+| **Pose Map Cutoff Frequency** | The low-pass cutoff frequency for smoothing the cubic splines in the POI pose maps. If the value is set to 0.0 smoothing is turned off. The default value is 20.0. |
+===== See Also =====
+Go back to an overview of [[other:dsx:calibratedsx:calibratedsx_overview#widgets|CalibrateDSX's widgets]].