Commands mkdocs new [dir-name] - Create a new project. mkdocs serve - Start the live-reloading docs server. mkdocs build - Build the documentation site. mkdocs -h - Print help message and exit.
TORQUE TABLES
What it is: Raw torque lookups keyed by RPM with an accompanying “compression/negative-Nm” channel from the file. Structure in XML:
Row0 starts a table (b0, comp, tq), then multiple rows as row-i (int RPM) or row-f (float RPM). Optional endvar tail exists. Sanity constraints: rpm 0–25000, comp −300…300, tq −4000…10000. Tuning cue: This is the ground truth for engine output. Any rescale you do should respect the defined ranges to avoid invalid parses.
BOOST TABLES
What it is: Turbo/boost lookup by RPM with throttle columns. Structure in XML:
Row0: b0, then throttle columns t0/t25/t50/t75/t100 (bar).
Row-i: adds rpm + the same five throttle columns. Sanity constraints: each throttle cell 0.5–3.0 bar. Tuning cue: Shape the five throttle traces per RPM to control response; keep within bounds to remain parsable.
LIMITS & RPM CONTROL
RevLimitRange Two encodings (float/float/byte or int/int/byte). Defines limit_min, limit_max, steps (unit rpm). Use for hard/soft limiter windows in the map.
RevLimitSetting Single byte selector for the active limiter slot/index. Selects which limit from the defined range to use.
RevLimitLogic Float logic scalar used by the limiter behavior. Acts as a tuning knob for how the limiter applies.
LifetimeEngineRPM Float or int variant: avg, max (rpm). Book-keeping fields embedded in the file; not a control.
FUEL & ENGINE MAPPING
FuelConsumption | FuelEstimate Single float each. Consumption/estimation scalars carried with the engine.
EngineFuelMapRange Three bytes: min, max, step. Index range for fuel map selection.
EngineFuelMapSetting Byte map_index. Chooses current fuel map within the above range.
EngineBrakingMapRange float min, float max, byte steps. Defines decel/engine-brake map scale.
EngineBrakingMapSetting Byte map_index. Selects active engine-brake map.
EngineInertia Float (unit kg·m², bounded in XML). Rotational inertia used by the solver.
Unknown_EngineFreeRevs Float placeholder. Keep as-is unless you’ve correlated it.
IdleRPMLogic Two variants: floats or ints for rpm_low, rpm_high. Idle window/reference used by the map.
LaunchEfficiency | LaunchRPMLogic Float efficiency and two-value launch RPM logic. Affect launch behavior in the engine context.
THERMAL MODEL
OptimumOilTemp Float °C. Target/nominal oil temp.
CombustionHeat | EngineSpeedHeat Floats contributing to heat generation terms.
OilMinimumCooling | WaterMinimumCooling Floats: baseline cooling capacities.
OilWaterHeatTransfer | RadiatorCooling Pair of floats each: coupling and radiator cooling terms.
LifetimeOilTemp float avg, float max °C. Book-keeping values; not controls.
EMISSIONS & MISC FLOATS
EngineEmission Three floats e1/e2/e3. Generic emissions scalars recorded in the file.
LifetimeAvg | LifetimeVar Float each. Statistical placeholders carried in the data.
Unknown_Float_2265DD60 | Unknown_Float_229217E0 Floats with unknown semantics; retain original values.
STARTER & AUX BYTES
OnboardStarter Byte presence flag.
EDF_UNKN_005 Byte unnamed control; do not alter without evidence.
StarterTiming Three floats t1/t2/t3. Timing scalars used by start sequence.
AirRestrictorRange float min, float max, byte steps. Defines restrictor band and discretization.
Unknown_Byte_2B3ED340 Byte placeholder.
BoostRange | BoostSetting Range: byte min, float max (bar), byte steps; Setting: byte. Caps and selects boost within allowed envelope.
ENGINE LAYOUT TAGS
What it is: Byte sequences near the file tail that identify cylinder/rotor layout (e.g., Straight 4, V8, Flat 6, V12, etc.). Usage: Read-only hints stored in the binary; they do not change maps but help classify engines in tooling