py-bmd-abaqus 0.1.9

Assign bone material properties to an finite element mesh in ABAQUS. This library was created in order to automatically assign trabecular bone material property values to an ABAQUS CAE input mesh file (INP).

py_BMD_abaqus

Authors:
Dr. David E. Cunningham, Ph.D.

Affiliation at Release:
University of Western Ontario
St. Joseph's Hospital
Roth | McFarlane Hand and Upper Limb Clinic

Description

• Purpose: Hello and welcome! This library was created in order to assign trabecular bone material property values to an ABAQUS CAE input mesh file (INP). This script uses the "Pooled" Morgan et al. Modulus-Density relationship - retrieved from DOI: 10.1016/s0021-9290(03)00071-x in order to calculate material modulus from density in g/cm^3. This tool also returns an array of element HU, density, or modulus values which can be used to easy evaluation of bone quality in the meshed region.

Online Tutorial

Features

• Retains Node and Element Parameters: When adding materials to an ABAQUS input file, sets, boundary conditions are currently NOT preserved. This may be added in the future.
• Supported Element Types (Tested):
  • Quadratic tetrahedral elements TYPE=C3D8, C3D10

Requirements

To run py_BMD_abaqus, you will need the following files:

1. An ABAQUS input file (.inp)
2. A CT scan (as a series of DICOM images in a folder. No other file types should be contained within the folder.)
3. An understanding of the phantom HU and density values for calibration of the DICOM HU density extraction

Installation

Using pip:

1. Install package via pip:

   pip install py_BMD_abaqus
   

Using git clone:

1. Clone the repository:

   git clone https://github.com/yourusername/py_BMD_abaqus.git
   

2. Navigate to the project directory:

   cd py_BMD_abaqus
   

3. Install the required dependencies:

   pip install -r requirements.txt
   

License

This project is licensed under the MIT License. See the LICENSE file for more details.

Citation

If you use this Python package for your research, we kindly request that you cite it using the following information:

IEEE

D. E. Cunningham, “py_BMD_abaqus.” Github, 2024. [Online]. Available: https://pypi.org/project/py-bmd-abaqus/

APA

Cunningham, D. E. (2024). py_BMD_abaqus (0.1.8). Github. https://pypi.org/project/py-bmd-abaqus/

MLA

Cunningham, David E. py_BMD_abaqus. 0.1.8, Github, 2024, https://pypi.org/project/py-bmd-abaqus/

JSES (Journal of Shoulder and Elbow Surgery)

Cunningham DE. py_BMD_abaqus [Internet]. 2024;Available from: https://pypi.org/project/py-bmd-abaqus/