Fields
| Field | Meaning |
|---|---|
ok | true when the command finished. |
errors | Each error has a code, the key at fault and a message. |
warnings | Each warning has a code, often where and first_frame, and a fix.key to change with a fix.hint. |
artifacts | Every file written, with its kind, width, height, size and SHA-256. |
metrics | Clip metrics such as life_s, rise_speed_mps, aspect_at_peak, mean_coverage and loop_seam, plus per-frame lists. |
metrics.leftover_divergence | Worst pressure error of any step, as the solve counts it. |
metrics.stored_divergence | Worst 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, gpu | Stage timings, the GPU device and its peak memory. |
Warnings and the key each one points at
| Code | Means | First key to change |
|---|---|---|
DOMAIN_CLIPPING | Visible gas reached a side or the top of the box | domain.size_m |
EMPTY_SIM | Nothing visible in any frame | emitters |
TILE_CLIPPING | Content touches the tile edge | views.margin |
NOT_RISING | Hot gas that does not climb | solver.buoyancy |
FLAT_SHAPE | Wider than tall, seen side-on | solver.buoyancy |
PALE_CORE | No flame pixel nears white | look.exposure |
FLAME_CLIPPED | Over a tenth of flame pixels at the encoding limit | look.exposure (lower) |
FLAME_NOT_EXPORTED | There is flame but no sheet carries it | export.channels (add "emissive") |
ENDS_VISIBLE | A one-shot is still visible on its last frame | domain.duration_s |
STARTS_FULL | A one-shot's first frame is already large | export.start_s |
LOOP_SEAM | The loop's wrap shows | export.loop_blend_frames, export.warmup_s |
PRESSURE_LOOSE | The solver missed its accuracy, or 16 bit numbers could not keep an accuracy finer than the default | domain.substeps, or solver.precision = "full" |
SEALED_SPACE | Gas 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 would | domain.open_faces, or carve a vent |
STEP_TOO_LARGE | Gas crosses more than about two cells a step | domain.substeps |
COVERAGE_HIGH | Mean coverage over a half; expensive to draw | solver.smoke_fade |
GRID_REDUCED | Draft quality; expected | none |
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.