Qics - Quantum Idealistic Computer Simulator
Qics is an Idealistic, Quantum Computer Simulation Library.
It works by holding a Quantum Register as a Matrix,
and then multiplying that against various
Gate Matrices.
For more information about the working,
see the src directory for the source code,
or see examples/node.js or the Usage Section for information
on the usage of the module.
Features
- A 'Universally Complete', Quantum Circuit Based Simulator
- Gate Expansion Function (To make a single qubit gate work on a register with multiple qubits)
- Relatively Simple To Use
- Inline Documentation with Docco
Usage
Currently the library is available using Node.js and NPM. To install the module, use the command:
npm install qics(NOTE: Works with Node.js Versions >= 4)
If you want to use this in the browser, just add the qics.js or qics.min.js
from the dist folder
Then you are able to use the module.
When it's installed, Qics exposes two classes,
qics.Register and qics.gates.
qics.Register is the main class, and is the basis of
the simulator.
It is used like any other class using the new keyword.
Once initiated, there is a number of methods, see below or
the Documentation.
qics.gates exposes all of the single qubit gates as 2D arrays.
It also has some static methods, such as generateGate().
Again, see the documentation.
Example simulation:
// Import the module
const qics = require('qics');
// Create a new Quantum Register with 3 Qubits
const reg = new qics.Register(3);
// Apply some gates.
// Hadamard Gate
reg.applyGate('H', 1);
// CNOT Gate, with control as qubit 1, and the
// target as qubit 3
reg.applyGate('CNOT', 1, 3) ;
// Now measure the register. Should return either "000" or "101"
console.log(reg.measure());You can also use your own gates, by inputing them as an Array or Math.Matrix object to the applyGate function.
// Manually Add A NOT Gate
const reg = new qics.Register(2);
reg.applyGate([
[0, 1],
[1, 0]
], 1);
// Now measure the register. Should return either "10"
console.log(reg.measure());Documentation
This library is documented using Inline Prose Comments, and then generated using Docco. The documentation is just source code comments, but the source isn't too complex, and the functions are quite clear to use.
To read the docs, Checkout Here!
To deploy the docs to the github pages, run
git subtree push --prefix docs origin gh-pagesTo build the docs, run npm run docs.
Build
First you need to clone the repo from github:
git clone git://github.com/adamisntdead/qics.git
cd qicsThen install the dependencies:
npm installThen you can run the build script:
npm run buildThis will build the module, and output to the lib folder.
If you want to build for client side (i.e. in the browser), run
npm run build:all and then it will output qics.js and qics.min.js to the dist folder.
Tests
To run the test for this module, after cloning and installing, run:
npm run testAnd it will run all of the tests.
![greenkeeper[bot] avatar](https://avatars.githubusercontent.com/in/505?v=4 "greenkeeper[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent