MITK-Diffusion icon indicating copy to clipboard operation
MITK-Diffusion copied to clipboard

Documentation missing on docs.mitk.org

Open benoit-dubreuil opened this issue 2 years ago • 5 comments

The MITK Diffusion plugin's documentation is missing on docs.mitk.org.

A linkless org_mitk_gui_qt_diffusionimaging list item is present in the List of Plugins for End User Use on the MITK Plugin Manuals web page for diffusion imaging. I tried to enter the following URL manually in my web browser, but in vain : https://docs.mitk.org/diffusion/nightly/org_mitk_gui_qt_diffusionimaging.html.

Also, there is no entry for diffusion imaging on the API Reference for MITK Plugins page. Is this normal?

However, by searching in the search box on the docs.mitk.org/diffusion website, I was able to find the page private plugins Directory Reference in which the API Reference for org.mitk.gui.qt.diffusionimaging is located. Is it normal that this is private and difficult to find?

benoit-dubreuil avatar Mar 04 '22 16:03 benoit-dubreuil

Actually, what I'm looking for is how to use FiberFox using Python code. Is there documentation about this?

The only thing I found was this : https://github.com/PennBBL/fiberfox-wrapper.

Thank you

benoit-dubreuil avatar Mar 04 '22 16:03 benoit-dubreuil

Hi Benoît. Since mitk diffusion moved from the core mitk repository to it's own repo and is now an extension of mitk, the documentation is unfortunately not building anymore. This is a known issue and will hopefully be addressed soonish.

Regarding your Fiberfox question. FIberfox or MITK DIffusion in general has no python interface. Nevertheless, you can of course simply call the Fiberfox command line app from python, e.g. using os.system('/path/to/MitkDiffusion/MitkFiberfox.sh')

peterneher avatar Mar 07 '22 09:03 peterneher

The documentation inside of MITK Diffusion should work though. Simply open the Fiberfox view and press F1

peterneher avatar Mar 07 '22 09:03 peterneher

Regarding your Fiberfox question. FIberfox or MITK DIffusion in general has no python interface. Nevertheless, you can of course simply call the Fiberfox command line app from python, e.g. using os.system('/path/to/MitkDiffusion/MitkFiberfox.sh')

That's what I found out whilst looking at the FiberFox Python Wrapper code. For any Internet user reading this, on Windows, it is actually os.system('C:/path/to/MitkDiffusion/MitkFiberfox.bat') (Windows supports "forward" slashes in paths).

The documentation inside of MITK Diffusion should work though. Simply open the Fiberfox view and press F1

I confirm it works, thank you.

@peterneher Should I leave this issue open due to the fact that it is a known issue but there's no official issue on this GitHub repository about it?

benoit-dubreuil avatar Mar 07 '22 16:03 benoit-dubreuil

Yeas, leave it ope. Might be useful for others. Thank you and don't hesitate to contact me if there are any more questions!

peterneher avatar Mar 08 '22 09:03 peterneher