analyze_printability
Read-only
Checks a 3D shape for FDM printability issues like overhangs, thin walls, and bed adhesion, returning a detailed report with severity and location.
Instructions
Analyse a build123d shape for FDM printability using augura (BREP-exact analysis).
Checks: overhangs, manifold/watertight, tip-over risk, brim/raft need,
minimum vertical feature (→ max layer height), and thin walls. Optionally
checks bed-fit against a declared build volume.
Returns a plain-text summary followed by a JSON report with per-finding
detail (kind, severity, message, area/location where applicable).
object_name: named object from show() (default: current shape).
support_angle: faces shallower than this many degrees from horizontal need
support (default 45).
nozzle: nozzle diameter in mm for wall-thickness check (default 0.4).
min_perimeters: walls thinner than min_perimeters × nozzle are flagged
(default 2).
build_volume: optional build envelope as 'X Y Z' in mm, e.g. '256 256 256';
omit to skip the bed-fit check.
bed_tol: Z tolerance in mm for identifying bed-contact faces (default 0.001);
raise it for parts whose bottom faces sit slightly off Z=0.
min_feature: minimum vertical feature size in mm to flag (default 0.5).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| nozzle | No | ||
| bed_tol | No | ||
| min_feature | No | ||
| object_name | No | ||
| build_volume | No | ||
| support_angle | No | ||
| min_perimeters | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |