Skip to content

visualdynamics.gui.settings_panel

settings_panel

What every settings panel is built from.

Six panels — averaging, filter, truncate, wavelet, rigid body, octave — wore the same chrome (the grid, the fixed width, the bold title) and listed their derived readings with the same loop, each with its own copy (2026-09-12). The copies live here once; each panel keeps what is its own: the rows, the readings, the button.

Functions:

Name Description
panel_grid

The panel's grid with the title across its first row, the panel
add_derived

The read-only rows under the editable ones: a greyed name and a

Functions:

panel_grid 

panel_grid(panel: QWidget, title: QLabel) -> QGridLayout

The panel's grid with the title across its first row, the panel fixed at PANEL_WIDTH and never stretched taller than it asks.

Source code in src/visualdynamics/gui/settings_panel.py 
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
def panel_grid(panel: QWidget, title: QLabel) -> QGridLayout:
    """The panel's grid with the title across its first row, the panel
    fixed at `PANEL_WIDTH` and never stretched taller than it asks."""
    grid = QGridLayout(panel)
    grid.setContentsMargins(8, 8, 8, 8)
    grid.setHorizontalSpacing(8)
    grid.setVerticalSpacing(4)
    panel.setSizePolicy(QSizePolicy.Policy.Fixed,
                        QSizePolicy.Policy.Preferred)
    panel.setFixedWidth(PANEL_WIDTH)
    font = title.font()
    font.setBold(True)
    title.setFont(font)
    grid.addWidget(title, 0, 0, 1, 2)
    return grid

add_derived 

add_derived(
    grid: QGridLayout, derived, first_row: int
) -> dict[str, tuple[QLabel, QLabel]]

The read-only rows under the editable ones: a greyed name and a right-aligned value per (key, label), from first_row down. Returns key → (name label, value label).

Source code in src/visualdynamics/gui/settings_panel.py 
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
def add_derived(grid: QGridLayout, derived, first_row: int
                ) -> dict[str, tuple[QLabel, QLabel]]:
    """The read-only rows under the editable ones: a greyed name and a
    right-aligned value per `(key, label)`, from `first_row` down.
    Returns key → (name label, value label)."""
    made = {}
    for offset, (key, label) in enumerate(derived):
        name = QLabel(label)
        name.setEnabled(False)
        value = QLabel('—')
        value.setAlignment(Qt.AlignmentFlag.AlignRight
                           | Qt.AlignmentFlag.AlignVCenter)
        grid.addWidget(name, first_row + offset, 0)
        grid.addWidget(value, first_row + offset, 1)
        made[key] = (name, value)
    return made