Get the run result
run_resultRetrieve final mass, stiffness, run time, final.stl path, and optional text/mesh preview once a topology optimization run finishes.
Instructions
Get the final metrics, the path of final.stl and a text preview when the run is done.
Tell the user the result: mass, stiffness, run time. Units: mm, N, MPa, g.
A run that a request to stop ended has no result: the reply is done: false and stopped: true with the pass.
run_dir: the run folder. Default: the last run that this server started.
preview: add mesh facts and ASCII silhouettes of final.stl (for clients that cannot open files). render_part gives real images of the part.
Reply keys: resource topopt://replies/run_result (the meaning of each key).
A note names a wall thinner than the voxel size. The thinnest wall (thinnest_wall_mm) is the lower end of the film, not a value to use.
The setting settings.part_only_min_film_mm (the wall thickness to cut off, in mm; default off) cuts off that thin film; then part_only also has min_film_mm, film_removed_mm3 and, for each body, thin_area_mm2, cut_area_mm2, thin_area_after_mm2 and the thinnest wall that stays. To apply it to a run that has finished: write the YAML with the value as a NEW file in the folder of the old YAML (region paths start there), then run_topopt with that YAML, the run folder as out_dir, resume=true and allow_changed_inputs=true (the post step repeats; copy the run folder first to keep the old result). Read the three areas and change the value if the film is still there.
For a run with a stress limit, "met" of metrics.stress.cases.<case>.relaxed is the relaxed measure of the optimizer, not the stress of the part. summary and independent_check of the case give the P2 p99.9 of verify_run and its ratio to the limit when verify has run on the folder (read again at each call), else the option to run it.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "run_result"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| preview | No | ||
| run_dir | No |