# NORMALIZATION_REVIEW_INDEX.txt
# STELLAR_BOUNDARY_DYNAMICS_I
# Phase C — Alpha Normalization Review

PHASE:
C_spectral_time_series

STAGE:
alpha_application / normalization_review

PURPOSE:
Review the first-pass Phase C alpha-application outputs before using Phase C
5D vectors for B–C or A–B–C bridge comparison.

This stage protects the pipeline from over-interpreting raw spectral deformation
vectors when one response channel or one object dominates the numerical scale.

WHY THIS REVIEW EXISTS:
Phase C uses real WISeREP public spectral time-series data converted into
spectral line-window ladders.

The current Phase C chain is:

raw WISeREP spectra
→ spectral line-window ladder CSV
→ STRUC-PERC-I canonical input CSV
→ numeric STRUC-PERC-I ladder TXT
→ STRUC-PERC-I batch result
→ alpha-application grid
→ first-pass 5D vector

The first-pass alpha output shows that C2_SN2012aw is numerically extreme in
the raw v1 vector scale. Therefore, normalization review is mandatory before
any cross-domain comparison.

INPUTS:
../grids/C1_SN1993J_alpha_grid.csv
../grids/C2_SN2012aw_alpha_grid.csv

../summaries/C_5D_VECTOR_SUMMARY.csv

REFERENCE FILES:
../../struc_perc_i/struc_perc_batch_results.csv
../../struc_perc_i/struc_perc_batch_results.json
../../struc_perc_i/summaries/C_STRUC_PERC_I_RESULTS_INTERPRETATION.txt

SCRIPT:
../../tools/c_alpha_normalization_review.py

OUTPUTS:
C_ALPHA_NORMALIZATION_REVIEW.csv
C_5D_VECTOR_SUMMARY_v2.csv
C_NORMALIZATION_REVIEW_INTERPRETATION.txt

PHASE C OBJECTS:
C1_SN1993J
C2_SN2012aw

C1 ROLE:
Contact-case spectral pilot object.

A–B CONTEXT:
SN1993J was the closest Phase B light-curve object to A2_20M in the A–B bridge.

C2 ROLE:
Outlier-case spectral pilot object.

A–B CONTEXT:
SN2012aw was the strongest outlier / special case in Phase B and remained the
most separated object in the A–B bridge context.

STRUC-PERC-I STATUS:
C1_SN1993J_numeric_ladder.txt:
FULL_PERCOLATION
κ_connect = 201.4048389456797
tailDominance = 0.5700456253569127
n = 685

C2_SN2012aw_numeric_ladder.txt:
FULL_PERCOLATION
κ_connect = 3992.353936889229
tailDominance = 0.9594287169370818
n = 198

FIRST-PASS ALPHA STATUS:
C1_SN1993J:
collapse_observed = yes
collapse_onset_radius = 0.05
admissibility_persistence ≈ 0.683698
anisotropic_persistence ≈ 4.007390

C2_SN2012aw:
collapse_observed = yes
collapse_onset_radius = 0.05
admissibility_persistence ≈ 0.667857
anisotropic_persistence is extremely large in raw v1 scale

REVIEW TASKS:
1. Detect whether any spectral response channel dominates the vector scale.

2. Compare response channel means:
   gap_response_norm
   flux_response_norm
   depth_response_norm
   equivalent_width_response_norm
   velocity_response_norm
   width_response_norm
   quality_response_norm
   transition_response_norm
   tail_pressure_proxy

3. Compute dominance ratios:
   flux_to_gap_ratio
   depth_to_gap_ratio
   equivalent_width_to_gap_ratio
   velocity_to_gap_ratio
   width_to_gap_ratio
   quality_to_gap_ratio
   transition_to_gap_ratio
   max_channel_to_gap_ratio

4. Bound anisotropic_persistence using a stable transform:
   anisotropic_persistence_bounded = anisotropic_persistence / (1 + anisotropic_persistence)

5. Add tail-aware review fields:
   tail_pressure_mean
   tail_pressure_max
   kappa_connect_reference
   tail_dominance_reference
   high_tail_attention
   high_kappa_attention

6. Recompute a comparable v2 vector summary that preserves:
   mean_GR
   var_GR
   admissibility_persistence
   collapse_onset_radius
   collapse_observed
   kappa_connect_reference
   tail_dominance_reference

7. Add review flags:
   flux_dominant
   depth_dominant
   equivalent_width_dominant
   velocity_dominant
   width_dominant
   quality_dominant
   transition_dominant
   tail_pressure_dominant
   scale_review_needed
   high_tail_attention
   high_kappa_attention

INTERPRETATION RULE:
The v1 vectors remain valid as first-pass diagnostic outputs.

The v2 vectors are the safe comparison layer for:
B–C bridge
A–C bridge
A–B–C tri-domain bridge

A scale-review flag is not a failure. It means the object should not be compared
using raw anisotropic_persistence or an unbounded dominated response channel
alone.

EXPECTED SPECIAL CASE:
C2_SN2012aw is expected to remain a high-tail/high-kappa attention object.
The review should preserve this as a structural warning, not erase it.

PHASE C SCIENTIFIC CAUTION:
Spectral line-window proxies are structural spectral features.
They are not direct elemental abundances.
They are not radiative-transfer outputs.
They are not nucleosynthesis yield measurements.

B–C BRIDGE REQUIREMENT:
Use:

C_spectral_time_series/alpha_application/normalization_review/C_5D_VECTOR_SUMMARY_v2.csv

against:

B_supernova_light_curves/alpha_application/normalization_review/B_5D_VECTOR_SUMMARY_v2.csv

A–B–C BRIDGE REQUIREMENT:
Use reviewed v2 summaries from all three phases:

A_mesa_precollapse_tracks/alpha_application/normalization_review/A_5D_VECTOR_SUMMARY_v2.csv
B_supernova_light_curves/alpha_application/normalization_review/B_5D_VECTOR_SUMMARY_v2.csv
C_spectral_time_series/alpha_application/normalization_review/C_5D_VECTOR_SUMMARY_v2.csv

Do not use raw v1 vector summaries alone for bridge claims.

NEXT SCRIPT:
../../tools/c_alpha_normalization_review.py

STATUS:
Initialized.
Ready for Phase C alpha normalization review script.
