.. CREAM_PDFF documentation master file, created by
   sphinx-quickstart on Fri Aug 26 14:58:54 2022.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.

Welcome to CREAM_PDFF's documentation!
======================================


What is CREAM_PDFF ?
********************
The CREAM_PDFF is a open-source multi-language toolbox (Python & MATLAB) developed to evaluate state-of-the art open source fat-water separation algorithms for proton density fat fraction (PDFF) and R2* quantification.



.. toctree::
   :maxdepth: 1
   :caption: Contents:
   
   notebooks/AlgoInfoTable
   installation
   howdoesitwork
   apidoc
   
 

Publication
***********
This open-source toolbox is described in the following abstract :

- Daudé P, Kober F, Confort-Gouny S, Bernard M, Rapacchi S. Comparative Review of Algorithm and Method for proton-density fat fraction (PDFF) quantification. Proceedings [Internet]. Virtual Meeting; 2021. p. Poster. Available from: https://mritogether.github.io/files/abstracts/daude.pdf


References
**********


#. Hernando D, Kellman P, Haldar JP, Liang Z-P. Robust water/fat separation in the presence of large field inhomogeneities using a graph cut algorithm. Magn Reson Med. 2009;NA-NA.

#. Berglund J, Kullberg J. Three-dimensional water/fat separation and T 2* estimation based on whole-image optimization-Application in breathhold liver imaging at 1.5 T. Magn Reson Med. 2012;67:1684–93.

#. Liu J, Drangova M. Method for B0 off-resonance mapping by non-iterative correction of phase-errors (B0-NICE): B0 Mapping with Multiecho Data. Magn Reson Med. 2015;74:1177–88.

#. Berglund J, Skorpil M. Multi-scale graph-cut algorithm for efficient water-fat separation: Multi-Scale Graph-Cut Water/Fat Separation. Magn Reson Med. 2017;78:941–9.

#. Cui C, Wu X, Newell JD, Jacob M. Fat water decomposition using globally optimal surface estimation (GOOSE) algorithm. Magn Reson Med. 2015;73:1289–99.

#. Andersson J, Ahlström H, Kullberg J. Water-fat separation incorporating spatial smoothing is robust to noise. Magn Reson Imaging. 2018;50:78–83.

#. Bydder M, Ghodrati V, Gao Y, Robson MD, Yang Y, Hu P. Constraints in estimating the proton density fat fraction. Magn Reson Imaging. 2020;66:1–8.

#. Boehm C, Diefenbach MN, Makowski MR, Karampinos DC. Improved body quantitative susceptibility mapping by using a variable‐layer single‐min‐cut graph‐cut for field‐mapping. Magn Reson Med. 2021;85:1697–712.