This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!
Project Description

Introduction

This python package provides tools to add material properties of bone to an ABAQUS finite element model input file, where the modulus of each element is defined based upon its corresponding CT data using the Hounsfield Unit (HU) and input parameters.

The package aims to be equivalent to Bonemat software developed by researchers in Bologna, Italy, but tailored for ABAQUS finite element users. The original Bonemat can be found at www.bonemat.org, and further details can be found in published papers [1], [2], [3], [4]. For more information about the verification tests performed on this Python package, refer to the following journal article [5].

Notes:

  • When this package is used to add materials to an ABAQUS input file, any model parameters (such as loading, sets, or step definitions) are retained.
  • The present version of this package will only work with:
    • linear and quadratic tetrahdral elements
    • linear wedge elements
    • linear hexahedral elements
  • To run the package, you need to have three files: a parameters file (.txt), an ABAQUS input file (.inp), and a CT scan (either as a series of dicom images in a folder, or as a .vtk file). Example files are provided in the example folder.
  • More information on this package can be found at the start of the py_bonemat_abaqus.py code

Publication

If you decide to use this python package for your research, when publishing we kindly request that you cite the following paper [5].

Installation

The simplest and recommended way to install py_bonemat_abaqus is with pip. You may install the latest stable release from PyPI with pip using the following command:

>>> pip install py_bonemat_abaqus

If you do not have pip, you may use easy_install:

>>> easy_install py_bonemat_abaqus

Alternatively, you may download the source package from the PyPI page, extract it and install using:

>>> python setup.py install

Dependencies

  • Numpy - version 1.6 or higher
  • PyDicom - version 0.9.7 or higher

Usage

The package can be run either from the terminal, or imported into a python script.

To run from a terminal use the following syntax:

>>> py_bonemat_abaqus -p <parameters file> -ct <ct file/dir> -m <abaqus input file>

To run from within a python script, at the top of the file import the ‘run’ script from the package, and then execute with:

run(<parameters file>, < ct scan dir or vtk>, <abaqus input file>)

For example, if a python script containing the following two lines were saved in the examples folder of the source code, it would calculate the material properties of ‘example_abaqus_mesh.inp’:

from py_bonemat_abaqus.run import run

run('example_parameters.txt','example_ct_data.vtk','example_abaqus_mesh.inp')

References

[1]Helgason B, Taddei F, Palsson H, Schileo E, Cristofolini L, Viceconti M, Brynjolfsson S. (2008) Med Eng Phys 30 [4] p444-453: http://dx.doi.org/10.1016/j.medengphy.2007.05.006
[2]Taddei F, Schileo E, Helgason B, Cristofolini L, Viceconti M. (2007) Med Eng Phys 29 [9] p973-979: http://dx.doi.org/10.1016/j.medengphy.2006.10.014
[3]Taddei F, Pancanti A, Viceconti M. (2004) Med Eng Phys 26 [1] p61-69: http://dx.doi.org/10.1016/S1350-4533(03)00138-3
[4]Zannoni C, Mantovani R, Viceconti M. (1998) Med Eng Phys 20 [1] p735-740: http://dx.doi.org/10.1016/S1350-4533(98)00081-2
[5]Pegg EC, Gill HS. (2016) J Biomechanics. In Press. http://dx.doi.org/10.1016/j.jbiomech.2016.07.037
Release History

Release History

1.0.9

This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

1.0.8

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

1.0.7

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

1.0.6

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

1.0.5

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

1.0.4

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

1.0.3

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

1.0.2

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

1.0.1

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

1.0.0

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
py_bonemat_abaqus-1.0.9.zip (56.9 kB) Copy SHA256 Checksum SHA256 Source May 31, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting