New Examples

.gitignore

@@ -91,3 +91,6 @@ ENV/
 
 # Rope project settings
 .ropeproject
+
+# Pycharm
+.idea/

.travis.yml

@@ -28,6 +28,7 @@ before_install:
 install:
  - sudo apt-get install -qq gcc gfortran libblas-dev liblapack-dev
  - sudo apt-get install -qq gcc-4.8 gfortran-4.8
+ - sudo apt install pandoc
  - |
    if [ ${TRAVIS_PYTHON_VERSION:0:1} = 3 ]; then
        sudo apt-get install python3-numpy
@@ -38,6 +39,7 @@ install:
        python3 setup.py build
        python3 setup.py install
        pip3 install sphinx
+       pip3 install nbsphinx
        pip3 install sphinx-rtd-theme
        cd ${TRAVIS_BUILD_DIR}/docs
        make html
@@ -50,6 +52,7 @@ install:
        python2 setup.py build
        python2 setup.py install
        pip2 install sphinx
+       pip2 install nbsphinx
        pip2 install sphinx-rtd-theme
        cd ${TRAVIS_BUILD_DIR}/docs
        make html

docs/source/conf.py

@@ -32,7 +32,7 @@
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
-extensions = ['sphinx.ext.autodoc','sphinx.ext.mathjax']
+extensions = ['sphinx.ext.autodoc','sphinx.ext.mathjax', 'nbsphinx']
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']
@@ -70,7 +70,7 @@
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
 # This patterns also effect to html_static_path and html_extra_path
-exclude_patterns = []
+exclude_patterns = ['**.ipynb_checkpoints']
 
 # The name of the Pygments (syntax highlighting) style to use.
 pygments_style = 'sphinx'
@@ -158,3 +158,7 @@
 
 
 html_sidebars = { '**': ['globaltoc.html', 'relations.html', 'sourcelink.html', 'searchbox.html'], }
+
+# -- Options for nbsphinx --------------------------------------------------
+
+nbsphinx_execute = 'never'

docs/source/index.rst

@@ -61,7 +61,7 @@ For citation of the individual procedures of QML, please see the "Citing use of
    installation
    citation
    tutorial
-   examples
+   qml_examples/examples
 
 
 .. toctree::

docs/source/installation.rst

@@ -10,6 +10,10 @@ Installing prerequisite modules (for most Linux systems):
 These should already be installed on most systems. The Intel compilers
 and MKL math-libraries are supported as well (see section 1.3).
 
+**Additional note:**
+For running neural networks, TensorFlow 1.8 is required. Pip does not automatically instal TF, so one should follow
+`these <https://www.tensorflow.org/versions/r1.8/install/>` instructions.
+
 Installing via ``pip``
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~