SocketFactory 1.0.5

Python library to analyze how the shape of the stump evolves, from the cast to the finished socket, based on the three-dimensional digitization of the surfaces.

SocketFactory is a Python library to analyze how the shape of the stump evolves, from the cast to the finished socket, based on the three-dimensional digitization of the surfaces. The software uses algorithms and computational geometry tools in order to support data processing processes. The implemented functionalities will also help understanding the errors inherent in the production of tailored orthopedic devices, including the propagation of error during the process chain. The developed library provides a set of interfaces that allows access to non-expert users and is characterized by modularity and extensibility of features.

The data processing flow was developed in the following phases:

• Acquisition and pre-processing of data;
• Digital identification of anatomical landmark;
• Alignment of surfaces in a global reference system according to a common logic, using methods defined both for patients with transtibial and transfemoral amputation;
• Spatial registration of two surfaces to align them with each other;
• Generation of outcomes and dimensional parameters, including distance maps, cross-sections, geodesic paths and regions of interest;
• Extraction of summary statistical indicators of differences related to a series of scans using PCA.

Functionalities

The provided interfaces allow to perform various features:

1. Mesh decimation;
2. Landmark selection;
3. Alignment of the scan according to a chosen method;
4. Registration of two meshes using different algorithms which the user can select from a predefined list;
5. Creation of 3D color quality mapper given two meshes and the related distance metric;
6. Application of the same color scale to N meshes for inter-map comparison;
7. Computation of cross-sections and related dimensional parameters;
8. Extraction of Region Of Interest (ROI) and analysis of the quality parameters associated with it;
9. Generation of the geodesic path between two mesh points, calculation of length and extraction of points coordinates at certain percentages of path;
10. Generation of the .pts file required by the morphing software, given two meshes;
11. PCA application to a set of meshes;
12. Differential PCA application to a set of differences between two mesh groups.

SocketFactory relies on different libraries:

• NumPy and SciPy to perform mathematical operations;
• Pandas, OpenPyXL and Plyfile to manage different data formats;
• PyMeshLab to process data with MeshLab filters;
• VTK and PyVista to process, visualize and analyze data;
• NetworkX and Networkx-query to create and query graphs;
• AmpScan to perform Sanders registration;
• Scikit-learn to perform PCA;
• PyQt to create interfaces.

Installing SocketFactory

SocketFactory uses Python 3.8.

SocketFactory can be installed via pip from PyPI.

pip install SocketFactory

Running applications

Run in Python console:

from SocketFactory import filename

filename.launch()

Replace filename with the file name of related functionality.

Author

• Linda Guiducci
• Ioana Madalina Raileanu