specbox.qtmodule

Package

class specbox.qtmodule.PGSpecPlot(*args: Any, **kwargs: Any)

Bases: PlotWidget

Interactive spectrum viewer based on pyqtgraph.

This widget was originally developed for Euclid SIR 1D spectra but has been generalized to handle any spectrum class derived from ConvenientSpecMixin (e.g. SpecEuclid1d, SpecLAMOST).

coordinate_changed

alias of float

update_slider_and_spin()

slider_changed(slider_value)

spin_changed(z)

plot_single()

update_spectrum_info_label()

Update the spectrum info label above the plot.

plot_next()

plot_previous()

keyPressEvent(event)

class specbox.qtmodule.PGSpecPlotApp(*args: Any, **kwargs: Any)

Bases: QApplication

Standalone application running PGSpecPlot.

make_layout()

keyPressEvent(event)

mousePressEvent(event)

save_dict_todf()

class specbox.qtmodule.PGSpecPlotThread(*args: Any, **kwargs: Any)

Bases: QThread

Run PGSpecPlotApp in a separate thread.

run()

class specbox.qtmodule.PGSpecPlotThreadFeLo(*args: Any, **kwargs: Any)

Bases: QThread

run()

class specbox.qtmodule.PGSpecPlotEnhanced(*args: Any, **kwargs: Any)

Bases: PlotWidget

Enhanced version of PGSpecPlot with image cutouts and template switching.

coordinate_changed

alias of float

record_committed

alias of object

update_slider_and_spin()

slider_changed(slider_value)

spin_changed(z_value)

plot_single(preserve_view=False)

Plot the spectrum without template.

update_spectrum_info_label()

Update the spectrum info label above the plot.

plot_template()

Plot template with current redshift.

plot_next()

Plot next spectrum.

plot_previous()

Plot previous spectrum.

jump_to_spectrum(index_one_based)

Jump directly to a spectrum by 1-based index.

change_template(template_name)

Change current template.

keyPressEvent(event)

Handle keyboard events.

class specbox.qtmodule.PGSpecPlotAppEnhanced(*args: Any, **kwargs: Any)

Bases: QApplication

Enhanced standalone application with image cutouts and template switching.

on_coordinate_changed(ra, dec)

Handle coordinate changes and pass object ID to cutout widget.

on_current_spec_changed()

on_record_committed(objid)

sync_qa_checkbox_from_current_spec()

Restore QA checkboxes from current spec/history.

on_qa_flag_changed(_state)

Persist QA flag from checkbox selections into current spec/history.

on_review_panel_qa_changed(qa_flag)

on_review_notes_changed(text)

on_review_reviewer_changed(text)

start_background_prefetch()

Start background prefetching of cutouts for upcoming spectra.

on_downsample_toggled(checked)

make_layout()

Create the enhanced layout with image cutouts and controls.

keyPressEvent(event)

Forward keyboard events to plot widget.

go_to_index()

mousePressEvent(event)

Forward mouse events to plot widget.

save_data()

Save current data to CSV.

save_png()

Save the entire application window as a PNG image.

save_and_quit()

Save data and quit application.

toggle_image_panel()

Toggle visibility of the image cutout panel.

run_cross_correlation()

Run cross-correlation analysis - placeholder.

save_dict_todf()

Save classification results to CSV.

class specbox.qtmodule.PGSpecPlotThreadEnhanced(*args: Any, **kwargs: Any)

Bases: QThread

Enhanced thread wrapper for the enhanced application.

run()

class specbox.qtmodule.ImageCutoutWidget(*args: Any, **kwargs: Any)

Bases: QWidget

Widget for displaying astronomical image cutouts.

QA_CONTAMINATION_BIT = 1

QA_UNUSABLE_BIT = 2

setup_ui()

Module: qtmodule

class specbox.qtmodule.qtmodule.PGSpecPlot(*args: Any, **kwargs: Any)

Bases: PlotWidget

Interactive spectrum viewer based on pyqtgraph.

