channeldataview.cpp

Go to the documentation of this file.

//=============================================================================================================
 
//=============================================================================================================
// INCLUDES
//=============================================================================================================
 
#include "channeldataview.h"
#include "helpers/channeldatamodel.h"
#include "helpers/channellabelpanel.h"
#include "helpers/channelrhiview.h"
#include "helpers/timerulerwidget.h"
 
#include <fiff/fiff_info.h>
 
//=============================================================================================================
// QT INCLUDES
//=============================================================================================================
 
#include <QVBoxLayout>
#include <QHBoxLayout>
#include <QScrollBar>
#include <QToolButton>
#include <QKeyEvent>
#include <algorithm>
#include <numeric>
#include <QResizeEvent>
#include <QSettings>
#include <QLabel>
#include <QPainter>
#include <QtMath>
 
//=============================================================================================================
// USED NAMESPACES
//=============================================================================================================
 
using namespace DISPLIB;
using namespace FIFFLIB;
using namespace Eigen;
 
//=============================================================================================================
// PRIVATE HELPER WIDGET — RulerHeaderWidget
// Left-column header that spans the full height of the TimeRulerWidget (stim
// lane + time zone).  The top portion is labelled "Stim" and the bottom portion
// shows "Time" with a "mm:ss·ms" sub-label — mirroring the two zones of the ruler.
//=============================================================================================================
 
class RulerHeaderWidget : public QWidget
{
public:
    explicit RulerHeaderWidget(QWidget *parent = nullptr) : QWidget(parent)
    {
        setFixedHeight(TimeRulerWidget::kTotalH);
        setSizePolicy(QSizePolicy::Expanding, QSizePolicy::Fixed);
    }
 
    void setClockTimeFormat(bool useClock) {
        if (m_useClock == useClock) return;
        m_useClock = useClock;
        update();
    }
 
protected:
    void paintEvent(QPaintEvent *) override
    {
        QPainter p(this);
        p.setRenderHint(QPainter::TextAntialiasing, true);
 
        const int kStimH = TimeRulerWidget::kStimZoneH;
        const int kTimeH = TimeRulerWidget::kTimeZoneH;
        const int W      = width();
 
        // Time zone background (top) — matches ruler time lane
        p.fillRect(QRect(0, 0, W, kTimeH), QColor(245, 245, 247));
 
        // Stim zone background (bottom) — matches ruler stim lane
        p.fillRect(QRect(0, kTimeH, W, kStimH), QColor(238, 238, 246));
 
        // Separator between zones
        p.setPen(QPen(QColor(190, 190, 205), 1));
        p.drawLine(0, kTimeH, W - 1, kTimeH);
 
        // Right-side separator (between header and ruler)
        p.setPen(QPen(QColor(185, 185, 195), 1));
        p.drawLine(W - 1, 0, W - 1, height());
 
        // "Time" bold in upper half of the time zone (top)
        QFont tf = font();
        tf.setPointSizeF(8.0);
        tf.setBold(true);
        p.setFont(tf);
        p.setPen(QColor(60, 60, 70));
        p.drawText(QRect(0, 0, W, kTimeH / 2 + 2), Qt::AlignCenter, QStringLiteral("Time"));
 
        // Format sub-label in lower half of the time zone
        QFont subf = font();
        subf.setPointSizeF(6.5);
        p.setFont(subf);
        p.setPen(QColor(130, 130, 145));
        QString fmtLabel = m_useClock ? QStringLiteral("mm:ss\u00B7ms")
                                      : QStringLiteral("seconds");
        p.drawText(QRect(0, kTimeH / 2, W, kTimeH / 2),
                   Qt::AlignCenter, fmtLabel);
 
        // "Stim" label in the stim zone (bottom)
        QFont sf = font();
        sf.setPointSizeF(7.5);
        sf.setBold(true);
        p.setFont(sf);
        p.setPen(QColor(80, 80, 100));
        p.drawText(QRect(0, kTimeH, W, kStimH), Qt::AlignCenter, QStringLiteral("Stim"));
    }
 
private:
    bool m_useClock = false;
};
 
//=============================================================================================================
// DEFINE MEMBER METHODS
//=============================================================================================================
 
ChannelDataView::ChannelDataView(const QString &sSettingsPath,
                                 QWidget *parent,
                                 Qt::WindowFlags f)
    : AbstractView(parent, f)
    , m_sSettingsPath(sSettingsPath)
    , m_pModel(new ChannelDataModel(this))
{
    setupLayout();
    loadSettings();
}
 
//=============================================================================================================
 
ChannelDataView::~ChannelDataView()
{
    saveSettings();
}
 
//=============================================================================================================
 
