.. raw:: html
   :file: utils/google_analytics_snippet.html

Welcome to the QMENTA SDK documentation!
==========================================

Introduction
------------

The |qmenta_platform| provides a unified solution for data management, processing and visualisation. 
The **analyses** (medical imaging processing tools) are executed on the hybrid cloud infrastructure as 
**Docker containers** and treated as black boxes that communicate with the platform using our SDK.

.. image:: ./images/image_execution_diagram.png
    :align: center
    :width: 350 px

A **simple Python program** connects the |qmenta_platform| with any third-party program. This typically involves 
fetching the input data, starting the binaries or scripts and uploading the result files in a compartmentalized, 
traceable and secure computing environment.

.. image:: ./images/platform_analysis_overview.png
   :width: 700 px
   :align: center

Any data uploaded to the platform can be used for analysis with a simple step, 
and the resulting files can be managed and visualized within the same platform website.

.. image:: ./images/start_analysis_settings.png
   :width: 700 px
   :align: center

In addition, tools can also be seamlessly customized to include external parameters using GUI elements that provide 
an easy way for users to choose between different options and tune the execution flow of the analyses.

.. External Links

.. |qmenta_platform| raw:: html

   <a href="https://client.qmenta.com" target="_blank">QMENTA Platform</a>

Getting started
---------------

We invite you to get started with the QMENTA SDK by following this step-by-step introductory tutorial to integrate 
your first algorithm in the QMENTA platform.

.. toctree::
   :maxdepth: 2

   Getting started <getting_started>

Guides
------

If you are looking for more in-depth information about specific stages in the tool development process with the 
QMENTA SDK, we recommend you 
to read the following documents.

.. toctree::
   :maxdepth: 2

   fundamentals
   advanced

Examples
--------

You can also find concrete examples of how the QMENTA SDK can be used in a variety of tool development scenarios.

.. toctree::
    :maxdepth: 2

    examples

API Reference
-------------

In the API reference you can find detailed documentation about the attributes and methods of the two main classes 
available in the SDK: `qmenta.sdk.context.AnalysisContext` and `qmenta.sdk.context.File`.

.. toctree::
    :maxdepth: 2

    api_reference

Community
---------

Lastly, we invite you to join the conversation and get support from fellow developers and QMENTA representatives 
in the Brain Innovation Hub.

.. toctree::
   :maxdepth: 1

   Join the Community <community>

.. TODO: Decide what to do with this notes
.. .. note::
   Feel free to contact us if you have any doubt or request at sdk@qmenta.com! We are happy to hear from you and expand the capabilities of the platform to fit new useful requirements.
.. .. note::
   In order to add tools to the QMENTA platform you need to have `developer` privileges. If you are interested in this feature, please contact us at info@qmenta.com.