Skip to content

cellects.gui.if_several_folders_window

cellects.gui.if_several_folders_window

GUI window for selecting folders when multiple options exist in Cellects analysis workflow.

This module implements a second-stage GUI dialog that appears when multiple experiment folders are available. It provides an interface for folder selection via checkboxes and table visualization, with navigation controls to proceed to image analysis or return to prior steps. Includes thread-safe background operations for loading data without freezing the UI.

Main Components IfSeveralFoldersWindow : QWidget subclass managing folder selection and analysis workflow navigation

IfSeveralFoldersWindow

Bases: WindowType

Second window of the Cellects GUI, only appears when there are multiple folders.

Source code in src/cellects/gui/if_several_folders_window.py 
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
class IfSeveralFoldersWindow(WindowType):
    """
    Second window of the Cellects GUI, only appears when there are multiple folders.
    """
    def __init__(self, parent, night_mode):
        """
        Initialize the IfSeveralFolders window with a parent widget and night mode setting.

        Parameters
        ----------
        parent : QWidget
            The parent widget to which this window will be attached.
        night_mode : bool
            A boolean indicating whether the night mode should be enabled.

        Examples
        --------
        >>> from PySide6 import QtWidgets
        >>> from cellects.gui.cellects import CellectsMainWidget
        >>> from cellects.gui.if_several_folders_window import IfSeveralFoldersWindow
        >>> import sys
        >>> app = QtWidgets.QApplication([])
        >>> parent = CellectsMainWidget()
        >>> session = IfSeveralFoldersWindow(parent, False)
        >>> session.true_init()
        >>> parent.insertWidget(0, session)
        >>> parent.show()
        >>> sys.exit(app.exec())
        """
        super().__init__(parent, night_mode)
        self.setParent(parent)

    def true_init(self):
        """
        Initialize the IfSeveralFoldersWindow with UI components and settings.

        Extended Description
        --------------------
        This method sets up the user interface for the IfSeveralFoldersWindow,
        including labels, a table widget for folders and sample sizes, checkboxes,
        buttons for video analysis and running tasks directly, and navigation
        buttons for previous and next steps. The window supports multiple folder
        selection and provides a means to control the analysis process.

        Notes
        -----
        This method assumes that the parent widget has a 'po' attribute with specific settings and variables.
        """
        logging.info("Initialize IfSeveralFoldersWindow")
        self.thread_dict = {}
        self.thread_dict["LoadFirstFolderIfSeveral"] = LoadFirstFolderIfSeveralThread(self.parent())
        self.next_clicked_once:bool = False
        self.layout = QtWidgets.QVBoxLayout()

        self.title_label = FixedText('Select folders to analyze', police=30, night_mode=self.parent().po.all['night_mode'])
        self.title_label.setAlignment(QtCore.Qt.AlignHCenter)
        self.layout.addWidget(self.title_label)
        self.layout.addItem(QtWidgets.QSpacerItem(1, 1, QtWidgets.QSizePolicy.Maximum, QtWidgets.QSizePolicy.MinimumExpanding))

        # 1) add a check box allowing to select every folders
        self.cb_layout = QtWidgets.QHBoxLayout()
        self.cb_widget = QtWidgets.QWidget()
        self.cb_label = FixedText(MF["Check_to_select_all_folders"]["label"] + ':', tip=MF["Check_to_select_all_folders"]["tips"], night_mode=self.parent().po.all['night_mode'])
        self.cb = QtWidgets.QCheckBox()
        self.cb.setChecked(True)
        self.cb.clicked.connect(self.checked)
        self.cb_layout.addWidget(self.cb_label)
        self.cb_layout.addWidget(self.cb)
        self.cb_layout.addItem(QtWidgets.QSpacerItem(1, 1, QtWidgets.QSizePolicy.MinimumExpanding, QtWidgets.QSizePolicy.Maximum))
        self.cb_widget.setLayout(self.cb_layout)
        self.layout.addWidget(self.cb_widget)

        # 2) Create a folder list and sample number per folder
        self.tableau = QtWidgets.QTableWidget()  # Scroll Area which contains the widgets, set as the centralWidget
        self.tableau.setColumnCount(2)
        self.tableau.setRowCount(len(self.parent().po.all['folder_list']))
        self.tableau.setHorizontalHeaderLabels(['Folders', 'Sample size'])
        self.parent().po.all['sample_number_per_folder'] = np.repeat(int(self.parent().po.all['first_folder_sample_number']), self.parent().po.all['folder_number']).tolist()

        for i, folder in enumerate(self.parent().po.all['folder_list']):
            self.tableau.setItem(i, 0, QtWidgets.QTableWidgetItem(folder))
            self.tableau.setItem(i, 1, QtWidgets.QTableWidgetItem(str(self.parent().po.all['sample_number_per_folder'][i])))
        self.tableau.horizontalHeader().setSectionResizeMode(0, QtWidgets.QHeaderView.ResizeToContents)
        self.tableau.horizontalHeader().setSectionResizeMode(1, QtWidgets.QHeaderView.ResizeToContents)
        self.tableau.setSelectionBehavior(QtWidgets.QAbstractItemView.SelectRows)
        self.tableau.selectAll()
        self.tableau.itemSelectionChanged.connect(self.item_selection_changed)

        self.tableau.setShowGrid(False)
        self.tableau.setSizePolicy(QtWidgets.QSizePolicy.Expanding, QtWidgets.QSizePolicy.Minimum)
        self.tableau.setVerticalScrollBarPolicy(QtCore.Qt.ScrollBarAsNeeded)
        self.tableau.horizontalHeader().hide()
        self.tableau.verticalHeader().hide()
        self.layout.addWidget(self.tableau)

        # Create the shortcuts row
        self.shortcuts_widget = QtWidgets.QWidget()
        self.shortcuts_layout = QtWidgets.QHBoxLayout()
        self.Video_analysis_window = PButton("Video tracking window", night_mode=self.parent().po.all['night_mode'])
        self.Video_analysis_window.clicked.connect(self.Video_analysis_window_is_clicked)
        self.Run_all_directly = PButton("Run all directly", tip=VAW["Run_All"]["tips"],
                                        night_mode=self.parent().po.all['night_mode'])
        self.Run_all_directly.clicked.connect(self.Run_all_directly_is_clicked)
        self.Video_analysis_window.setVisible(False)
        self.Run_all_directly.setVisible(False)
        self.shortcuts_layout.addItem(QtWidgets.QSpacerItem(1, 1, QtWidgets.QSizePolicy.Maximum, QtWidgets.QSizePolicy.MinimumExpanding))
        self.shortcuts_layout.addWidget(self.Video_analysis_window)
        self.shortcuts_layout.addWidget(self.Run_all_directly)
        self.shortcuts_widget.setLayout(self.shortcuts_layout)
        self.layout.addWidget(self.shortcuts_widget)

        # 3) Previous button
        self.last_row_layout = QtWidgets.QHBoxLayout()
        self.last_row_widget = QtWidgets.QWidget()
        self.previous = PButton('Previous', night_mode=self.parent().po.all['night_mode'])
        self.previous.clicked.connect(self.previous_is_clicked)

        # 4) Message
        self.message = QtWidgets.QLabel(self)
        self.message.setText('')
        self.message.setStyleSheet("color: rgb(230, 145, 18)")
        self.message.setAlignment(QtCore.Qt.AlignRight)

        # 5) Next button
        self.next = PButton('Next', night_mode=self.parent().po.all['night_mode'])
        self.next.clicked.connect(self.next_is_clicked)
        self.last_row_layout.addWidget(self.previous)
        self.last_row_layout.addItem(QtWidgets.QSpacerItem(1, 1, QtWidgets.QSizePolicy.MinimumExpanding, QtWidgets.QSizePolicy.Maximum))
        self.last_row_layout.addWidget(self.message)
        self.last_row_layout.addWidget(self.next)
        self.last_row_widget.setLayout(self.last_row_layout)
        self.layout.addItem(QtWidgets.QSpacerItem(1, 1, QtWidgets.QSizePolicy.Maximum, QtWidgets.QSizePolicy.MinimumExpanding))
        self.layout.addWidget(self.last_row_widget)
        self.setLayout(self.layout)

    def checked(self):
        """
        Check or uncheck all entries in the tableau based on checkbox state.

        If the associated checkbox is checked, select all items in the
        tableau. Otherwise, clear the selection.
        """
        if self.cb.isChecked():
            self.tableau.selectAll()
        else:
            self.tableau.clearSelection()

    def item_selection_changed(self):
        """
        Update the checkbox state based on the number of selected items.
        """
        if (len(self.tableau.selectedItems()) // 2) == len(self.parent().po.all['folder_list']):
            self.cb.setChecked(True)
        else:
            self.cb.setChecked(False)

    def previous_is_clicked(self):
        """
        Handles the logic for when a "Previous" button is clicked in the interface, leading to the FirstWindow.

        It modifies internal state to force the decision between IfSeveralFoldersWindow and ImageAnalysisWindow to be
        done once again if the user clicks on the "Next" button of the FirstWindow.
        """
        self.next_clicked_once = False
        self.parent().firstwindow.instantiate = True
        self.parent().change_widget(0)

    def next_is_clicked(self):
        """
        Handles the logic for when a "Next" button is clicked in the interface, leading to the ImageAnalysisWindow.

        If `self.next_clicked_once` is True, instanties widgets and performs image analysis.
        Otherwise, checks for selected folders and samples. Updates internal state and starts
        a thread for loading the first folder if multiple folders are selected.

        Notes
        -----
        This function updates the internal state based on user selection and starts a thread
        for loading data. The `self.parent().po.update_folder_id` method is called to update
        folder IDs.
        """
        if self.next_clicked_once:
            self.instantiates_widgets_and_do_image_analysis()
        else:
            self.message.setText("Loading, wait...")
            item_number = len(self.tableau.selectedItems())
            if item_number == 0:
                self.message.setText("Select at least one folder")
            else:
                sample_number_per_folder = []
                folder_list = []
                for i in np.arange(item_number):
                    if i % 2 == 0:
                        folder_list.append(self.tableau.selectedItems()[i].text())
                    else:
                        sample_number_per_folder.append(int(self.tableau.selectedItems()[i].text()))
                self.parent().po.all['first_folder_sample_number'] = int(self.tableau.selectedItems()[1].text())

                self.parent().po.all['folder_list'] = folder_list
                self.parent().po.all['sample_number_per_folder'] = sample_number_per_folder
                self.parent().po.update_folder_id(self.parent().po.all['first_folder_sample_number'],
                                                  self.parent().po.all['folder_list'][0])
                self.thread_dict["LoadFirstFolderIfSeveral"].start()
                self.thread_dict["LoadFirstFolderIfSeveral"].message_when_thread_finished.connect(self.first_folder_loaded)

    def first_folder_loaded(self, first_exp_ready_to_run: bool):
        """
        Set the visibility of widgets and messages based on whether data is found.

        Parameters
        ----------
        first_exp_ready_to_run : bool
            Indicates if the one_experiment data is ready to be run.
        """
        if first_exp_ready_to_run:
            self.cb_widget.setVisible(False)
            self.tableau.setVisible(False)
            if len(self.parent().po.vars['analyzed_individuals']) != self.parent().po.all['first_folder_sample_number']:
                self.parent().po.vars['analyzed_individuals'] = list(range(1, self.parent().po.all['first_folder_sample_number'] + 1))
                self.parent().po.sample_number = self.parent().po.all['first_folder_sample_number']
            self.message.setText("Data found, shortcuts are available. Click Next again to redo/improve the image analysis")
            self.next_clicked_once = True
            self.Video_analysis_window.setVisible(True)
            self.Run_all_directly.setVisible(True)
            self.parent().firstwindow.Run_all_directly.setVisible(True)
        else:
            self.instantiates_widgets_and_do_image_analysis()

    def instantiates_widgets_and_do_image_analysis(self):
        """
        Instantiate widgets and initialize the image analysis window.
        -----
        This function is responsible for:
            - Instantiating widgets with a specific condition.
            - Initializing the true initialization of the image analysis window.
            - Remember to not re-instantiate the image analysis window if the user goes back to the first window.
            - Changing the current widget to ImageAnalysisWindow.
        """
        self.parent().instantiate_widgets(several_folder_included=False)
        self.parent().imageanalysiswindow.true_init()
        self.parent().firstwindow.instantiate = False
        self.parent().change_widget(2)# ImageAnalysisWindow

    def Video_analysis_window_is_clicked(self):
        """
        Save the identity of the current widget (for future navigation) and change to the video analysis window.
        """
        self.parent().last_tab = "data_specifications"
        self.parent().change_widget(3)

    def Run_all_directly_is_clicked(self):
        """
        Run the "Run all directly" operation in the parent window.

        This function triggers the execution of the "Run all directly"
        functionality by calling the corresponding method in the parent
        window and then updates the state accordingly.
        """
        self.parent().firstwindow.Run_all_directly_is_clicked()
        self.previous_is_clicked()

Run_all_directly_is_clicked()

Run the "Run all directly" operation in the parent window.

This function triggers the execution of the "Run all directly" functionality by calling the corresponding method in the parent window and then updates the state accordingly.

Source code in src/cellects/gui/if_several_folders_window.py 
270
271
272
273
274
275
276
277
278
279
def Run_all_directly_is_clicked(self):
    """
    Run the "Run all directly" operation in the parent window.

    This function triggers the execution of the "Run all directly"
    functionality by calling the corresponding method in the parent
    window and then updates the state accordingly.
    """
    self.parent().firstwindow.Run_all_directly_is_clicked()
    self.previous_is_clicked()

Video_analysis_window_is_clicked()

Save the identity of the current widget (for future navigation) and change to the video analysis window.

Source code in src/cellects/gui/if_several_folders_window.py 
263
264
265
266
267
268
def Video_analysis_window_is_clicked(self):
    """
    Save the identity of the current widget (for future navigation) and change to the video analysis window.
    """
    self.parent().last_tab = "data_specifications"
    self.parent().change_widget(3)

__init__(parent, night_mode)

Initialize the IfSeveralFolders window with a parent widget and night mode setting.

Parameters:

Name Type Description Default
parent QWidget

The parent widget to which this window will be attached.

 required
night_mode bool

A boolean indicating whether the night mode should be enabled.

 required

Examples:

>>> from PySide6 import QtWidgets
>>> from cellects.gui.cellects import CellectsMainWidget
>>> from cellects.gui.if_several_folders_window import IfSeveralFoldersWindow
>>> import sys
>>> app = QtWidgets.QApplication([])
>>> parent = CellectsMainWidget()
>>> session = IfSeveralFoldersWindow(parent, False)
>>> session.true_init()
>>> parent.insertWidget(0, session)
>>> parent.show()
>>> sys.exit(app.exec())
Source code in src/cellects/gui/if_several_folders_window.py 
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
def __init__(self, parent, night_mode):
    """
    Initialize the IfSeveralFolders window with a parent widget and night mode setting.

    Parameters
    ----------
    parent : QWidget
        The parent widget to which this window will be attached.
    night_mode : bool
        A boolean indicating whether the night mode should be enabled.

    Examples
    --------
    >>> from PySide6 import QtWidgets
    >>> from cellects.gui.cellects import CellectsMainWidget
    >>> from cellects.gui.if_several_folders_window import IfSeveralFoldersWindow
    >>> import sys
    >>> app = QtWidgets.QApplication([])
    >>> parent = CellectsMainWidget()
    >>> session = IfSeveralFoldersWindow(parent, False)
    >>> session.true_init()
    >>> parent.insertWidget(0, session)
    >>> parent.show()
    >>> sys.exit(app.exec())
    """
    super().__init__(parent, night_mode)
    self.setParent(parent)

checked()

Check or uncheck all entries in the tableau based on checkbox state.

If the associated checkbox is checked, select all items in the tableau. Otherwise, clear the selection.

Source code in src/cellects/gui/if_several_folders_window.py 
155
156
157
158
159
160
161
162
163
164
165
def checked(self):
    """
    Check or uncheck all entries in the tableau based on checkbox state.

    If the associated checkbox is checked, select all items in the
    tableau. Otherwise, clear the selection.
    """
    if self.cb.isChecked():
        self.tableau.selectAll()
    else:
        self.tableau.clearSelection()

first_folder_loaded(first_exp_ready_to_run)

Set the visibility of widgets and messages based on whether data is found.

Parameters:

Name Type Description Default
first_exp_ready_to_run bool

Indicates if the one_experiment data is ready to be run.

 required
Source code in src/cellects/gui/if_several_folders_window.py 
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
def first_folder_loaded(self, first_exp_ready_to_run: bool):
    """
    Set the visibility of widgets and messages based on whether data is found.

    Parameters
    ----------
    first_exp_ready_to_run : bool
        Indicates if the one_experiment data is ready to be run.
    """
    if first_exp_ready_to_run:
        self.cb_widget.setVisible(False)
        self.tableau.setVisible(False)
        if len(self.parent().po.vars['analyzed_individuals']) != self.parent().po.all['first_folder_sample_number']:
            self.parent().po.vars['analyzed_individuals'] = list(range(1, self.parent().po.all['first_folder_sample_number'] + 1))
            self.parent().po.sample_number = self.parent().po.all['first_folder_sample_number']
        self.message.setText("Data found, shortcuts are available. Click Next again to redo/improve the image analysis")
        self.next_clicked_once = True
        self.Video_analysis_window.setVisible(True)
        self.Run_all_directly.setVisible(True)
        self.parent().firstwindow.Run_all_directly.setVisible(True)
    else:
        self.instantiates_widgets_and_do_image_analysis()

instantiates_widgets_and_do_image_analysis()

Instantiate widgets and initialize the image analysis window.

This function is responsible for: - Instantiating widgets with a specific condition. - Initializing the true initialization of the image analysis window. - Remember to not re-instantiate the image analysis window if the user goes back to the first window. - Changing the current widget to ImageAnalysisWindow.

Source code in src/cellects/gui/if_several_folders_window.py 
248
249
250
251
252
253
254
255
256
257
258
259
260
261
def instantiates_widgets_and_do_image_analysis(self):
    """
    Instantiate widgets and initialize the image analysis window.
    -----
    This function is responsible for:
        - Instantiating widgets with a specific condition.
        - Initializing the true initialization of the image analysis window.
        - Remember to not re-instantiate the image analysis window if the user goes back to the first window.
        - Changing the current widget to ImageAnalysisWindow.
    """
    self.parent().instantiate_widgets(several_folder_included=False)
    self.parent().imageanalysiswindow.true_init()
    self.parent().firstwindow.instantiate = False
    self.parent().change_widget(2)# ImageAnalysisWindow

item_selection_changed()

Update the checkbox state based on the number of selected items.

Source code in src/cellects/gui/if_several_folders_window.py 
167
168
169
170
171
172
173
174
def item_selection_changed(self):
    """
    Update the checkbox state based on the number of selected items.
    """
    if (len(self.tableau.selectedItems()) // 2) == len(self.parent().po.all['folder_list']):
        self.cb.setChecked(True)
    else:
        self.cb.setChecked(False)

next_is_clicked()

Handles the logic for when a "Next" button is clicked in the interface, leading to the ImageAnalysisWindow.

If self.next_clicked_once is True, instanties widgets and performs image analysis. Otherwise, checks for selected folders and samples. Updates internal state and starts a thread for loading the first folder if multiple folders are selected.

Notes

This function updates the internal state based on user selection and starts a thread for loading data. The self.parent().po.update_folder_id method is called to update folder IDs.

Source code in src/cellects/gui/if_several_folders_window.py 
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
def next_is_clicked(self):
    """
    Handles the logic for when a "Next" button is clicked in the interface, leading to the ImageAnalysisWindow.

    If `self.next_clicked_once` is True, instanties widgets and performs image analysis.
    Otherwise, checks for selected folders and samples. Updates internal state and starts
    a thread for loading the first folder if multiple folders are selected.

    Notes
    -----
    This function updates the internal state based on user selection and starts a thread
    for loading data. The `self.parent().po.update_folder_id` method is called to update
    folder IDs.
    """
    if self.next_clicked_once:
        self.instantiates_widgets_and_do_image_analysis()
    else:
        self.message.setText("Loading, wait...")
        item_number = len(self.tableau.selectedItems())
        if item_number == 0:
            self.message.setText("Select at least one folder")
        else:
            sample_number_per_folder = []
            folder_list = []
            for i in np.arange(item_number):
                if i % 2 == 0:
                    folder_list.append(self.tableau.selectedItems()[i].text())
                else:
                    sample_number_per_folder.append(int(self.tableau.selectedItems()[i].text()))
            self.parent().po.all['first_folder_sample_number'] = int(self.tableau.selectedItems()[1].text())

            self.parent().po.all['folder_list'] = folder_list
            self.parent().po.all['sample_number_per_folder'] = sample_number_per_folder
            self.parent().po.update_folder_id(self.parent().po.all['first_folder_sample_number'],
                                              self.parent().po.all['folder_list'][0])
            self.thread_dict["LoadFirstFolderIfSeveral"].start()
            self.thread_dict["LoadFirstFolderIfSeveral"].message_when_thread_finished.connect(self.first_folder_loaded)

previous_is_clicked()

Handles the logic for when a "Previous" button is clicked in the interface, leading to the FirstWindow.

It modifies internal state to force the decision between IfSeveralFoldersWindow and ImageAnalysisWindow to be done once again if the user clicks on the "Next" button of the FirstWindow.

Source code in src/cellects/gui/if_several_folders_window.py 
176
177
178
179
180
181
182
183
184
185
def previous_is_clicked(self):
    """
    Handles the logic for when a "Previous" button is clicked in the interface, leading to the FirstWindow.

    It modifies internal state to force the decision between IfSeveralFoldersWindow and ImageAnalysisWindow to be
    done once again if the user clicks on the "Next" button of the FirstWindow.
    """
    self.next_clicked_once = False
    self.parent().firstwindow.instantiate = True
    self.parent().change_widget(0)

true_init()

Initialize the IfSeveralFoldersWindow with UI components and settings.

Extended Description

This method sets up the user interface for the IfSeveralFoldersWindow, including labels, a table widget for folders and sample sizes, checkboxes, buttons for video analysis and running tasks directly, and navigation buttons for previous and next steps. The window supports multiple folder selection and provides a means to control the analysis process.

Notes

This method assumes that the parent widget has a 'po' attribute with specific settings and variables.

Source code in src/cellects/gui/if_several_folders_window.py 
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
def true_init(self):
    """
    Initialize the IfSeveralFoldersWindow with UI components and settings.

    Extended Description
    --------------------
    This method sets up the user interface for the IfSeveralFoldersWindow,
    including labels, a table widget for folders and sample sizes, checkboxes,
    buttons for video analysis and running tasks directly, and navigation
    buttons for previous and next steps. The window supports multiple folder
    selection and provides a means to control the analysis process.

    Notes
    -----
    This method assumes that the parent widget has a 'po' attribute with specific settings and variables.
    """
    logging.info("Initialize IfSeveralFoldersWindow")
    self.thread_dict = {}
    self.thread_dict["LoadFirstFolderIfSeveral"] = LoadFirstFolderIfSeveralThread(self.parent())
    self.next_clicked_once:bool = False
    self.layout = QtWidgets.QVBoxLayout()

    self.title_label = FixedText('Select folders to analyze', police=30, night_mode=self.parent().po.all['night_mode'])
    self.title_label.setAlignment(QtCore.Qt.AlignHCenter)
    self.layout.addWidget(self.title_label)
    self.layout.addItem(QtWidgets.QSpacerItem(1, 1, QtWidgets.QSizePolicy.Maximum, QtWidgets.QSizePolicy.MinimumExpanding))

    # 1) add a check box allowing to select every folders
    self.cb_layout = QtWidgets.QHBoxLayout()
    self.cb_widget = QtWidgets.QWidget()
    self.cb_label = FixedText(MF["Check_to_select_all_folders"]["label"] + ':', tip=MF["Check_to_select_all_folders"]["tips"], night_mode=self.parent().po.all['night_mode'])
    self.cb = QtWidgets.QCheckBox()
    self.cb.setChecked(True)
    self.cb.clicked.connect(self.checked)
    self.cb_layout.addWidget(self.cb_label)
    self.cb_layout.addWidget(self.cb)
    self.cb_layout.addItem(QtWidgets.QSpacerItem(1, 1, QtWidgets.QSizePolicy.MinimumExpanding, QtWidgets.QSizePolicy.Maximum))
    self.cb_widget.setLayout(self.cb_layout)
    self.layout.addWidget(self.cb_widget)

    # 2) Create a folder list and sample number per folder
    self.tableau = QtWidgets.QTableWidget()  # Scroll Area which contains the widgets, set as the centralWidget
    self.tableau.setColumnCount(2)
    self.tableau.setRowCount(len(self.parent().po.all['folder_list']))
    self.tableau.setHorizontalHeaderLabels(['Folders', 'Sample size'])
    self.parent().po.all['sample_number_per_folder'] = np.repeat(int(self.parent().po.all['first_folder_sample_number']), self.parent().po.all['folder_number']).tolist()

    for i, folder in enumerate(self.parent().po.all['folder_list']):
        self.tableau.setItem(i, 0, QtWidgets.QTableWidgetItem(folder))
        self.tableau.setItem(i, 1, QtWidgets.QTableWidgetItem(str(self.parent().po.all['sample_number_per_folder'][i])))
    self.tableau.horizontalHeader().setSectionResizeMode(0, QtWidgets.QHeaderView.ResizeToContents)
    self.tableau.horizontalHeader().setSectionResizeMode(1, QtWidgets.QHeaderView.ResizeToContents)
    self.tableau.setSelectionBehavior(QtWidgets.QAbstractItemView.SelectRows)
    self.tableau.selectAll()
    self.tableau.itemSelectionChanged.connect(self.item_selection_changed)

    self.tableau.setShowGrid(False)
    self.tableau.setSizePolicy(QtWidgets.QSizePolicy.Expanding, QtWidgets.QSizePolicy.Minimum)
    self.tableau.setVerticalScrollBarPolicy(QtCore.Qt.ScrollBarAsNeeded)
    self.tableau.horizontalHeader().hide()
    self.tableau.verticalHeader().hide()
    self.layout.addWidget(self.tableau)

    # Create the shortcuts row
    self.shortcuts_widget = QtWidgets.QWidget()
    self.shortcuts_layout = QtWidgets.QHBoxLayout()
    self.Video_analysis_window = PButton("Video tracking window", night_mode=self.parent().po.all['night_mode'])
    self.Video_analysis_window.clicked.connect(self.Video_analysis_window_is_clicked)
    self.Run_all_directly = PButton("Run all directly", tip=VAW["Run_All"]["tips"],
                                    night_mode=self.parent().po.all['night_mode'])
    self.Run_all_directly.clicked.connect(self.Run_all_directly_is_clicked)
    self.Video_analysis_window.setVisible(False)
    self.Run_all_directly.setVisible(False)
    self.shortcuts_layout.addItem(QtWidgets.QSpacerItem(1, 1, QtWidgets.QSizePolicy.Maximum, QtWidgets.QSizePolicy.MinimumExpanding))
    self.shortcuts_layout.addWidget(self.Video_analysis_window)
    self.shortcuts_layout.addWidget(self.Run_all_directly)
    self.shortcuts_widget.setLayout(self.shortcuts_layout)
    self.layout.addWidget(self.shortcuts_widget)

    # 3) Previous button
    self.last_row_layout = QtWidgets.QHBoxLayout()
    self.last_row_widget = QtWidgets.QWidget()
    self.previous = PButton('Previous', night_mode=self.parent().po.all['night_mode'])
    self.previous.clicked.connect(self.previous_is_clicked)

    # 4) Message
    self.message = QtWidgets.QLabel(self)
    self.message.setText('')
    self.message.setStyleSheet("color: rgb(230, 145, 18)")
    self.message.setAlignment(QtCore.Qt.AlignRight)

    # 5) Next button
    self.next = PButton('Next', night_mode=self.parent().po.all['night_mode'])
    self.next.clicked.connect(self.next_is_clicked)
    self.last_row_layout.addWidget(self.previous)
    self.last_row_layout.addItem(QtWidgets.QSpacerItem(1, 1, QtWidgets.QSizePolicy.MinimumExpanding, QtWidgets.QSizePolicy.Maximum))
    self.last_row_layout.addWidget(self.message)
    self.last_row_layout.addWidget(self.next)
    self.last_row_widget.setLayout(self.last_row_layout)
    self.layout.addItem(QtWidgets.QSpacerItem(1, 1, QtWidgets.QSizePolicy.Maximum, QtWidgets.QSizePolicy.MinimumExpanding))
    self.layout.addWidget(self.last_row_widget)
    self.setLayout(self.layout)