void ChannelDataView::setupLayout()
{
    auto *outerLayout = new QVBoxLayout(this);
    outerLayout->setContentsMargins(0, 0, 0, 0);
    outerLayout->setSpacing(0);
 
    // ── Render area ──────────────────────────────────────────────────────
    // Layout:
    //   renderRow (HBox)
    //     leftCol  (VBox): [stimHdr(22px) | timeHdr(28px) | labelPanel   ]
    //     traceCol (VBox): [stimStrip(22px) | ruler(28px) | rhiView(flex)]
    //     rightCol (VBox): [spacer(22px) | scrollModeBtn(28px) | chanSB   ]
 
    auto *renderRow = new QHBoxLayout();
    renderRow->setContentsMargins(0, 0, 0, 0);
    renderRow->setSpacing(0);
 
    // ── Left column ───────────────────────────────────────────────────────
    auto *leftCol = new QVBoxLayout();
    leftCol->setContentsMargins(0, 0, 0, 0);
    leftCol->setSpacing(0);
 
    // Combined header spanning the full ruler height (stim + time zones)
    m_pRulerHeader = new RulerHeaderWidget(this);
    leftCol->addWidget(m_pRulerHeader, 0);
 
    m_pLabelPanel = new ChannelLabelPanel(this);
    leftCol->addWidget(m_pLabelPanel, 1);
 
    renderRow->addLayout(leftCol, 0);
 
    // ── Centre column: unified ruler (stim+time) + RHI view ──────────────
    auto *traceColumn = new QVBoxLayout();
    traceColumn->setContentsMargins(0, 0, 0, 0);
    traceColumn->setSpacing(0);
 
    m_pTimeRuler = new TimeRulerWidget(this);
    traceColumn->addWidget(m_pTimeRuler, 0);
 
    m_pRhiView = new ChannelRhiView(this);
    m_pRhiView->setModel(m_pModel.data());
    m_pRhiView->setBackgroundColor(m_bgColor);
    m_pRhiView->setSizePolicy(QSizePolicy::Expanding, QSizePolicy::Expanding);
    m_pRhiView->setFocusPolicy(Qt::ClickFocus);
    traceColumn->addWidget(m_pRhiView, 1);
 
    renderRow->addLayout(traceColumn, 1);
 
    // ── Right column: spacer (ruler height) + channel scrollbar ─────────
    auto *rightCol = new QVBoxLayout();
    rightCol->setContentsMargins(0, 0, 0, 0);
    rightCol->setSpacing(0);
 
    // Spacer that aligns with the ruler height so the channel scrollbar
    // starts exactly where the channel area begins.
    auto *rulerSpacer = new QWidget(this);
    rulerSpacer->setFixedHeight(TimeRulerWidget::kTotalH);
    rulerSpacer->setVisible(true);
    rightCol->addWidget(rulerSpacer, 0);
 
    m_pChannelScrollBar = new QScrollBar(Qt::Vertical, this);
    m_pChannelScrollBar->setMinimum(0);
    m_pChannelScrollBar->setMaximum(0);
    m_pChannelScrollBar->setValue(0);
    m_pChannelScrollBar->setSingleStep(1);
    m_pChannelScrollBar->setPageStep(12);
    m_pChannelScrollBar->setSizePolicy(QSizePolicy::Fixed, QSizePolicy::Expanding);
    rightCol->addWidget(m_pChannelScrollBar, 1);
 
    renderRow->addLayout(rightCol, 0);
 
    outerLayout->addLayout(renderRow, 1);
 
    // ── Overview bar (minimap) ───────────────────────────────────────────
    m_pOverviewBar = new OverviewBarWidget(this);
    m_pOverviewBar->setModel(m_pModel.data());
    outerLayout->addWidget(m_pOverviewBar, 0);
 
    // ── Bottom row: horizontal scroll bar + scroll-mode toggle ───────────
    // The scroll-mode button lives at the bottom-right corner, between the
    // horizontal and vertical scrollbars, so it doesn't crowd the ruler area.
    auto *bottomRow = new QHBoxLayout();
    bottomRow->setContentsMargins(0, 0, 0, 0);
    bottomRow->setSpacing(0);
 
    m_pScrollBar = new QScrollBar(Qt::Horizontal, this);
    m_pScrollBar->setMinimum(0);
    m_pScrollBar->setMaximum(0);
    m_pScrollBar->setValue(0);
    m_pScrollBar->setSingleStep(1);
    m_pScrollBar->setPageStep(100);
    m_pScrollBar->setSizePolicy(QSizePolicy::Expanding, QSizePolicy::Fixed);
    bottomRow->addWidget(m_pScrollBar, 1);
 
    m_pScrollModeButton = new QToolButton(this);
    m_pScrollModeButton->setCheckable(true);
    m_pScrollModeButton->setChecked(true);  // default: ↕ = channels
    m_pScrollModeButton->setText(QStringLiteral("\u2195 Ch"));
    m_pScrollModeButton->setToolTip(QStringLiteral(
        "Vertical mouse wheel:\n"
        "\u2195 Ch  \u2013 scroll through channels\n"
        "\u21c4 Time \u2013 scroll through time"));
    bottomRow->addWidget(m_pScrollModeButton, 0);
 
    outerLayout->addLayout(bottomRow, 0);
 
    // ── Connections ──────────────────────────────────────────────────────
    connect(m_pScrollBar, &QScrollBar::valueChanged,
            this, &ChannelDataView::onScrollBarMoved);
 
    connect(m_pChannelScrollBar, &QScrollBar::valueChanged,
            this, &ChannelDataView::onChannelScrollBarMoved);
 
    connect(m_pRhiView, &ChannelRhiView::scrollSampleChanged,
            this, &ChannelDataView::onRhiScrollChanged);
 
    connect(m_pRhiView, &ChannelRhiView::channelOffsetChanged,
            this, &ChannelDataView::onChannelOffsetChanged);
 
    connect(m_pLabelPanel, &ChannelLabelPanel::channelScrollRequested,
            m_pRhiView, &ChannelRhiView::setFirstVisibleChannel);
 
    connect(m_pRhiView, &ChannelRhiView::channelOffsetChanged,
            m_pLabelPanel, &ChannelLabelPanel::setFirstVisibleChannel);
 
    connect(m_pScrollModeButton, &QToolButton::toggled, this, [this](bool checked) {
        // checked = ↕ channels mode; unchecked = ⟷ time mode
        m_pRhiView->setWheelScrollsChannels(checked);
        m_pScrollModeButton->setText(checked ? QStringLiteral("\u2195 Ch")
                                             : QStringLiteral("\u21c4 Time"));
    });
 
    connect(m_pRhiView, &ChannelRhiView::sampleClicked,
            this, &ChannelDataView::sampleClicked);
 
    connect(m_pRhiView, &ChannelRhiView::sampleRangeSelected,
            this, &ChannelDataView::sampleRangeSelected);
 
    connect(m_pRhiView, &ChannelRhiView::annotationBoundaryMoved,
            this, &ChannelDataView::annotationBoundaryMoved);
 
    // Forward crosshair cursor data to ChannelDataView consumers
    connect(m_pRhiView, &ChannelRhiView::cursorDataChanged,
            this, &ChannelDataView::cursorDataChanged);
 
    connect(m_pRhiView, &ChannelRhiView::scrollSampleChanged,
            m_pTimeRuler, &TimeRulerWidget::setScrollSample);
 
    connect(m_pRhiView, &ChannelRhiView::samplesPerPixelChanged,
            m_pTimeRuler, &TimeRulerWidget::setSamplesPerPixel);
 
    connect(m_pTimeRuler, &TimeRulerWidget::addReferenceMarkerRequested,
            this, &ChannelDataView::referenceMarkerAddRequested);
    connect(m_pTimeRuler, &TimeRulerWidget::removeReferenceMarkerRequested,
            this, &ChannelDataView::referenceMarkerRemoveRequested);
    connect(m_pTimeRuler, &TimeRulerWidget::clearReferenceMarkersRequested,
            this, &ChannelDataView::referenceMarkersClearRequested);
 
    // Recompute samples-per-pixel when the RHI view itself is resized so the
    // time window stays constant regardless of the widget's pixel width.
    connect(m_pRhiView, &ChannelRhiView::viewResized,
            this, [this](int, int) { updateSamplesPerPixel(); });
 
    connect(m_pModel.data(), &ChannelDataModel::dataChanged,
            this, &ChannelDataView::updateScrollBarRange);
 
    connect(m_pModel.data(), &ChannelDataModel::metaChanged,
            this, &ChannelDataView::updateChannelScrollBarRange);
 
    // Keep label panel in sync with model changes so status pills update immediately.
    connect(m_pModel.data(), &ChannelDataModel::metaChanged,
            m_pLabelPanel, QOverload<>::of(&QWidget::update));
    connect(m_pModel.data(), &ChannelDataModel::dataChanged,
            m_pLabelPanel, QOverload<>::of(&QWidget::update));
 
    // Feed current visible sample window to the label panel for the RMS level bar.
    connect(m_pRhiView, &ChannelRhiView::scrollSampleChanged,
            this, [this](float sample) {
                if (m_pLabelPanel && m_pRhiView) {
                    m_pLabelPanel->setVisibleSampleRange(
                        static_cast<int>(sample),
                        static_cast<int>(sample) + m_pRhiView->visibleSampleCount());
                }
            });
 
    // ── Overview bar connections ─────────────────────────────────────────
    // Keep viewport indicator in sync with scroll/zoom changes.
    connect(m_pRhiView, &ChannelRhiView::scrollSampleChanged,
            this, [this](float sample) {
                if (m_pOverviewBar && m_pRhiView) {
                    m_pOverviewBar->setViewport(
                        sample,
                        static_cast<float>(m_pRhiView->visibleSampleCount()));
                }
            });
    connect(m_pRhiView, &ChannelRhiView::samplesPerPixelChanged,
            this, [this](float) {
                if (m_pOverviewBar && m_pRhiView) {
                    m_pOverviewBar->setViewport(
                        m_pRhiView->scrollSample(),
                        static_cast<float>(m_pRhiView->visibleSampleCount()));
                }
            });
    // Rebuild envelope when data changes.
    connect(m_pModel.data(), &ChannelDataModel::dataChanged,
            this, [this]() {
                if (m_pOverviewBar) {
                    m_pOverviewBar->setModel(m_pModel.data());
                }
            });
    // Click/drag on overview bar → navigate.
    connect(m_pOverviewBar, &OverviewBarWidget::scrollRequested,
            this, [this](float targetSample) {
                if (m_pRhiView)
                    m_pRhiView->scrollTo(targetSample, 150);
            });
 
    setFocusProxy(m_pRhiView);
    setFocusPolicy(Qt::StrongFocus);
}
 