This widget was originally developed for Euclid SIR 1D spectra but has been generalized to handle any spectrum class derived from ConvenientSpecMixin (e.g. SpecEuclid1d, SpecLAMOST).

coordinate_changed

alias of float

update_slider_and_spin()

slider_changed(slider_value)

spin_changed(z)

plot_single()

update_spectrum_info_label()

Update the spectrum info label above the plot.

plot_next()

plot_previous()

keyPressEvent(event)

class specbox.qtmodule.qtmodule.PGSpecPlotApp(*args: Any, **kwargs: Any)

Bases: QApplication

Standalone application running PGSpecPlot.

make_layout()

keyPressEvent(event)

mousePressEvent(event)

save_dict_todf()

class specbox.qtmodule.qtmodule.PGSpecPlotThread(*args: Any, **kwargs: Any)

Bases: QThread

Run PGSpecPlotApp in a separate thread.

run()

Module: qtmodule_enhanced

specbox.qtmodule.qtmodule_enhanced.normalize_class_label(value)

specbox.qtmodule.qtmodule_enhanced.display_class_label(value)

specbox.qtmodule.qtmodule_enhanced.default_reviewer_username()

specbox.qtmodule.qtmodule_enhanced.normalize_data_release(value, *, aimsz_review=False)

specbox.qtmodule.qtmodule_enhanced.load_template_table(template_path)

class specbox.qtmodule.qtmodule_enhanced.ImageCutoutWidget(*args: Any, **kwargs: Any)

Bases: QWidget

Widget for displaying astronomical image cutouts.

QA_CONTAMINATION_BIT = 1

QA_UNUSABLE_BIT = 2

setup_ui()

class specbox.qtmodule.qtmodule_enhanced.AIMSZReviewPanel(*args: Any, **kwargs: Any)

Bases: QWidget

Read-only review context plus reviewer-editable fields for AIMS-z.

qa_flag_changed

alias of int

notes_changed

alias of str

reviewer_changed

alias of str

hide_notes_editor()

set_default_reviewer(reviewer)

set_review_context(spec, record=None)

get_qa_flag()

set_qa_flag(qa_flag)

load_online_cutouts(ra, dec, objid=None)

Load cutouts from HiPS2FITS service for given coordinates.

add_image_from_pil(pil_image, label='')

Add PIL image directly to display (for JPEG format).

add_image_from_array(data, label='')

Add image from numpy array to display.

add_image_from_rgb_array(rgb_data, label='')

Add RGB image from numpy array (for JPEG format).

create_composite_image(ra, dec, size_arcsec)

Create RGB composite from multiple bands.

add_image_from_fits(fits_path, label='')

Add FITS image to display.

add_image_from_file(file_path)

Add image from file (FITS or regular image formats).

add_image_widget(pixmap, label='')

Add image widget to layout.

add_status_message(message)

Add status message to display.

remove_widget(widget)

Remove widget from layout.

clear_images()

Clear all displayed images.

get_cache_filename(objid, survey_name)

Get cache filename for an object and survey.

save_cutout_to_cache(objid, survey_name, image_data)

Save cutout image to cache.

load_cutout_from_cache(objid, survey_name)

Load cutout from cache if exists.

prefetch_cutouts_background(spectrum_list, current_index, num_prefetch=None)

Prefetch cutouts for upcoming spectra in the background.

class specbox.qtmodule.qtmodule_enhanced.TemplateManager

Bases: object

Manages spectrum templates.

load_default_templates()

Load default templates.

get_template(template_name)

Get template by name.

get_available_templates()

Get list of available template names.

add_template(name, wave, flux, description='')

Add new template.

class specbox.qtmodule.qtmodule_enhanced.PGSpecPlotEnhanced(*args: Any, **kwargs: Any)

Bases: PlotWidget

Enhanced version of PGSpecPlot with image cutouts and template switching.

coordinate_changed

alias of float

record_committed

alias of object

update_slider_and_spin()

slider_changed(slider_value)

