added comments for the final user of the software and the reader of the thesis