Skip to content

UST-QuAntiL/visualization-service

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Visualization Service

Tests passed License Code style: black codecov

The visualization service enables a service-based visualization of quantum-related provenance and execution data.

It implements visualization functions for:

  • Circuits, e.g., implemented in OpenQASM 2.0 or 3.0
  • Optimization landscapes
  • Circuit execution data
  • Objective Evaluations, e.g., for MaxCut or TSP

Running the Application

The easiest way to get started is using a pre-built Docker image:

docker run -p 5079:5079 planqk/visualization-service

Alternatively, the application can be built manually:

  1. Clone the repository using git clone https://github.com/UST-QuAntiL/visualization-service.git
  2. Navigate to the repository cd visualization-service
  3. Build the Docker container: docker build -t visualization-service .
  4. Run the Docker container: docker run -p 5079:5079 visualization-service

Then the application can be accessed via: http://127.0.0.1:5079.

API Documentation

The Visualization service provides a Swagger UI, specifying the request schemas and showcasing exemplary requests for all API endpoints.

Developer Guide

Setup (exemplary for ubuntu 18.04):

git clone https://github.com/UST-QuAntiL/visualization-service.git
cd visualization-service

# if virtualenv is not installed
sudo -H pip install virtualenv

# create new virtualenv called 'venv'
virtualenv venv

# activate virtualenv; in Windows systems activate might be in 'venv/Scripts'
source venv/bin/activate

#install application requirements.
pip install -r requirements.txt

Execution:

  • Run the application with: flask run --port=5079
  • Test with: python -m unittest discover
  • Coverage with: coverage run --branch --include 'app/*' -m unittest discover; coverage report

Codestyle:

black . OR black FILE|DIRECTORY

Disclaimer of Warranty

Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License.

Haftungsausschluss

Dies ist ein Forschungsprototyp. Die Haftung für entgangenen Gewinn, Produktionsausfall, Betriebsunterbrechung, entgangene Nutzungen, Verlust von Daten und Informationen, Finanzierungsaufwendungen sowie sonstige Vermögens- und Folgeschäden ist, außer in Fällen von grober Fahrlässigkeit, Vorsatz und Personenschäden, ausgeschlossen.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published