Skip to content

Commit 397066b

Browse files
Clarify scientific projection telemetry scope
1 parent 141f77c commit 397066b

1 file changed

Lines changed: 10 additions & 4 deletions

File tree

docs/WWPGD_PROJECTION_DOSE.md

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,12 @@
11
# WW-PGD projection dose telemetry
22

3-
Projection rows report the realized intervention size and distinguish scheduled events from actual per-layer applications.
3+
The main scientific runner’s `wwpgd_projection.csv` rows report the realized intervention size and distinguish scheduled events from actual per-layer applications.
4+
5+
## Scope
6+
7+
This schema is applied by the shared durable artifact writer used by `run_scientific_single`. It covers the scientific Level 0–2 WW-PGD, delayed-onset, adaptive, and norm-matched-sham arms that write the root experiment artifact `wwpgd_projection.csv`.
8+
9+
It does not silently redefine the separate invalid-for-science `run_single` smoke artifact or the isolated `level_0_wwpgd` package’s independent projection schema. Those paths have different lifecycle contracts and require separate schema changes if they are ever promoted to scientific evidence.
410

511
## Realized dose
612

@@ -21,7 +27,7 @@ This is an observed dose. It is not `blend_eta`, requested hardness, or a config
2127

2228
## Scheduled event indexing
2329

24-
`projection_event` is zero-based. Rows also include:
30+
Within the main scientific runner, `projection_event` is zero-based. Rows also include:
2531

2632
- `projection_event_index_base = 0`
2733
- `projection_event_number = projection_event + 1`
@@ -36,8 +42,8 @@ Actual applications are counted independently for each `layer_name` from the dur
3642
- `layer_application_index`: one-based application count for an applied row; empty when no dose was applied
3743
- `is_first_applied_projection`: true exactly when `layer_application_index == 1`
3844

39-
The count is reconstructed from the committed projection-row history before every append. It therefore remains correct after checkpoint resume or process restart without adding process-local counters to the optimizer, controller, model, or checkpoint state.
45+
The count is reconstructed from the durable projection-row history before every append. Checkpoint recovery first reconciles the CSV to its committed prefix, so the count remains correct after resume or process restart without adding process-local counters to the optimizer, controller, model, or checkpoint state.
4046

4147
## Compatibility
4248

43-
These fields extend the projection CSV schema but do not change model weights, optimizer state, projection mathematics, spectral targets, or defaults. An incomplete run created with an older projection CSV header is rejected before append; start a fresh run under the new schema instead.
49+
These fields extend the main scientific projection CSV schema but do not change model weights, optimizer state, projection mathematics, spectral targets, or defaults. An incomplete scientific run created with an older projection CSV header is rejected before append; start a fresh run under the new schema instead.

0 commit comments

Comments
 (0)