DOCS // PYRO 0.4.1

The report

Every command prints the same JSON report to stdout and writes it to bake_report.json: ok, errors, warnings with a fix key and hint, artifacts and metrics. A shipped effect ends with "ok": true and no warnings.

Fields

FieldMeaning
oktrue when the command finished.
errorsEach error has a code, the key at fault and a message.
warningsEach warning has a code, often where and first_frame, and a fix.key to change with a fix.hint.
artifactsEvery file written, with its kind, width, height, size and SHA-256.
metricsClip metrics such as life_s, rise_speed_mps, aspect_at_peak, mean_coverage and loop_seam, plus per-frame lists.
metrics.leftover_divergenceWorst pressure error of any step, as the solve counts it.
metrics.stored_divergenceWorst pressure error in the velocity as it is kept, at the exported frames: leftover_divergence plus what rounding to solver.precision put back. New in 0.4.1.
timings_ms, gpuStage timings, the GPU device and its peak memory.

Warnings and the key each one points at

CodeMeansFirst key to change
DOMAIN_CLIPPINGVisible gas reached a side or the top of the boxdomain.size_m
EMPTY_SIMNothing visible in any frameemitters
TILE_CLIPPINGContent touches the tile edgeviews.margin
NOT_RISINGHot gas that does not climbsolver.buoyancy
FLAT_SHAPEWider than tall, seen side-onsolver.buoyancy
PALE_CORENo flame pixel nears whitelook.exposure
FLAME_CLIPPEDOver a tenth of flame pixels at the encoding limitlook.exposure (lower)
FLAME_NOT_EXPORTEDThere is flame but no sheet carries itexport.channels (add "emissive")
ENDS_VISIBLEA one-shot is still visible on its last framedomain.duration_s
STARTS_FULLA one-shot's first frame is already largeexport.start_s
LOOP_SEAMThe loop's wrap showsexport.loop_blend_frames, export.warmup_s
PRESSURE_LOOSEThe solver missed its accuracy, or 16 bit numbers could not keep an accuracy finer than the defaultdomain.substeps, or solver.precision = "full"
SEALED_SPACEGas was asked to grow in a space it cannot leave: a box with no open side, or a room closed by obstacles. The growth is taken back evenly over the space, as the rising pressure of a closed room woulddomain.open_faces, or carve a vent
STEP_TOO_LARGEGas crosses more than about two cells a stepdomain.substeps
COVERAGE_HIGHMean coverage over a half; expensive to drawsolver.smoke_fade
GRID_REDUCEDDraft quality; expectednone

Warnings are advice. An element meant to be flat (a dust ring) or cold avoids some warnings through its settings, and the examples show which ones. A shipped element has no warnings.