.. _sphx_glr_auto_examples_1_registration:

.. _examples_gallery_reg:

Registration examples
=======================================================

The examples below shows how to make various registrations tasks with Demeter-Metamorphosis.



.. raw:: html

    <div class="sphx-glr-thumbnails">

.. thumbnail-parent-div-open

.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example demonstrates how to change the data cost for the registration. We will build a simple toy example mimicking situations we can encounter in medical imaging where the shapes to match are clode in geometry but have different intensity distributions. There are plenty other data costs in the literature for every specific purpose, and we will focus on the mutual information.">

.. only:: html

  .. image:: /auto_examples/1_registration/images/thumb/sphx_glr_data_cost_mutualInformation_thumb.png
    :alt:

  :ref:`sphx_glr_auto_examples_1_registration_data_cost_mutualInformation.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Data cost variation example: Mutual Information</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="In this file we apply the metamorphosis algorithm to 3D images.">

.. only:: html

  .. image:: /auto_examples/1_registration/images/thumb/sphx_glr_metamorphosis_3D_thumb.png
    :alt:

  :ref:`sphx_glr_auto_examples_1_registration_metamorphosis_3D.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Metamorphosis on 3D images</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip=" In this example I will try to demonstrate to you why we should use the semi-Lagrangian scheme during geodesic integration rather than Eulerian. Obviously, we could use even more developed schemes like Runge-Kutta, but semi-Lagrangian is a good compromise between speed and accuracy.">

.. only:: html

  .. image:: /auto_examples/1_registration/images/thumb/sphx_glr_semiLagrangian_scheme_thumb.png
    :alt:

  :ref:`sphx_glr_auto_examples_1_registration_semiLagrangian_scheme.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Why we should use semi-Lagrangian scheme?</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example shows how the MetaMorphosis behaves with different values of rho.">

.. only:: html

  .. image:: /auto_examples/1_registration/images/thumb/sphx_glr_simpleToyExample_metamorphosis_thumb.png
    :alt:

  :ref:`sphx_glr_auto_examples_1_registration_simpleToyExample_metamorphosis.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">MetaMorphosis behaviour with different values of rho</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This toy example was build to simulate a cancer growth in a brain. The gray scott texture as been used to add intricate patterns to the brain background. This particular example is a very hard registration problem, this example shows how constrained metamorphosis can solve it.">

.. only:: html

  .. image:: /auto_examples/1_registration/images/thumb/sphx_glr_toyExample_grayScott_constrainedMetamorphosis_thumb.png
    :alt:

  :ref:`sphx_glr_auto_examples_1_registration_toyExample_grayScott_constrainedMetamorphosis.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Constrained Metamorphosis - simulated cancer growth</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This toy example was build to simulate a cancer growth in a brain. This is a simple example of how to use the weighted metamorphosis to register two images.. This example is part of an exercise, it has been truncated to make you complete it.">

.. only:: html

  .. image:: /auto_examples/1_registration/images/thumb/sphx_glr_toyExample_weightedMetamorphosis_thumb.png
    :alt:

  :ref:`sphx_glr_auto_examples_1_registration_toyExample_weightedMetamorphosis.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Weighted metamorphosis - simulated cancer growth</div>
    </div>


.. thumbnail-parent-div-close

.. raw:: html

    </div>


.. toctree::
   :hidden:

   /auto_examples/1_registration/data_cost_mutualInformation
   /auto_examples/1_registration/metamorphosis_3D
   /auto_examples/1_registration/semiLagrangian_scheme
   /auto_examples/1_registration/simpleToyExample_metamorphosis
   /auto_examples/1_registration/toyExample_grayScott_constrainedMetamorphosis
   /auto_examples/1_registration/toyExample_weightedMetamorphosis