added documentation to shoalDE.py