//=============================================================================================================
 
void ChannelDataView::init(QSharedPointer<FiffInfo> pInfo)
{
    m_pFiffInfo = pInfo;
    m_pModel->init(pInfo);
 
    // Re-apply scale map and colour after re-init
    if (!m_scaleMap.isEmpty())
        m_pModel->setScaleMap(m_scaleMap);
    m_pModel->setSignalColor(m_signalColor);
 
    if (pInfo) {
        if (m_pTimeRuler)
            m_pTimeRuler->setSfreq(pInfo->sfreq);
        if (m_pRhiView)
            m_pRhiView->setSfreq(static_cast<float>(pInfo->sfreq));
        if (m_pOverviewBar)
            m_pOverviewBar->setSfreq(static_cast<float>(pInfo->sfreq));
    }
 
    if (m_pLabelPanel) {
        m_pLabelPanel->setModel(m_pModel.data());
        m_pLabelPanel->setVisibleChannelCount(m_pRhiView ? m_pRhiView->visibleChannelCount() : 12);
    }
 
    updateSamplesPerPixel();
    updateScrollBarRange();
    updateChannelScrollBarRange();
}
 
//=============================================================================================================
 
void ChannelDataView::setFileBounds(int first, int last)
{
    m_firstFileSample = first;
    m_lastFileSample  = last;
    if (m_pRhiView) {
        m_pRhiView->setFirstFileSample(first);
        m_pRhiView->setLastFileSample(last);
    }
    if (m_pTimeRuler)
        m_pTimeRuler->setFirstFileSample(first);
    if (m_pOverviewBar) {
        m_pOverviewBar->setFirstFileSample(first);
        m_pOverviewBar->setLastFileSample(last);
    }
    updateScrollBarRange();
}
 
