Repository files navigation

Repository contains the code for an automatic knee joint detection on plain radiographs. It can be used to process very large amount of knee X-rays and generate bounding boxes (up to 6 000 000 per day on a high-end computer).

Our package processes the data in a batch mode using multiple threads. To run in on your machine, you have to install the conda environment. For that, simply executecreate_conda_env.sh.

Run the script as follows:

cd oulukneelocpython detector.py --path_input <dir with DICOM files> \                   --fname_output <file to write the results>

Script will produce the bounding boxes of 120mm and save it to the specified file(by default,../detection_results.txt).

If you use our package in your own research, please cite us:

@inproceedings{tiulpin2017novel,  title={A novel method for automatic localization of joint area on knee plain radiographs},  author={Tiulpin, Aleksei and Thevenot, Jerome and Rahtu, Esa and Saarakkala, Simo},  booktitle={Scandinavian Conference on Image Analysis},  pages={290--301},  year={2017},  organization={Springer}}