Function sequant::eval::schedule::size_audit_table

Function Documentation

std::string sequant::eval::schedule::size_audit_table(Document const &doc)

The size audit: one row per dag value, ranked by its realized slab (RunRecord::leaf_bytes for a leaf, else RunRecord::footprint), with the modeled slab (ValueRecord::modeled_footprint), the modeled full size, the realized full size, the build count and the realized/modeled slab ratio; then the modeled and the realized combined peak, each with its static point and its live value ids. Both peaks are the same interval sweep over the dag’s [first_use, last_use] liveness (eval::interval_peak_sweep), the modeled one of modeled_footprint, the realized one of the realized slab: structural liveness priced with the sizes the run measured, so the two are comparable term for term. Neither sees memory outside the table’s values (an operand’s buffer a backend task still reads, a transient inside a production tree, a backend’s own temporaries). Rows for values the run never produced print 0 realized. Byte columns print as “<n> B” below 1e6 and in MB/GB above; the ratio with two decimals.

Throws:

Exception – when the document has no dag or run section