Module dose 

Dose to named layers, depth-dose through a stack, and interface transmission, for the electron tally.

Everything here is bookkeeping on the deposits and interface crossings the transport already reports; nothing changes the transport. The accumulators are opt-in through DoseConfig on ElectronTallyConfig, so a run without it is unchanged.

Conventions

• Per-history errors. A history’s contribution to a bin is the sum over the primary and all its secondaries. The reported mean is the sum over histories divided by the number of histories, and the standard error is sqrt((Σx² − (Σx)²/N) / (N (N − 1))). It is NaN for fewer than two histories.
• Dose per fluence. The target is laterally infinite, so lateral escape cancels and the energy deposited in a layer per primary, divided by the layer’s areal mass density ρ t, is the absorbed dose per unit incident fluence, in Gy m² (J kg⁻¹ m²). Multiply by a fluence in m⁻² for a dose. A semi-infinite last layer has no finite areal mass, so it is reported as energy only (its LayerDose::dose_gy_m2 is None).
• Depth-dose grid. Each finite layer gets bins_per_layer uniform bins over its middle and, with InterfaceRefine, bins finer uniform bins in the band of width width_m next to each of its faces (at most half the layer each side). A semi-infinite last layer is binned over DepthDoseConfig::substrate_depth_m; energy deeper than that is kept in DepthDose::outside_ev. A deposit is binned by the layer it was made in (the transport’s layer), clamped to that layer’s extent, so the bins of a layer sum to its layer total to summation error.
• Deposition point. The same as the rest of the electron tally: an inelastic loss at the collision point, the sub-threshold remainder at the stopping point.
• Transmission. One count per crossing from the transport’s interface hook: an electron that crosses an interface several times is counted each time. Primaries and secondaries are separate entries. The energy is the kinetic energy on the new side of the face (after refraction with a step barrier). Forward is towards larger depth.
• Deposits are measured from the band bottom, like DepositionReport; with a secondary model in a layer with a Fermi energy they include the Fermi-sea energy of liberated conduction electrons.

Structs

DepthDose

The depth-dose profile through the stack.

DepthDoseConfig

The 1D depth-dose grid.

DoseConfig

Settings of the dose, depth-dose and transmission tallies.

DoseError

An invalid DoseConfig.

DoseReport

Result of the dose tallies.

Estimate

A mean with its standard error.

InterfaceRefine

Refined depth bins next to each interface.

InterfaceTransmission

Electrons crossing one interface in one direction.

LayerDose

Energy and dose in one layer, per primary.