improved codebook and readme