Skip to content
/ EMLDDMM Public

Robust medical image registration using EM-LDDMM for datasets with differing contrasts and missing data. Supports 3D-to-3D and 3D-to-2D serial section alignment. Tward Lab.

License

Notifications You must be signed in to change notification settings

xl1393/EMLDDMM

Repository files navigation

EMLDDMM

License: MIT Python 3.6+ Documentation Status Code Style: Black

Expectation Maximization Large Deformation Diffeomorphic Metric Mapping

EMLDDMM is a robust image registration framework designed to align datasets with differing contrast profiles, missing tissue, or artifacts. It leverages the Expectation Maximization (EM) algorithm to handle missing data and the Large Deformation Diffeomorphic Metric Mapping (LDDMM) paradigm to ensure diffeomorphic mappings.

Explore the Docs » Web Interface »


🌟 Key Features

  • Robust Alignment: Handles differing contrasts and missing data effectively.
  • Diffeomorphic Mappings: Ensures smooth, invertible transformations.
  • Multi-Modality Support: Efficient pipelines for registering datasets with multiple image modalities.
  • Versatile Inputs: Supports 3D-to-3D registration and 3D-to-2D serial section alignment.
  • Standard Formats: Works with VTK, NIfTI, NRRD, and other common medical imaging formats.

🚀 Quick Start

Prerequisites

  • Python 3.6+
  • PyTorch (GPU acceleration recommended but not required)

Installation

  1. Clone the repository

    git clone https://github.com/xl1393/EMLDDMM.git
    cd EMLDDMM
  2. Install dependencies

    pip install -r requirements.txt

Basic Usage

You can run registrations using the command line interface. Configuration is handled via JSON files.

python transformation_graph.py --infile config.json

For detailed examples and tutorials, check out the Examples Documentation.

📖 Documentation

Full documentation is available at twardlab.github.io/emlddmm.

It includes:

🤝 Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

See CONTRIBUTING.md for more details.

📜 License

Distributed under the MIT License. See LICENSE for more information.

About

Robust medical image registration using EM-LDDMM for datasets with differing contrasts and missing data. Supports 3D-to-3D and 3D-to-2D serial section alignment. Tward Lab.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published