Chapter 1 · Frame and baseline

What the GPU actually executes

Use what the gpu actually executes to move the gpu training production brief toward a defensible release.

65–90 min4 key conceptsReviewed 26 Aug 2026
01 · Production proposition

Training repeatedly OOMs and misses its nightly completion window.

This lesson isolates what the gpu actually executes as one decision inside that system. The people affected are product users and operators; the learning data must carry event time, availability time, ownership, and version; and the operating envelope is 24 GB device and nightly completion.

Decision

Choose whether and how to use kernels at a declared prediction cutoff.

Metric

Measure decision utility alongside calibration, slice reliability, and system latency—not model score alone.

Failure consequence

Training repeatedly OOMs and misses its nightly completion window. An unsafe release must degrade to a named baseline or the last known-good version.

02 · Intuition & prerequisites

Build the mental model before the machinery.

The core move is to treat what the gpu actually executes as a contract between data, a computation, and an action. Record hardware/software, shapes, precision, seeds, throughput method, peak memory, and cost per sample. The implementation becomes easier to debug once you can state which inputs exist, which state is learned, what output means, and what must remain invariant after serialization.

01

kernels

Define it in a hand-checkable form and name the prediction-time inputs.

02

HBM bandwidth

Connect it to the production metric and identify what it cannot guarantee.

03

arithmetic intensity

Stress it with a slice, a temporal boundary, and a failure-safe alternative.

04

pinned memory

Stress it with a slice, a temporal boundary, and a failure-safe alternative.

Bring forward

Neural networks

03 · Formal treatment

Name every symbol. Check every shape.

Roofline bound is the central invariant for this lesson. The formula is useful only when its inputs match the production cutoff and its output maps to an action.

Formal treatment
attainable FLOP/smin ⁣(Ppeak,IBmem)\text{attainable FLOP/s} \le \min\!\left(P_{\mathrm{peak}}, I \cdot B_{\mathrm{mem}}\right)

Roofline bound

Symbol, shape or unit contract
SymbolMeaning / shape / unit
P_peakpeak compute
Iarithmetic intensity
B_memmemory bandwidth
Open derivation and numerical substitution

Start from the production quantity being optimized, substitute the observed values with their declared units, then isolate the model-controlled term. Preserve shape annotations at each step so broadcasting or aggregation cannot silently change the result.

  1. Write the named inputs: P_peak, I, B_mem.
  2. Substitute one small, hand-checkable batch before vectorizing.
  3. Calculate an independent reference value and compare within a declared tolerance.
# equation → code contract
inputs = validate_shapes_and_units(batch)
value = compute_c12(inputs)
assert is_finite(value)
04 · Three views of the idea

Calculate it small. Shape it realistically. Break it on purpose.

HAND-CALCULATED TOY

A result you can reproduce on paper

Compare one large matrix multiplication with thousands of tiny kernel launches.

  1. Write every input and unit.
  2. Substitute values into the roofline bound equation above.
  3. Compare the result to one simple baseline and explain the direction of the difference.
PRODUCTION-SHAPED

The same reasoning under real constraints

Profile a decoder trainer, overlap input transfer, enable mixed precision, tune shapes, and checkpoint selected activations.

The production record includes the data snapshot, transformation state, artifact identity, cutoff, score, decision, and the version of the policy that consumed it.

FAILURE / COUNTEREXAMPLE

The attractive result you should reject

Unsynchronized timing reports impossible speedups while retained tensors keep computation graphs alive and leak memory.

Diagnostic: replay the smallest failing slice from immutable inputs, then compare each boundary rather than retuning the model.

05 · Deterministic lab

Change one assumption and make the tradeoff visible.

This lab runs predefined TypeScript only. It never executes learner code. Use the slider, numeric input, reset, live text, or table—the computation is the same.

Estimate

GPU memory ledger

Change microbatch size and calculate a simplified training-memory budget.

samples
Primary8.6 GB
Secondary36.0%
DiagnosisFits

Assumption: 3.2 GB weights+grads+optimizer, 0.34 GB activations per sample, 24 GB device, 10% reserve.

Open nonvisual data table
ItemComputed stateInterpretation
block 11.09 GB activationsresident
block 22.18 GB activationsresident
block 33.26 GB activationsresident
block 44.35 GB activationsresident
block 55.44 GB activationsresident
06 · Production implications

Trace the complete operating path.

  1. 01

    Validate and version kernels.

  2. 02

    Compute what the gpu actually executes from prediction-time-safe inputs.

  3. 03

    Persist model, feature, and configuration identities together.

  4. 04

    Serve or materialize behind explicit 24 GB device and nightly completion.

  5. 05

    Join telemetry to mature outcomes and retain a rollback path.

Observability

Join service health, input quality, prediction distributions, slice behavior, and mature outcomes by exact version.

Cost

Measure storage, preprocessing, compute, queueing, and human review under a representative arrival pattern.

Failure modes

Unsynchronized timing reports impossible speedups while retained tensors keep computation graphs alive and leak memory. Add a detector, owner, mitigation, and stop condition for this class of failure.

Alternatives

Compare a rule, a simpler statistical baseline, and a different system boundary before adding model complexity.

07 · Check understanding

Explain the contract, not just the vocabulary.

Browser-graded checkpointPass ≥ 80%
01Why can Python timing understate GPU work?
02Why does FP16 often need loss scaling?
03Does gradient accumulation always equal one large batch?
08 · Apply in production

Single-GPU optimization plan

Profile and optimize a correctness-locked trainer without sacrificing model quality.

  • Profiler diagnosis
  • Mixed precision parity
  • Memory plan
  • Throughput/cost report
Open assignment and rubric
09 · Sources & next depth

Read primary material with a purpose.

10 · Production resolution

Return to the opening failure.

Record hardware/software, shapes, precision, seeds, throughput method, peak memory, and cost per sample.

For this lesson, the release evidence is a hand-checked formal result, deterministic simulation output, a ≥80% checkpoint, the production rubric, and a named fallback. The course resolves when the system can produce a profiled, mixed-precision, memory-budgeted training loop.