Improve tutorial for upcoming release on github

* Also some minor deletion of dead code in tests.

* Bump version up to v1.8.1

Change-Id: Ie345aaf5795e9bf9dff76199d130e12a201655ac

Author: obreitwi

example/tutorial.py

@@ -1,7 +1,6 @@
 #!/usr/bin/env python
 # encoding: utf-8
 """
-
     Small informal tutorial hastily thrown together to demonstrate how to use
     the spike-based sampling (sbs) library.
 
@@ -563,7 +562,25 @@ def is_noarg_function(f):
                 return True
         return False
 
+    def print_paragraph(text):
+        import textwrap
+        for line in textwrap.wrap(text, width=80, initial_indent="# ",
+                                  subsequent_indent="# "):
+            print(line)
+
     def show_functions():
+        message = "# sbs tutorial (using v{version}) #".format(
+            version=sbs.__version__)
+        barrier = "#" * len(message)
+        print(barrier)
+        print(message)
+        print(barrier)
+        print("#")
+        print_paragraph("The following tutorial functions are defined. "
+                        "Run them by typing:")
+        print("#    python {script} <function-name>".format(
+            script=sys.argv[0]))
+        print("#")
         functions.sort()
         for f in functions:
             print(f)
@@ -576,5 +593,9 @@ def show_functions():
                 run = globals()[launch]
                 run()
             else:
-                print(launch, "not part of functions:")
+                print_paragraph(
+                    "ERROR: '{to_launch}' not part of functions!".format(
+                        to_launch=launch))
+                print("#")
                 show_functions()
+                sys.exit(1)

sbs/version.py

@@ -1,2 +1,2 @@
 
-__version__ = (1, 8, 0)
+__version__ = (1, 8, 1)

tests/test_basics.py

@@ -441,13 +441,11 @@ def test_sample_network_fixed_spikes(self):
             bm.dist_marginal_theo, bm.dist_marginal_sim)
         log.info("DKL marginal: {}".format(dkl_marginal))
         self.assertTrue(dkl_marginal > 0)
-        #  self.assertTrue(dkl_marginal < 1) # not assured here
 
         dkl_joint = sbs.utils.dkl(
-                bm.dist_joint_theo.flatten(), bm.dist_joint_sim.flatten())
+            bm.dist_joint_theo.flatten(), bm.dist_joint_sim.flatten())
         log.info("DKL joint: {}".format(dkl_joint))
         self.assertTrue(dkl_joint > 0)
-        #  self.assertTrue(dkl_joint < 1) # not assured here
 
         bm.plot_dist_marginal(prefix="test_basics_fixed_spike-", save=True)
         bm.plot_dist_joint(prefix="test_basics_fixed_spike-", save=True)