/perphix

Utilities and documentation for working with X-ray Workflows datasets.

Primary LanguagePythonMIT LicenseMIT

Perphix

License PyPI Documentation Status

Utilities and documentation for the collection, annotation, and usage of X-ray image sequences for surgical phase recognition, with a focus on percutaneous fracture fixation.

This repository is used by Pelphix to provide data-related utilities and documentation. It classes for loading and processing data, as well as documentation for the Perphix datasets. It is provided separately for ease of installation.

Installation

Perphix can be installed from PyPI:

pip install perphix

Development

Clone the repository and install from source using pip:

git clone git@github.com:arcadelab/perphix.git
cd perphix
pip install -e .

Alternatively, you can use the included environment.yml file to install an Anaconda environment.

conda env create -f environment.yml
conda activate perphix

Documentation

The documentation for this project is hosted on Read the Docs.

Citation

If you find this work useful in your research, please consider citing:

@incollection{Killeen2023Pelphix,
 author = {Killeen, Benjamin D. and Zhang, Han and Mangulabnan, Jan and Armand, Mehran and Taylor, Russell H. and Osgood, Greg and Unberath, Mathias},
 title = {{Pelphix: Surgical Phase Recognition from X-Ray Images in Percutaneous Pelvic Fixation}},
 booktitle = {{Medical Image Computing and Computer Assisted Intervention {\textendash} MICCAI 2023}},
 journal = {SpringerLink},
 pages = {133--143},
 year = {2023},
 month = oct,
 isbn = {978-3-031-43996-4},
 publisher = {Springer},
 address = {Cham, Switzerland},
 doi = {10.1007/978-3-031-43996-4_13}
}