Giter Club home page Giter Club logo

qsys's Introduction

Qsys Build Status CodeFactor

Qsys is a C++ library used in Qhord to simulate a quantum particle.

Website: qhord

Demo: Youtube

Getting Started

Prerequisites

This library uses the linear algebra library Eigen, which is already installed in src/Eigen. The depdencies for this project use conan to download the required depdenices. Its documentation can be found here.

Git

this project has some submodule that will need to be cloned

git submodule update --init --recursive

Conan

conan is a package manager for C/C++ libraries.
To install, you need Python >=2.7 with pip, which should come by default:

pip install conan

Then, go to the repository's root directory and do

conan install . -s compiler.libcxx=libstdc++11

to install the required libraries that Qsys will need to use when building.

Scons (cross platform)

Godot will need to be built first before building QSys. it's under /godot-cpp. more information can be found here. It's already available as a submodule so there is no need to clone godot-cpp.

scons generate_bindings=yes

scons is used to compile QSys:

scons platform=windows/linux/osx

This should create the required shared libraries under: bin/{platform}/libQSys.*.
Note: When running the above script, select your operating system from the list (ie if you're compiling on Linux, run scons platform=linux).

CxxTest

We are currently using CxxTest to unit-test this library. To generate a test runner for a given test suite, run

cxxtestgen --error-printer -o test_runner.cpp [TestSuite].h

The runner can then be built via

g++ -o runner -I CXXTEST test_runner.cpp

Files

README.md - this file
LICENSE - the MIT license for this project
math.pdf - an outline of the mathematics being implemented by this library
QsysLibraryInterface.md - a brief description of what the API will be
FunctionSpecification.md - a specification for how functions will be written in initialization files
library - a folder containing all the code. Within it there are three subfolders:

  • include - the header files needed for the tests and source code
  • src - the source code for the library
  • tests - tests for the source code and header files

Contributing

Please reach out to us at http://qhord.com/ or email Aaron at [email protected] for info about contributing.

Starting in 2019, we're using Jira! [link].

Maintainers

The current maintainers of this repository are:

License

This project is licensed under the MIT License - see the LICENSE file for details

qsys's People

Contributors

aarongrisez avatar hungryjoe avatar pollend avatar

Stargazers

 avatar

Watchers

 avatar

Forkers

pollend boyquotes

qsys's Issues

System Class

Feature

We need to code a base class for quantum systems. This will track the state of the quantum system and house all methods related to the system evolution/simulation.

Description

I think the best starting place here would be to emulate the system class already in the tests directory. See system.py for more details.

Main Simulation Loop

Feature

The main loop that needs to be evaluated for the simulation to advance in time

Description

Every time step, the state of the system needs to be updated by applying the next propagator matrix to the current state. Then, that propagator isn't needed anymore.

This step may need an additional check where we see if the state is still normalized. If the precision in evaluating the propagators is sufficient, this won't be necessary. However, if the simulation runs for a very long time, this may become necessary. Let's not address this until we can compare data from the library simulation to known solutions (i.e.: after we hit the first milestone)

Submodule gut

Can we submodule gut so that it doesn't fill up the repo unnecessarily?

Exponentiate Hamiltonian

Feature

Evaluate Matrix exponent to generate the propagators needed for simulation

Description

So one of the core parts of the math outline is to generate an array of matrices (propagators) that let us run the simulation. This is accomplished by a simple 3 step procedure:

  1. Evaluate the given hamiltonian at some time t
  2. Use our selected linear algebra library (Eigen at the time this issue was opened) to evaluate the matrix exponential of the result from step 1.
  3. Append the result of 2 to an array that will exist in memory until it is used in the simulation.

Reference math.pdf for more details and feel free to comment any questions!

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.