readme and descriptions for analysis code
trying again