Debian Codegraph @

doc/features/signal/menu_roi.rst

raw
1 .. _sig-menu-roi:
2
3 Regions Of Interest (ROI)
4 =========================
5
6 This section describes how to manipulate Regions Of Interest (ROIs) for signals in DataLab.
7
8 .. figure:: /images/shots/s_roi.png
9
10 Screenshot of the "ROI" menu.
11
12 The "ROI" menu allows you to manage Regions Of Interest (ROIs) associated with the current signal.
13
14 .. seealso::
15
16 For more information about signal metadata, see the :ref:`sig-menu-edit` section.
17
18 The Regions Of Interest (ROI) are signal areas that are defined by the user to perform specific operations, processing, or analysis on them.
19
20 ROI are taken into account almost in all computing features in DataLab:
21
22 - The "Operations" menu features are done only on the ROI if one is defined (except if the operation changes the number of points, like interpolation or resampling).
23
24 - The "Processing" menu actions are performed only on the ROI if one is defined (except if the destination signal data type is different from the source's, like in the Fourier analysis features).
25
26 - The "Analysis" menu actions are done only on the ROI if one is defined.
27
28 .. note::
29
30 ROI are stored as metadata, and thus attached to signal.
31
32 The "ROI" menu allows you to:
33
34 - "Edit graphically" |edit_roi|: open a dialog box to manage ROI associated with the selected signal (add, remove, move, resize, etc.). The ROI definition dialog is exactly the same as ROI extraction (see below): the ROI is defined by moving the position and adjusting the width of an horizontal range.
35
36 .. figure:: /images/shots/s_roi_editor.png
37
38 A signal with an ROI.
39
40 - "Edit numerically": open a dialog box to edit the parameters of the selected ROIs numerically (i.e. using a simple form). This allows you to define or modify ROIs based on numerical values.
41
42 - "Extract" |signal_roi|: extract the defined ROI from the selected signals. This will create a new signal for each ROI (or a single signal, if the "Extract all ROIs into a single signal" option is selected in the dialog), with the same metadata as the original signal, but with the data corresponding to the ROI only. The new signals will be added to the current workspace.
43
44 - "Copy" |roi_copy|: copy the defined ROI from the selected signals to the clipboard. This allows you to paste the ROI into another signal or use it in other operations.
45
46 - "Paste" |roi_paste|: paste the copied ROI from the clipboard to the selected signals. This will add the ROI to the signals, allowing you to define or modify ROIs based on previously copied ones.
47
48 - "Import" |roi_import|: import ROIs from a file. This allows you to load previously saved ROIs into the current signal.
49
50 - "Export" |roi_export|: export the defined ROIs to a file. This allows you to save the ROIs for later use or to share them with others.
51
52 - "Remove all" |roi_delete|: remove all defined ROI for the selected signals.
53
54 .. figure:: /images/shots/s_roi_dialog.png
55
56 ROI extraction dialog: the ROI is defined by moving the position and adjusting the width of an horizontal range.
57
58 .. |edit_roi| image:: ../../../datalab/data/icons/roi/roi.svg
59 :width: 24px
60 :height: 24px
61 :class: dark-light
62
63 .. |signal_roi| image:: ../../../datalab/data/icons/roi/roi_sig.svg
64 :width: 24px
65 :height: 24px
66 :class: dark-light
67
68 .. |roi_copy| image:: ../../../datalab/data/icons/roi/roi_copy.svg
69 :width: 24px
70 :height: 24px
71 :class: dark-light
72
73 .. |roi_paste| image:: ../../../datalab/data/icons/roi/roi_paste.svg
74 :width: 24px
75 :height: 24px
76 :class: dark-light
77
78 .. |roi_import| image:: ../../../datalab/data/icons/roi/roi_import.svg
79 :width: 24px
80 :height: 24px
81 :class: dark-light
82
83 .. |roi_export| image:: ../../../datalab/data/icons/roi/roi_export.svg
84 :width: 24px
85 :height: 24px
86 :class: dark-light
87
88 .. |roi_delete| image:: ../../../datalab/data/icons/roi/roi_delete.svg
89 :width: 24px
90 :height: 24px
91 :class: dark-light