int_driver_isolation_lap_panel

Driver isolation step 0: the clean-lap panel Ω and the field-centred isolated time.

Part of the Skill family.

Driver isolation step 0: the clean-lap panel Ω and the field-centred isolated time. One row per Ω lap: correction_weight 1, anomaly_class normal/clean_cliff, dry, not rain, not an out- or in-lap, a known tyre (compound_component_s and laps_past_cliff non-NULL, never COALESCEd), not in var(‘isolation_exclude_races’), on a (race, lap) with >= var(‘isolation_min_field_n’) such laps. y_s = x_s minus the lap’s field median, so every per-(race, lap) term (field base, fuel, rubber, ambient) cancels: the ratings do not depend on the FD1 base (T41). Also the stint phase (tyre phase from the seed’s onset, recovery overlay from the air state). The input of the car-term fit (fit_constructor_car_fe.py —panel isolation). Leakage: a function of the residual trajectory; no ML-contract mart may depend on it (T48, ml/tests/test_manifest_contract.py). WI-16a, _roadmap/_fixes/wi/WI-16-cumulative- driver-isolation.md.

Lineage

Overview

Property	Value
Layer	intermediate
Family	Skill
Contract enforced	No
Tags	driver_isolation
Upstream	int_lap_residual_decomposed, int_lap_anomaly_flags, int_stint_geometry, int_lap_air_state

31 tests guard this model - 27 generic, 4 singular.

Columns

Column	Type	Nullable	Tests	Description
lap_id		Yes	not_null, unique	Lap identifier (int_lap_residual_decomposed.lap_id).
stint_id		Yes	not_null	Stint identifier (int_stint_geometry.stint_id).
race_year		Yes	not_null	Season.
race_id		Yes	not_null	FastF1 event id, e.g. 2021_8.
driver_id		Yes	not_null	Driver (three-letter code). In the pair mart, the focal driver whose gains the row reports.
constructor_id		Yes	not_null	Constructor (stg_laps.constructor_id).
stint_number		Yes		Stint ordinal within the driver’s race (int_stint_geometry).
lap_number		Yes	not_null	Race lap number. Tiers 1 and 3 match cars on it, which is why 2020_1 is excluded (W18).
compound		Yes	not_null	Dry compound of the stint (INTERMEDIATE and WET laps are not in Ω).
age_in_stint		Yes	not_null	Tyre age in laps (int_stint_geometry).
lap_in_stint		Yes		Lap ordinal within the stint, counting every lap.
valid_lap_in_stint		Yes	not_null	Ordinal among the stint’s valid laps; early vs mid phase splits at 5/6.
laps_past_cliff		Yes	not_null	Laps beyond the compound seed’s cliff onset (0 before it); drives tyre_phase = cliff. Never NULL in Ω.
fuel_mass_kg		Yes		Scheduled-distance fuel load, kg. The same for every car on a lap, so it cancels from every rating (carried for WI-16b’s V4 physics check).
era		Yes	not_null	Regulation era: pre<era_boundary> or post<era_boundary> (var era_boundary, 2022).
driver_era		Yes	not_null	driver_id + ’_’ + era: the driver key of the era-split car-term fit.
anomaly_class		Yes		int_lap_anomaly_flags.anomaly_class; normal or clean_cliff in Ω.
air_state_dominant		Yes		int_lap_air_state.air_state_dominant (context; dirty_air drives the recovery overlay).
is_dirty_air_lap		Yes	not_null	TRUE when air_state_dominant = ‘dirty_air’.
field_n		Yes	not_null	Ω laps on this (race, lap); >= var(‘isolation_min_field_n’) by construction (T40).
lap_time_s		Yes	not_null	Raw lap time, s.
compound_component_s		Yes	not_null	C: the compound seed’s expected cost of this tyre state, s, positive = slower (int_lap_residual_decomposed). Never COALESCEd: an unknown tyre is not in Ω.
dirty_air_tax_s		Yes	not_null	D: dirty-air tax, s, positive = slower (int_lap_residual_decomposed).
x_s		Yes	not_null	lap_time_s - compound_component_s - dirty_air_tax_s, s.
field_median_x_s		Yes		Median of x_s over the Ω laps on this (race, lap), s.
y_s		Yes	not_null	x_s minus the lap’s Ω field median of x_s, s. POSITIVE = SLOWER than the field- typical car and driver on the lap. Invariant to the field base, fuel, rubber and ambient terms, which depend on (race, lap) only (T41).
tyre_offset_vs_field_s		Yes	not_null	compound_component_s minus the lap’s Ω field median of it, s; positive = this tyre state costs more than the field’s. The strategy position on the lap: team-dominated context, not a rating.
tyre_phase		Yes	not_null, accepted_values	early (laps_past_cliff = 0, valid_lap_in_stint <= 5), mid (laps_past_cliff = 0, >= 6) or cliff (laps_past_cliff > 0), from the seed’s onset, so never selected on the residual.
is_recovery		Yes	not_null	TRUE on the first var(‘isolation_recovery_laps’) valid laps of a non-dirty-air run directly after >= var(‘isolation_recovery_min_dirty_run’) consecutive dirty-air valid laps in the stint. Backward-looking only.
stint_phase		Yes	not_null, accepted_values	’recovery’ when is_recovery, else tyre_phase (T45).