spacr.qt.screens.volcano

Volcano Explorer — open a finished regression and interrogate its plot.

A regression run leaves a volcano PDF. That file answers “what was significant” and nothing else: which guide is that dot, what would it look like coloured by compartment, does the axis label match the correction that was actually applied, and can I have it as a vector figure at the size the journal asked for.

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 what is on screen is the plot, not a preview of it.

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)

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

Accepts the CSV itself, a regression output folder, or a parent holding one – the three things a user actually has to hand when they want to look at a volcano again.

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)

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:138

_make_screen.VolcanoScreen._open(self) → None

Ask for a results folder and load it.

spacr/qt/screens/volcano.py:172

_make_screen.VolcanoScreen.dragEnterEvent(self, event)

Accept a drag that carries paths.

spacr/qt/screens/volcano.py:179

_make_screen.VolcanoScreen.dropEvent(self, event)

Load the first dropped folder that holds results.

spacr/qt/screens/volcano.py:184

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

Load a results folder. Returns whether one was found.

spacr/qt/screens/volcano.py:161