//=============================================================================================================
 
void ChannelDataView::setData(const MatrixXd &data, int firstSample)
{
    m_pModel->setData(data, firstSample);
    updateScrollBarRange();
}
 
//=============================================================================================================
 
void ChannelDataView::addData(const MatrixXd &data)
{
    m_pModel->appendData(data);
    updateScrollBarRange();
}
 
//=============================================================================================================
 
void ChannelDataView::scrollToSample(int sample, bool animate)
{
    m_pRhiView->scrollTo(static_cast<float>(sample), animate ? 200 : 0);
}
 
//=============================================================================================================
 
void ChannelDataView::setWindowSize(float seconds)
{
    m_windowSizeSeconds = qMax(seconds, 0.01f);
    updateSamplesPerPixel();
    saveSettings();
}
 
//=============================================================================================================
 
float ChannelDataView::windowSize() const
{
    return m_windowSizeSeconds;
}
 
//=============================================================================================================
 
void ChannelDataView::setZoom(double factor)
{
    m_zoomFactor = qMax(factor, 0.001);
    updateSamplesPerPixel();
    saveSettings();
}
 
//=============================================================================================================
 
double ChannelDataView::zoom() const
{
    return m_zoomFactor;
}
 
//=============================================================================================================
 
void ChannelDataView::setBackgroundColor(const QColor &color)
{
    m_bgColor = color;
    if (m_pRhiView)
        m_pRhiView->setBackgroundColor(color);
    saveSettings();
}
 
//=============================================================================================================
 
QColor ChannelDataView::backgroundColor() const
{
    return m_bgColor;
}
 
//=============================================================================================================
 
void ChannelDataView::setSignalColor(const QColor &color)
{
    m_signalColor = color;
    m_pModel->setSignalColor(color);
    saveSettings();
}
 
//=============================================================================================================
 
QColor ChannelDataView::signalColor() const
{
    return m_signalColor;
}
 
//=============================================================================================================
 
void ChannelDataView::setScalingMap(const QMap<qint32, float> &scaleMap)
{
    m_scaleMap = scaleMap;
    m_pModel->setScaleMap(scaleMap);
}
 
//=============================================================================================================
 
QMap<qint32, float> ChannelDataView::scalingMap() const
{
    return m_scaleMap;
}
 
//=============================================================================================================
 
void ChannelDataView::hideBadChannels(bool hide)
{
    m_hideBadChannels = hide;
    if (m_pRhiView)
        m_pRhiView->setHideBadChannels(hide);
    if (m_pLabelPanel)
        m_pLabelPanel->setHideBadChannels(hide);
    updateChannelScrollBarRange();
}
 
//=============================================================================================================
 
bool ChannelDataView::badChannelsHidden() const
{
    return m_hideBadChannels;
}
 
//=============================================================================================================
 
void ChannelDataView::setChannelFilter(const QStringList &names)
{
    QVector<int> indices;
    if (!names.isEmpty() && m_pModel) {
        int total = m_pModel->channelCount();
        for (int i = 0; i < total; ++i) {
            const ChannelDisplayInfo info = m_pModel->channelInfo(i);
            if (info.isVirtualChannel || names.contains(info.name))
                indices.append(i);
        }
    }
 
    if (m_pRhiView)
        m_pRhiView->setChannelIndices(indices);
    if (m_pLabelPanel)
        m_pLabelPanel->setChannelIndices(indices);
 
    // Reset scroll to start of filtered set and update scrollbar range
    updateChannelScrollBarRange();
}
 
