adding codebook, final script, README enhancements