updated readme and codebook