//=============================================================================================================
 
void ChannelDataView::setRemoveDC(bool dc)
{
    m_pModel->setRemoveDC(dc);
}
 
//=============================================================================================================
 
void ChannelDataView::setDetrendMode(DetrendMode mode)
{
    m_pModel->setDetrendMode(mode);
}
 
//=============================================================================================================
 
DetrendMode ChannelDataView::detrendMode() const
{
    return m_pModel->detrendMode();
}
 
//=============================================================================================================
 
void ChannelDataView::setEvents(const QVector<ChannelRhiView::EventMarker> &events)
{
    if (m_pRhiView)
        m_pRhiView->setEvents(events);
 
    if (m_pOverviewBar)
        m_pOverviewBar->setEvents(events);
 
    if (m_pTimeRuler) {
        QVector<TimeRulerEventMark> rulerMarks;
        rulerMarks.reserve(events.size());
        for (const auto &ev : events)
            rulerMarks.append({ev.sample, ev.color, ev.label});
        m_pTimeRuler->setEvents(rulerMarks);
    }
}
 
//=============================================================================================================
 
void ChannelDataView::setEpochMarkers(const QVector<int> &triggerSamples)
{
    if (m_pRhiView)
        m_pRhiView->setEpochMarkers(triggerSamples);
}
 
void ChannelDataView::setEpochMarkersVisible(bool visible)
{
    if (m_pRhiView)
        m_pRhiView->setEpochMarkersVisible(visible);
}
 
bool ChannelDataView::epochMarkersVisible() const
{
    return m_pRhiView ? m_pRhiView->epochMarkersVisible() : false;
}
 
void ChannelDataView::setClippingVisible(bool visible)
{
    if (m_pRhiView)
        m_pRhiView->setClippingVisible(visible);
}
 
bool ChannelDataView::clippingVisible() const
{
    return m_pRhiView ? m_pRhiView->clippingVisible() : false;
}
 
void ChannelDataView::setZScoreMode(bool enabled)
{
    if (m_pRhiView)
        m_pRhiView->setZScoreMode(enabled);
}
 
bool ChannelDataView::zScoreMode() const
{
    return m_pRhiView ? m_pRhiView->zScoreMode() : false;
}
 
//=============================================================================================================
 
void ChannelDataView::setReferenceMarkers(const QVector<TimeRulerReferenceMark> &markers)
{
    if (m_pTimeRuler)
        m_pTimeRuler->setReferenceMarkers(markers);
}
 
//=============================================================================================================
 
void ChannelDataView::setAnnotations(const QVector<ChannelRhiView::AnnotationSpan> &annotations)
{
    if (m_pRhiView)
        m_pRhiView->setAnnotations(annotations);
    if (m_pOverviewBar)
        m_pOverviewBar->setAnnotations(annotations);
}
 
//=============================================================================================================
 
void ChannelDataView::setAnnotationSelectionEnabled(bool enabled)
{
    if (m_pRhiView)
        m_pRhiView->setAnnotationSelectionEnabled(enabled);
}
 
//=============================================================================================================
 
void ChannelDataView::setEventsVisible(bool visible)
{
    if (m_pRhiView)
        m_pRhiView->setEventsVisible(visible);
}
 
bool ChannelDataView::eventsVisible() const
{
    return m_pRhiView ? m_pRhiView->eventsVisible() : true;
}
 
//=============================================================================================================
 
void ChannelDataView::setAnnotationsVisible(bool visible)
{
    if (m_pRhiView)
        m_pRhiView->setAnnotationsVisible(visible);
}
 
bool ChannelDataView::annotationsVisible() const
{
    return m_pRhiView ? m_pRhiView->annotationsVisible() : true;
}
 
//=============================================================================================================
 
void ChannelDataView::setOverviewBarVisible(bool visible)
{
    if (m_pOverviewBar)
        m_pOverviewBar->setVisible(visible);
}
 
bool ChannelDataView::overviewBarVisible() const
{
    return m_pOverviewBar ? m_pOverviewBar->isVisible() : true;
}
 
//=============================================================================================================
 
void ChannelDataView::setScrollSpeedFactor(float factor)
{
    if (m_pRhiView)
        m_pRhiView->setScrollSpeedFactor(factor);
}
 
float ChannelDataView::scrollSpeedFactor() const
{
    return m_pRhiView ? m_pRhiView->scrollSpeedFactor() : 1.0f;
}
 
//=============================================================================================================
 
