You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/WWPGD_PROJECTION_DOSE.md
+10-4Lines changed: 10 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,12 @@
1
1
# WW-PGD projection dose telemetry
2
2
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.
4
10
5
11
## Realized dose
6
12
@@ -21,7 +27,7 @@ This is an observed dose. It is not `blend_eta`, requested hardness, or a config
21
27
22
28
## Scheduled event indexing
23
29
24
-
`projection_event` is zero-based. Rows also include:
30
+
Within the main scientific runner, `projection_event` is zero-based. Rows also include:
25
31
26
32
-`projection_event_index_base = 0`
27
33
-`projection_event_number = projection_event + 1`
@@ -36,8 +42,8 @@ Actual applications are counted independently for each `layer_name` from the dur
36
42
-`layer_application_index`: one-based application count for an applied row; empty when no dose was applied
37
43
-`is_first_applied_projection`: true exactly when `layer_application_index == 1`
38
44
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.
40
46
41
47
## Compatibility
42
48
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