An open API service indexing awesome lists of open source software.

https://github.com/predict-idlab/landmarker

PyTorch-based toolkit for landmark localization
https://github.com/predict-idlab/landmarker

computer-vision keypoint-detection keypoints-detector landmark-detection landmark-localization medical-image-analysis medical-image-processing python-package pytorch

Last synced: 19 days ago
JSON representation

PyTorch-based toolkit for landmark localization

Awesome Lists containing this project

README

          



landmarker

[![PyPI Latest Release](https://img.shields.io/pypi/v/landmarker.svg)](https://pypi.org/project/landmarker/)
[![support-version](https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13-blue)](https://pypi.org/project/landmarker/)
[![codecov](https://img.shields.io/codecov/c/github/predict-idlab/landmarker?logo=codecov)](https://codecov.io/gh/predict-idlab/landmarker)
[![CodeQL](https://github.com/predict-idlab/landmarker/actions/workflows/codeql.yml/badge.svg)](https://github.com/predict-idlab/landmarker/actions/workflows/codeql.yml)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?)](http://makeapullrequest.com)
[![Documentation](https://github.com/predict-idlab/landmarker/actions/workflows/documentation.yml/badge.svg)](https://predict-idlab.github.io/landmarker/)
[![Testing](https://github.com/predict-idlab/landmarker/actions/workflows/tests.yml/badge.svg)](https://github.com/predict-idlab/landmarker/actions/workflows/tests.yml)

Landmarker is a [PyTorch](https://pytorch.org/)-based toolkit for (anatomical) landmark localization in 2D/3D images. It is designed to be easy to use and to provide a flexible framework for state-of-the-art landmark localization algorithms for small and large datasets. Landmarker was developed for landmark detection in medical images. However, it can be used for any type of landmark localization problem.

## ๐Ÿ› ๏ธ Installation

| | command |
| :--------------------------------------------------- | :------------------------------------ |
| [**pip**](https://pypi.org/project/landmarker) | `pip install landmarker` |

## ๐Ÿš€ Getting Started
Technical documentation is available at [documentation](https://predict-idlab.github.io/landmarker/).

Examples and tutorials are available at [examples](https://predict-idlab.github.io/landmarker/examples/index.html)

## โœจ Features
- **Modular**: Landmarker is designed to be modular. Almost all components can be used independently.
- **Flexible**: Landmarker provides a flexible framework for landmark detection, allowing you to easily customize your model, loss function, and data loaders.
- **State-of-the-art**: Landmarker provides state-of-the-art landmark detection models and loss functions.

## ๐Ÿ“ˆ Future Work
- Extension to landmark detection in videos.
- ...

## ๐Ÿ‘ช Contributing

We welcome contributions to Landmarker. Please read the [contributing guidelines](CONTRIBUTING.md) for more information.

## ๐Ÿ“– Citation
If you use landmarker in your research, please cite the following paper:

J. Jonkers, L. Duchateau, G. Van Wallendael, and S. Van Hoecke, โ€œlandmarker: A Toolkit for Anatomical Landmark Localization in 2D/3D Images,โ€ SoftwareX, vol. 30, p. 102165, May 2025, doi: 10.1016/j.softx.2025.102165.

J. Jonkers, F. Coopman, L. Duchateau, G. V. Wallendael, and S. V. Hoecke, โ€œReliable uncertainty quantification for 2D/3D anatomical landmark localization using multi-output conformal prediction,โ€ Mar. 18, 2025, arXiv: arXiv:2503.14106. doi: 10.48550/arXiv.2503.14106.

## ๐Ÿ“ License
Landmark is licensed under the MIT [license](LICENSE).

---


๐Ÿ‘ค Jef Jonkers