# B_PHASE_INDEX.txt
# STELLAR_BOUNDARY_DYNAMICS_I
# Phase B — Supernova Light Curves

PHASE:
B_supernova_light_curves

PHASE_PURPOSE:
Collect observed supernova light-curve sources for constructing
STRUC_PERC_I-compatible post-collapse observable ladders.

UNNS_ROLE:
Phase B supplies observable boundary-response trajectories.
These are not pre-collapse stellar interiors. They are post-boundary
brightness-time records showing rise, peak, decline, plateau, break,
tail decay, and late relaxation.

PRIMARY_INTERPRETATION:
Supernova light curves encode the observable response after a stellar
collapse/explosion event has routed the progenitor into ejecta and remnant
basins.

SOURCE_LIST:

============================================================
SOURCE_ID:
B1

SOURCE_NAME:
Open Supernova Catalog / AstroCats

LOCAL_PATH:
B_supernova_light_curves/sources/B1_OSC_repo/

SOURCE_REPOSITORY:
https://github.com/astrocatalogs/supernovae

SOURCE_TYPE:
Supernova metadata and photometry JSON catalog

USE:
Index, metadata, classifications, aliases, references, photometry records.

FIELDS_TO_EXTRACT:
object_name
aliases
supernova_type
photometry
time
magnitude_or_flux
band
discovery_date
redshift
host
references

UNNS_ROLE:
Collapse-output curve source.
Observable boundary-response record.
Post-collapse relaxation trajectory source.

STATUS:
Archived.

============================================================
SOURCE_ID:
B2

SOURCE_NAME:
Zwicky Transient Facility Public Data Releases

SOURCE_URL:
https://www.ztf.caltech.edu/ztf-public-releases.html

SECONDARY_SOURCE:
https://registry.opendata.aws/ztf/

SOURCE_TYPE:
Bulk photometric survey data and light-curve detections

USE:
Modern light curves, filter-specific brightness records, PSF-fit photometry,
object-linked detections.

FIELDS_TO_EXTRACT:
ztf_object_id
time_mjd
filter
magnitude_or_flux
magnitude_error_or_flux_error
detection_flag
coordinates
object_id_linkage

UNNS_ROLE:
Time-resolved light-curve ladder.
Brightness relaxation curve.
Post-boundary decay, plateau, and break structure.

STATUS:
Pending.

============================================================
SOURCE_ID:
B3

SOURCE_NAME:
Transient Name Server

SOURCE_URL:
https://www.wis-tns.org/

SOURCE_TYPE:
Official transient naming and classification source

USE:
Object identity, official names, classifications, coordinates, discovery data,
redshift, host information.

FIELDS_TO_EXTRACT:
official_name
discovery_name
classification
classification_date
coordinates
redshift
host_name
reporting_group
discovery_group

UNNS_ROLE:
Object identity anchor.
Classification label.
Cross-source alignment key.

STATUS:
Pending.

============================================================

STRUC_PERC_I_LADDER_SCHEMA_TARGET:
Each supernova light curve should eventually be canonicalized into rows with:

ladder_id
source_id
object_name
supernova_type
stage_index
phase_name
time_mjd
time_since_peak
band
brightness_value
brightness_error
slope_local
curvature_local
transition_marker
boundary_role
unns_interpretation

CANONICAL_LIGHT_CURVE_STAGES:
pre_discovery_or_baseline
rise
peak
early_decline
plateau_or_shoulder
break
tail_decay
late_relaxation

PHASE_B_STATUS:
B1 archived.
B2 pending.
B3 pending.