Skip to content

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

Image title

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.

Image title

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.

Image title

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

Cotas and measurements can be toggled on or off. They are useful to double check the dimensions of cuts if needed.For a single element select Show Cotas, for the whole model select Show All Cotas.

Multiple models

You can also subdivide your fabrication in multiple acims 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

Image title
If you notice that the model is slightly bended or the boundaries are off, you can try to adjust the model's scaling. This can occur if your markers are not perfectly printed or if the camera calibration is not precise. Take a meter and measure the length between the purple limits of the beam (a). Insert the value with the slider in the Scaling Factor Adjustements section (b).