spin_changed(z_value)

plot_single(preserve_view=False)

Plot the spectrum without template.

update_spectrum_info_label()

Update the spectrum info label above the plot.

plot_template()

Plot template with current redshift.

plot_next()

Plot next spectrum.

plot_previous()

Plot previous spectrum.

jump_to_spectrum(index_one_based)

Jump directly to a spectrum by 1-based index.

change_template(template_name)

Change current template.

keyPressEvent(event)

Handle keyboard events.

class specbox.qtmodule.qtmodule_enhanced.PGSpecPlotAppEnhanced(*args: Any, **kwargs: Any)

Bases: QApplication

Enhanced standalone application with image cutouts and template switching.

on_coordinate_changed(ra, dec)

Handle coordinate changes and pass object ID to cutout widget.

on_current_spec_changed()

on_record_committed(objid)

sync_qa_checkbox_from_current_spec()

Restore QA checkboxes from current spec/history.

on_qa_flag_changed(_state)

Persist QA flag from checkbox selections into current spec/history.

on_review_panel_qa_changed(qa_flag)

on_review_notes_changed(text)

on_review_reviewer_changed(text)

start_background_prefetch()

Start background prefetching of cutouts for upcoming spectra.

on_downsample_toggled(checked)

make_layout()

Create the enhanced layout with image cutouts and controls.

keyPressEvent(event)

Forward keyboard events to plot widget.

go_to_index()

mousePressEvent(event)

Forward mouse events to plot widget.

save_data()

Save current data to CSV.

save_png()

Save the entire application window as a PNG image.

save_and_quit()

Save data and quit application.

toggle_image_panel()

Toggle visibility of the image cutout panel.

run_cross_correlation()

Run cross-correlation analysis - placeholder.

save_dict_todf()

Save classification results to CSV.

class specbox.qtmodule.qtmodule_enhanced.PGSpecPlotThreadEnhanced(*args: Any, **kwargs: Any)

Bases: QThread

Enhanced thread wrapper for the enhanced application.

run()

Module: qtfelo

class specbox.qtmodule.qtfelo.PGSpecPlotFeLo(*args: Any, **kwargs: Any)

Bases: PlotWidget

Plot widget for plotting spectra using pyqtgraph.

plot_single()

plot_next()

plot_previous()

keyPressEvent(event)

class specbox.qtmodule.qtfelo.PGSpecPlotAppFeLo(*args: Any, **kwargs: Any)

Bases: QApplication

mousePressEvent(event)

save_dict_todf()

make_layout()

keyPressEvent(event)

class specbox.qtmodule.qtfelo.PGSpecPlotThreadFeLo(*args: Any, **kwargs: Any)

Bases: QThread

run()

Module: qtsir1d

Backward compatibility module.

The functionality of the original qtsir1d viewer has been merged into qtmodule. This file simply re-exports the public classes so that existing imports continue to work.

class specbox.qtmodule.qtsir1d.PGSpecPlot(*args: Any, **kwargs: Any)

Bases: PlotWidget

Interactive spectrum viewer based on pyqtgraph.

This widget was originally developed for Euclid SIR 1D spectra but has been generalized to handle any spectrum class derived from ConvenientSpecMixin (e.g. SpecEuclid1d, SpecLAMOST).

coordinate_changed

alias of float

update_slider_and_spin()

slider_changed(slider_value)

spin_changed(z)

plot_single()

update_spectrum_info_label()

Update the spectrum info label above the plot.

plot_next()

plot_previous()

keyPressEvent(event)

class specbox.qtmodule.qtsir1d.PGSpecPlotApp(*args: Any, **kwargs: Any)

Bases: QApplication

Standalone application running PGSpecPlot.

make_layout()

keyPressEvent(event)

mousePressEvent(event)

save_dict_todf()

class specbox.qtmodule.qtsir1d.PGSpecPlotThread(*args: Any, **kwargs: Any)

Bases: QThread

Run PGSpecPlotApp in a separate thread.

run()