Main Workflow
===================

Development of quantum programs involves 3 steps: debugging, running and submitting.

.. image:: images/doc_scr22.png
   :alt: Screenshot 1
   :width: 100%
   :align: center




Debugging
---------

With Quantag Studio you can do step debugging of quantum circuits like you do with usual C++ or Java code.
With installed extension open .qasm or .py file and choose Debug Circuit to start debuggin session.
On every step quantum state is calcualated and sent from QVM to IDE. You can see it in Variables view as local variables.
IDE uses Debugger Adapter Protocol to communicate with QVM (Quantum Virtual Machine)

.. image:: images/doc_scr23.png
   :alt: Debugger mode
   :width: 100%
   :align: center


Running
-------
Here Running means use Debugger Adapter Protocol to execute circuit. It is part of debuggin process and can be used 
to polish simple circuits. To get real reasults from quantum circuit you need to Submit circuit to simulator or real hardware.


Submitting
----------

To get real reasults from circuit you need to submit quantum circuit (Job) to hardware accelerated quantum simulator or
real hardware quantum computer.


Configuration
-------------

Every mode can be configured using file config.json in root folder of current workplace.

Structure of config.json file:


Example config.json :: 


{
  "apikey": " take from https://cloud.quantag-it.com/profile",

  "debug": {

    "server": "node3.quantag-it.com:5555" 
   
  },

  "run": {

    "server": "node3.quantag-it.com:5555"  

 },

  "submit": {

    "backend": "ibm",

    "mode": "sampler",

    "shots": 1024,

    "options": {

      "ibm_token": "take from IBMQ",

      "instance": "one",

      "device": "ibm_aachen"


    }
 }
}


Section 'debug' configures QVM endpoint for command 'Debug Circuit'

Section 'run' configures QVM endpoint for command 'Run Circuit'

Section 'submit' configures parameters for command 'Submit Circuit'


Supported backends for submit
=============================

The following backends are supported:

.. list-table::
   :header-rows: 1

   * - Backend
     - Description
   * - cudaq
     - CUDA-Q simulator (also GPU accelerated)
   * - ibm
     - IBM Quantum computer
   * - zi
     - Zurich Instruments hardware (simulator or real)