Skip to content

visualdynamics.gui.octave_panel

octave_panel

The octave-band parameters, as a table beside the spectrum.

One number is set here — bands per octave — and the conversion it means is previewed over the narrowband data it will be made from: the banded steps drawn on the same axes, so the trade (legibility against resolution) is read on the spectrum being banded, not imagined. Principle 13's four parts: the reading on the bar, these settings, that preview, and the Apply button below.

Nothing here computes anything final. The button runs the same compute_octave verb a script calls, with whatever spacing is set at that moment.

Classes:

Name Description
OctavePanel

The parameter table. Edits arrive as bands per octave.

Classes

OctavePanel 

OctavePanel(parent: QWidget | None = None)

Bases: QWidget

The parameter table. Edits arrive as bands per octave.

Methods:

Name Description
per_octave

The spacing the editor currently describes.
show_bands

Say how many bands the preview came out as — or a dash when
Source code in src/visualdynamics/gui/octave_panel.py 
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
def __init__(self, parent: QWidget | None = None) -> None:
    super().__init__(parent)
    self.title: QLabel = QLabel('Octave Bands')
    grid = panel_grid(self, self.title)

    self.per_box: QComboBox = QComboBox()
    for n in CHOICES:
        self.per_box.addItem(
            'full octave' if n == 1 else f'1/{n} octave', n)
    self.per_box.setCurrentIndex(CHOICES.index(PER_OCTAVE))
    self.per_box.setToolTip(
        'Band spacing. A sixth of an octave is the usual reading; '
        'a third and a whole octave are both ordinary. Each band '
        'takes the mean-square content that falls in it, so the '
        'RMS carried is unchanged whatever the spacing')
    grid.addWidget(QLabel('Spacing'), 1, 0)
    grid.addWidget(self.per_box, 1, 1)

    rule = QFrame()
    rule.setFrameShape(QFrame.Shape.HLine)
    rule.setFrameShadow(QFrame.Shadow.Sunken)
    grid.addWidget(rule, 2, 0, 1, 2)

    # what follows from the one, shown so the trade is visible
    # while it is being made
    self.derived: dict[str, QLabel] = {}
    derived = (('bands', 'Bands'), ('grid', 'Grid'))
    for key, (_name, value) in add_derived(grid, derived,
                                           3).items():
        self.derived[key] = value
    # the grid is absolute and base ten, and saying so here is what
    # makes "two runs land on the same bands" checkable at a glance
    self.derived['grid'].setText('ANSI S1.11, base 10')

    self.apply_button: QPushButton = QPushButton('Apply Octave Bands')
    self.apply_button.setToolTip(
        'Make the banded spectrum — exactly the steps previewed '
        'over the narrowband — beside this one')
    self.apply_button.clicked.connect(self.apply_asked.emit)
    grid.addWidget(self.apply_button, 5, 0, 1, 2)
    grid.setRowStretch(6, 1)

    self.per_box.currentIndexChanged.connect(
        lambda _index: self.changed.emit(self.per_octave()))
Methods:
per_octave 
per_octave() -> int

The spacing the editor currently describes.

Source code in src/visualdynamics/gui/octave_panel.py 
84
85
86
def per_octave(self) -> int:
    """The spacing the editor currently describes."""
    return int(self.per_box.currentData())
show_bands 
show_bands(count: int | None) -> None

Say how many bands the preview came out as — or a dash when the spectrum refuses (too narrow for even one band).

Source code in src/visualdynamics/gui/octave_panel.py 
88
89
90
91
92
def show_bands(self, count: int | None) -> None:
    """Say how many bands the preview came out as — or a dash when
    the spectrum refuses (too narrow for even one band)."""
    self.derived['bands'].setText('—' if count is None
                                  else str(count))

Functions: