cleanup and improvement of downmodis
update documentation