updated documentation and parameter design