Add some documentation to 'chaos.py' functions

This commit adds some docstring style documentation to a few of the
functions found in 'chaos.py'. More documentation is needed, but this is
a start.

Signed-off-by: Prakash Surya <surya1@llnl.gov>