Documented by added comments and discretized kappa function fixed.

- Many comments made to explain what's going on. Besides that, the
  places where to find the definition in the paper were added.
- Dove into the numpy.array api in order to get the array dimension
  problem fixed. alongside to this, added comment on the reliability of
the kappa result.