ABAQUS plug-in to create virtual x-rays from bone models
Project description
About
An ABAQUS plug-in to generate virtual x-rays from 3D finite element bone/implant models.
Creates a time series of virtual x-rays of a bone/implant model by projecting a scalar representing bone density onto three orthogonal planes. This is intended for post-processing of numerical bone remodelling analyses, the main objective of which typically is to detect temporal changes in the bone density around an implant and predict the long term stability of the implant in the absence of clinical data.
The resulting series of virtual x-ray images are in a format similar to clinical results making the result (1) more easily understood and accepted by clinicians and (2) able to be directly compared to clinical data, which enables validation of numerical bone remodelling algorithms.
The series of images (which are outputted in common image formats such as bmp, jpeg and png) can be analysed using BMDanalyse, which was developed for this purpose. This tool enables the quick creation of regions of interest (ROIs) over which changes in bone density over time can be determined.
Installation
Installation of pyvXRAY with prebuilt extension module
Download the binary distribution (zip file) version of pyvXRAY appropriate for your system. This is currently available on the project website for Windows 64-bit only
Unzip the zip file to a convenient location
Copy the abaqus_plugins directory to one of the locations required by ABAQUS. See README.txt or the ABAQUS documentation for further details
Installation of pyvXRAY from source
Download source distribution (zip file) version of pyvXRAY
Unzip the zip file to a convenient location
Open a command window and browse to pyvXRAY folder containing setup.py
Build the extension modules using:
$ python setup.py build_ext --inplace
See README.txt for more details on how to do this. Note that this should create file pyvXRAY/cythonMods.pyd (on Windows).
Copy the entire pyvXRAY to one of the abaqus_plugins directories that are searched by ABAQUS for plug-ins. See README.txt or the ABAQUS documentation for further details
How to use
To use pyvXRAY, follow these steps:
Open ABAQUS/CAE or ABAQUS/Viewer
Open the ABAQUS odb file in the current viewport
Run pyvXRAY by clicking the following from the ABAQUS toolbar:
Plug-ins -> Bone modelling tools -> Create virtual x-rays
Fill in the required information in the pyvXRAY GUI. The required information includes:
The part set name of the bone and implant regions
The name of the fieldoutput representing bone density
A list of steps for which the virtual x-rays will be created (only the last frame in the step is used)
Details corresponding to sampling resolution and image size
Click ‘OK’ as the bottom of the pyvXRAY GUI to run
Look at the Python Scripting Window at the bottom of the ABAQUS GUI for progress and error messages
Analyse the images to investigate regional changes in bone density over time. BMDanalyse can be used for this purpose
Requirements
Note that there are a several requirements for using the current version of pyvRAY:
Requires ABAQUS, a commercially available, general purpose finite element analysis software. ABAQUS requires a paid license available from SIMULIA
The finite element model must consist of tetrahedral elements (ABAQUS element base types C3D4 or C3D10)
The ABAQUS results file (odb) must contain a scalar variable that represents bone density
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.