spacr.qt.screens.volcano

Volcano Explorer — open a finished regression and inspect its volcano plot.

A regression run leaves a volcano PDF. That file shows what was significant. It does not show which guide a point is, colour points by compartment, confirm that the axis label matches the correction applied, or export a vector figure at a chosen size.

This screen opens a results folder (or a single results CSV) and hands it to spacr.qt.widgets.volcano_explorer.VolcanoExplorer, which draws the plot through the same renderer the pipeline used – so the plot on screen is the pipeline’s plot, not an approximation.

It is deliberately a reader. It runs no analysis and writes nothing back into the results folder; exports go wherever the user chooses. That means it can be pointed at a finished run, including one produced months ago on another machine, without any risk to it.

Functions

find_results_table(path)

Return the results CSV to plot for path, or None.

load_results(path)

Read a results CSV and keep only the primary support family.

Module Contents

spacr.qt.screens.volcano.find_results_table(path)[source]

Return the results CSV to plot for path, or None.

Accepts the CSV itself, a regression output folder, or a parent folder holding one.

Parameters:

path – a results CSV, a regression output folder, or a folder searched recursively for one; ~ is expanded.

spacr.qt.screens.volcano.load_results(path)[source]

Read a results CSV and keep only the primary support family.

A long permutation table holds every minimum-support family stacked, so plotting it unfiltered draws each guide once per family – the same point two to four times, at different heights, which reads as extra hits.

Nested helpers

_make_screen.VolcanoScreen.__init__(self, host=None)

Build the screen. host is the window, NOT a Qt parent.

Handing it to QWidget.__init__ raises, because the registry’s host is not always a QWidget.

spacr/qt/screens/volcano.py:136

_make_screen.VolcanoScreen._open(self) → None

Ask for a results folder and load it.

spacr/qt/screens/volcano.py:170

_make_screen.VolcanoScreen.dragEnterEvent(self, event)

Accept a drag that carries paths.

spacr/qt/screens/volcano.py:177

_make_screen.VolcanoScreen.dropEvent(self, event)

Load the first dropped folder that holds results.

spacr/qt/screens/volcano.py:182

_make_screen.VolcanoScreen.load(self, path) → bool

Load a results folder. Returns whether one was found.

spacr/qt/screens/volcano.py:159