void ChannelDataView::sortChannelsByType()
{
    if (!m_pModel)
        return;
 
    // Define a canonical type ordering
    static const QStringList typeOrder = {
        "MEG grad", "MEG mag", "EEG", "EOG", "ECG", "EMG", "STIM", "MISC"
    };
 
    const int n = m_pModel->channelCount();
    QVector<int> indices(n);
    std::iota(indices.begin(), indices.end(), 0);
 
    std::stable_sort(indices.begin(), indices.end(), [&](int a, int b) {
        int ia = typeOrder.indexOf(m_pModel->channelInfo(a).typeLabel);
        int ib = typeOrder.indexOf(m_pModel->channelInfo(b).typeLabel);
        if (ia < 0) ia = typeOrder.size();
        if (ib < 0) ib = typeOrder.size();
        return ia < ib;
    });
 
    if (m_pRhiView)
        m_pRhiView->setChannelIndices(indices);
    if (m_pLabelPanel)
        m_pLabelPanel->setChannelIndices(indices);
    updateChannelScrollBarRange();
}
 
void ChannelDataView::resetChannelOrder()
{
    if (m_pRhiView)
        m_pRhiView->setChannelIndices({});
    if (m_pLabelPanel)
        m_pLabelPanel->setChannelIndices({});
    updateChannelScrollBarRange();
}
 
//=============================================================================================================
 
void ChannelDataView::setCrosshairEnabled(bool enabled)
{
    if (m_pRhiView)
        m_pRhiView->setCrosshairEnabled(enabled);
}
 
bool ChannelDataView::crosshairEnabled() const
{
    return m_pRhiView ? m_pRhiView->crosshairEnabled() : false;
}
 
//=============================================================================================================
 
void ChannelDataView::setScalebarsVisible(bool visible)
{
    if (m_pRhiView)
        m_pRhiView->setScalebarsVisible(visible);
}
 
bool ChannelDataView::scalebarsVisible() const
{
    return m_pRhiView ? m_pRhiView->scalebarsVisible() : false;
}
 
//=============================================================================================================
 
void ChannelDataView::setButterflyMode(bool enabled)
{
    if (m_pRhiView)
        m_pRhiView->setButterflyMode(enabled);
    if (m_pLabelPanel)
        m_pLabelPanel->setButterflyMode(enabled);
}
 
bool ChannelDataView::butterflyMode() const
{
    return m_pRhiView ? m_pRhiView->butterflyMode() : false;
}
 
//=============================================================================================================
 
void ChannelDataView::toggleTimeFormat()
{
    if (m_pTimeRuler)
        m_pTimeRuler->toggleTimeFormat();
    bool useClock = m_pTimeRuler ? m_pTimeRuler->clockTimeFormat() : false;
    if (m_pRhiView)
        m_pRhiView->setClockTimeFormat(useClock);
    if (m_pRulerHeader)
        static_cast<RulerHeaderWidget*>(m_pRulerHeader)->setClockTimeFormat(useClock);
}
 
void ChannelDataView::setClockTimeFormat(bool useClock)
{
    if (m_pTimeRuler)
        m_pTimeRuler->setClockTimeFormat(useClock);
    if (m_pRhiView)
        m_pRhiView->setClockTimeFormat(useClock);
    if (m_pRulerHeader)
        static_cast<RulerHeaderWidget*>(m_pRulerHeader)->setClockTimeFormat(useClock);
}
 
bool ChannelDataView::clockTimeFormat() const
{
    return m_pTimeRuler ? m_pTimeRuler->clockTimeFormat() : false;
}
 
//=============================================================================================================
 
int ChannelDataView::firstVisibleSample() const
{
    return m_pRhiView ? m_pRhiView->visibleFirstSample() : 0;
}
 
//=============================================================================================================
 
int ChannelDataView::visibleSampleCount() const
{
    return m_pRhiView ? m_pRhiView->visibleSampleCount() : 0;
}
 
//=============================================================================================================
 
QRect ChannelDataView::signalViewportRect() const
{
    return m_pRhiView ? m_pRhiView->geometry() : QRect();
}
 
//=============================================================================================================
 
int ChannelDataView::sampleToViewportX(int sample) const
{
    const QRect viewportRect = signalViewportRect();
    const int visibleSamples = qMax(1, visibleSampleCount());
 
    if(viewportRect.width() <= 0) {
        return viewportRect.left();
    }
 
    const double samplesPerPixel = static_cast<double>(visibleSamples)
                                 / static_cast<double>(viewportRect.width());
    const double xOffset = static_cast<double>(sample - firstVisibleSample()) / samplesPerPixel;
 
    return viewportRect.left()
           + qBound(0, qRound(xOffset), viewportRect.width() - 1);
}
 
//=============================================================================================================
 
int ChannelDataView::viewportXToSample(int x) const
{
    const QRect viewportRect = signalViewportRect();
    const int visibleSamples = qMax(1, visibleSampleCount());
 
    if(viewportRect.width() <= 0) {
        return firstVisibleSample();
    }
 
    const int clampedX = qBound(viewportRect.left(), x, viewportRect.right());
    const double samplesPerPixel = static_cast<double>(visibleSamples)
                                 / static_cast<double>(viewportRect.width());
 
    return firstVisibleSample()
           + qRound(static_cast<double>(clampedX - viewportRect.left()) * samplesPerPixel);
}
 
//=============================================================================================================
 
