CraniumPy v0.4.2

New features and changes:

• Optimized registration scheme based on Euler angles.
• Now option to choose for registration and clipping based on either cranial or facial analysis. This selection determines the reference point and clipping plane.
• Mean facial asymmetry algorithm implemented.
• Non-rigid ICP algorithm implemented.
• New templates added

CraniumPy v0.3.1

Important change:

• Registration bug "mesh flipping" fixed

CraniumPy v0.3.0

Important changes:

• New reference frame (right hand coordinate convention with z-axis pointing outward from the nose)
• New templates included based on new reference frame
• Bug that caused post registration landmark positions to be stored incorrectly - fixed
• New test mesh included to explore CraniumPy functionality
• Landmarks after registration are no longer appended but the landmark file now only stores 1 set of (pre and post registration) landmarks

CraniumPy standalone version 0.2.4

Minor update:

• Program crashing bug fix when selecting a menu option without a mesh loaded
• Landmarks are now exported as a dictionary and written to a json file instead of .txt
• Isometric view included

CraniumPy standalone version 0.2.2

Minor update:

• Both the initial and final landmark positions are stored and saved in filename_landmarks.txt

CraniumPy standalone version 0.2.1

To make the tool more accessible, users no longer have to build an executable, instead it can be downloaded from https://drive.google.com/drive/folders/1kFNyoITESdn4FvOnUSdWewUJ1dbkbAyQ?usp=sharing.
This allows anyone to use this software as a standalone tool without having to install any of the requirements or dependencies. For users who want to change the code and subsequently build a new executable, instructions are still included in the README.md.

Required folder structure to run CraniumPy as a standalone tool:
|- Any folder
| |-- CraniumPy.exe
| |-- template (folder)
| | |-- clipped_template_ntplane_com.ply
| | |-- origin_template_ntplane_com.ply

Other change(s):

• Updated templates with center of mass translation

Known issues:

• CraniumPy closes if less than 3 landmarks are selected before registration. Steps need to be follow carefully as described in the step-by-step guide
• Registration step 3. (clip, repair, resample) takes a few seconds and freezes the user interface until all the calculations are performed, which may create the suspicion that the programme crashed. This is not the case. The user interface will unfreeze after the calculations are completed.

v0.2.0 standalone CraniumPy executable

To make the tool more accessible, users no longer have to build an executable, instead it is already part of the main folder (run CraniumPy.exe). This allows anyone to use this software as a standalone tool without having to install any of the requirements or dependencies. For users who want to change the code and subsequently build a new executable, instructions are still included in the README.md.

Required folder structure to run CraniumPy as a standalone tool:
|- Any folder
| |-- CraniumPy.exe
| |-- template (folder)
| | |-- clipped_template_ntplane_com.ply
| | |-- origin_template_ntplane_com.ply

Other change(s):

• updated templates with center of mass translation

Known issues:

• CraniumPy closes if less than 3 landmarks are selected before registration. Steps need to be follow carefully as described in the step-by-step guide
• Registration step 3. (clip, repair, resample) takes a few seconds and freezes the user interface until all the calculations are performed, which may create the suspicion that the programme crashed. This is not the case. The user interface will unfreeze after the calculations are completed.

v0.1.2 center of mass translation added

We have seen that the centroid of the three landmarks (nasion, LH tragus, RH tragus) is not the most suitable origin in our frame of reference for analysis (overly sensitive to change in the posterior regions of the head). The main change in this release is therefore an additional registration step. After registration based on the original centroid, the mesh is translated along the y-axis (front-back) based on the center of mass of the head-circumference slice.

v0.1.1

Small fixes:

• Registration steps added to menu
• "Show registration" function now also available without imported mesh
• Slice height increased to [0,0,2] for visualization of the registration.
• Limited BPD search count implemented.

Initial release

CraniumPy release 0.1.0