sage.plotting.prediction_raw

Filename : prediction.py Description : Short description of the file

Created on 2026-03-21 17:26:02

__author__ = Narenraju Nagarajan __copyright__ = Copyright 2026, ProjectName __license__ = MIT Licence __version__ = 0.0.1 __maintainer__ = Narenraju Nagarajan __affiliation__ = N/A __email__ = N/A __status__ = [‘inProgress’, ‘Archived’, ‘inUsage’, ‘Debugging’]

GitHub Repository: NULL

Documentation: NULL

Functions

plot_prediction_raw(epoch, ranking_stat, labels[, ...])

Plot raw ranking-statistic distributions and a FAR-efficiency sweep.

Module Contents

plot_prediction_raw(epoch, ranking_stat, labels, export_dir=None, save=True)[source]

Plot raw ranking-statistic distributions and a FAR-efficiency sweep.

Produces two panels: (1) overlapping histograms of the raw ranking statistic for signal and noise events, and (2) a detection-efficiency- vs-threshold curve that shows the signal fraction recovered as a function of the noise false-alarm rate.

Parameters:

  • epoch (int or str) – Epoch identifier for the title and filename.

  • ranking_stat (array-like, shape (N,)) – Network ranking statistics for all validation events.

  • labels (array-like, shape (N,)) – Binary ground-truth labels (1 = signal, 0 = noise).

  • export_dir (str or None) – Output directory (saved under PRED_RAW/).

  • save (bool) – If True, save to disk; otherwise display interactively.