void ChannelDataView::saveSettings()
{
    if (m_sSettingsPath.isEmpty())
        return;
    QSettings s;
    s.setValue(m_sSettingsPath + "/windowSizeSeconds", m_windowSizeSeconds);
    s.setValue(m_sSettingsPath + "/zoomFactor",        m_zoomFactor);
    s.setValue(m_sSettingsPath + "/backgroundColor",   m_bgColor);
    s.setValue(m_sSettingsPath + "/signalColor",       m_signalColor);
}
 
//=============================================================================================================
 
void ChannelDataView::loadSettings()
{
    if (m_sSettingsPath.isEmpty())
        return;
    QSettings s;
    float rawWindowSec  = s.value(m_sSettingsPath + "/windowSizeSeconds", 10.f).toFloat();
    m_windowSizeSeconds = qBound(0.5f, rawWindowSec, 120.f);
    // Remove stale out-of-range value so next session starts clean.
    if (rawWindowSec != m_windowSizeSeconds)
        s.remove(m_sSettingsPath + "/windowSizeSeconds");
 
    m_zoomFactor  = s.value(m_sSettingsPath + "/zoomFactor",        1.0).toDouble();
    m_bgColor     = s.value(m_sSettingsPath + "/backgroundColor",   QColor(250, 250, 250)).value<QColor>();
    m_signalColor = s.value(m_sSettingsPath + "/signalColor",       QColor(Qt::darkGreen)).value<QColor>();
 
    // Propagate loaded colors to the sub-views (they may have been created
    // with defaults in setupLayout() before loadSettings() ran).
    if (m_pRhiView)
        m_pRhiView->setBackgroundColor(m_bgColor);
    if (m_pModel)
        m_pModel->setSignalColor(m_signalColor);
}
 
//=============================================================================================================
 
void ChannelDataView::clearView()
{
    m_pModel->clearData();
    if (m_pScrollBar) {
        m_pScrollBar->setMaximum(0);
        m_pScrollBar->setValue(0);
    }
    if (m_pRhiView)
        m_pRhiView->setScrollSample(0.f);
    if (m_pTimeRuler) {
        m_pTimeRuler->setFirstFileSample(0);
        m_pTimeRuler->setScrollSample(0.f);
        m_pTimeRuler->setReferenceMarkers({});
    }
}
 
//=============================================================================================================
 
void ChannelDataView::updateGuiMode(GuiMode /*mode*/) {}
 
void ChannelDataView::updateProcessingMode(ProcessingMode /*mode*/) {}
 
//=============================================================================================================
 
void ChannelDataView::keyPressEvent(QKeyEvent *event)
{
    if (!m_pRhiView) {
        QWidget::keyPressEvent(event);
        return;
    }
 
    float step = m_pRhiView->visibleSampleCount() * 0.1f;
    float page = m_pRhiView->visibleSampleCount() * 0.9f;
 
    switch (event->key()) {
    case Qt::Key_Left:
        m_pRhiView->scrollTo(m_pRhiView->scrollSample() - step, 150);
        break;
    case Qt::Key_Right:
        m_pRhiView->scrollTo(m_pRhiView->scrollSample() + step, 150);
        break;
    case Qt::Key_PageUp:
        m_pRhiView->scrollTo(m_pRhiView->scrollSample() - page, 200);
        break;
    case Qt::Key_PageDown:
        m_pRhiView->scrollTo(m_pRhiView->scrollSample() + page, 200);
        break;
    case Qt::Key_Home:
        m_pRhiView->scrollTo(static_cast<float>(m_pModel->firstSample()), 300);
        break;
    case Qt::Key_End:
        {
            float lastStart = static_cast<float>(
                m_pModel->firstSample() + m_pModel->totalSamples()
                - m_pRhiView->visibleSampleCount());
            m_pRhiView->scrollTo(qMax(lastStart, 0.f), 300);
        }
        break;
    case Qt::Key_Plus:
    case Qt::Key_Equal:
        m_pRhiView->zoomTo(m_pRhiView->samplesPerPixel() * 0.75f, 200);
        break;
    case Qt::Key_Minus:
        m_pRhiView->zoomTo(m_pRhiView->samplesPerPixel() * 1.33f, 200);
        break;
    case Qt::Key_B:
        setButterflyMode(!butterflyMode());
        emit butterflyToggled(butterflyMode());
        break;
    case Qt::Key_D:
        if (m_pModel) {
            // Cycle: None → Mean → Linear → None
            switch (m_pModel->detrendMode()) {
            case DetrendMode::None:   m_pModel->setDetrendMode(DetrendMode::Mean);   break;
            case DetrendMode::Mean:   m_pModel->setDetrendMode(DetrendMode::Linear); break;
            case DetrendMode::Linear: m_pModel->setDetrendMode(DetrendMode::None);   break;
            }
        }
        break;
    case Qt::Key_S:
        setScalebarsVisible(!scalebarsVisible());
        emit scalebarsToggled(scalebarsVisible());
        break;
    case Qt::Key_X:
        setCrosshairEnabled(!crosshairEnabled());
        emit crosshairToggled(crosshairEnabled());
        break;
    case Qt::Key_E:
        setEventsVisible(!eventsVisible());
        emit eventsVisibleToggled(eventsVisible());
        break;
    case Qt::Key_G:
        setEpochMarkersVisible(!epochMarkersVisible());
        emit epochMarkersToggled(epochMarkersVisible());
        break;
    case Qt::Key_C:
        setClippingVisible(!clippingVisible());
        emit clippingToggled(clippingVisible());
        break;
    case Qt::Key_Z:
        setZScoreMode(!zScoreMode());
        emit zScoreModeToggled(zScoreMode());
        break;
    case Qt::Key_A:
        if (event->modifiers() & Qt::ShiftModifier) {
            setAnnotationsVisible(!annotationsVisible());
            emit annotationsVisibleToggled(annotationsVisible());
        } else {
            QWidget::keyPressEvent(event);
            return;
        }
        break;
    case Qt::Key_O:
        setOverviewBarVisible(!overviewBarVisible());
        emit overviewBarToggled(overviewBarVisible());
        break;
    case Qt::Key_BracketRight:
        setScrollSpeedFactor(scrollSpeedFactor() * 1.5f);
        emit scrollSpeedChanged(scrollSpeedFactor());
        break;
    case Qt::Key_BracketLeft:
        setScrollSpeedFactor(scrollSpeedFactor() / 1.5f);
        emit scrollSpeedChanged(scrollSpeedFactor());
        break;
    case Qt::Key_T:
        toggleTimeFormat();
        break;
    default:
        QWidget::keyPressEvent(event);
        return;
    }
    event->accept();
}
 
