Welcome to tofu’s documentation!¶
ToFu (TOmography for FUsion) is an open-source python library first created at the Max-Planck Institute for Plasma Physics (IPP) in Garching (Germany) by Didier Vezinet (as a postdoc) through the years 2014-2016. It is continuously maintained, debugged and upgraded to this day.
It aims at providing the fusion and plasma community with an object-oriented, transparent and documented tool for designing tomography diagnostics, computing synthetic signal (direct problem) as well as tomographic inversions (inverse problem). It gives access to a full 3D description of the diagnostic geometry, thus reducing the impact of geometrical approximations on the direct and, most importantly, on the inverse problem.
It is modular and generic in the sense that it was developed with the objective of being machine-independent, thus guaranteeing that it can be used for arbitrary geometries and with an arbitrary number of apertures for each detector.
- Open-source:
ToFu is distributed under the very permissive MIT license, thus allowing free use, keeping in mind that neither the author nor any of the laboratories in which he worked can be held responsible for unwanted behaviour or results. It is instead transparency, reproducibility and incremental improvements that guarantee quality on the long-term.
ToFu is hosted on github.
- Versions:
- A list of the successive versions of ToFu, with a brief description can be found here.
- Dependences:
- ToFu uses the following python packages.
- Citing ToFu:
- If you decide to use ToFu for research and published results please acknowledge this work by citing the project.
- Feedback - bug report - wish list
- To provide feedback on ToFu itself please use the github page.
To provide feedback on a specific plugin, please refer to that plugin’s webpage where a contact will be indicated.
- Miscellaneous
- ToFu is tested with the nose/1.3.4 library (not all methods are tested yet, in process...) ToFu can be installed using the distutils library.
Contents:¶
Description of the library structure:
Code documentation:
Notice that the main ToFu classes and methods have docstrings so you can access contextual help with the usual python syntax from a iython console (print <method>.__doc__, or <method>?).
- Tutorials and how to’s:
- How to compute integrated signal from 2D or 3D synthetic emissivity
- Visit the tutorial for getting started: load an already-existing diagnostic geometry in a synthetic diagnostic approach to solve the direct problem and compute the line Of Sight and / or Volume of Sight integrated signals from a simulated emissivity field that you provide as an input.
- How to compute tomographic inversions (to do)
Use existing diagnostic geometry and signals to solve the inverse problem and compute tomographic inversions using a choice of discretization basis functions and regularisation functionals.
How to contribute (todos)