This is the repository related to a paper presented at UIST 2020. It is an interface where you can model a joint geometry in a voxelized design space, and export milling paths for fabrication with a 3-axis CNC-machine.
This software is free for personal use and non-commercial research conducted within non-commercial organizations. If you want to use it for commercial purposes, please contact Kaoru Shigeta (shigeta@todaitlo.jp).
- Python 3.8.3
- pip 21.1.2
- Packages: requirements.txt
It is recommended to use a virtual environment, for example venv.
The following command will install the packages at once.
$ pip install -r requirements.txt
After installing the necessary packages, run the application by the following commands.
$ cd setup
$ python tsugite_app.py
Open a joint by double-clicking anywhere or by pressing the SPACE bar. Edit the joint geometry by pushing and pulling on the faces. Change the orientation and position of the wood components by dragging them. Other properties can be edited in the control panel to the left. Editable properties are summarized in the figure below.
The system performs geometric evaluations in real time and provides graphical feedback accordingly (see a-h below).
In case of an invalid joint, the system also gives suggestions (on the right side). The suggestions consists of up to four valid joint geometries within one edit distance from the current design.
For more details, see the User Interface Wiki (coming soon).
*.tsu is a unique file format for this application. This file my_joint.tsu is provided as an example. You can save and open *.tsu files from the menu bar in the interface.
Set machine origin at the center of the top side of the joint. Insert wood bar a) vertically if the sliding/fabrication is aligned with the timber axis, and b) horizontally if it is perpendicular to the timber axis.
For more details, see the Fabrication Wiki (coming soon).
Please note that this is a research prototype and not a consumer-ready product. We cannot provide technical support and we are not responsible for any damage to your fabrication equipment.
Maria Larsson, Hironori Yoshida, Nobuyuki Umetani, and Takeo Igarashi. 2020. Tsugite: Interactive Design and Fabrication of Wood Joints. In Proceedings of the 32nd Annual ACM Symposium on User Interface Software and Technology (UIST '20). Association for Computing Machinery, Virtual Event, USA.
ACM link: https://dl.acm.org/doi/abs/10.1145/3379337.3415899
Project page: http://www.ma-la.com/tsugite.html
Paper PDF: http://ma-la.com/Tsugite_UIST20.pdf