NK NUCLEAR EXPLOSION STRUCTURAL PIPELINE
========================================

Folder Structure
----------------

delta_ladders/
    Generated ΔA structural ladders.

sac_raw/
    Raw SAC waveform datasets for:
        • 2006 NK test
        • 2009 NK test
        • 2013 NK test

struc_perc_output/
    STRUC_PERC admissibility/percolation outputs.

sac_to_csv.py
    SAC → CSV batch conversion utility.

SAC_TO_CSV_USAGE.txt
    Usage instructions for SAC conversion pipeline.

------------------------------------------------------------
PIPELINE
------------------------------------------------------------

STEP 1 — SAC → CSV
------------------

Convert all SAC waveform traces into CSV format.

Run:

    python sac_to_csv.py sac_raw

or:

    python sac_to_csv.py .

depending on dataset location.

Outputs:
    *.csv waveform files

------------------------------------------------------------

STEP 2 — CSV → DELTA LADDERS
----------------------------

Generate ΔA structural ladders from waveform amplitudes.

Transformation:

    ΔA(i) = A(i+1) - A(i)

Outputs stored in:

    delta_ladders/

------------------------------------------------------------

STEP 3 — STRUC_PERC
-------------------

Run STRUC_PERC on generated ladders.

Outputs stored in:

    struc_perc_output/

------------------------------------------------------------

STEP 4 — STRUCTURAL ANALYSIS
----------------------------

Inspect:

    • admissibility class
    • giant component persistence
    • fragmentation behavior
    • tail dominance
    • station coherence
    • cross-event persistence

------------------------------------------------------------
PRIMARY OBSERVABLE
------------------------------------------------------------

Primary observable:

    ΔA seismic waveform transitions

derived from:

    broadband vertical seismic traces (BHZ).

------------------------------------------------------------
DATASET CONTENT
------------------------------------------------------------

The corpus contains waveform traces from:

    • 2006 North Korea nuclear test
    • 2009 North Korea nuclear test
    • 2013 North Korea nuclear test

across multiple stations.

Typical stations include:

    • BJT
    • HIA
    • MDJ
    • SSE
    • MAJO
    • YSS
    • JNU
    • TSK

------------------------------------------------------------
EXPECTED STRUCTURAL OUTPUTS
------------------------------------------------------------

Typical structural regimes:

    • GIANT_COMPONENT_PERCOLATION
    • TAIL_FRAGMENTATION
    • FULL_PERCOLATION

with:

    • strong giant persistence
    • extreme tail dominance
    • stable waveform coherence

------------------------------------------------------------
KEY STRUCTURAL OBSERVATION
------------------------------------------------------------

The NK explosion corpus revealed:

    coherence and fragmentation can coexist simultaneously.

This produces:

    globally coherent
    but tail-fragmenting
    admissibility structure.

------------------------------------------------------------
IMPORTANT STATIONS
------------------------------------------------------------

MDJ station became especially significant because:

    all three NK events
        →
    strong TAIL_FRAGMENTATION persistence

with near-maximal tail dominance.

This suggests:

    directional admissibility deformation
    and propagation-sensitive structural coupling.

------------------------------------------------------------
COMPARISON ROLE
------------------------------------------------------------

This branch is compared against:

    • South Sandwich tectonics
    • Nevada local rupture
    • SN Ia admissibility saturation
    • Voyager transition migration
    • CERN interaction topology

------------------------------------------------------------
STRUCTURAL CLASS
------------------------------------------------------------

Current interpreted class:

    forced coherent collapse

------------------------------------------------------------
END
------------------------------------------------------------