pfc_capture_plot
Generate and save PFC simulation plot images with customizable visualization settings for balls, walls, and contacts, handling complex plot setup automatically.
Instructions
Capture a PFC plot image. The image is saved to output_path and returned for visual inspection.
ALWAYS use this tool for plot visualization. Do NOT write PFC plot commands manually via pfc_execute_task — the PFC plot command syntax is complex and error-prone. This tool handles all plot setup, camera, coloring, and export internally.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| output_path | Yes | Absolute output path for plot screenshot PNG | |
| size | No | Image size in pixels [width, height] | |
| include_ball | No | ||
| ball_shape | No | sphere | |
| ball_color_by | No | Ball coloring key (string). Examples: velocity, displacement, force-contact, radius, density, group, extra-1. Aliases like force_contact are accepted. | |
| ball_color_by_quantity | No | mag | |
| include_wall | No | ||
| wall_color_by | No | Wall coloring key (string). Examples: velocity, force-contact, name, group, extra-1. | |
| wall_color_by_quantity | No | mag | |
| wall_transparency | No | ||
| include_contact | No | ||
| contact_color_by | No | Contact coloring key (string). Examples: force, contact-type, model-name, fric, kn, ks, extra-1. | force |
| contact_color_by_quantity | No | mag | |
| contact_scale_by_force | No | ||
| center | No | ||
| eye | No | ||
| roll | No | Camera roll angle in degrees | |
| magnification | No | Zoom factor (1.0 = fit model, >1 = zoom in) | |
| projection | No | perspective | |
| ball_cut | No | ||
| wall_cut | No | ||
| contact_cut | No | ||
| timeout | No | Capture timeout in seconds |