chaow95/deformetrica

Deformetrica

Website: www.deformetrica.org

Deformetrica is a software for the statistical analysis of 2D and 3D shape data. It essentially computes deformations of the 2D or 3D ambient space, which, in turn, warp any object embedded in this space, whether this object is a curve, a surface, a structured or unstructured set of points, an image, or any combination of them.

Deformetrica comes with three main applications:

• registration : estimates the best possible deformation between two sets of objects;
• atlas construction : estimates an average object configuration from a collection of object sets, and the deformations from this average to each sample in the collection;
• geodesic regression : estimates an object time-series constrained to match as closely as possible a set of observations indexed by time.

Deformetrica has very little requirements about the data it can deal with. In particular, it does not require point correspondence between objects!

Install

• Requirements: Anaconda 3, Linux or Mac OS X distributions
• Best practice: conda create -n deformetrica python=3.7 && source activate deformetrica
• Conda install: conda install -c pytorch -c conda-forge -c anaconda -c aramislab deformetrica
• Run an example:
  • deformetrica estimate model.xml data_set.xml --p optimization_parameters.xml
  • deformetrica compute model.xml --p optimization_parameters.xml
• Try the GUI (alpha version): deformetrica gui
• Documentation: wiki

Community

• Need help? Ask the Deformetrica Google group.
• Spotted an issue? Have a feature request? Let us know in the dedicated Gitlab section.

References

Deformetrica relies on a control-points-based instance of the Large Deformation Diffeomorphic Metric Mapping framework, introduced in [Durrleman et al. 2014]. Are fully described in this article the shooting, registration, and deterministic atlas applications. Equipped with those fundamental building blocks, additional applications have been successively developed:

• the bayesian atlas application, described in [Gori et al. 2017];
• the geodesic regression application, described in [Fishbaugh et al. 2017];
• the parallel transport application, described in [Louis et al. 2018];
• the longitudinal atlas application, described in [Bône et al. 2018a].

[Bône et al. 2018b] provides a concise reference summarizing those functionalities, with unified notations.

Archived repositories

• Deformetrica 3: deformetrica-legacy2
• Deformetrica 2.1: deformetrica-legacy