This repository hosts several Jupyter notebooks detailing how to use QInfer. These examples can be viewed online using nbviewer, and can be used interactively online with binder. Instructions for running these examples on your own computer are provided below.
To run the example notebooks provided in this repository, we suggest using Python 3 with the Anaconda distribution for Linux and OS X, or Python 2 with Anaconda for Windows. To get started, download the latest notebooks from GitHub, or clone the repository using Git:
$ git clone https://github.com/QInfer/qinfer-examples.git
We have provided an Anaconda environment for use with these notebooks. This
environment currently does not work on Windows, so please follow the manual
installation instructions below to use these notebooks on Windows. To install
the environment and all required software (NumPy/SciPy, QuTiP, Pandas and
Mpltools), use the conda
tool provided with Anaconda.
$ cd qinfer-examples
$ conda env create -f environment.yml
Next, activate the environment and run Jupyter Notebook.
$ source activate qinfer-examples
$ jupyter notebook
When you are done, you can deactivate the new environment, leaving your Anaconda configuration unchanged.
$ source deactivate
The examples provided in this repository demonstrate using QInfer with other libraries, such as [QuTiP](http://qutip.org), such that these libraries must be installed first to use the example notebooks. The instructions below detail how to do so with Anaconda for Python 2.7 or 3.5 on Linux or OS X, and with Anaconda for Python 2.7 on Windows. Note that these instructions assume that you have Git installed; on Windows, Git can be installed from the official downloads.
$ conda install numpy scipy pandas configobj jupyter
$ conda install -c conda-forge qutip
$ pip install mpltools
$ pip install git+https://github.com/QInfer/python-qinfer.git
Once everything has been installed, the examples can be run by using Jupyer Notebook:
$ cd qinfer-examples
$ jupyter notebook