TeethAnnotationTool

This is a teeth annotation tool for cropping out each individual teeth. Following two sections are the usage of binary and how you can build from scratch.

1. Definition of Teeth IDs

• Upper Right ThirdWisdomMolar: 1
• Upper Right SecondMolar: 2
• Upper Right FirstMolar: 3
• Upper Right SecondPremolar: 4
• Upper Right FirstPremolar: 5
• Upper Right Canine: 6
• Upper Right LateralIncisor: 7
• Upper Right CentralIncisor: 8
• Upper Left CentralIncisor: 9
• Upper Left LateralIncisor: 10
• Upper Left Canine: 11
• Upper Left FirstPremolar: 12
• Upper Left SecondPremolar: 13
• Upper Left FirstMolar: 14
• Upper Left SecondMolar: 15
• Upper Left ThirdWisdomMolar: 16
• Lower Left ThirdWisdomMolar: 17
• Lower Left SecondMolar: 18
• Lower Left FirstMolar: 19
• Lower Left SecondPremolar: 20
• Lower Left FirstPremolar: 21
• Lower Left Canine: 22
• Lower Left LateralIncisor: 23
• Lower Left CentralIncisor: 24
• Lower Right CentralIncisor: 25
• Lower Right LateralIncisor: 26
• Lower Right Canine: 27
• Lower Right FirstPremolar: 28
• Lower Right SecondPremolar: 29
• Lower Right FirstMolar: 30
• Lower Right SecondMolar: 31
• Lower Right ThirdWisdomMolar: 32

2. Binaries and Usage

Binary tested on Win10 64bit fresh system.

2.1 Folder

• Input: Please choose the folder with these files in it:

  • LowerJawScan.stl
  • UpperJawScan.stl

• Checkbox of existing cropped parts will be checked automatically.

• Output: Cropped OBJ files will be stored in cropped_mesh folder with corresponding IDs.

2.2 Mouse Clicks

• Please use left click to define the boundary of one tooth.
• After finish defining the boundary, you can click the middle button to show the cropping result.
• If you are not satisfied with the cropped result, just close the window. If you think the cropped result is good, click save.

2.3 Click "Finish this People" Button

3. Dependencies and Build Instructions

Following are dependencies for building from source code:

1. VS 2017
2. Qt 5.9.2: Download here.
3. Qt VS plugin: Download here, and select C:\Qt\5.9.2\msvc2015 as Default Qt/Win Version not msvc2017 64bit.
4. CMake GUI: Download here, for building VTK from source.
5. VTK 8.0.1: Download here, please see the following section to build from scratch and do not use the binary installer on the internet.

3.1 Building VTK

We have to build VTk with QVTKWidget and OpenGL1 backend(default VTK binaries are with OpenGL2 backend and no QVTKWidget). Following are the settings of CMake (I set the source folder as C:\vtk_801 and build target folder as c:\vtk_801\bin):

• VTK_GROUP_QT: TRUE
• VTK_RENDERING_BACKEND: OPENGL

press configure again, and set:

• VTK_QT_VERSION: 5
• QT_QMAKE_EXECUTABLE: C:/Qt/5.9.2/msvc2015/bin/qmake.exe

press configure again, and set:

• QT_DIR: C:\Qt\5.9.2\msvc2015\lib\cmake\Qt5

Click Generate and Open Project, then build in VS using Release Win32 settings. Then add C:\vtk_801\bin\bin\Release to your system PATH.

3.2 Building the Annotation Tool

Note that you should building the annotation tool using Release Win32 mode.