Better doc in examples (example of it).

Author: eduardo-rodrigues

README.md

@@ -18,3 +18,6 @@ Work-in-progress instructions:
 4. go to build directory: `cd build`
 5. `cmake -DHYDRA_INSTALL_PATH=/path2sw/Hydra/ -DTHRUST_INSTALL_PATH=/path2sw/Hydra/ -DPYBIND11_INSTALL_PATH=/path2sw/pybind11/include/ ..`
 6. `make`
+
+These instructions create a library .so to be imported from Python.
+Comprehensive documentation is to be found under the `docs/` folder.

examples/PhaseSpace/phsp_basic.py

@@ -1,24 +1,29 @@
-import HydraPython as hypy
+# Licensed under a GNU general public license, see LICENSE.
+"""
+This example shows how to use the Hydra's phase space Monte Carlo algorithms
+to generate a sample of B0 -> J/psi K pi decays.
+
+Author: Deepanshu Thakur
+Date  : Aug 21, 2017
+"""
+
 import sys
 import time
 
+import HydraPython as hypy
+
 
 def main():
-    """
-    This example shows how to use the Hydra's
-    phase space Monte Carlo algorithms to
-    generate a sample of B0 -> J/psi K pi.
-    """
     nentries = 1000000
-    B0_mass = 5.27955
+    B0_mass = 5.27955    # All masses ar given in GeV/c^2
     Jpsi_mass = 3.0969
     K_mass = 0.493677
     pi_mass = 0.13957061
     if len(sys.argv) > 1:
         nentries = int(sys.argv[1])
 
     B0 = hypy.Vector4R(B0_mass, 0.0, 0.0, 0.0)
-    masses = [Jpsi_mass, K_mass, pi_mass]
+    masses = [Jpsi_mass, K_mass, pi_mass]  # list of final-state particles
     phsp = hypy.PhaseSpace3(B0_mass, masses)
 
     #     Device    #