badc.aggregate

Detection aggregation utilities.

Functions

load_detections(root[, manifest])	Load detection JSON payloads under root.
parquet_report(parquet_path, *[, ...])	Summarize canonical detections using DuckDB.
quicklook_metrics(parquet_path, *[, ...])	Return multi-table summary metrics from the canonical Parquet export.
summarize_parquet(parquet_path, *[, group_by])	Return aggregated metrics from the Parquet detections file.
write_parquet(records, out_path)	Persist detection records to Parquet via DuckDB.
write_summary_csv(records, out_path)	Write detection records to out_path in CSV form.

Classes

DetectionRecord(recording_id, chunk_id, ...)	Normalized detection entry used for CSV summaries.
ParquetReport(labels, recordings, timeline, ...)	Structured summary produced by parquet_report().
QuicklookReport(top_labels, top_recordings, ...)	Convenience container for DuckDB quicklook metrics.