GithubHelp home page GithubHelp logo

yulinwu / autodepgraph Goto Github PK

View Code? Open in Web Editor NEW

This project forked from adriaanrol/autodepgraph

0.0 1.0 0.0 459 KB

QCoDeS based Framework for using a dependency graph for calibrations.

License: MIT License

Python 15.95% C 81.18% HTML 2.88%

autodepgraph's Introduction

AutoDepGraph

PyPI Build Status Codacy Badge Coverage Status DOI

AutoDepGraph is a framework for using dependency graphs to calibrate a system. It is heavily inspired by "Physical qubit calibration on a directed acyclic graph".

Overview

AutoDepGraph consists of two main classes, the CalibrationNode and the Graph. Calibration is done by calling a node that one wants to execute, the node contains the logic required to satisfy the nodes it depends on (parents).

A CalibrationNode contains:

  • parameters

    • state
      • Good (green): check passes
      • needs calibration (yellow): calibration is not up to date anymore and needs to be updated
      • Bad (red): calibration or check has failed
      • unknown (grayed): checks of the node should be run
      • active (blue): calibration or check in progress
    • parents: the nodes it depends on
    • children: nodes that depend on this node
    • check_function : name of function to be executed when check is called. This can be a method of another instrument.
    • calibrate_function : name of function to be executed when calibrate is called. This can be a method of another instrument.
    • calibration_timeout: time in (s) after which a calibration times out.
  • function

    • execute or call
      • Performs the logic of a node (check state, satisfy requirements) with the goal of moving to a "good" state
    • check
      • Performs checks to determine and the state of a node
    • calibrate
      • Executes the calibration routines of the node

A Graph is a container of nodes, it is used for:

  • new graphs can be created by instantiating a graph and then using the add_node method to define new nodes.
  • loading and saving the graph
  • real-time visualization using pyqtgraph
    • state of the node determines color of a node
    • if a node has no calibrate function defined it is a manual node and has a hexagonal instead of a circle as symbol
    • mouseover information lists more properties (planned)

Example calibration graph

Examples

For an introductory example see the example notebook. If you want to see how to use a specific function, see the tests located in the autodepgraph/tests folder.

Installation

  • Clone the repository
  • install the requirements
  • navigate to the repository and run pip install -e .
  • verify success of installation by running py.test

N.B. windows can be "problematic"

Installation on windows is a bit more difficult, this relates mostly to the installation of pygraphviz. To install graphviz and pygraphviz on windows follow these steps:

  • get the 64 bit version of graphviz for windows, copy it to e.g., program files and add the bin folder to the system path.
  • the 64 bit version lacks the libxml2.dll, you most likely have this from some other program. You can find this by searching for libxml2.dll in the program files folder. After that just copy paste it to the bin folder of graphviz.
  • get pygraphviz by downloading the master from github.
  • Now you will need to edit pygraphviz/graphviz.i and pygraphviz/graphviz_wrap.c according to the changes at https://github.com/Kagami/pygraphviz/tree/py3-windows-iobase. A reference can be found in the _install folder
  • Next install using
python setup.py install --include-path="C:\Program Files\graphviz-2.38_x64\include" --library-path="C:\Program Files\graphviz-2.38_x64\lib"
  • then install autodepgraph and test the installation using py.test

Acknowledgements

I would like to thank Julian Kelly for the idea of using a dependency graph for calibrations and for early discussions. I would like to thank Joe Weston for discussions and help in working out the initial design. I would like to acknowledge Livio Ciorciaro for disucssions and as a coauthor of this project.

autodepgraph's People

Contributors

adriaanrol avatar damazter2 avatar eendebakpt avatar lciorciaro avatar nielsbultink avatar peendebak avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.