This page complements our paper on "Customized software to optimize circumferential pharyngoesophageal free flap reconstruction".
It provides a software that unwraps an open cone to a planar domain. The user prescribes four parameters: base circumference1, top circumference2, height,
and cut angle, and the system produces a PDF file of the corresponding 2D "unwrapped" projection of the cone.
Here is a brief technical description of the method.
Instructions
1. Create a desktop folder with a name ThroatUnwrap.
2. Download the software: ThroatUnwrap*.
* this software will only run on MacOSX Yosemite or higher.
3. Open Terminal
4. Change directory by typing:
cd /Users/`whoami`/Desktop/ThroatUnwrap
5. Install software by typing:
chmod 777 throatunwrap_v3
6. The application is now ready to be used. For example, if measurements of the defect are Circumference 1 = 10cm, Circumference 2 = 7cm, Height=9cm, and you would like to have a cut through frustum at 45 degrees, type the following:
./throatunwrap_v3 10 7 9 45 template.ps
7. Executing this line creates two outputs:
a. Creates a file with a name "template.ps" in the ThroatUnwrap folder. This file contains a printable template.
b. Opens software that shows a virtual model. Within the model, pressing Q allows to unwrap the frustum. Pressing + and – changes the angle of the cut (the angle is documented in the terminal line).
Also see the video below:
License
Copyright (c) 2016 Vladimir Kim, Alex Butskiy
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Note: the software relies on libigl for visualization which is published under MPL2 license.