//=============================================================================================================
 
void ChannelDataView::resizeEvent(QResizeEvent *event)
{
    AbstractView::resizeEvent(event);
    updateSamplesPerPixel();
    updateScrollBarRange();
}
 
//=============================================================================================================
 
void ChannelDataView::onScrollBarMoved(int value)
{
    if (m_scrollBarUpdating || !m_pRhiView)
        return;
    m_pRhiView->setScrollSample(static_cast<float>(value));
}
 
//=============================================================================================================
 
void ChannelDataView::onRhiScrollChanged(float sample)
{
    emit scrollPositionChanged(static_cast<int>(sample));
 
    if (!m_pScrollBar)
        return;
 
    m_scrollBarUpdating = true;
    m_pScrollBar->setValue(static_cast<int>(sample));
    m_scrollBarUpdating = false;
}
 
//=============================================================================================================
 
void ChannelDataView::updateScrollBarRange()
{
    if (!m_pScrollBar || !m_pRhiView)
        return;
 
    int visible = m_pRhiView->visibleSampleCount();
    int minVal, maxVal;
 
    if (m_firstFileSample >= 0 && m_lastFileSample >= 0) {
        // File bounds known: allow scrolling across the whole file
        minVal = m_firstFileSample;
        maxVal = qMax(m_firstFileSample, m_lastFileSample - visible + 1);
    } else {
        // Fall back to ring-buffer bounds
        int firstSamp = m_pModel->firstSample();
        int total     = m_pModel->totalSamples();
        minVal = firstSamp;
        maxVal = qMax(firstSamp, firstSamp + total - visible);
    }
 
    m_scrollBarUpdating = true;
    m_pScrollBar->setMinimum(minVal);
    m_pScrollBar->setMaximum(maxVal);
    m_pScrollBar->setPageStep(visible);
    m_scrollBarUpdating = false;
}
 
//=============================================================================================================
 
void ChannelDataView::updateSamplesPerPixel()
{
    if (!m_pRhiView || !m_pFiffInfo)
        return;
 
    float sfreq   = static_cast<float>(m_pFiffInfo->sfreq);
    int   viewPx  = m_pRhiView->width();
    if (viewPx <= 0)
        return;
 
    // samples per pixel = (window_duration × sample_rate) / viewport_width / zoom
    float spp = (m_windowSizeSeconds * sfreq) / viewPx / static_cast<float>(m_zoomFactor);
    m_pRhiView->setSamplesPerPixel(qMax(spp, 1e-4f));
    updateScrollBarRange();
}
 
//=============================================================================================================
 
void ChannelDataView::onChannelScrollBarMoved(int value)
{
    if (m_channelScrollBarUpdating || !m_pRhiView)
        return;
    m_pRhiView->setFirstVisibleChannel(value);
}
 
//=============================================================================================================
 
void ChannelDataView::onChannelOffsetChanged(int firstChannel)
{
    if (!m_pChannelScrollBar)
        return;
    m_channelScrollBarUpdating = true;
    m_pChannelScrollBar->setValue(firstChannel);
    m_channelScrollBarUpdating = false;
}
 
//=============================================================================================================
 
void ChannelDataView::updateChannelScrollBarRange()
{
    if (!m_pChannelScrollBar || !m_pRhiView)
        return;
 
    // Use the view's logical channel count (respects active filter)
    int totalCh    = m_pRhiView ? m_pRhiView->totalLogicalChannels()
                                : m_pModel->channelCount();
    int visibleCnt = m_pRhiView->visibleChannelCount();
    int maxVal     = qMax(0, totalCh - visibleCnt);
 
    m_channelScrollBarUpdating = true;
    m_pChannelScrollBar->setMaximum(maxVal);
    m_pChannelScrollBar->setPageStep(visibleCnt);
    m_channelScrollBarUpdating = false;
}