Contents3 sections
geofx runs on the hosted API: try it in the Playground.
Errors and exits
| Exit | Codes | Meaning |
|---|---|---|
| 0 | Done. Warnings, if any, are in the report. | |
| 1 | SOURCE_MISSING, GRID_NOT_WHOLE, DRAW_CELL_NOT_NESTED, STAMP_CELL_NOT_NESTED, GRID_MISMATCH, FIXED_HEIGHT_CONVERT, FIXED_HEIGHT_CONFLICT, WORLD_TOO_LARGE, MATERIAL_UNKNOWN, TARGET_LIMIT | The spec or the command is wrong; the message names the key and what it accepts. |
| 2 | STAGE_FAILED, OUT_OF_MEMORY | A step could not make a valid result. |
| 3 | FILE_READ, FILE_WRITE, HEIGHT_UNREADABLE, IMAGE_UNREADABLE, LAYOUT_INVALID | A file could not be read, used or written; the message names it. |
| 4 | NO_GPU | Only for an unbuilt stage. |
| 5 | BUDGET_EXCEEDED | The run finished and wrote every file, but missed a [budget] limit. |
Warnings and settings
| Warning | Key to change |
|---|---|
FLAT_TERRAIN | shape.amplitude_m |
OVER_ERODED | erosion.iterations, erosion.strength |
SPIKES | erosion.thermal_rate, source.height |
CONSTRAINT_BROKEN | constraints.tolerance_m, constraints.falloff_m |
MESH_ERROR_HIGH | mesh.max_error_m |
EDGE_ARTIFACTS | grid.tiling, erosion.apron_m |
HEIGHT_CLIPPED | grid.height_range_m |
HEIGHT_STEP_COARSE | grid.height_range_m |
HEIGHT_QUANTISED | source.height |
DETAIL_CLAMPED | draw.detail_max_m |
MATERIAL_UNCOVERED | materials.weight |
MATERIAL_LAYERS_DROPPED | material_map.encoding |
WETNESS_SATURATED | wetness.twi_range |
TILE_ALONE | grid.tiles |
FIXED_HEIGHT_KEPT | source.height_mode |
STAMP_CLIPPED | stamps.crater_ejecta |
STAMP_VOLUME | stamps.crater_rim |
TEXTURE_DOWNSIZED | draw.cell_m |
TARGET_RESAMPLED | export.targets |
STAGE_NOT_BUILT | erosion.enabled |
Read the full report before using a result. A finished compile can still miss a budget; exit code 5 keeps all output files.
Questions
What does exit code 5 mean on a geofx compile?
Exit code 5 means the compile finished and wrote every output file, but missed a limit set in the budget section.
Which exit codes indicate invalid geofx specs or unreadable files?
Exit code 1 reports an invalid spec key or value, while exit code 3 means an input or output file could not be read or written.
How do you fix a HEIGHT_CLIPPED or SPIKES warning in geofx?
Adjust grid.height_range_m to fix HEIGHT_CLIPPED warnings or tune erosion.thermal_rate and source.height to resolve SPIKES warnings.