Skip to main content

Demo figure

ICON: Learning Regular Maps through Inverse Consistency

This is the official repository for

ICON: Learning Regular Maps through Inverse Consistency.
Hastings Greer, Roland Kwitt, Francois-Xavier Vialard, Marc Niethammer.
ICCV 2021 https://arxiv.org/abs/2105.04459

GradICON: Approximate Diffeomorphisms via Gradient Inverse Consistency.
Lin Tian, Hastings Greer, Francois-Xavier Vialard, Roland Kwitt, Raúl San José Estépar, Marc Niethammer.
CVPR 2023 https://arxiv.org/abs/2206.05897

Inverse Consistency by Construction for Multistep Deep Registration. Hastings Greer, Lin Tian, Francois-Xavier Vialard, Roland Kwitt, Sylvain Bouix, Raul San Jose Estepar, Richard Rushmore and Marc Niethammer. MICCAI 2023 https://arxiv.org/abs/2305.00087

Cite this work

@InProceedings{Greer_2021_ICCV,
    author    = {Greer, Hastings and Kwitt, Roland and Vialard, Francois-Xavier and Niethammer, Marc},
    title     = {ICON: Learning Regular Maps Through Inverse Consistency},
    booktitle = {Proceedings of the IEEE/CVF International Conference on Computer Vision (ICCV)},
    month     = {October},
    year      = {2021},
    pages     = {3396-3405}
}
@article{Tian_2022_arXiv,
  title={GradICON: Approximate Diffeomorphisms via Gradient Inverse Consistency},
  author={Tian, Lin and Greer, Hastings and Vialard, Fran{\c{c}}ois-Xavier and Kwitt, Roland and Est{\'e}par, Ra{\'u}l San Jos{\'e} and Niethammer, Marc},
  journal={arXiv preprint arXiv:2206.05897},
  year={2022}
}
@misc{greer2023inverseconsistencyconstructionmultistep,
      title={Inverse Consistency by Construction for Multistep Deep Registration}, 
      author={Hastings Greer and Lin Tian and Francois-Xavier Vialard and Roland Kwitt and Sylvain Bouix and Raul San Jose Estepar and Richard Rushmore and Marc Niethammer},
      year={2023},
      eprint={2305.00087},
      archivePrefix={arXiv},
      primaryClass={cs.CV},
      url={https://arxiv.org/abs/2305.00087}, 
}

uniGradICON and multiGradICON

If you are interested in general purpose deep learning registration approaches check out uniGradICON and multiGradICON. These networks were trained using the GradICON technology but over many different datasets allowing them to generalize to different unimodal and multimodal registration tasks.

Video Presentation

Running our code

We are available on PyPI!

pip install icon-registration

To run our pretrained model in the cloud on sample images from OAI knees, visit our knee google colab notebook

To run our pretrained model for lung CT scans on an example from COPDgene, visit our lung google colab notebook


To train from scratch on the synthetic triangles and circles dataset:

git clone https://github.com/uncbiag/ICON
cd ICON

pip install -e .

python training_scripts/2d_triangles_example.py

Metadata

Release files for icon-registration 1.1.9

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for icon-registration 1.1.9
File Size Uploaded
icon_registration-1.1.9.tar.gz 51.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for icon-registration 1.1.9
File Interpreter ABI Platform
icon_registration-1.1.9-py3-none-any.whl Python 3 none any Details

Total release size: 100.6 kB

Release files / icon_registration-1.1.9.tar.gz

Download URL icon_registration-1.1.9.tar.gz
Size 51.2 kB
Tags Source
SHA-256 checksum
How to use checksums
cb586c7a836985877ec00f593a544d1b9d7da3cbf7fd27e39f37fd2ad0890af8
BLAKE2b-256 checksum
How to use checksums
11315d46633cd73d6042b10c6609dd427b9a02f6430c0fb1c4c1e37c0f435964
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.5

Release files / icon_registration-1.1.9-py3-none-any.whl

Download URL icon_registration-1.1.9-py3-none-any.whl
Size 49.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
679dcba027b27bb82c45aa2ab6f83af6aa0fc0bcfe017deb82d2aae812da66b8
BLAKE2b-256 checksum
How to use checksums
37f19b4878bea40c38fa741fa38613d8e4f58007fbb0b6c4b9b62f29986f06c0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.5

Release history Release notifications | RSS feed

This release

1.1.9 This release

2 release files

1.1.8

2 release files

1.1.7

1 release file

1.1.6

1 release file

1.1.5

1 release file

1.1.4

1 release file

1.1.3

1 release file

1.1.2

1 release file

1.1.1

1 release file

1.1.0

1 release file

1.0.0

1 release file

0.3.4

1 release file

0.3.3

1 release file

0.3.2

1 release file

0.3.1

1 release file

0.3.0

1 release file

0.2.1

1 release file

0.2.0

1 release file

0.1.0

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page