.. _datawidget: Data Widget =========== The *Data Widget* is located in the top-left corner of the ImFusion Suite, shows all currently loaded datasets, and enables you to interact with them. .. figure:: datawidget.png :align: center :width: 75% The *Data Widget* of the ImFusion Suite showing 1 CT and 2 MRI volumes grouped by Study ID Basic Interaction ----------------- The main functionality of the Data Widget is to toggle visibility of datasets, and to select them in order to run algorithms on them (cf. :ref:`run-algorithms-on-data`). Visibility is indicated by the eye icon (1), while selection is indicated by highlighting the row and using a blue font color (2). Number overlays over the icon/thumbnail indicate the selection order in case more than 1 dataset is selected. Every row represents one dataset such as an image or a tracking sequence together with a representative icon or thumbnail. Next to the thumbnail is the name of the dataset. You can rename a dataset by double-clicking on its name. There is a series of badge icons (3) next to the dataset name that indicate properties, such as dimensionality and modality (cf. :ref:`datawidget-attributes`). :ref:`Dataset Links` are indicated by separate badge icons on the right-hand side of participating datasets (5). The number overlay on the link icon indicates link groups in case there exist multiple links. You can change the appearance and the behavior of the Data Widget via the options menu (4) (cf. :ref:`datawidget-options`). .. _datawidget-attributes: Dataset Attributes ------------------ Every item in the Data Widget is annotated by a selection of small badge icons describing aspects and attributes of the corresponding dataset. They show the following information: .. |attr2d| image:: DataWidget/Attribute2D.png :height: 2.5ex :align: middle .. |attr2dt| image:: DataWidget/Attribute2Dt.png :height: 2.5ex :align: middle .. |attr3d| image:: DataWidget/Attribute3D.png :height: 2.5ex :align: middle .. |attr3dt| image:: DataWidget/Attribute3Dt.png :height: 2.5ex :align: middle .. |attr-ct| image:: DataWidget/AttributeCT.png :height: 2.5ex :align: middle .. |attr-lab| image:: DataWidget/AttributeLAB.png :height: 2.5ex :align: middle .. |attr-mr| image:: DataWidget/AttributeMR.png :height: 2.5ex :align: middle .. |attr-nm| image:: DataWidget/AttributeNM.png :height: 2.5ex :align: middle .. |attr-us| image:: DataWidget/AttributeUS.png :height: 2.5ex :align: middle .. |attr-xr| image:: DataWidget/AttributeXR.png :height: 2.5ex :align: middle .. |attr-color| image:: DataWidget/AttributeColor.png :height: 2.5ex :align: middle .. |attr-stream| image:: DataWidget/AttributeStream.png :height: 2.5ex :align: middle .. |attr-compound| image:: DataWidget/AttributeCompoundData.png :height: 2.5ex :align: middle .. |attr-deform| image:: DataWidget/AttributeDeformation.png :height: 2.5ex :align: middle .. |attr-mask| image:: DataWidget/AttributeMask.png :height: 2.5ex :align: middle .. |attr-link-windowing| image:: DataWidget/AttributeLinkWindowing.png :height: 2.5ex :align: middle .. |attr-link-pose| image:: DataWidget/AttributeLinkPose.png :height: 2.5ex :align: middle .. |attr-link-sel| image:: DataWidget/AttributeLinkSelection.png :height: 2.5ex :align: middle .. list-table:: :header-rows: 1 * - Type - Badges * - Dimensionality - - |attr2d| 2D Image - |attr2dt| 2D Image Set - |attr3d| 3D Volume - |attr3dt| 3D Volume Set * - Modality - - |attr-ct| Computed Tomography - |attr-lab| Label Map - |attr-mr| Magnetic Resonance Imaging - |attr-nm| Nuclear Medicine (e.g. PET, SPECT) - |attr-us| Ultrasound - |attr-xr| X-Ray * - Other Attributes - - |attr-color| Multi-channel color image - |attr-stream| Live Stream (cf. :ref:`streammodule`) - |attr-compound| Compound dataset consisting of multiple individual datasets - |attr-mask| Masked image - |attr-deform| Image with deformation field * - Dataset Links - - |attr-link-pose| Link world registration pose matrix between datasets - |attr-link-sel| Link selection between datasets - |attr-link-windowing| Link windowing between datasets .. _datawidget-links: Dataset Linking --------------- The ImFusion Suite enables you to link certain properties between multiple datasets. Dataset links are created by selecting multiple datasets in the Data Widget, opening the context menu by clicking the right mouse button, and navigating to the *Linking* submenu. Depending on the selected datasets and their current linking state you can create new links or unlink datasets. .. image:: datawidget-linking.png :align: center :width: 50% The following link types exist: - **Link Windowing:** Synchronizes the :ref:`windowing` between participating datasets. This is useful when showing multiple datasets with similar intensity distributions. - **Link Pose:** Synchronizes the world pose matrix between participating datasets and keeps their relative position to each other when moving one of them. This is particularly useful for registration workflows. - **Link Selection:** Synchronizes the selection state of participating image sets and volume sets (sequences of 2D or 3D images). .. _datawidget-options: Options ------- Clicking on the cog-wheel icon in the top-right corner of the Data Widget opens the options menu. It offers the following settings: .. image:: datawidget-options.png :align: center :width: 50% - **Visibility Follows Selection:** By default, the visibility of datasets is synchronized with the current selection. You can disable this setting so that you can select datasets without changing what data is shown in the views. This is useful for complex workflows where you want to show multiple datasets while running algorithms on other datasets. - **Automatically Link Windowing per Modality:** Automatically :ref:`link the windowing` between datasets that share the same modality. - **Automatically Link Pose when Grouping:** Automatically :ref:`link the pose` between datasets when grouping them together manually. - **Show Thumbnails:** Show thumbnails of supported datasets instead of generic icons. - **Grouping:** Enables you to automatically group your datasets by patient ID or study ID if your datasets contain the necessary metadata (e.g. if they originate from DICOM). By default, all datasets are shown in a flat list unless you create manual groups.