Once you mapped the piece, you can load the .acim
model to lock the execution model to the current timber element. This will allow you to visualize directly in 3D all the augmented cuts, drills and other information directly on the timber piece.
Step-by-step¶
To operate machines with AC, you need to export a .acim
file from your 3D modeling software. This file contains all the information required for the fabrication process, such as geometric information (e.g., joints and holes) and fabrication metadata (e.g., ID, fabrication status). For now we only support .acim
files generated from Grasshopper.
Install augmented-carpentry
via the Package Manager and export your structure via the component acpy-acim-exporter
.

Once the mapping is processed and saved, you can load the .acim
model to lock the execution model to the current piece.

The execution model is now locked to the timber element and it can now be visualized in 3D.

Since the model is referenced to the timber element, moving the piece will not affect the tracking.
Let's start by looking at the different elements of the ACIM interface when the model is loaded.
a - a selected hole
b - a lap-joint in the unselected state
c - a hole in the unselected state
d - a selected lap-joint
e - a UI panel for execution model controls (acim
)
f - dimension lines (cotas) that can be toggled on or off
g - basic I/O controls for ACIM
h - visual cues indicating the bounding box
i - a widget delineating the outer boundaries of the imported execution model
o - controls for adjusting the model's position and orientation
p - tools to navigate and designate holes or cuts as current
q - additional options specific to holes or cuts.
To select the current cut or drill, use the list selector (b) or the arrows (c). The selected cut or drill will be highlighted in green (a). Based on the selected cut or drill, the corresponding UI will automatically appear for the right tool.
You are now ready to do some augmented woodworking.
Measurements and cotas

Show Cotas
, for the whole model select Show All Cotas
. Multiple models

acim
s and load them differently. This can be useful if you have a complex piece with multiple parts like in this example of multiple perforations for a glulam beam. Troubleshooting out-of-scale model

Scaling Factor Adjustements
section (b).