Trick for using the @profile decorator even when not running with the line_profiler

As suggested in answer 1 on http://stackoverflow.com/questions/18229628/python-profiling-using-line-profiler-clever-way-to-remove-profile-statements
Move to main source directory

This file is better located here as it is only imported once in the main program
Fixed documentation.