Pythonic Paediatric Computed Tomography to Strength

Download | Documentation | Contact

Authors: George H Allison^1,2

Affiliation: ¹ INSIGNEO Institute, University of Sheffield, United Kingdom; ² School of Mechanical, Aerospace & Civil Engineering, University of Sheffield, United Kingdom

Contact: GHA (Email | LinkedIn), Dr X. Li (Email)

INTRODUCTION

This work uses techniques and tools developed by the INSIGNEO Institute for the CT2S pipeline.

The goal of this work is to automate the CT2S pipeline steps, to use them in a modern setting in a repeatable and user-friendly manner; with high adaptability and extensibility.

Use of this tool has resulted in pipeline time reductions of up to 70 %.

Scripts, methods, and work contained in this repository have been heavily based on works by Dr Xinshan Li and Dr Zainab Altai.

Specific works of importance to this repository are: 1, 2, 3, 4

If you use this software in your work, please cite the following: CITATION

Detailed documentation can be found in the project page or in the application itself under the HELP link at the bottom. Documentation

If you find this software useful, please consider starring the repository.

USAGE

Please only run the scripts if you are comfortable running Python scripts.

It is recommended to use the latest release available under: Releases

You can run each tab individually, or run the entire pipeline from the start. (e.g. You may want to stop after the material assignment step and take that file to your own solving software. This is possible and just requires you to use the first two tabs.)

Fill in blank fields and press button to run. Information will display in the log window. Repeat for each tab required.

REQUIREMENTS

[!IMPORTANT]

An ANSYS install is required to run ANSYS based scripts

Make Sure you are connected to a licensing server before running.

ANSYS scripts require a minimum ANSYS version (2021R2) to function correctly. 2023R2 and above is recommended, and the systems have been tested on 2021R2 up.

If you are looking to use automatic Bonemat-based material assignment, you will need to have the rolling version of Bonemat available on your system and copy the BonematCLI.exe in to the Bonemat folder. We will not distribute a copy of Bonemat with is software.

Please keep in mind the limits of the software this GUI interfaces with. We cannot solve issues that arise for errors in software we do not control. However, if you think there is an issue with the GUI, please raise an issue on the repo.

Python Requirements

• See requirements file

• Set up an environment as follows:

  • pip install -r requirements.txt

File / Model / Input Requirements

You can start the process at any step by jumping to that tab.

If you wish to start fresh you require the following files: - DICOM image scans contained in a *.VTK file. - Segmented 3D *.STL model of the bone. (It is important you check the quality of segmentation, meshing will fail if there are external floating elements in the model.) - Configuration file for material application, based on the specific CT scanner used.

CONTACT

Batch and pool processing are currently unavailable in the public release.

Sideways and STANCE are currently unavailable in the public release.

If you are interested in any of these features, please contact the authors.

GHA (Email | LinkedIn), Dr X. Li (Email)

DISCLAIMER

This software has been designed for research purposes only and has not been reviewed or approved by medical device regulation bodies.

This software is not to be used alone or in combination, for human beings for one or more of the following specific medical purposes: - diagnosis, prevention, monitoring, prediction, prognosis, treatment or alleviation of disease. - diagnosis, monitoring, treatment, alleviation of, or compensation for, an injury or disability. - investigation, replacement or modification of the anatomy or of a physiological or pathological process or state. - providing information by means of in vitro examination of specimens derived from the human body, including organ, blood and tissue donations.

FEEDBACK AND DEVELOPMENT

This software is in active development and will likely remain for the next few years. If you have any feedback, please raise an issue or open a discussion on the repository.

If you want to include your custom scripts, please raise an issue, open a discussion, or create a pull request on the repository. Alternatively, you can contact the authors directly.

Pull requests are welcome, but please ensure you have tested your changes before submitting.

REFERENCES

1: Altai, Z., Viceconti, M., Offiah, A.C. et al. Investigating the mechanical response of paediatric bone under bending and torsion using finite element analysis. Biomechanics and Modeling in Mechanobiology 17, 1001–1009 (2018). DOI

2: Altai, Z., Muhammad, Q., Li, X. et al. The effect of boundary and loading conditions on patient classification using finite element predicted risk of fracture. Clinical Biomechanics 68, 137–143 (2019). DOI

3: Li, X., Viceconti, M., Cohen, M.C. et al. Developing CT based computational models of pediatric femurs. Journal of Biomechanics 48, 2034–2040 (2015). DOI

4: Viceconti, M., Muhammad, Q., Bhattacharya, P. et al. Are CT-Based Finite Element Model Predictions of Femoral Bone Strengthening Clinically Useful? Current Osteoporosis Reports 16, 216–223 (2018). DOI